Skip to content

Wifsimster/toko

Repository files navigation

Tokō

Application web qui aide les parents à suivre et accompagner leur enfant TDAH (Trouble du Déficit de l'Attention avec ou sans Hyperactivité) au quotidien.

Table des matières

Documentation technique

Document Description
Fonctionnalités Inventaire des fonctionnalités utilisateur et routes associées
Architecture Architecture monorepo et flux de données entre packages
Authentification Flux de connexion Better Auth, sessions et protection des routes
Programme Barkley Programme d'entraînement parental PEHP et tableau de récompenses
Schéma de base de données Structure des tables PostgreSQL et relations
Déploiement Guide Docker, variables d'environnement et pipeline CI/CD
Intégration Stripe Abonnements, paiements et webhooks Stripe
Base de connaissances TDAH Articles éducatifs sur le TDAH pour les parents

À quoi sert ce produit ?

  • Suivre les symptômes TDAH de votre enfant au quotidien sur 7 dimensions
  • Tenir un journal d'observations avec humeur et étiquettes
  • Construire une liste de crise pour aider l'enfant à s'apaiser
  • Mettre en place le programme Barkley (PEHP) avec tableau de récompenses
  • Visualiser les tendances sur semaine, mois et trimestre

Fonctionnalités principales

  • Suivi des symptômes — Évaluation quotidienne sur 7 axes : agitation, concentration, impulsivité, régulation émotionnelle, sommeil, comportement social et autonomie
  • Journal d'observations — Notes libres avec humeur (4 niveaux) et étiquettes thématiques (école, victoire, crise, médicament, sommeil, sport, thérapie)
  • Liste de crise — Activités apaisantes construites avec l'enfant, mode plein écran avec navigation par swipe pour être utilisée pendant les crises
  • Programme Barkley — Suivi des 10 étapes du programme d'entraînement parental (PEHP) avec quiz de validation
  • Tableau de récompenses — Suivi hebdomadaire de comportements, étoiles cumulatives et récompenses à débloquer
  • Tableau de bord — Vue synthétique avec série d'observance, humeur récente et graphique des symptômes sur semaine / mois / trimestre
  • Multi-enfants — Jusqu'à 3 profils enfants par compte parent (plan Famille)
  • Base de connaissances — Articles éducatifs sur le TDAH et sujets connexes pour les parents
  • Conformité RGPD — Export des données personnelles au format JSON et suppression de compte
  • PWA — Installable sur mobile et optimisée pour smartphone

Comment ça fonctionne

graph LR
    A[Parent] --> B[Application Web]
    B --> C[API Hono]
    C --> D[Base PostgreSQL]
    C --> E[Authentification]
    C --> F[Paiement Stripe]
Loading

Le parent accède à l'application web depuis son navigateur. L'interface communique avec l'API backend. L'API gère la logique métier, l'authentification et stocke les données en base PostgreSQL.

Environnements

Environnement URL Description
Développement http://localhost:5173 (web) / http://localhost:3001 (API) Environnement local
Production https://toko.battistella.ovh Environnement de production

Déploiement

graph LR
    A[Développeur] -->|Push sur main| B[GitHub Actions]
    B -->|Tests et typage| C{Résultat ?}
    C -->|Succès| D[Build Docker]
    D --> E[Push GHCR]
    E --> F[Déploiement auto]
    C -->|Échec| G[Notification]
Loading

Le pipeline CI/CD (Intégration et Déploiement Continus) se déclenche à chaque push sur la branche principale. Les tests et la vérification de typage s'exécutent en premier. Si tout passe, une image Docker est construite et poussée sur le registre GitHub. Le déploiement s'effectue automatiquement sur le serveur de production.

La version est déterminée automatiquement par les commits conventionnels :

  • feat: déclenche une version mineure
  • fix: déclenche un correctif
  • feat!: ou BREAKING CHANGE: déclenche une version majeure

Stack technique

  • Frontend : React 19, TypeScript, TailwindCSS 4, TanStack Router, TanStack React Query, Zustand, Recharts
  • Backend : Node.js 22, Hono, Better Auth, Drizzle ORM, Stripe
  • Base de données : PostgreSQL 16
  • Validation : Zod (partagé frontend/backend)
  • Infrastructure : Docker, GitHub Actions, Traefik, pnpm + Turborepo (monorepo)

Documentation complémentaire

La documentation technique détaillée se trouve dans le dossier docs/ :

About

L'application qui aide les parents à guider leur enfant TDAH, un jour à la fois.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages