docs(README): link policies/ and CI workflow; add local validation snippets
Some checks failed
validate / JSON Schema (ajv) (push) Failing after 29s
validate / Rego (opa fmt + opa test) (push) Failing after 26s

This commit is contained in:
CTO Agent 2026-10-25 15:28:50 +00:00
parent 961102ca6f
commit baa8b61021

View file

@ -60,12 +60,34 @@ schemas/
expense/canonical/v1.0.0.json expense/canonical/v1.0.0.json
ds/expense/project_assignment/v1.0.0.json ds/expense/project_assignment/v1.0.0.json
sink/db/expense/v1.0.0.json sink/db/expense/v1.0.0.json
policies/
README.md # Policy-Klassen, Input-Verträge, Deployment
transformations/expense.rego (+ _test.rego)
sinks/expense_db_app.rego (+ _test.rego)
data_sources/expense_db_app.rego (+ _test.rego)
.forgejo/workflows/
validate.yml # JSON-Schema (ajv) + Rego (opa fmt + opa test)
``` ```
Weitere Verzeichnisse (Services, Policies, Deployment-Manifeste, Senken-/Datenquellen-Adapter) folgen im Zuge der Architekturentwicklung. Weitere Verzeichnisse (Services, Deployment-Manifeste, Senken-/Datenquellen-Adapter) folgen im Zuge der Architekturentwicklung.
## Einstiegspunkte ## Einstiegspunkte
- [Architektur V1.1](docs/architecture/v1.1.md) — Zielbild - [Architektur V1.1](docs/architecture/v1.1.md) — Zielbild
- [ADRs](docs/adr/README.md) — getroffene Entscheidungen - [ADRs](docs/adr/README.md) — getroffene Entscheidungen
- [Schemas](schemas/README.md) — kanonische Business-, Datenquellen- und Senken-Formate - [Schemas](schemas/README.md) — kanonische Business-, Datenquellen- und Senken-Formate
- [Policies](policies/README.md) — OPA/Rego-Policies für Transformationen, Senken und Datenquellen
## Lokal validieren
```bash
# JSON-Schemas
npx -y ajv-cli@5 compile --spec=draft2020 -c ajv-formats \
-s schemas/expense/canonical/v1.0.0.json
# Rego
opa fmt --list --diff policies/
opa test policies/ -v
```
CI (`.forgejo/workflows/validate.yml`) läuft dieselben Prüfungen auf jedem Push und PR gegen `main`.