Orbien
Monorepo da plataforma Orbien — gerenciado com npm workspaces + Turborepo.
Estrutura
apps/
api/ NestJS + Prisma → Render, runtime Node (orbien-backend)
site/ Next.js → Vercel (site público) (orbien-site)
web/ Next.js → Vercel (app logado) (orbien-web)
admin/ Next.js → Vercel (subdomínio admin.) (orbien-admin)
mobile/ Expo + React Native → EAS Build (iOS/Android) (orbien-mobile)
Cada app continua com deploy independente: a API não vai para a Vercel, os
três fronts ficam em projetos Vercel separados, e o mobile não passa por
nenhuma das duas — sai por EAS Build.
apps/admin é o console da plataforma (opera acima dos tenants; dado de
igreja não passa por lá). apps/mobile é o app do membro e da liderança, e
fala direto com a API por Bearer token — não usa o /api-proxy do web.
Requisitos
Instalação
npm install # instala todos os workspaces a partir da raiz
Um único package-lock.json na raiz. Não rode npm install dentro de apps/*.
Desenvolvimento
npm run dev # sobe todos em paralelo
npm run dev:api # NestJS — :3000
npm run dev:web # Next.js — :3001
npm run dev:site # Next.js — :3002
npm run dev:admin # Next.js — :3003
npm run dev:mobile # Expo (Metro) — abre no dispositivo ou emulador
Build
npm run build # tudo, com cache do Turborepo
npm run build:api # só a API
npm run build:web # só o app
npm run build:admin # só o console da plataforma
npm run build:site # só o site público
npm run build:mobile # typecheck + expo export do mobile
Banco de dados (Prisma — workspace da API)
npm run db:generate
npm run db:migrate -- nome_da_migration
npm run db:migrate:status
npm run db:seed
npm run db:studio
Variáveis de ambiente
Não são centralizadas — cada app mantém as suas:
apps/api/.envapps/web/.env.local, apps/web/.env.productionapps/admin/.env.localapps/mobile: não usa .env — identidade e URL da API são resolvidas por
app.config.js a partir do profile do eas.json
Deploy
| App | Plataforma | Configuração |
|---|
apps/api | Render, runtime Node | render.yaml na raiz documenta o serviço; build e start rodam da raiz |
apps/site | Vercel | Root Directory = apps/site |
apps/web | Vercel | Root Directory = apps/web |
apps/admin | Vercel | Root Directory = apps/admin; subdomínio admin. |
apps/mobile | EAS Build | Profiles em apps/mobile/eas.json; build de preview no CI quando o diff toca apps/mobile |
O Dockerfile de apps/api existe e funciona, mas não é o que o Render
executa — o serviço usa runtime Node. Ver render.yaml na raiz.
Passo a passo completo de configuração das plataformas: DEPLOY.md
(hoje cobre API, site, web e admin; o mobile está documentado em
apps/mobile/README.md, seção "Build profiles").
Estrutura interna do monorepo: docs/MONOREPO.md.
Documentação de produto e roadmap
docs/PLANO.md — fonte única: o que já foi entregue, o
que o material de produto prevê e não existe, as pendências abertas, os
ajustes e as decisões de produto em aberto. Cada item aberto tem ID.docs/PENDENCIAS.md — arquivo histórico dos achados
já fechados, com a evidência e a decisão de cada um.docs/produto/ — ADRs, especificação de
produto, pricing, mapeamento LGPD, minutas de contrato e briefings de
sprint que guiaram o desenvolvimento.
