Repository structure

The workspace groups multiple deployable applications and one backend API. Paths are relative to the repository root.

PathRole
ethica-api/NestJS + Sequelize + PostgreSQL — shared business logic and data.
ethica-erp/Staff ERP (Next.js).
customer-portal/Customer-facing portal (Next.js).
customer-onboarding/Public onboarding flows (Next.js).
admin-portal/Platform admin (Next.js).
documentation/This documentation site (Next.js).

Frontends call the API over HTTPS; they do not connect to the database directly.

Build and deployment

  • Next.js apps — each of ethica-erp, customer-portal, customer-onboarding, admin-portal, and documentation is built and deployed separately, typically as its own Netlify site with that folder as the base directory (yarn install / yarn build).
  • APIethica-api is built with Nest (yarn build, yarn start:prod) and deployed to DigitalOcean (or your chosen Node host) with environment variables supplied by the platform.

Shared packages

There is no shared packages/ workspace yet; dependencies are per app. If you introduce internal packages later, document them here.

See also