STAFF — Cahier des charges de la maquette (document historique)#

⚠️ Document historique#

Ce cahier des charges décrit le prototype présenté en juillet 2026, qui a servi de base aux discussions produit. Il ne décrit pas la plateforme actuelle et ne fait pas foi.

Il est conservé parce que les parcours et le vocabulaire qu'il fixe ont été validés et restent la référence de conception. Mais plusieurs de ses choix ont été tranchés autrement depuis, et une partie de ce qu'il présente en priorité haute est aujourd'hui hors périmètre de la première version : notation et récompenses, offres multi-sites, accompagnement humain à la création de statut, assistance conversationnelle, tableaux de bord analytiques, portage salarial.

Pour l'état réel : README.md, docs/ARCHITECTURE.md et docs/API.md.

Nature du livrable décrit ici : MAQUETTE HAUTE-FIDÉLITÉ front-end. Fausses données réalistes, aucun back-end, aucune base réelle, aucune API externe. Tous les flux (mandat de prélèvement, règlement, notifications, pointage) y sont simulés côté client.

0. Contexte produit (à connaître avant de coder)#

Staff = plateforme DOM-TOM de mise en relation entre établissements (demandeurs, ex. stations-service) en manque de personnel et prestataires (auto-entrepreneurs) disponibles pour des missions courtes. Alternative rapide et moins chère que l'intérim.

• Origine du besoin : l'exploitation de stations-service, où le renfort ponctuel est fréquent et l'intérim mal adapté.
• Marché de lancement (MVP) : stations-service en Martinique (~250 stations, 2–5 missions/semaine chacune). Secteurs activés au MVP : Station-service + Nettoyage.
• Cible régionale : Martinique, Guadeloupe, Guyane, Saint-Martin, Saint-Barthélemy, La Réunion.
• Positionnement : abonnement établissement 29,90 € HT/mois + commission 30 % sur missions ; rémunération prestataire benchmark 12–13 €/h. Coût employeur via Staff ~68 € vs ~90 € intérim.

Le « golden path » démontré par le client (à rendre PARFAIT dans la maquette)#

1. Le gérant s'inscrit (SIRET + coordonnées bancaires) et publie une mission.
2. Les prestataires inscrits dans un rayon de 10 km reçoivent une notification géolocalisée.
3. Plusieurs candidats postulent → le gérant voit une liste capée à 5–8 candidats et choisit.
4. Le prestataire accepte → sur place, il scanne un QR code → la mission démarre.
5. Il scanne à la sortie → décompte horaire automatique.
6. Heures validées → encaissement automatique sous 24 h (fenêtre de contestation gérant 24 h).
7. Le prestataire (auto-entrepreneur) reçoit facture + récap URSSAF dans l'app ; backup web pour la comptabilité côté prestataire ET côté établissement.

Le pointage par QR code (scan début + scan fin) est l'interaction SIGNATURE de l'app. Le point de friction n° 1 est l'onboarding prestataire : question « Avez-vous un SIRET ? » → si non, deep-link d'aide + accompagnement humain pour créer l'auto-entreprise en minutes.

1. Deux applications, trois surfaces#

Déploiement : équipe Vercel Jaikin, intégration git, jamais vercel deploy. Flux DEV → PREVIEW → PRODUCTION par PR de promotion. PREVIEW = branche PREVIEW → staff.jaikin.dev. Le mobile n'est pas déployé web (Expo/EAS only).

2. Priorités des écrans (P0 = golden path, doit être irréprochable)#

apps/mobile — Mode PRESTATAIRE#

• P0 Splash + choix de rôle (Prestataire / Établissement) — identité verte Staff.
• P0 Inscription 5 étapes :
  1. Identité (Prénom, Nom, Date de naissance JJ/MM/AAAA, Email, Téléphone +596…). Calcul d'âge temps réel, BLOCAGE < 18 ans avec message exact : « Vous devez avoir 18 ans révolus pour utiliser Staff. »
  2. Territoire — sélection multiple des 6 régions (min. 1).
  3. Secteurs — sélection multiple parmi les secteurs actifs dans la région (au MVP : Station-service, Nettoyage). Pictogramme + libellé.
  4. Situation professionnelle — 3 options (voir §4), avec écran comparatif AE vs portage avant le choix « portage ». Branche SIRET : « Avez-vous un SIRET ? » Non → carte d'aide « On vous guide en 5 min » (deep-link simulé) + « Être accompagné par un conseiller Staff ».
  5. Charte + activation — Charte Staff intégrale (voir §5), case obligatoire, récap, bouton « Activer mon compte Staff ».
• P0 Feed missions géolocalisées — liste de cartes (station, secteur, fonction, rémunération, durée, distance), + bascule carte (plan stylisé, pas de service tiers). La fiche mission côté prestataire n'affiche PAS la note de l'établissement.
• P0 Détail mission → « Accepter la mission » (indiquer « places limitées, 5–8 candidats »).
• P0 Pointage QR — écran héros : scanner plein écran, halo, état GPS confirmé, gros CTA « Scanner pour démarrer » puis, mission en cours, chrono live + « Scanner pour terminer ».
• P0 Récompenses — 3 niveaux (Standard / Or / Platine / Diamant) : jauge de progression, bonus %, missions restantes, badge. (Or ≥4,0 & 10 missions / Platine ≥4,5 & 20 / Diamant ≥4,8 & 30.)
• P1 Mes missions (à venir / en cours / passées) + validation d'heures.
• P1 Profil public prestataire — note globale 5★, 4 critères (Ponctualité, Présentation, Attitude, Compétences), badge niveau, historique d'avis (≤200 car.).
• P1 Revenus & paiements — encaissements « sous 24 h » (AE), historique, récap URSSAF, facture de mission (PDF simulé).
• P1 Support — chat IA (simulé, ton Staff) + bouton « Parler à l'équipe Staff » (WhatsApp).
• P1 Profil / paramètres — régions, secteurs, IBAN, statut, notifications.

apps/mobile — Mode ÉTABLISSEMENT (gérant, mobile)#

• P0 Inscription 3 étapes :
  1. Établissement (Nom, Adresse, SIRET du site, Secteur, Région → TVA calculée dynamiquement 8,5 % DOM / 0 % Guyane & collectivités, Email de facturation, Responsable).
  2. Abonnement + Mandat SEPA + Engagement — formules (1 site 29,90 € / 3 sites 79,90 € / 5+ devis) ; mandat SEPA (titulaire, IBAN, BIC auto) avec texte légal SEPA exact (§6.1) ; case engagement 12 mois avec texte exact (§6.2). Signature = clic horodaté (simulé).
  3. Activation — récap complet + case CGU + « Accéder au tableau de bord ».
• P0 Publier une mission — secteur, fonction, date/heure, durée (min. 2 h), rémunération, rayon (10 km, extension 25 km simulée) → écran de confirmation « X prestataires notifiés autour ».
• P0 Suivi mission — candidats (liste capée 5–8), sélection du prestataire, QR code à afficher sur place (généré), statut de pointage (en attente → en cours → terminé), heures.
• P0 Noter le prestataire — 5★ + 4 critères + commentaire (≤200 car.) → public ; + note privée établissement (interne Staff, jamais publique).
• P1 Dashboard établissement (missions actives, prestataires en mission, dépenses du mois).
• P1 Abonnement / SEPA / factures.

apps/web → staff.jaikin.dev#

(A) Dashboard Établissement (backup web) — accès rapide role-switch :

• P1 Vue d'ensemble (missions, dépenses, prestataires récurrents).
• P1 Publier / suivre missions (miroir du mobile, layout desktop).
• P1 Factures & récap comptable (export CSV/PDF simulé), abonnement & mandat SEPA.

(B) Admin interne Staff (back-office) :

• P0 Overview KPIs — régions, secteurs actifs, prestataires (par niveau), établissements (abonnements actifs / past_due), missions (jour/semaine), GMV & commissions.
• P0 Matrice Secteurs × Régions — activer/désactiver un secteur par région (toggles). Au MVP seuls Station-service & Nettoyage sont ON en Martinique. (Cœur de la config produit.)
• P1 Prestataires — liste, niveaux Or/Platine/Diamant, notes, alertes qualité (1/2/3).
• P1 Établissements — abonnements, statut SEPA & escalier de rejet (past_due J+7, résiliation J+21, codes AM04/AC04).
• P1 Missions & litiges — pointages QR/GPS, heures contestées, escalade WhatsApp.
• P1 Modération notation — anomalies statistiques, neutralisation d'avis injuste.
• P2 Portage salarial — journal des clôtures (email + PDF Factur-X + virement) vers Freedom Portage / Réunion Portage.
• P2 Alertes éditoriales — aperçu des messages d'inactivité & renouvellement M-3 (règles rédactionnelles : jamais de montant, jamais de résiliation).

3. Design — voir DESIGN.md#

Identité verte Staff, direction Apple / Airbnb / Linear : blanc dominant, vert de marque, dégradés subtils, coins arrondis, glassmorphism léger, animations calmes (reanimated / framer). Réutiliser l'architecture du design system de ze-rencontre (apps/mobile/src/lib/theme.ts — tokens sémantiques : texte / surface / verre / élévation / motion) mais reskinné en vert. Qualité de référence : au moins aussi soignée que ze-rencontre. Zéro texte blanc-sur-blanc, zéro gradient cassé (attention aux classes Tailwind bg-[image:var(--x)] pour les dégradés).

4. Étape 4 — 3 options de situation professionnelle (libellés EXACTS, pas de jargon)#

Ne jamais écrire « auto-entrepreneur » dans l'option B ni « portage salarial » dans le libellé principal de l'option C.

• A — « Je suis déjà auto-entrepreneur » — « Vous avez un numéro SIRET actif. Inscription immédiate, vérification en 2 secondes. » (Saisie SIRET → vérif simulée → IBAN → actif.)
• B — « Je veux créer mon auto-entreprise » — « On vous guide en 5 minutes. Gratuit et officiel. Compte actif sous 48-72 h. » (Deep-link simulé guichet-entreprises + aide humaine.)
• C — « Je préfère le portage salarial » — « Staff s'occupe de tout. Vous travaillez et recevez votre paiement mensuel via notre partenaire agréé. Note : cette option réduit votre rémunération nette vs l'option A. » (→ écran comparatif puis partenaire Freedom/Réunion Portage.)

Écran comparatif AE vs Portage (à afficher avant de valider C) : Paiement (24 h vs mensuel), Net/mission 4 h (~37 € vs ~20 €), Démarches (5 min/mois vs aucune), Protection sociale (partielle vs complète), Reco Staff (★ Recommandé pour maximiser vos revenus vs si besoin de protection).

5. Charte Staff (étape 5) — titres et contenu exacts#

• Section 1 — « Vos avantages d'être sur Staff » : 8 avantages (opportunités en 1 clic ; paiement garanti 24 h AE / mensuel portage ; liberté de choix ; mobilité DOM-TOM ; app 100 % gratuite sans prélèvement sur salaire ; récompenses jusqu'à +6 % ; assistance 7j/7 ; récap mensuel URSSAF).
• Section 2 — « Vos engagements pour offrir un service de qualité » : intro obligatoire + 6 engagements (ponctualité, présentation, attitude, disponibilité, discrétion, fiabilité).
• Section 3 — Programme de récompenses : Or / Platine / Diamant (seuils §2), évaluation bimestrielle, badge public.
• Section 4 — Alertes qualité (vocabulaire B2B strict) : INTERDITS : « sanction », « faute », « exclusion », « avertissement », « règlement intérieur », « pouvoir disciplinaire ». Alerte 1 (<3/5 sur 3 missions → échange WhatsApp bienveillant, aucun impact). Alerte 2 (<2,5/5 sur 5 → pause temporaire + échange). Alerte 3 (3 absences non signalées / 3 mois → fin de partenariat commercial, pas une mesure disciplinaire).

6. Textes légaux — à afficher EXACTEMENT (non modifiables)#

6.1 Mandat SEPA#

« En confirmant ce mandat, vous autorisez (A) Staff SAS à envoyer des instructions à votre banque pour débiter votre compte, et (B) votre banque à débiter votre compte conformément aux instructions de Staff SAS. Vous bénéficiez d'un droit à remboursement par votre banque selon les conditions décrites dans la convention que vous avez passée avec elle. Toute demande de remboursement doit être présentée dans les 8 semaines suivant la date de débit de votre compte. Pour les débits non autorisés : 13 mois maximum. »

6.2 Engagement annuel (case à cocher)#

« En cochant cette case, vous souscrivez un abonnement Staff d'une durée minimale de 12 mois (valeur totale : 358,80 € HT pour la formule 1 site, soit 29,90 € × 12 mois). À l'issue de cette période, l'abonnement se renouvelle automatiquement par tacite reconduction pour des périodes successives de 12 mois. Vous serez informé du renouvellement 3 mois avant l'échéance. En cas de résiliation anticipée, le solde des mois restants sera facturé à hauteur de 50 %. »

7. Notation (rappels)#

• Public : le demandeur note le prestataire (1–5★ + 4 critères + commentaire ≤200 car.).
• Privé : le prestataire évalue l'établissement → interne Staff uniquement, jamais public.
• Délai 48 h, rappel H+24 ; sans note → 3/5 neutre (aucun impact).
• Fiche mission prestataire : jamais la note de l'établissement.

8. Données mockées (réalistes, Martinique)#

• Édition MVP Martinique : ~250 stations, secteurs Station-service + Nettoyage actifs.
• Établissements exemples : « Station Total Génipa (Ducos) », « Vito Le Lamentin », « Esso Fort-de-France », « Netto Propreté Schœlcher »… (fictifs, crédibles).
• Missions : Pompiste, Caissier, Laveur, Agent d'entretien… rémunérations 12–13 €/h, durées 2–6 h, distances 1–9 km.
• Prestataires : profils variés avec niveaux Or/Platine/Diamant, notes, historiques.
• TVA : Martinique/Guadeloupe/Réunion 8,5 % ; Guyane/Saint-Martin/Saint-Barth 0 %.
• 6 régions, 16 secteurs (avec pictos), mais seuls 2 actifs au MVP (le reste = « Bientôt »).

9. Non-goals (maquette)#

• Pas de vrai Stripe / SEPA / INSEE / URSSAF / envoi email / WhatsApp / IA — tout est simulé.
• Pas d'auth réelle, pas de paiement, pas de base de données.
• Le QR « scan » est simulé (bouton qui simule un scan réussi + animation).
• Les données vivent dans apps/mobile/src/data et apps/web/src/data (typées, partagées via packages/ui).

10. Qualité & vérification (obligatoire avant de dire « fini »)#

• pnpm build PASSE sur apps/web. apps/mobile : npx expo export --platform web réussit + typecheck.
• Au moins 1 test automatisé qui vérifie du comportement (pas juste un build).
• Audit visuel de chaque écran (screenshot) — pas seulement « ça compile ». Chasse spécifiquement : texte blanc-sur-blanc, dégradés non rendus, chevauchements, contrastes faibles.
• Français partout, typé strict, cohérence du design system.