Pular para o conteúdo
Moldapé Docs

Ambiente local

Pré-requisitos: Node.js 20, pnpm 10 (corepack enable), Docker e Git.

  1. Clonar e preparar

    Janela do terminal
    git clone git@bitbucket.org:moldape/moldape-v2.git
    cd moldape-v2
    git checkout develop
    make setup

    O make setup executa, em ordem: pnpm i, a distribuição do .env.example da raiz para o .env de cada app e pacote (cria os que não existem e só acrescenta variáveis faltantes nos existentes; use make setup FORCE=1 para recriá-los), pnpm run prisma:generate e pnpm build. make help lista os alvos avulsos (install, env, prisma, build, test, e2e-install). Sem make instalado, rode os quatro comandos na mão (node scripts/copy-env.mjs faz a cópia).

  2. Ajustar os .env

    O .env.example da raiz já vem com padrões que funcionam localmente (Postgres e Redis do passo 3, web em :3000, API em :4001). Só é preciso preencher SMTP_USER/SMTP_PASS (web) e SMTP_USER/SMTP_PASSWORD (API) para testar envio de e-mail. Referência completa em Variáveis de ambiente.

  3. Subir PostgreSQL e Redis

    Janela do terminal
    docker compose -f docker-compose.dev.yml up -d

    Sobe postgres-dev (5432, banco moldape_dev) e redis-dev (6379).

  4. Preparar o banco

    Janela do terminal
    pnpm prisma:migrate
    pnpm prisma:seed   # opcional: dados iniciais

  5. Rodar tudo

    Janela do terminal
    pnpm dev
    • Web: http://localhost:3000
    • API: http://localhost:4001 (health em /health, Swagger se ENABLE_SWAGGER=true)
    • Docs: http://localhost:4321
Desenvolvido e documentado por
Nós Tecnologia · Desenvolvimento Criativo