Align store calls with selected-company scoping and add entity numbers.

Drop companyId from company-scoped store wrappers and routes, add GET /entity/next-number plus optional number on entity create/update, and document dashdbschema API.md lookup in sibling-repos.
This commit is contained in:
seb
2026-08-07 06:22:13 +02:00
parent 2767568f5a
commit e6c24654dd
36 changed files with 496 additions and 189 deletions

View File

@@ -32,13 +32,17 @@ Wenn ein Vertrag unklar oder fehlt: **nicht weiterwursteln**. Human fragen, Vors
| **dieses** | `docs/api/README.md` | HTTP-Routen, Auth, CORS |
| **dieses** | `docs/api/routes/` | eine Markdown-Datei pro Endpoint |
| **dieses** | `docs/api/openapi.json` | maschinenlesbare Spec |
| dashdbschema | `../dashdbschema/README.md` | Store-Methoden, Signaturen, Returns |
| dashdbschema | `../dashdbschema/README.md` | Store-Übersicht, Konventionen, HTTP-Mapping |
| dashdbschema | `../dashdbschema/API.md` | Store-API-Index (TOC → `API.<modul>.md`) |
| dashdbschema | `../dashdbschema/API.<modul>.md` | pro Namespace (`entity`, `article`, …): Methoden, Signaturen, JSDoc-Beispiele |
| dashdbschema | `../dashdbschema/src/store/` | Implementierung (wenn Doku unklar) |
| dashfront | `../dashfront/README.md`, `../dashfront/src/api/index.js` | Client-Spiegel; erwartet unsere API-Docs |
API-Docs hier regenerieren: `npm run docs:api` (aus `@openapi` an den Handlern).
API-Docs hier regenerieren: `npm run docs:api` (aus `@openapi` an den Handlern).
Store-API-Docs in dashdbschema: `npm run api-doc` (aus JSDoc in `src/store/` → `API.md` + `API.<modul>.md`).
## Was der Human / die anderen von dir erwarten
1. **Vor Frontend-Arbeit:** Route in `docs/api/` aktuell halten (nach Code-Änderung `docs:api` laufen lassen).
2. **Vor Store-Nutzung:** `../dashdbschema/README.md` und ggf. dessen Git-Log lesen — fehlende Store-Methode dem Human melden, nicht erfinden.
2. **Vor Store-Nutzung:** `../dashdbschema/API.md` / `API.<modul>.md` für Signaturen und Beispiele; `README.md` für Konventionen und HTTP-Mapping; ggf. Git-Log lesen — fehlende Store-Methode dem Human melden, nicht erfinden.
3. Frontend-Verträge nur über dokumentierte HTTP-Shapes; keine stillen Breaking Changes ohne Doku-Update.