Portal que cria sistemas de gestão com IA sobre seus bancos de dados: você cadastra um sistema, conecta um banco (PostgreSQL, MySQL ou BigQuery), conversa com o agente pelo chat do portal e ele gera uma app administrativa (NiceGUI, 100% Python) que sobe automaticamente e fica acessível em /apps/<slug>.
- Gera apps administrativas reais a partir de um chat em PT-BR, sobre o schema de verdade do seu banco (via MCP) — não um template estático. Checkpoints permitem voltar o código a qualquer ponto.
- Isolamento de verdade por sistema: cada container roda confinado por seccomp + Landlock, aplicado pelo kernel — não depende de aprovar um pedido de permissão no chat (ver Segurança).
- Gate de SQL no data plane: um
DROPouDELETEsemWHEREnunca chega ao banco — recusado por um sidecar classificador, sem pedir aprovação a ninguém. - Segredos nunca tocam o container do sistema: credenciais de banco e chaves de LLM ficam cifradas no portal; com o broker de inferência (opcional), o sistema nem recebe a chave real — só um token opaco revogável.
- Mesma lógica de negócio em Docker ou Kubernetes: o driver de provisionamento é uma abstração comum, validada ponta a ponta nos dois (ver Instalação).
- Mudanças planejadas pelo chat com OpenSpec: o agente de cada sistema já vem com o OpenSpec
1.15.0 (versão pinada na imagem base, sem depender de rede) e os comandos
/opsx-propose,/opsx-explore,/opsx-applye/opsx-archive. Ao digitar/no chat, o campo sugere os comandos disponíveis no agente daquele sistema (ver guia de uso). - Pilha 100% Python, do portal (FastAPI + NiceGUI) à app gerada (NiceGUI) — sem troca de linguagem/framework em nenhuma camada.
Traefik (edge)
│
▼
Portal FastAPI + NiceGUI (auth/RBAC, chat, proxy)
│ provisiona
▼
1 container por sistema (supervisor + "opencode serve" + app gerada)
│ MCP somente leitura (agente) / driver direto (app)
▼
Banco de produção (PostgreSQL, MySQL ou BigQuery)
- Decisões de arquitetura:
docs/adr/(21 ADRs, formato MADR). - Especificações formais:
openspec/specs/(13 capacidades); histórico de mudanças emopenspec/changes/archive/.
- Docker 24+ com Compose v2
- Porta 80 livre
- ~2 GB RAM por sistema ativo (padrão; ver Configuração para limites)
Duas formas de subir o portal, conforme o driver de provisionamento (o que materializa cada sistema — container Docker ou Pod Kubernetes). O driver padrão, e o único validado para produção, é o Docker.
cd deploy
docker compose up -d --build # postgres + mysql + traefik + portal
docker compose exec portal alembic upgrade head # migrações (opcional: o portal cria o schema no boot)- O serviço
mysqldo compose existe só como banco de teste para cadastrar conexões MySQL (hostmysql, porta 3306, banco/usuário/senhaappaiforge); as portas dos bancos não são publicadas no host. - Portal: http://localhost (admin semeado em dev:
admin@appaiforge.local/admin123—APPAIFORGE_SEED_DEMO_ADMIN=1no compose) - Health: http://localhost/api/health
Em vez do admin semeado, crie o primeiro admin por CLI (produção):
docker compose -f deploy/docker-compose.yml exec portal appaiforge create-admin --email voce@empresa.com --password 'uma-senha-forte'
# e remova a variável APPAIFORGE_SEED_DEMO_ADMIN do composeSem chave de LLM cadastrada, o portal opera em modo fake (todo o resto funciona) — para geração real, ver Chave de LLM e broker de inferência.
docker build -f deploy/portal.Dockerfile -t appaiforge/portal:0.1.0 .
kind load docker-image appaiforge/portal:0.1.0 --name appaiforge-dev
helm install appaiforge-portal deploy/helm/appaiforge-portal \
--namespace appaiforge --create-namespace \
--kube-context kind-appaiforge-devMaterializa cada sistema como um Pod em vez de container Docker; só validado contra um cluster
kind local (nunca contra um cluster gerenciado real). Detalhes, pré-requisitos (Traefik no
cluster) e o chart Helm completo: Driver Kubernetes.
Cada sistema roda isolado, com várias camadas independentes — uma falha numa não derruba as outras:
- Confinamento do agente (3 modos de execução;
sandboxedpor padrão quando o host suporta Landlock, senão cai parareducedcom aviso): seccomp nega um denylist de syscalls perigosas e Landlock nega acesso a filesystem/rede fora do declarado no perfil do agente — aplicados pelo próprio supervisor (PID 1), irrevogáveis, sem depender de ninguém clicar "Aprovar" (ADR 0018, ADR 0019). - Proxy HTTP(S) de saída obrigatório por sistema: a única saída de internet do agente passa
por um sidecar com allow-list calculada (provedor de LLM/broker + registros de pacote) —
443/80saíram do Landlock fixo exatamente por isso (ADR 0024). - Gate de operações destrutivas: toda SQL que toca um banco de conexão passa por um
classificador (sqlglot) rodando num sidecar no data plane. No modo
enforce(default),DROP/TRUNCATE/ALTEReDELETE/UPDATEsem escopo por chave são recusados na hora, sem pedir aprovação a ninguém; o modoshadowclassifica e audita sem bloquear, para observar um sistema antes de confiar nele (ADR 0017, ADR 0021). - Segredos cifrados em repouso: chaves de provedor de LLM e credenciais de conexão de banco ficam cifradas no Postgres do portal, nunca em texto puro (ADR 0007).
- Autenticação local ou SSO (OIDC), escolhida por ENV e travada na instalação, com admin break-glass; o acesso a cada app é verificado pelo portal a cada requisição e a app recebe a identidade num JWT restrito a ela (ADR 0027, ver Autenticação).
- RBAC: tipo global por usuário —
admin(tudo),editor(cria e gerencia sistemas) ouapp_user(só usa as apps de sistemas a que tem acesso); sem papel por sistema (ADR 0014). - Broker de inferência (opcional): o container do sistema carrega só um token opaco em vez da chave do provedor, revogável por sistema ou por sessão de chat (ADR 0020, ver LLM e broker).
- Auditoria: toda ação de escrita da gestão e toda decisão do gate (aprovada/recusada/ bloqueada) fica numa trilha sem segredos.
Confinamento do agente e gate de destrutivas por dentro: docs/seguranca.md.
Broker de inferência: docs/llm-e-broker.md. Segredos cifrados e RBAC:
os ADRs linkados acima.
| Tema | Onde |
|---|---|
| Criar um sistema, chat, editor, aparência | docs/guia-de-uso.md |
| Login local, SSO por OIDC (Keycloak), break-glass e acesso às apps | docs/autenticacao.md |
| Gate de operações destrutivas e confinamento do agente | docs/seguranca.md |
| Chave de LLM e broker de inferência (LiteLLM) | docs/llm-e-broker.md |
| Instalação sob o driver Kubernetes (chart Helm) | docs/driver-kubernetes.md |
Todas as variáveis de ambiente APPAIFORGE_* |
docs/configuracao.md |
| Rodar a suíte de testes (unit/BDD/integration/E2E) | docs/testes.md |
| Rollback, logs, auditoria, backup, reconciliação | docs/operacao.md |
| Decisões de arquitetura (ADRs) | docs/adr/ |
| Roadmap de confinamento do agente | docs/roadmap-confinamento-do-agente.md |
portal/ appaiforge/ (FastAPI+NiceGUI), tests/ (unit, bdd, integration, e2e), migrations/
base-image/ Dockerfile da imagem dos sistemas + afsupervisor (PID 1) + gated-mcp/ (MCP somente leitura com o gate)
deploy/ docker-compose.yml (postgres, mysql, traefik, portal), docker-compose.e2e.yml e helm/ (chart do portal p/ driver Kubernetes)
docs/ guias de uso, segurança, configuração etc. (acima) e docs/adr/ (decisões de arquitetura)
openspec/ specs vigentes (specs/) e histórico de changes (changes/archive/)
Distribuído sob a licença MIT: uso, modificação e redistribuição livres, inclusive para fins comerciais, desde que o aviso de copyright e o texto da licença acompanhem as cópias. Veja LICENSE.