# Platform foundation

## 1. High-Level Overview

**Purpose:** **Wire enums**, **PostgreSQL schema/mapping**, **cross-cutting HTTP error handling**, **path resolution**, **JWT policies + token refresh**, and **application bootstrap** — no standalone product feature; enables all other components.

**Architectural pattern:** Shared kernel / infrastructure.

**Upstream dependencies:** None (root).

**Downstream consumers:** All feature components.

## 2. Internal interfaces

- `src/Enums/*`
- `src/Database/*` (`AppDataConnection`, `DatabaseMigrator`, entities)
- `ErrorHandlingMiddleware`, `PathResolver`, `PaginatedResponse`, `ErrorResponse`, `GlobalUsings.cs`
- `JwtExtensions` (JWKS verifier; `HttpDocumentRetriever.RequireHttps` is gated on `ASPNETCORE_ENVIRONMENT` — HTTPS-required for every value except `E2ETest`), `ConfigurationResolver`, `CorsConfigurationValidator`
- `Program.cs`

## 3. External API

`/health` (AllowAnonymous); Swagger in development configuration. Token refresh is no longer hosted here — callers refresh against admin's `POST /token/refresh`.

## 4. Modules included

`wire-enums`, `database-layer`, `common-infrastructure`, `auth-identity`, `composition-program`.