# `apps/` — Deployable Applications

Each folder is an independently deployable unit. Apps depend on shared logic in `packages/`, `enterprise-modules/`, and `platform/`.

| App            | Materialized in | Role                                          |
| -------------- | --------------- | --------------------------------------------- |
| `web-angular/` | Phase 3         | Primary frontend (Angular 19 + Signals)       |
| `web-next/`    | Phase 3         | Secondary frontend (Next.js 15 App Router)    |
| `api-nest/`    | Phase 4         | Secondary backend (NestJS 11)                 |
| `worker-nest/` | Phase 6         | BullMQ worker (audit shipping, notifications) |
| `admin/`       | Phase 3 (stub)  | Admin console (Angular)                       |
| `mobile/`      | Future          | Placeholder for React Native / Expo           |

> The primary .NET API lives at the repo root in `dotnet/` (Clean Architecture solution), not under `apps/`. See [`dotnet/README.md`](../dotnet/README.md).

## Rules

- Apps MUST NOT import directly from other apps.
- Apps MUST NOT duplicate shared logic — promote to `packages/` or `enterprise-modules/`.
- Each app owns its own `Dockerfile`, lint config layer, and tests.
- Each app declares its dependencies in its own `package.json` (or `.csproj`).
