Estrutura do projecto

Organização do monorepo SIGA Plus (cinco apps + dados partilhados por contratos).

---

Árvore principal

onsoft-replica-dev/
├── src/                      # SIGA — gestão escolar (TanStack Start :3006)
│   ├── routes/               # Rotas de ficheiro (/alunos, /pedagogica, …)
│   ├── features/             # Módulos (students, finance, academic, …)
│   ├── components/           # UI partilhada do SIGA
│   └── lib/                  # URLs do ecossistema, helpers
├── painel/
│   ├── web/                  # WEB comercial (Vite :5174)
│   ├── admin/                # ADMIN SaaS Control Center (Next.js :3005)
│   ├── payflow/              # PAYFLOW — financeiro transacional (Vinext :3007)
│   └── docs/                 # DOC — VitePress (:5173)
├── scripts/siga/             # Inventário modules.json, checks, scaffold
├── supabase/                 # SQL SGA (APPLY_*.sql — nunca migrações Lovable)
└── tests/                    # Vitest + Playwright E2E

Cada app mantém o seu frontend. Não unificar design systems.

---

SIGA (src/)

Pasta	Conteúdo
routes/	Páginas TanStack Router
features/<módulo>/	schemas.ts, server.ts, UI do módulo
features/auth/	access-policy, portal-engine, navigation-catalog, route-inventory
components/layout/	AppShell, AppSidebar, PageHeader

Navegação: mapa de módulos. Inventário: scripts/siga/modules.json.

npm run siga:check      # inventário + testes de navegação
npm run siga:scaffold -- <id> [--with-page]

---

ADMIN (painel/admin)

Next.js App Router — Control Center SaaS, não a operação escolar:

• /tenants, /subscriptions, /domains
• /platform-admins, /audit, /settings/billing

Manual: Control Center.

---

WEB (painel/web)

Vite + React — landing, /pricing, wizard /start (criar escola via API SaaS).

Manual: Criar escola.

---

PAYFLOW (painel/payflow)

Vinext + React + Cloudflare D1 — pagamentos, recibos e reconciliação ligados ao SIGA. Produção não contém dados demo e falha de forma fechada até o provedor ser homologado. As migrações Drizzle desta pasta pertencem apenas ao D1 do PayFlow; nunca devem ser aplicadas ao PostgreSQL/Supabase SGA.

Referência técnica no repositório: docs/agents/PAYFLOW_INTEGRATION.md.

---

DOC (painel/docs)

VitePress. Manuais reais sob /siga/, /admin/, /web/, /arquitetura/, /integracoes/.
Secções /vite/, /nextjs/, /components/ ainda reflectem o template de UI — usar como referência de componentes, não como mapa do produto.

---

SQL e ambiente

• Aplicar só supabase/APPLY_IN_SQL_EDITOR.sql, APPLY_ENROLLMENT_AND_PREMIUM.sql, APPLY_SAAS_PLATFORM.sql
• Node 24 (nvm use 24)
• npm run siga:sync-env propaga .env → painel/web, painel/admin e painel/payflow
• npm run dev:ecosystem arranca as cinco apps

---

Ligações

• Funcionalidades & permissões
• Navegação SIGA
• Arquitetura
• Segurança de rotas