Files
apf_portal/docs
Julien Gautier 2c341a56e8
CI / commits (pull_request) Successful in 2m45s
CI / check (pull_request) Successful in 3m0s
CI / scan (pull_request) Successful in 3m5s
CI / a11y (pull_request) Successful in 3m6s
Docs site / build (pull_request) Successful in 3m21s
CI / perf (pull_request) Successful in 6m34s
docs(adr): accept ADR-0026 + ADR-0027
Both ADRs shipped as proposed in #217 after the cascade /
acteurs_plus source-of-truth audit reshaped the org-hierarchy
model. No open questions left on either - promote to accepted
in lockstep since they reference each other.

CLAUDE.md gets two new Architecture bullets ("Portal-side
identity model", "Portal-side organisational hierarchy") and
a small touch-up on the ADR-0025 bullet to clarify the scope
literal `etablissement:<structure-code>` semantics.
2026-05-24 16:57:22 +02:00
..

Documentation index

This is the entry point to all project documentation. It is maintained automatically: any addition, rename, or removal of a .md file under docs/ must be reflected here in the same change.

Conventions

  • Documentation is written in English.
  • One topic per file. Group related files into a folder when there are three or more.
  • Cross-reference with relative links so they keep working in GitHub, IDEs, and exported sites.
  • For architectural decisions, do not add them here — they belong in decisions/ as MADR 4.0.0 ADRs.

Sections

Daily development

  • development.md — repo layout, prerequisites, initial setup, daily commands, observability dev-loop (Jaeger UI, log ↔ trace correlation), dependency updates (Renovate), conventional commit cycle. Day-to-day reference for working on the project.

Architecture

  • architecture.md — cross-cutting Mermaid diagrams: C4 system context, C4 containers, Nx module boundaries, CI/CD pipeline. Single-decision diagrams (auth sequence, ERD, etc.) live inline in their ADR.

Onboarding & environment

Setup guides for new contributors:

Operations & runbooks

Empty — to be populated when we deploy.

Security, performance, accessibility

Empty — placeholders to be filled with rationale docs alongside their corresponding ADRs.