Mathias STRASSER
b7dc27f2a5
Les enseignants ont besoin de moyennes à jour immédiatement après la publication ou modification des notes, sans attendre un batch nocturne. Le système recalcule via Domain Events synchrones : statistiques d'évaluation (min/max/moyenne/médiane), moyennes matières pondérées (normalisation /20), et moyenne générale par élève. Les résultats sont stockés dans des tables dénormalisées avec cache Redis (TTL 5 min). Trois endpoints API exposent les données avec contrôle d'accès par rôle. Une commande console permet le backfill des données historiques au déploiement.
89 lines
3.2 KiB
Markdown
89 lines
3.2 KiB
Markdown
---
|
||
title: '{title}'
|
||
type: 'feature' # feature | bugfix | refactor | chore
|
||
created: '{date}'
|
||
status: 'draft' # draft | ready-for-dev | in-progress | in-review | done
|
||
context: [] # optional: max 3 project-wide standards/docs. NO source code files.
|
||
---
|
||
|
||
<!-- Target: 900–1300 tokens. Above 1600 = high risk of context rot.
|
||
Never over-specify "how" — use boundaries + examples instead.
|
||
Cohesive cross-layer stories (DB+BE+UI) stay in ONE file.
|
||
IMPORTANT: Remove all HTML comments when filling this template. -->
|
||
|
||
<frozen-after-approval reason="human-owned intent — do not modify unless human renegotiates">
|
||
|
||
## Intent
|
||
|
||
<!-- What is broken or missing, and why it matters. Then the high-level approach — the "what", not the "how". -->
|
||
|
||
**Problem:** ONE_TO_TWO_SENTENCES
|
||
|
||
**Approach:** ONE_TO_TWO_SENTENCES
|
||
|
||
## Boundaries & Constraints
|
||
|
||
<!-- Three tiers: Always = invariant rules. Ask First = human-gated decisions. Never = out of scope + forbidden approaches. -->
|
||
|
||
**Always:** INVARIANT_RULES
|
||
|
||
**Ask First:** DECISIONS_REQUIRING_HUMAN_APPROVAL
|
||
<!-- Agent: if any of these trigger during execution, HALT and ask the user before proceeding. -->
|
||
|
||
**Never:** NON_GOALS_AND_FORBIDDEN_APPROACHES
|
||
|
||
## I/O & Edge-Case Matrix
|
||
|
||
<!-- If no meaningful I/O scenarios exist, DELETE THIS ENTIRE SECTION. Do not write "N/A" or "None". -->
|
||
|
||
| Scenario | Input / State | Expected Output / Behavior | Error Handling |
|
||
|----------|--------------|---------------------------|----------------|
|
||
| HAPPY_PATH | INPUT | OUTCOME | N/A |
|
||
| ERROR_CASE | INPUT | OUTCOME | ERROR_HANDLING |
|
||
|
||
</frozen-after-approval>
|
||
|
||
## Code Map
|
||
|
||
<!-- Agent-populated during planning. Annotated paths prevent blind codebase searching. -->
|
||
|
||
- `FILE` -- ROLE_OR_RELEVANCE
|
||
- `FILE` -- ROLE_OR_RELEVANCE
|
||
|
||
## Tasks & Acceptance
|
||
|
||
<!-- Tasks: backtick-quoted file path -- action -- rationale. Prefer one task per file; group tightly-coupled changes when splitting would be artificial. -->
|
||
<!-- If an I/O Matrix is present, include a task to unit-test its edge cases. -->
|
||
<!-- AC covers system-level behaviors not captured by the I/O Matrix. Do not duplicate I/O scenarios here. -->
|
||
|
||
**Execution:**
|
||
- [ ] `FILE` -- ACTION -- RATIONALE
|
||
|
||
**Acceptance Criteria:**
|
||
- Given PRECONDITION, when ACTION, then EXPECTED_RESULT
|
||
|
||
## Spec Change Log
|
||
|
||
<!-- Append-only. Populated by step-04 during review loops. Do not modify or delete existing entries.
|
||
Each entry records: what finding triggered the change, what was amended, what known-bad state
|
||
the amendment avoids, and any KEEP instructions (what worked well and must survive re-derivation).
|
||
Empty until the first bad_spec loopback. -->
|
||
|
||
## Design Notes
|
||
|
||
<!-- If the approach is straightforward, DELETE THIS ENTIRE SECTION. Do not write "N/A" or "None". -->
|
||
<!-- Design rationale and golden examples only when non-obvious. Keep examples to 5–10 lines. -->
|
||
|
||
DESIGN_RATIONALE_AND_EXAMPLES
|
||
|
||
## Verification
|
||
|
||
<!-- If no build, test, or lint commands apply, DELETE THIS ENTIRE SECTION. Do not write "N/A" or "None". -->
|
||
<!-- How the agent confirms its own work. Prefer CLI commands. When no CLI check applies, state what to inspect manually. -->
|
||
|
||
**Commands:**
|
||
- `COMMAND` -- expected: SUCCESS_CRITERIA
|
||
|
||
**Manual checks (if no CLI):**
|
||
- WHAT_TO_INSPECT_AND_EXPECTED_STATE
|