Chaque module a sa propre base URL. En production, l'API du Hub est sur
api.puwapi.com et la plupart des modules sur <module>.api.puwapi.com ou un domaine
direct. En développement, chaque service écoute sur un port local dédié.
Domaines de production¶
| Module | Domaine de production |
|---|---|
| Hub (RDV, CRM, factures, agenda) | api.puwapi.com |
| Identity Hub | identity.puwapi.com |
| Billing | billing.puwapi.com |
| Work (Projets & Support) | work.puwapi.com |
| Send | send.puwapi.com |
| Cloud | cloud.puwapi.com |
| Connect | connect.puwapi.com |
| Forms | forms.api.puwapi.com |
| Docs | docs.api.puwapi.com |
| Slides | slides.api.puwapi.com |
| Knowledge | knowledge.api.puwapi.com |
| RH | rh.api.puwapi.com |
| Fidélité | loyalty.api.puwapi.com |
| Careers | careers.api.puwapi.com |
| IA | ia.api.puwapi.com |
| Chat | chat.api.puwapi.com |
| VR (serveur de formation) | vr.puwapi.com |
Les domaines directs (work, send, cloud, connect, billing, identity) et les domaines en
<module>.api.puwapi.comcoexistent pour raisons historiques ; la base exacte est toujours celle indiquée dans la référence de chaque module.
Ports de développement local¶
| Module | Port dev |
|---|---|
| Identity Hub | 5029 (http) |
| Hub | 5200 |
| Billing | 5300 |
| Cloud | 5400 |
| Work | 5500 |
| Fidélité | 5600 |
| Send | 5700 |
| RH | 5800 |
| Forms | 5900 |
| Connect | 6000 |
| Docs | 6100 |
| Slides | 6200 |
| Knowledge | 6300 |
| VR | 6400 |
| Careers | 6500 |
| IA | 6600 |
Applications web publiques¶
Outre le Hub (app.puwapi.com), certains modules ont une surface publique dédiée :
| Surface | Domaine | Port dev |
|---|---|---|
| Formulaires publics | forms.puwapi.com/{org}/{form} | 3003 |
| Portail candidat (Careers) | careers.puwapi.com/{org}/{portail} | 3007 |
| Prise de RDV / boutique | rendezvous (public) | 3002 |
| Docs | docs.puwapi.com | 3004 |
| Slides | slides.puwapi.com | 3005 |
| Knowledge (KB/blog public) | knowledge.puwapi.com/{org}/{espace} | 3006 |
{org} = le slug d'organisation : un identifiant unique par organisation (source de
vérité côté Identity, édité dans Hub → Paramètres → Organisation), qui préfixe toutes les
URL publiques de Knowledge, Forms et Careers. Les slugs de ressource (espace, formulaire,
portail) sont uniques par organisation. ⚠️ Renommer le slug d'organisation casse les
liens déjà partagés (pas de redirection).
Environnement local¶
En local, les dépendances partagées (PostgreSQL, Redis) sont mutualisées. Chaque service a
sa base puwapi_<module>. Les points d'attention (factory EF design-time, secrets internes
identiques des deux côtés d'un pont, réseau interne) sont documentés dans le dépôt de chaque
module (AGENTS.md / README.md).