# AgroLink Angola
AgroLink Angola e uma plataforma agricola portal-first com tres superficies principais:
- `apps/web`: aplicacao web multi-portal em portugues, com camada publica minima e portais privados por papel.
- `apps/agent-mobile`: app Flutter para agentes de campo com offline-first, fila local e sincronizacao.
- `apps/api`: API NestJS com Prisma, RBAC, auditoria, sync e suporte explicito a modo demo controlado por ambiente.
O repositorio continua a incluir um modo demo/local para seeds, atalhos de validacao e apresentacoes. Produção exige que esses comportamentos estejam desligados.
## Escala demo atual
O ambiente demo foi alargado para uma narrativa de investidor e agora inclui:
- 36 agricultores seedados
- 12 províncias ativas
- múltiplas fazendas por parte do portefólio
- diversidade alargada de culturas
- acordos, expedições e comprovativos de entrega suficientes para leitura comercial
- analítica demo determinística para receita anual, ranking de culturas vendidas e consumo de água mensal
## Estado de release local
Validado no workspace limpo `/Volumes/2T Storage/Angola garden`.
O caminho de aceitacao local para a web e `pnpm preview:web`.
O `next dev` pode voltar a sofrer com a instabilidade interna de manifesto do Next 15, por isso o preview compilado e o modo suportado para verificacao final.
## Setup rapido
1. `pnpm install --frozen-lockfile`
2. Confirmar `.env` a partir de `.env.example`
3. `docker compose up -d`
4. `pnpm db:generate`
5. `pnpm db:seed`
## Comandos principais
- `pnpm dev`
- `pnpm build`
- `pnpm preview:web`
- `pnpm demo:reset`
- `pnpm lint`
- `pnpm typecheck`
- `pnpm test`
- `pnpm db:generate`
- `pnpm db:migrate`
- `pnpm db:seed`
- `pnpm smoke:docker`
- `pnpm smoke:health`
- `pnpm smoke:e2e`
## Como executar
### API
`pnpm --filter @agrolink/api dev`
- base local: `
localhost`
- health: `
localhost`
### Web
Preview estavel e recomendado:
`pnpm preview:web`
- porta padra …