A casa: arquitetura do monorepo

O spaceAI é um monorepo de seis aplicações. Cada uma tem deploy, banco e container próprios. Esta página explica como elas se organizam.

A regra da casa#

Regra da casa

CADA APP TEM O SEU PRÓPRIO DEPLOY DE PRODUÇÃO. Banco próprio. Container próprio. Imagem própria. Ciclo de vida próprio. Nenhum app sobe, cai, migra ou é redesenhado junto com outro.

O monorepo existe para facilitar a codação com IA: contexto único para convenções, contratos e decisões. Ele não junta o deploy.

Inventário#

App	Papel	API	Banco	Score
`agent-package`	Motor de agentes + MCP	`4000`	Postgres	96
`conta-central`	IdP central OIDC	`4100`	Postgres	61
`load-balance`	Proxy de APIs de IA	`3018`	Postgres	63
`motor`	Agent coder + worker	`4000`	Postgres	67
`mypanel`	Control panel	—	SQLite	43
`render`	Renderização (standby)	`4000`	Postgres	80

Como os apps conversam#

Apps se comunicam por contrato HTTP versionado. Nunca por import de código. Nunca por banco compartilhado.

1Motor pedeformato canônico

→

2Load-balance resolverota + credencial

→

3Resposta voltamesmo formato

Fluxo de desenvolvimento#

Aqui
Codar. Repo local, branch do trabalho.
Sandbox
Validar. Subir sb no mypanel, rodar testes e E2E.
GitHub
Publicar. Commit + push; merge na main só depois de validar.

Bancos: databases_prod e databases_dev. Um banco dev por branch, com o nome da branch. Depois do merge, apagar sandbox e banco dev.

Próximos passos#

Você entendeu a casa. A seguir, abra a documentação de um app.

📦 agent-package

O núcleo e o padrão da casa.

Explore além:

Todas as aplicações

O mapa dos apps.

conta-central

Autenticação central.

motor

O motor dos agentes.