Um mapa do projeto
O builder tem interfaces de operação, um motor compartilhado e pacotes usados na compilação ou execução do backend. Escolha um componente para ver sua responsabilidade, uso e limites.
Define convenções MSBuild, versões e guardrails dos backends.
ExecuçãoSil.Builder.RuntimeOferece ids v7, tenant, Result, envelope HTTP, listagem, permissões e unidade de trabalho.
ExecuçãoSil.Builder.Runtime.DataConecta o contrato de domínio ao PostgreSQL: EF Core escreve; Dapper lê.
CompilaçãoSil.Builder.AnalyzersAnalisa o código C# e aponta violações das convenções SIL.
CompilaçãoSil.Builder.CodeFixesImplementa correções Roslyn para regras classificadas como auto.
CompilaçãoSil.Builder.GeneratorsProduz código incremental durante o build a partir de declarações C#.
VerificaçãoSil.Builder.TestingCompartilha suporte de testes de arquitetura, API e banco.
GeraçãoSil.Builder.TemplatesEmpacota sil-satellite e sil-module com a estrutura inicial e governança.
MotorSil.Builder.CoreCompartilha descoberta de workspace, checks, geração, planos, contratos e recuperação.
Interfacedotnet-builderExpõe o motor local como dotnet builder, com resultados JSON.
InterfaceSil.Builder.McpExpõe ferramentas tipadas e recursos de contexto para agentes.
IA e avaliaçãoSil.Builder.AgentsDefine tarefas, faixas de modelo e avaliador determinístico para medir agentes.
As cinco camadas do módulo gerado
Seção intitulada “As cinco camadas do módulo gerado”| Camada | Responsabilidade | Uso no dia a dia |
|---|---|---|
| ApiControllers | HTTP, rotas, públicos e respostas | Traduza o protocolo e invoque a aplicação |
| Application | Handlers, validação e casos de uso | Implemente a regra dentro de sil-business |
| Contracts | DTOs e contratos públicos | Mantenha estável a interface entre consumidores |
| Domain | Entidades e regras do domínio | Expresse invariantes sem dependência HTTP |
| Infrastructure | EF, Dapper e integrações | Persista e consulte respeitando tenant/transação |
O host fica em src/API, os módulos em src/Modules e os testes em test. Entre módulos, as fronteiras públicas são Domain e Contracts; o SDK e os analisadores verificam as dependências.
Pastas que sustentam o fluxo
Seção intitulada “Pastas que sustentam o fluxo”schemas/: contratos JSON de feature, relatórios, planos e evals.samples/ReferenceSatellite/: referência executável alinhada ao template.tests/: testes do ferramental, runtime e fluxos gerados.eng/e.github/workflows/: build, validação e entrega.docs/: decisões, contratos, estado e pendências.