Introdução
Overview
Esta é a documentação técnica interna do AZ Collections. Ela existe para apoiar o desenvolvimento e as atualizações da plataforma — registrar o que está construído, o que está devendo e o que precisa acontecer a seguir.
Conteúdo
Duas seções, com propósitos diferentes. Uma olha para dentro, outra para frente.
| Seção | Responde | Quando consultar |
|---|---|---|
| Débitos técnicos | O que hoje custa tempo, dinheiro ou risco — e por quê. | Ao planejar sprint, priorizar refatoração ou entender por que algo é lento de mexer. |
| Virada AZ 3.0 | O que falta para a versão 3.0 entrar em produção. | Ao planejar a virada, dimensionar infraestrutura ou acompanhar o andamento. |
Contagem de arquivos, tamanho de serviços, versões de biblioteca e cobertura de tabelas foram medidos no código, não estimados. Afirmações sobre ambiente valem para a data indicada — ambiente muda, e memória envelhece.
Como a plataforma se divide hoje
O AZ Collections é um aplicativo e quatro serviços. Saber quem é dono de quê evita a confusão mais comum aqui — procurar uma funcionalidade no lugar errado.
| Serviço | Repositório | De que é dono | Estado |
|---|---|---|---|
| Aplicativo | azcollections-mobile |
Toda a interface. React Native / Expo. | 3.0 construído, em acabamento |
| Servidor principal | api.collectionsaz.com |
Contas, feed, loja, checkout, pedidos, AZ Pay. | Em produção |
| Chat | chat.collectionsaz.com |
Conversa, negociação e propostas de troca. | Versão antiga em produção; a 3.0 pronta e não publicada |
| Mídia | api.az.media.collectionsaz.com |
AZ Play, envio de fotos e vídeos, moderação automática. | Só em homologação — nunca rodou em produção |
| Dashboard | az-dash.collectionsaz.com |
Administração interna e relatórios. | Em produção |
Os serviços conversam entre si por fila de mensagens, não por chamadas diretas: cada um mantém sua própria cópia do que precisa saber dos outros. É o que permite que um fique fora do ar sem derrubar os demais — e também o que explica por que um dado às vezes demora alguns segundos para aparecer em outro lugar.
Por onde começar
Para quem chega agora ao projeto, Débitos técnicos é a leitura mais curta e a que mais explica o comportamento do código: por que certas áreas são lentas de alterar, onde estão as armadilhas e o que já se sabe que precisa mudar.
Para questões de prazo, infraestrutura ou lançamento, o ponto de partida é Virada AZ 3.0.