project · niveau 2 · FastAPI

tableau de bord — tableau de bord financier

Construire un tableau de bord pour un cas tableau de bord financier, avec données propres, erreurs gérées et interface utilisable.

Atelier projet Academy

Ce projet se fait dans Academy Untelcom: fichiers éditables, runtime préinstallé, aperçu, contrôles, ampoules de réflexion, accompagnement et checklist QA. Aucune installation externe n'est requise pour apprendre et avancer.

Ouvrir l'atelier Academy

Prérequis dans Academy

navigateur moderne
atelier Academy
compte optionnel pour synchroniser

Déjà prêt dans Academy

éditeur multi-fichiers Academy
simulateur FastAPI pédagogique
console de requêtes HTTP intégrée
correcteur de tests API et schémas

Actions de l'atelier

Ouvrir le workspace Academy du projet
Lancer le simulateur API intégré
Tester les endpoints avec la console Academy
Sauvegarder l'avancement localement ou sur compte optionnel

Tests Academy

Exécuter les tests Academy des endpoints
Vérifier les contrats d'entrée et de sortie
Tester erreurs, permissions simples et cas limites

Qualité Academy

Relire schémas, handlers et règles métier
Contrôler que les réponses d'erreur sont claires
Compléter le journal QA avant de valider le jalon

Limites et export

Tout le travail pédagogique se fait dans Academy sans outil externe.
L'export serveur réel devient un jalon guidé après validation Academy.

Fichiers de départ

README.md

Mode d'emploi du projet: objectif, usage dans Academy, décisions et limites.

app/main.py

Application FastAPI et routes.

app/domain.py

Règles métier isolées de Flask.

app/schemas.py

Contrats d'entrée/sortie API.

tests/test_api.py

Tests HTTP FastAPI.

Ampoules pour réfléchir

Si tu bloques, reviens à la donnée principale: qui la crée, qui la lit, qui la modifie ?
Si le projet semble trop grand, coupe-le en un parcours complet minuscule.
Si tu ne sais pas tester, écris d'abord une règle métier pure et teste-la sans interface.
Si l'interface est confuse, ajoute les états vide, succès, erreur et chargement.
Si Codex ou Claude écrit trop de code, demande-lui un plan puis une petite étape vérifiable.

Accompagnement étape par étape

1. Cadrage

Comprendre qui utilise le projet, quelle donnée est manipulée et ce que signifie réussir.

Ampoules

Écris l'utilisateur principal en une phrase.
Liste les 3 actions indispensables avant de coder.
Définis ce qui serait dangereux ou incohérent dans les données.

Questions

Dans le contexte tableau de bord financier, quelle donnée mérite d'être protégée ?
Quel est le parcours minimum pour prouver que tableau de bord fonctionne ?
Quelle erreur utilisateur dois-tu rendre impossible ou visible ?

Fini quand

mission reformulée
objets métier listés
règles de validation écrites

2. Atelier Academy préinstallé

Ouvrir le workspace Academy, lancer le runtime intégré et obtenir une première preuve visible.

Ampoules

Reste dans l'atelier Academy: l'éditeur, le runner, l'aperçu et les tests sont déjà là.
Lance une preuve minimale avant de construire les fonctionnalités.
Si un contrôle échoue, copie l'erreur exacte dans ton journal QA Academy.

Questions

Quelle action Academy prouve que le projet démarre ?
Quel fichier est le point d'entrée dans l'atelier ?
Quel test minimal peut passer avant toute fonctionnalité ?

Fini quand

workspace Academy ouvert
runtime intégré lancé
preuve visible obtenue
test minimal vert

3. Modèle et règles métier

Coder les règles dans une fonction ou couche métier testable avant l'interface.

Ampoules

Commence par les données et les règles, pas par la décoration.
Écris les cas limites avant le code final.
Un controller ou une page ne doit pas contenir la règle métier principale.

Questions

Quelles valeurs sont obligatoires ?
Quel cas vide ou limite doit être accepté ?
Quelle erreur doit être refusée proprement ?

Fini quand

modèle minimal
règles isolées
tests unitaires des règles

4. Parcours utilisateur

Construire le chemin complet: créer, lire, modifier ou exploiter la donnée selon le projet.

Ampoules

Avance par parcours, pas par fichiers au hasard.
Après chaque action, affiche un état clair: succès, vide, erreur ou chargement.
Teste le parcours avec des données réalistes et des données fausses.

Questions

Quel est le premier écran ou endpoint utile ?
Comment l'utilisateur sait-il que l'action a réussi ?
Que se passe-t-il si la liste est vide ?

Fini quand

parcours principal complet
états vides/erreurs visibles
données d'exemple

5. Tests, QA et livraison

Prouver que le projet tourne, se teste, se relit et peut être présenté.

Ampoules

Ne livre pas parce que ça marche une fois: livre parce que tu peux le prouver.
Garde un journal des bugs trouvés et corrigés.
Prépare une démo courte: problème, solution, preuve, limite.

Questions

Quel contrôle Academy prouve le coeur métier ?
Quelle checklist manuelle couvre le parcours réel ?
Quelle limite assumes-tu dans le README ?

Fini quand

tests verts
QA manuel fait
README complet
démo préparée

Tu n'es jamais seul

Si tu bloques

Décris le blocage en une phrase: cadrage, logique métier, interface, test, données ou déploiement.
Cherche la plus petite preuve possible: un test vert, un écran, un endpoint simulé ou une checklist validée.
Reviens au jalon courant et ignore le reste du projet pendant 20 minutes.
Compare ce que tu pensais obtenir avec ce que tu observes réellement.

Prompts Codex

Analyse ce projet tableau de bord — tableau de bord financier. Propose un plan en 5 étapes, puis commence uniquement par le modèle métier et ses tests.
Lis le code actuel, trouve le plus petit bug ou manque qui bloque le prochain jalon, puis corrige-le avec tests.
Fais une revue QA: parcours principal, cas vide, validation, erreurs, accessibilité mobile, README.

Prompts Claude Code

Explore le projet tableau de bord — tableau de bord financier, identifie les fichiers importants, puis prépare un plan de livraison vérifiable.
Implémente le prochain jalon sans refactor inutile, en gardant les règles métier séparées de l'interface.

Jalons

Cadrer les utilisateurs, les objets métier et les règles de validation.
Créer le modèle de données minimal et les écrans principaux.
Implémenter les actions, les tests et les états d'erreur.
Préparer une démonstration et une checklist QA.

Critères d'acceptation

Le parcours principal fonctionne sans donnée incohérente.
Les entrées utilisateur sont validées.
Les cas vides et limites sont visibles.
Le README explique l'usage dans Academy, les décisions et les limites.

Tests et livrables

tests unitaires des règles métier
tests fonctionnels du parcours principal
test manuel mobile et clavier
code source
README
captures
journal QA

QA et déploiement

Projet repris depuis un workspace Academy vide.
Aucun outil externe requis pour travailler le projet.
Runner, aperçu ou simulateur Academy vérifié.
Tests Academy exécutés.
Parcours principal testé manuellement.
Cas vide testé.
Erreur utilisateur testée.
README relu comme si un autre étudiant reprenait le projet.
Ne déploie pas tant que les tests et la checklist QA ne sont pas verts.
Prépare une variable d'environnement pour les secrets; ne mets jamais de secret dans le code.
Prévois une procédure de rollback avant la mise en ligne réelle.