Setup local

1. Clonar e instalar

git clone https://github.com/soucannabis/kunk-soucannabis.git
cd kunk-soucannabis
npm install

2. Banco e API

cd kunk-api
cp .env.example .env
# Ajuste PG_URL ou PGHOST/PGUSER/PGPASSWORD/PGDATABASE
npm install
npm run dev

Health check (npm): http://localhost:8056/api/v1/health
Com Docker da API: http://localhost:4250/api/v1/health

Dados de exemplo:

npm run seed:sample --prefix kunk-api

Detalhes: documentação da API e o README em kunk-api/.

3. Frontends

No root do monorepo:

npm run dev:registration   # cad — :4255
npm run dev:admin          # admin — :4256
npm run dev:kunk           # app — :4257
npm run dev:doc-sign       # termos — :4258

Os apps falam com /api/v1 no próprio host (proxy Vite). Não é necessário preencher CORS_ORIGIN.

4. Este site de documentação

npm run dev:website

Abre em http://localhost:4260.

Stack Docker unificado

Para API + Admin + App juntos, veja Deploy / Docker.