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.
67 lines
1.6 KiB
Markdown
67 lines
1.6 KiB
Markdown
---
|
|
name: bmad-index-docs
|
|
description: 'Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder'
|
|
---
|
|
|
|
# Index Docs
|
|
|
|
**Goal:** Generate or update an index.md to reference all docs in a target folder.
|
|
|
|
|
|
## EXECUTION
|
|
|
|
### Step 1: Scan Directory
|
|
|
|
- List all files and subdirectories in the target location
|
|
|
|
### Step 2: Group Content
|
|
|
|
- Organize files by type, purpose, or subdirectory
|
|
|
|
### Step 3: Generate Descriptions
|
|
|
|
- Read each file to understand its actual purpose and create brief (3-10 word) descriptions based on the content, not just the filename
|
|
|
|
### Step 4: Create/Update Index
|
|
|
|
- Write or update index.md with organized file listings
|
|
|
|
|
|
## OUTPUT FORMAT
|
|
|
|
```markdown
|
|
# Directory Index
|
|
|
|
## Files
|
|
|
|
- **[filename.ext](./filename.ext)** - Brief description
|
|
- **[another-file.ext](./another-file.ext)** - Brief description
|
|
|
|
## Subdirectories
|
|
|
|
### subfolder/
|
|
|
|
- **[file1.ext](./subfolder/file1.ext)** - Brief description
|
|
- **[file2.ext](./subfolder/file2.ext)** - Brief description
|
|
|
|
### another-folder/
|
|
|
|
- **[file3.ext](./another-folder/file3.ext)** - Brief description
|
|
```
|
|
|
|
|
|
## HALT CONDITIONS
|
|
|
|
- HALT if target directory does not exist or is inaccessible
|
|
- HALT if user does not have write permissions to create index.md
|
|
|
|
|
|
## VALIDATION
|
|
|
|
- Use relative paths starting with ./
|
|
- Group similar files together
|
|
- Read file contents to generate accurate descriptions - don't guess from filenames
|
|
- Keep descriptions concise but informative (3-10 words)
|
|
- Sort alphabetically within groups
|
|
- Skip hidden files (starting with .) unless specified
|