GovON Frameworkdocs

Como rodar local

Pre-requisitos: Node 20+, npm 10+, Docker Desktop.

1. Setup

git clone <repo> govon-framework
cd govon-framework
cp .env.example .env
npm install

2. Infra

npm run docker:up
# Postgres: localhost:5433 (user: govon / db: govon)
# Redis:    localhost:6380

3. Migrate + seed

cd apps/api
DATABASE_URL="postgresql://govon:govon@localhost:5433/govon?schema=public" \
  npx prisma migrate deploy

DATABASE_URL="postgresql://govon:govon@localhost:5433/govon?schema=public" \
  npx prisma db seed

cd ../..

Apos seed:

  • 2 municipios (Dev A / SP, Dev B / RJ)
  • admin@govon.dev + maria@govon.dev — senha admin
  • 8 permissoes core seedadas

4. API

DATABASE_URL=... JWT_SECRET=... REDIS_URL=... \
  npx ts-node --transpile-only -P apps/api/tsconfig.json apps/api/src/main.ts

5. Admin

npm run dev --workspace=@govon/admin
# http://localhost:3002

6. Docs (este site)

npm run dev --workspace=@govon/docs
# http://localhost:3003

7. Validacao

npm run typecheck
npm run lint
npm run test
npm run build
GOVON_API_URL=http://localhost:3001 npm run test:e2e

Ver tambem: docs/RUN_LOCAL.md (receita completa) e docs/DEPLOY_DEMO.md (deploy online).