mirror of
https://github.com/Sea-Haven-Industries/seahaven-ap.git
synced 2026-09-30 09:13:17 +00:00
39 lines
859 B
Markdown
39 lines
859 B
Markdown
|
# Local development
|
||
|
|
|
||
|
|
## Data plane
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker compose up -d
|
||
|
|
npm run db:migrate
|
||
|
|
npm run db:seed
|
||
|
|
npm run dev:api
|
||
|
|
```
|
||
|
|
|
||
|
|
Defaults:
|
||
|
|
|
||
|
|
- Postgres at `postgresql://seahaven:seahaven@127.0.0.1:5432/seahaven_ap`
|
||
|
|
- API at `http://127.0.0.1:8787`
|
||
|
|
- MinIO at `http://127.0.0.1:9000` (documents bucket for AP-15)
|
||
|
|
|
||
|
|
## Smoke
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -s http://127.0.0.1:8787/health
|
||
|
|
curl -s http://127.0.0.1:8787/api/me
|
||
|
|
```
|
||
|
|
|
||
|
|
With `DEV_AUTH_BYPASS=true` and `NODE_ENV=development` (or `test`), `/api/me`
|
||
|
|
does not require a Bearer token. Bypass is rejected for staging, preview,
|
||
|
|
production, and any other `NODE_ENV`.
|
||
|
|
|
||
|
|
## Docs
|
||
|
|
|
||
|
|
```bash
|
||
|
|
npm run lint:api
|
||
|
|
npm run docs:preview
|
||
|
|
```
|
||
|
|
|
||
|
|
`docs:preview` runs `redocly build-docs` (CLI v2) and opens the HTML at
|
||
|
|
`/tmp/seahaven-ap-api-docs.html`. Published OpenAPI servers point at
|
||
|
|
`https://ap.seahaven.com`. Use this page for the local docs view.
|