Plataforma para conectar proprietários, empresas de gestão e empresas de limpeza na operação de flats.

• specs/: especificação viva do produto e decisões arquiteturais.
• backend/src/Rental.Domain: regras e tipos do domínio, sem dependências externas.
• backend/src/Rental.Domain/Services: contratos, validações e serviços organizados por feature.
• backend/src/Rental.Infrastructure: persistência, e-mail, autenticação e AWS (a implementar).
• backend/src/Rental.Api: API HTTP ASP.NET Core.
• backend/src/Rental.Mcp: módulo de tools MCP hospedado pela API.
• backend/tests/: testes automatizados do backend.
• frontend/: frontend Next.js com exportação estática para S3.
• deploy/aws/: stacks CloudFormation, buildspecs e scripts de entrega versionada.

Pré-requisitos: .NET SDK 10 e Node.js 22.

dotnet tool restore
dotnet build backend/Rental.slnx
dotnet test backend/Rental.slnx
dotnet run --project backend/src/Rental.Api --launch-profile http

cd frontend
npm install
npm run dev
npm run build

Para conduzir desenvolvimento incremental com os três papéis:

./scripts/agent-status.sh
./scripts/backlog-check.sh
./scripts/validate.sh full

Consulte specs/agent-orchestration.md e os contratos em .agents/.

O build do frontend é gerado em frontend/out/. A conta e os recursos AWS ainda não são necessários para desenvolvimento local.

Em desenvolvimento:

• API: http://localhost:5133
• Swagger: http://localhost:5133/swagger
• MCP local: http://localhost:5133/mcp
• Frontend: http://localhost:3133
• Código local de confirmação, 2FA e recuperação: 123456
• Convite de demonstração: http://localhost:3133/invitation/?token=local-demo

O ambiente Docker usa PostgreSQL e aplica migrations versionadas do Entity Framework Core. A execução isolada pode usar SQLite efêmero; consulte specs/local-development.md para o fluxo de migrations e suas limitações.

Para exportar traces, métricas e logs, configure OpenTelemetry__OtlpEndpoint ou OTEL_EXPORTER_OTLP_ENDPOINT com a URL de um collector OTLP.

Para habilitar o assistente conversacional de propriedades localmente sem versionar a chave:

dotnet user-secrets set "OpenAI:ApiKey" "<sua-chave>" --project backend/src/Rental.Api

Também é possível usar OPENAI_API_KEY no ambiente da API. O modelo padrão é gpt-5.6-terra e pode ser alterado com OpenAI__Model. O endpoint de onboarding é registrado em todos os ambientes; a persistência da propriedade exige sessão e autorização da empresa.