SmartPerformance SFA — Documentação

Plataforma de Sales Force Automation multiorganização, escalável e orientada a eventos. Esta documentação acompanha o código: cada feature relevante atualiza estas páginas e a referência de API no mesmo PR.

Mapa rápido

• Arquitetura — serviços, fronteiras, multiorganização, eventos e escala.
• Autenticação & RBAC — login, tokens, papéis e permissões.
• Referência da API — Scalar interativo a partir do OpenAPI do NestJS.

Stack

Camada	Tecnologia
Monorepo	pnpm workspaces + Turborepo
Backend	NestJS + Prisma + PostgreSQL + Redis
Frontend	Next.js (App Router) + shadcn/ui
Docs	Docusaurus + Scalar
Execução	Docker (compose para dev)

Como rodar (dev)

cp .env.example .env            # ajuste segredos
docker compose up -d postgres redis
pnpm install
pnpm --filter @sfa/api prisma:migrate dev
pnpm --filter @sfa/api seed     # cria organização + admin
pnpm dev                        # api (3001), web (3000), docs (3002)

Login inicial (do seed): admin@smartperformance.local / Admin@123456 (troque após o primeiro acesso).