Plataforma enterprise-grade para corretores independentes e imobiliárias. Centraliza o ciclo completo:
captação e qualificação de leads (matchmaking com score [0,100] e pitch CVBA), catálogo unificado de imóveis
com mapa, análise de risco G.C.C.A., esteira de contratos, repasse de comissões, credenciais CRECI, documentos, agenda de visitas,
integrações com portais e central de chamados.
Nome visual: Propertius Global (design system). Produto: THZ Imob.
| Camada | Tecnologia |
|---|---|
| Repositório | pnpm workspaces (pnpm 11.20.0) + Turborepo |
| Backend | NestJS 11 · Prisma ORM 6 · PostgreSQL 16 · Redis 7 · MinIO S3 · Zod · JWT/JWE/RBAC · WebAuthn/FIDO2 · OpenAPI 3 |
| Frontend | Next.js 15 (App Router) · React 19 · Tailwind CSS v4 · TanStack Query · react-leaflet · PWA |
| Conteinerização | Docker Compose (PostgreSQL 16, Redis 7, MinIO S3, API NestJS, Web Next.js) |
| Testes | Jest + supertest (API) · Vitest (Web) · fast-check (testes baseados em propriedades) |
apps/
api/ Backend NestJS 11 (Modular Monolith, 6 Bounded Contexts)
web/ Frontend Next.js 15 (Route groups (public) e (dashboard))
packages/
contracts/ DTOs + schemas Zod compartilhados (single source of truth)
database/ Schema Prisma único, migrations PostgreSQL, PrismaService, seed
ui/ Design system (tokens MD3, componentes Tailwind CSS v4 / shadcn)
config/ Configurações TS/ESLint/Prettier reutilizáveis
docs/
adr/ Architectural Decision Records (ADR-000..024 em formato MADR)
engineering/ Guias de engenharia (backend, dados, frontend, segurança, testes, deploy, observabilidade)
general/ Visão do projeto, specs de produto, stack, fluxo dev, glossário, roadmap
source/ Especificações e PRDs originais
specs/
mockups/ Telas mock (code.html + screen.png)
design/ DESIGN.md (tokens do design system MD3)
Pré-requisitos: Node ≥ 20, pnpm 11.20.0, Docker & Docker Compose.
# 1. Instalar dependências
pnpm install
# 2. Subir ambiente completo de serviços (PostgreSQL 16, Redis 7, MinIO S3 + init de buckets)
docker compose up -d
# 3. Preparar o banco de dados (geração do client Prisma, migrações e seed)
pnpm db:generate
pnpm db:migrate
pnpm db:seed
# 4. Rodar API + Web em paralelo
pnpm dev- API REST: http://localhost:3333/api/v1
- Swagger / OpenAPI: http://localhost:3333/api/v1/docs
- Frontend Web: http://localhost:3000
- MinIO Console: http://localhost:9001 (Usuário/Senha:
minioadmin/minioadmin)
| Comando | Descrição |
|---|---|
pnpm dev |
Executa API + Web em paralelo via Turborepo |
pnpm dev:api / pnpm dev:web |
Execução individual de desenvolvimento |
pnpm lint / pnpm typecheck / pnpm test / pnpm build |
Validação e compilação no monorepo via Turborepo |
pnpm db:generate / pnpm db:migrate / pnpm db:seed / pnpm db:studio |
Gestão de esquema, migrações e dados Prisma |
- Regras para Agentes e Desenvolvedores: Leia AGENTS.md antes de realizar alterações no código.
- Portal de Documentação: Acesse docs/README.md.
- Decisões de Arquitetura: docs/adr/ (ADR-000 a ADR-024).
- Guias de Engenharia: docs/engineering/.
- Especificações Originais: docs/source/ (PRDs e DAS v2).
Uso interno e privado — não publicado publicamente.
THZ Imob @ Elite Properties Group · Material Design 3 · #091426 / #0058be