HALO

L'OS des opérations de conciergerie : ménages, planning, arrivées/départs, linge.

Lancer l'application sur ton ordinateur

1. Installer Node.js (version LTS) : https://nodejs.org
2. Ouvrir ce dossier dans Cursor, puis le terminal (Ctrl + ù ou menu Terminal > New Terminal).
3. Taper, une seule fois : npm install
4. Puis à chaque fois : npm run dev
5. Ouvrir http://localhost:3000/fr/today dans le navigateur.

Pages utiles :

• Manager : http://localhost:3000/fr/today
• Agent (format téléphone) : http://localhost:3000/fr/a/today
• Connexion : http://localhost:3000/fr/login
• Vitrine du design : http://localhost:3000/fr/design

Commandes

Commande	Rôle
npm run dev	Lance l'app en local
npm run check	Vérifie tout (style du code, types, tests)
npm run build	Construit la version de production
npm run test:e2e	Tests dans un vrai navigateur

Statut : démonstration

Toutes les données restent dans le navigateur (aucune sauvegarde en ligne, aucun compte réel, synchro iCal manuelle). Ne pas utiliser avec des données réelles. Prérequis de production et sécurité du livret : docs/09-securite-production.md.

Documentation

Tout est dans docs/ (vision, parcours, données, moteur, design). Les règles pour Cursor sont dans .cursor/rules/halo.mdc.

Avancement

• Phase 1 — Socle technique, design system, navigation, 6 langues
• Écran de connexion (interface et logo animé ; branchement à Supabase en phase 2)
• Logements : création en 3 étapes, fiche complète (calendrier, infos, accès, couchages, checklist)
• Réservations : saisie manuelle + synchronisation iCal (Airbnb, Booking, Vrbo) → ménages générés automatiquement
• Planning jour/semaine par agent, répartition automatique, alertes de conflit
• Tâches (filtres, détail, assignation, validation/reprise), Équipe, Réglages
• App agent branchée : démarrer / terminer, code d'accès visible pendant la mission
• Équipements et extérieurs par logement (terrasse, balcon, piscine, four, TV…)
• Livret voyageur : lien + QR code + affiche A5 (wifi, accès, règles, départ), signalement voyageur, bouton « Je pars »
• Alertes : signalements équipes / voyageurs / manager, localisés (pièce ou équipement), photos, intervention planifiée
• Module Linge : stock par emplacement, kits auto par logement, prévision de rupture 7 jours, bons de blanchisserie (envoi, réception, écarts), journal, coûts
• Voyageurs : noms, adultes/enfants/bébés/animaux (kit bébé, +30 min si animaux)
• Planning mois, tuiles du tableau de bord cliquables, photo exigée + photo de référence dans la checklist
• Écran de mission agent : chrono (pointage), checklist par pièce, photos, état de chaque pièce (RAS / casse / manquant / très sale) + commentaire → alertes automatiques
• Durées apprises : chaque ménage pointé ajuste la durée des suivants (par logement, désactivable)
• Planning glisser-déposer (jour et semaine), durée et charge visibles à l'assignation
• Agent : calendrier 7 jours / semaine / mois, heures travaillées