Documentation Bell

Plateforme de conciergerie hôtelière digitale — spec, ADRs, opérations, conventions

Bienvenue dans la documentation interne de Bell. Quatre sections sélectionnables dans le menu en haut de la sidebar.

Sections

Architecture

Vision, entités, API, intelligence, intégrations PMS

Décisions

ADRs : séparation apps, auth, realtime, jobs, tests, Eden Treaty, Signoz

Opérations

Environnements, auth, monitoring, concurrence, RGPD, coûts, onboarding hôtel

Conventions

Architecture modulaire, naming, tests, code style, git workflow

Par où commencer

Nouveau sur le projet ? Lis Architecture → Vue d'ensemble, puis Conventions.
Tu vas coder un module métier ? Lis Architecture modulaire et la Spec fonctionnelle.
Tu vas brancher un nouveau PMS ? Lis PMS adapter pattern puis Mews comme référence.
Tu vas déployer ? Lis Environnements et Monitoring.
Tu hésites sur un choix techno ? Cherche dans Décisions — il y a probablement déjà un ADR.

Vision courte

Bell remplace le téléphone de chambre et l'attente à la réception par une expérience digitale fluide, agnostique du PMS de l'hôtel. Deux faces :

PWA Guest (apps/pwa) — accessible sur invitation de l'hôtel uniquement, pré-check-in digital + services (room service, spa, laundry, restaurant) + concierge IA
Dashboard Staff/Admin (apps/dashboard) — gestion du cardex, confirmation d'arrivée, réponse aux chats, analytics, configuration des intégrations PMS

Côté intégrations, on est un hub : Mews en premier, Opera et Cloudbeds ensuite, via un pattern adapter qui normalise les données. Un hôtel sans PMS fonctionne aussi (Bell reste master).