Pambe — documentation du monorepo
Pambe est un moteur de matching directionnel entre des tasks (demandes
ponctuelles, « babysitting samedi 14h ») et des services (offres
récurrentes, « société de nettoyage, ouverte mar–sam 06–20h »). Le cœur du
produit, POST /match, ramène les meilleurs candidats grâce à des embeddings
sémantiques, des filtres géo/temporels, et un re-rank par juge LLM.
Cette doc s'adresse aux devs qui rejoignent le projet (humains comme agents Claude Code). Elle explique où vivent les choses, comment démarrer, et comment contribuer sans casser les conventions.
Si tu n'as que cinq minutes, lis Démarrer → Installation puis Architecture → Monorepo. Le reste se consulte au besoin.
Le produit en une image
Ce que tu trouveras ici
| Section | Pour quoi faire |
|---|---|
| Démarrer | Booter le stack local, faire sa première contribution |
| Architecture | Monorepo, frontière packages/lib, câblage web ↔ UI |
| Applications | apps/api, apps/web, apps/hermes en détail |
| Modèle de données | Tables Postgres, enums, diagramme ER |
| Authentification | Flux Auth0, pas de table users |
| Conventions | Object-args, env, i18n, workflow Git |
| Docs-as-code | Comment cette doc reste synchro avec le code |
Sources de vérité complémentaires
Cette doc est additive : elle ne remplace pas le
README.md (quick start
exhaustif, exemples curl) ni le
CLAUDE.md (instructions
pour les agents). Quand un détail opérationnel vit déjà là-bas, on y renvoie
plutôt que de le recopier.