---
layout: home

hero:
  name: APF Portal
  text: Documentation
  tagline: Architecture decisions, development guide, and onboarding material for APF France Handicap's web portal.
  actions:
    - theme: brand
      text: Read the architecture
      link: /architecture
    - theme: alt
      text: Browse decisions
      link: /decisions/

features:
  - title: Architecture
    details: System context, container diagram, Nx module boundaries, CI/CD pipeline. Cross-cutting Mermaid diagrams that frame the whole platform.
    link: /architecture
    linkText: Open architecture
  - title: Decisions (ADRs)
    details: Every non-trivial choice — auth flow, sessions, audit trail, downstream-API access, accessibility, performance budgets, admin app — recorded as MADR 4.0.0 ADRs.
    link: /decisions/
    linkText: Open decisions
  - title: Development guide
    details: Repo layout, daily commands, observability dev-loop (Jaeger, log↔trace correlation), dependency updates, conventional commits.
    link: /development
    linkText: Open development guide
  - title: Onboarding
    details: WSL terminal setup, Node + pnpm + Docker, Angular + Nx monorepo bootstrap. Everything a new contributor needs to get a working environment.
    link: /setup/01-wsl-terminal-setup
    linkText: Start onboarding
---