zenter-docs

Zenter API

API backend do sistema Zenter, uma plataforma de gestão de aluguéis construída no modelo SaaS + Marketplace, focada exclusivamente na administração pós-locação.

O Zenter não anuncia imóveis, não intermedia locações e não participa financeiramente do pagamento do aluguel.
Seu papel é organizar, automatizar e escalar a gestão entre locador e inquilino.

---

🎯 Propósito

Resolver o problema operacional de pequenos e médios locadores que gerenciam aluguéis de forma manual, sem escala e sem rastreabilidade.

O Zenter entrega:

• Gestão de contratos
• Assinaturas digitais
• Cobrança automatizada
• Controle de inadimplência
• Comunicação centralizada
• Escalabilidade real

---

🧱 Arquitetura de Negócio

O sistema adota um modelo híbrido com responsabilidades bem definidas:

SaaS (Zenter)

• Assinatura mensal do locador
• Cobrança recorrente via Stripe
• Controle de acesso baseado no status da assinatura

Marketplace (Aluguel)

• Pagamento do inquilino vai diretamente ao locador
• O Zenter não toca no dinheiro do aluguel
• Implementado via Stripe Connect

---

💳 Arquitetura de Pagamentos

A API separa completamente os fluxos financeiros:

• Billing Gateway
  • Assinaturas do Zenter
  • Stripe Customer & Subscription
  • Webhooks como fonte da verdade
• Payment Gateway
  • Pagamentos de aluguel
  • Stripe Connect
  • Repasse direto ao locador

Essa separação garante:

• Segurança
• Escalabilidade
• Baixo risco regulatório
• Expansão internacional

---

🧭 Onboarding (alto nível)

1. Criação de conta
2. Escolha de plano
3. Criação de assinatura (INCOMPLETE)
4. Redirecionamento para Checkout Stripe
5. Ativação via Webhook
6. Liberação do sistema
7. Gestão de aluguéis

---

🚀 Tecnologias

• NestJS
• TypeScript
• Prisma ORM
• PostgreSQL
• Zod
• Stripe
• Sentry
• PNPM

---

📦 Instalação

pnpm install

---

🧪 Testes

• Testes unitários
• Testes E2E
• Gateways externos mockados
• Nenhum teste depende de serviços externos

---

📈 Estado do Projeto

• Core financeiro estruturado
• Domínios bem definidos
• Arquitetura preparada para escala
• Projeto em evolução contínua

---

👤 Autor

Desenvolvido por Joseilton Junior
Full-Stack Engineer — TypeScript • React • React Native • Node.js • AWS

GitHub: https://github.com/joseiltonjunior
Portfólio: https://ferreirajr.netlify.app
LinkedIn: https://www.linkedin.com/in/joseilton-junior