docs: update documentation to OKF v0.1 format

docs/architecture/key-files.md

@@ -12,6 +12,7 @@ timestamp: 2026-07-22T19:18:00Z
 |---|---|
 | `backend/src/main.ts` | Bootstraps Nest, middleware, OpenAPI, static assets, and SPA fallback. |
 | `backend/src/app.module.ts` | Wires feature modules and global providers. |
+| `backend/src/config/env.schema.ts` | Zod-validated runtime config; canonical defaults for `DATABASE_PATH` (`./data/db.sqlite`) and `UPLOAD_DIR` (`./data/uploads`). |
 | `backend/src/database/database.module.ts` | Configures TypeORM with SQLite. |
 | `backend/src/database/database-init.service.ts` | Initializes the database and runs migrations; `verifySeed()` also asserts the canonical six system-category keys and reports missing/duplicate rows. |
 | `backend/src/database/migrations/1700000000400-RepairCategorySchemaAndSystemCategories.ts` | Forward-only repair migration: adds `created_at`/`updated_at` to legacy six-column `category` tables, deletes obsolete `FOR`/`OSI` system rows, rewrites canonical row metadata, inserts any missing canonical key, and re-asserts unique indexes. Exports `CANONICAL_SYSTEM_CATEGORIES`. |
@@ -35,6 +36,10 @@ timestamp: 2026-07-22T19:18:00Z
 | File | Responsibility |
 |---|---|
 | `frontend/src/main.ts` | Bootstraps Angular and registers HTTP interceptors. |
+| `frontend/proxy.conf.json` | Angular dev-server proxy: forwards `/api` and `/uploads` to `http://localhost:3000`. |
+| `frontend/angular.json` | Angular workspace config; the `serve` target references `proxy.conf.json`. |
+| `package.json` (root) | Root npm scripts; `dev` runs both workspaces via `concurrently`, `dev:backend` / `dev:frontend` run one at a time. |
+| `setup.sh` | Idempotent setup: installs root + workspace deps, builds both packages, creates `./data/uploads`. |
 | `frontend/src/app/app.routes.ts` | Defines public, shell, child, and admin routes. |
 | `frontend/src/app/core/services/bootstrap.service.ts` | Caches and exposes bootstrap state, refreshes it after admin updates, and applies the resolved theme. |
 | `frontend/src/app/core/services/bootstrap.types.ts` | Defines bootstrap/theme payload types and maps theme tokens to CSS custom properties. |

docs/architecture/overview.md

@@ -27,12 +27,12 @@ Browser  ──HTTPS──▶  NestJS process (PORT, default 3000)
                        ├── /api/v1/*  ── controllers → services → TypeORM
                        │                                 │
                        │                                 ▼
-                       │                         better-sqlite3
-                       │                          (DATABASE_PATH)
+                        │                         better-sqlite3
+                        │                          (DATABASE_PATH, default ./data/db.sqlite)
                        │
                        ├── /api/docs, /api/docs-json ── Swagger UI (OpenAPI 3.1)
                        │
-                       ├── /uploads/*  ── static file server (UPLOAD_DIR)
+                        ├── /uploads/*  ── static file server (UPLOAD_DIR, default ./data/uploads)
                        │
                        └── /*  ── SPA fallback (FRONTEND_DIST/index.html)
 ```