Docs menu

STAFF#

Plateforme de mise en relation entre des entreprises ayant un besoin de renfort ponctuel — stations-service, commerces de proximité, restauration — et des prestataires indépendants disponibles à proximité.

Elle couvre le cycle complet d'une mission : publication, diffusion géolocalisée, candidatures, sélection, pointage sur site, validation des heures et règlement. Marchés visés : Martinique, Guadeloupe, Guyane et La Réunion.

Sommaire#

Document	Contenu
Architecture	Structure du dépôt, couches, modèle d'autorisation, décisions
API	Surface tRPC : routers, procédures, garanties
Environnement de développement	Installation, base de données, tests, déploiement
Design system	Identité visuelle et jetons
Cahier des charges de la maquette	Document historique — prototype antérieur à la plateforme

Stack#

Couche	Technologie
Monorepo	Turborepo, pnpm, Node ≥ 20
Web	Next.js 15 (App Router), Tailwind CSS 4
Mobile	Expo / React Native, expo-router
API	tRPC v11
Base de données	PostgreSQL — Neon en ligne, Docker en local
ORM	Drizzle
Déploiement	Vercel (web), EAS (mobile)

Structure#

apps/
  web/          Next.js — surfaces entreprise, prestataire et administration
  mobile/       Expo — application prestataire et entreprise
packages/
  db/           Schéma Drizzle, migrations, référentiels
  auth/         Mots de passe, sessions, cloisonnement des données
  api/          Routers tRPC, règles métier
  ui/           Types et jetons partagés

Démarrage#

Prérequis : Node ≥ 20, pnpm 9, Docker.

bash

cp .env.example .env      # puis renseigner AUTH_SECRET
pnpm setup                # dépendances, base, migrations, référentiels
pnpm dev:web              # http://localhost:3001
pnpm dev:mobile           # Expo

Le détail — commandes de base de données, comptes de démonstration, exécution des tests — est dans docs/DEV-SETUP.md.

Vérifications#

bash

pnpm typecheck
pnpm test        # 188 tests ; les suites d'intégration exigent PostgreSQL
pnpm build

Déploiement#

Le travail se fait sur la branche DEV, déployée en preview.

La production est réservée à la mise en ligne, une fois le nom de domaine arrêté. Elle ne possède aucune variable d'environnement : un déploiement prématuré échoue franchement plutôt que de servir en silence la base de l'aperçu.

La base de données n'est rattachée au projet qu'en preview. Après toute nouvelle migration, appliquer pnpm db:migrate avec l'URL correspondante.

Le mobile n'est pas déployé sur Vercel. Le pointage utilisant la caméra, Expo Go ne suffit pas : il faut un build EAS.

Périmètre#

La première version couvre le cycle décrit plus haut. En sont exclus et relèvent d'évolutions ultérieures : le suivi de position en temps réel, la notation et la fidélisation, l'assistance à la création du statut d'indépendant, l'assistance téléphonique, les tableaux de bord analytiques, les offres multi-établissements, les connexions aux outils tiers et toute fonctionnalité reposant sur l'intelligence artificielle.

Certaines pages héritées du prototype sont encore alimentées par des données fictives ; elles sont signalées comme telles dans la navigation.