mirror of
https://github.com/Sea-Haven-Industries/seahaven-ap.git
synced 2026-09-30 22:03:17 +00:00
Sea Haven AP — internal AP automation (ap.seahaven.com)
| .github | ||
| e2e | ||
| packages | ||
| public/fixtures | ||
| scripts | ||
| src | ||
| .env.example | ||
| .gitignore | ||
| .npmrc | ||
| .prettierignore | ||
| .prettierrc | ||
| .redocly.lint-ignore.yaml | ||
| docker-compose.yml | ||
| eslint.config.js | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| playwright.config.ts | ||
| README.md | ||
| redocly.yaml | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
| vitest.config.ts | ||
Sea Haven AP
Internal accounts payable automation for Sea Haven Industries (ap.seahaven.com).
Workspace layout
npm workspaces:
@seahaven-ap/web— Vite/React SPA (repo root)@seahaven-ap/shared— payment ladder, invoice helpers, pay-date parsers, CSV constants (packages/shared)@seahaven-ap/api— Hono API, Drizzle schema, auth/RBAC (packages/api)
Local development
Frontend (mocks)
npm ci
cp .env.example .env # optional; defaults already use mocks
npm run dev
App serves at http://localhost:3000. VITE_USE_MOCKS=true is the default data path until AP-15 wires live API calls.
API + data plane (AP-14)
docker compose up -d
cp .env.example .env
npm run db:migrate
npm run db:seed
npm run dev:api
API listens on http://127.0.0.1:8787. Vite proxies /api to that port.
Smoke:
curl -s http://127.0.0.1:8787/health
curl -s http://127.0.0.1:8787/api/me
DEV_AUTH_BYPASS=true is local-only and only allowed when NODE_ENV is development or test (rejected for production, staging, preview, and any other value).
API roles (source of truth): admin, ap_processor, approver, viewer. Frontend mocks still use ap_operator until AP-15 remaps them.
OpenAPI / Redocly
Linting uses the same redocly.yaml ruleset as procurement-ingest.
npm run lint:api
npm run docs:preview # builds HTML via redocly build-docs and opens it
Verify
npm run verify
npm run test:e2e