Tranches
La colonne « Commencer par » contient des commandes du générateur sans leur lanceur : dans cet
exemple, elles sont exécutées avec node scripts/gen.mjs <command> (le
npx ddd-ts-kit generate <command> --json du kit, mesuré). Un cas d'usage dont les mots ne sont pas encore dans le glossaire les ajoute avec
--term "<Term>=<meaning>". Responsables : conductor (le chef d'orchestre), platform, ou le
worker d'un contexte (scheduling en a deux : scheduling-calendar et scheduling-appointment,
sur des agrégats différents).
| # | Contexte | Type | Tranche | Commencer par | Dépend de | Responsable | Statut |
|---|---|---|---|---|---|---|---|
| M1.01 | scheduling | skeleton | Calendar, Appointment, Waitlist | aggregate scheduling <Name> puis repository scheduling <Name>, trois fois |
conductor | done | |
| M1.02 | identity | skeleton | Person, Practice, Delegation | aggregate identity <Name> puis repository identity <Name>, trois fois |
conductor | done | |
| M1.03 | notification | skeleton | Notification, Reminder | aggregate notification <Name> puis repository notification <Name>, deux fois |
conductor | done | |
| M1.04 | identity | contract | Personne enregistrée, Cabinet ouvert, Membre ajouté, Membre retiré, Délégation accordée, Délégation révoquée | integration-event identity Person Registered, ... Practice Opened, ... Practice MemberAdded, ... Practice MemberRemoved, ... Delegation Granted, ... Delegation Revoked |
M1.02 | conductor | done |
| M1.05 | scheduling | contract | Calendrier créé ; Rendez-vous réservé, confirmé, déplacé, annulé, expiré, terminé, marqué en absence | integration-event scheduling Calendar Created, integration-event scheduling Appointment <Fact> sept fois |
M1.01 | conductor | done |
| M1.06 | identity | contract | Annuaire des personnes (contrat de lecture) | gateway scheduling identity PersonDirectory |
M1.02 | conductor | done |
| M1.07 | scheduling | contract | Export des rendez-vous (contrat de lecture, source d'une reconstruction) | gateway analytics scheduling AppointmentExport |
M1.01 | conductor | done |
| M1.08 | scheduling | skeleton | Politiques du préavis du patient | policy scheduling PatientCancelsUntilNotice --permission appointment.cancel, policy scheduling PatientReschedulesUntilNotice --permission appointment.reschedule |
M1.01 | conductor | done |
| M1.09 | all | skeleton | Le travail déclenché par le temps | command scheduling ExpireUnconfirmedAppointments --aggregate Appointment --permission appointment.expire et job scheduling ExpireUnconfirmedAppointments --every 5m --command ExpireUnconfirmedAppointments ; la même paire pour identity ExpireDelegations (5m), notification SendDueReminders (15m), analytics VerifyOccupancy (cron 0 3 * * *, Europe/Paris ; retiré après la livraison, voir la note de M1.37) |
M1.01, M1.02, M1.03 | conductor | done |
| M1.10 | platform | skeleton | Tuples de relation persistants, schéma des relations, rôles combinés aux relations, prise d'identité en lecture seule | à la main dans src/platform/auth/ (aucun générateur) et adr "Combine token roles with relationships in one authorizer" |
conductor | todo | |
| M1.11 | identity | slice | Enregistrer une personne | command identity RegisterPerson --aggregate Person --permission person.register ; route identity RegisterPerson --method PUT --path /people/me |
M1.02, M1.04 | identity | todo |
| M1.12 | identity | slice | Ouvrir un cabinet | command identity OpenPractice --aggregate Practice --permission practice.open ; route identity OpenPractice --method POST --path /practices |
M1.02, M1.04 | identity | todo |
| M1.13 | identity | slice | Ajouter un membre, retirer un membre | command identity AddMember --aggregate Practice --permission member.add ; route ... --method POST --path /practices/:practiceId/members ; command identity RemoveMember --aggregate Practice --permission member.remove ; route ... --method DELETE --path /practices/:practiceId/members/:personId |
M1.12 | identity | todo |
| M1.14 | identity | slice | Accorder une délégation, révoquer une délégation | command identity GrantDelegation --aggregate Delegation --permission delegation.grant ; route ... --method POST --path /practices/:practiceId/desks/:practitionerId/delegations ; command identity RevokeDelegation --aggregate Delegation --permission delegation.revoke ; route ... --method DELETE --path /practices/:practiceId/desks/:practitionerId/delegations/:delegationId |
M1.13 | identity | todo |
| M1.15 | identity | slice | Faire expirer les délégations (job de la ligne M1.09) | remplir ExpireDelegations |
M1.14 | identity | todo |
| M1.16 | identity | slice | Les relations suivent les adhésions et les délégations | port identity IdentityRelationships ; adapter identity IdentityRelationships ; event-handler identity Practice MemberAdded, ... Practice MemberRemoved, ... Delegation Granted, ... Delegation Revoked, ... Person Registered |
M1.10, M1.13, M1.14 | identity | todo |
| M1.17 | identity | slice | Répondre à l'annuaire des personnes | implémenter PersonDirectoryContract du langage publié |
M1.06, M1.11 | identity | todo |
| M1.18 | scheduling | slice | Les praticiens connus d'identity (projection) | integration-handler n'est pas utilisé : une @Projection dans application/projections/ sur identity.practice.member-added et .member-removed |
M1.04 | scheduling-calendar | todo |
| M1.19 | scheduling | slice | Créer un calendrier (squelette ambulant du cœur) | command scheduling CreateCalendar --aggregate Calendar --permission calendar.create ; route scheduling CreateCalendar --method POST --path /calendars |
M1.01, M1.05, M1.18 | scheduling-calendar | todo |
| M1.20 | scheduling | slice | Fixer les horaires d'ouverture, ajouter une exception, ajouter une indisponibilité, définir un type de rendez-vous | command scheduling SetOpeningHours --aggregate Calendar --permission calendar.set-opening-hours et sa route PUT /calendars/:calendarId/opening-hours ; AddException (POST /calendars/:calendarId/exceptions) ; AddTimeOff (POST /calendars/:calendarId/time-off) ; DefineAppointmentType (POST /calendars/:calendarId/appointment-types) ; objets-valeurs TimeZone, Range, OpeningHours, Exception, TimeOff, AppointmentType, BookingWindow, Slot |
M1.19 | scheduling-calendar | todo |
| M1.21 | scheduling | slice | Les relations suivent les calendriers et les rendez-vous | port scheduling SchedulingRelationships ; adapter scheduling SchedulingRelationships ; event-handler scheduling Calendar Created ; event-handler scheduling Appointment Booked |
M1.10, M1.19 | scheduling-calendar (calendrier), scheduling-appointment (rendez-vous) | todo |
| M1.22 | scheduling | slice | Réserver un rendez-vous (avec le Scheduler) | domain-service scheduling Scheduler ; command scheduling BookAppointment --aggregate Appointment --permission appointment.book ; route scheduling BookAppointment --method POST --path /appointments |
M1.20 | scheduling-appointment | todo |
| M1.23 | scheduling | slice | Exactement une réservation sur deux concurrentes | contrainte d'exclusion dans la table des rendez-vous ; spec d'intégration avec deux transactions concurrentes | M1.22 | scheduling-appointment | todo |
| M1.24 | scheduling | slice | Confirmer, annuler, déplacer | command scheduling ConfirmAppointment --aggregate Appointment --permission appointment.confirm (POST /appointments/:appointmentId/confirmation) ; CancelAppointment (POST /appointments/:appointmentId/cancellation) ; RescheduleAppointment (POST /appointments/:appointmentId/reschedule) ; politiques de la ligne M1.08 |
M1.22 | scheduling-appointment | todo |
| M1.25 | scheduling | slice | Terminer, marquer une absence, faire expirer les non confirmés | command scheduling CompleteAppointment --aggregate Appointment --permission appointment.complete (POST /appointments/:appointmentId/completion) ; MarkAppointmentNoShow --permission appointment.mark-no-show (POST /appointments/:appointmentId/no-show) ; remplir ExpireUnconfirmedAppointments |
M1.22 | scheduling-appointment | todo |
| M1.26 | scheduling | slice | Modèle de lecture de l'agenda (projection des propres événements du contexte) et ses recherches | @Projection dans application/projections/ ; query scheduling SearchAppointments --permission appointment.search --search (GET /appointments) ; query scheduling SearchPracticeAgenda --permission agenda.read --search (GET /practices/:practiceId/agenda) |
M1.22 | scheduling-appointment | todo |
| M1.27 | scheduling | slice | Détail d'un rendez-vous, hydraté avec le nom du patient | query scheduling GetAppointment --permission appointment.read (GET /appointments/:appointmentId) ; remplir la gateway de la ligne M1.06 |
M1.06, M1.22 | scheduling-appointment | todo |
| M1.28 | scheduling | slice | Jour d'un calendrier, vue partagée (occupé sans le nom) | query scheduling GetCalendarDay --permission calendar.browse (GET /calendars/:calendarId/days/:day) |
M1.20, M1.26 | scheduling-calendar | todo |
| M1.29 | scheduling | slice | Liste d'attente : la rejoindre, proposer un créneau libéré, la réservation provisoire expire | command scheduling JoinWaitlist --aggregate Waitlist --permission waitlist.join (POST /calendars/:calendarId/waitlist) ; command scheduling OfferFreedSlot --aggregate Waitlist --permission waitlist.offer ; event-handler scheduling Appointment Cancelled, ... Appointment Expired, ... Appointment Rescheduled |
M1.24, M1.25 | scheduling-calendar | todo |
| M1.30 | scheduling | slice | Répondre à l'export des rendez-vous | implémenter AppointmentExportContract du langage publié |
M1.07, M1.26 | scheduling-appointment | todo |
| M1.31 | notification | slice | Les coordonnées connues d'identity (projection) | @Projection sur identity.person.registered |
M1.04 | notification | todo |
| M1.32 | notification | slice | Envoyer une notification pour un fait d'un rendez-vous | port notification Mailer ; adapter notification Mailer --kind external --decorators ; command notification SendNotification --aggregate Notification --permission notification.send ; integration-handler notification scheduling scheduling.appointment.booked, .confirmed, .rescheduled, .cancelled |
M1.03, M1.05, M1.31 | notification | todo |
| M1.33 | notification | slice | Planifier, retirer et envoyer les rappels | command notification PlanReminder --aggregate Reminder --permission reminder.plan ; command notification WithdrawReminder --aggregate Reminder --permission reminder.withdraw ; consommateurs de booked, rescheduled, cancelled, expired ; remplir SendDueReminders |
M1.32 | notification | todo |
| M1.34 | notification | slice | Les notifications envoyées à une personne | query notification SearchNotifications --permission notification.read --search (GET /notifications) |
M1.32 | notification | todo |
| M1.35 | analytics | slice | Issues des rendez-vous (projection) et occupation par jour (la projection de l'occupation a été remplacée après la livraison, voir la note de M1.35) | deux modèles de lecture @Projection sur les événements de la ligne M1.05 ; port analytics ... selon les besoins |
M1.05 | analytics | todo |
| M1.36 | analytics | slice | Lire l'occupation | query analytics SearchOccupancy --permission occupancy.read --search (GET /practices/:practiceId/occupancy) |
M1.35 | analytics | todo |
| M1.37 | analytics | slice | Vérifier l'occupation chaque nuit (remplacé après la livraison, voir la note de M1.37) ; reconstruire les issues à partir de scheduling | remplir la gateway de la ligne M1.07 ; une spec qui exécute ProjectionRebuild |
M1.07, M1.35 | analytics | todo |
| M1.38 | all | slice | Une réservation, une trace, à travers le worker | worker ; spec de bout en bout qui vérifie l'arbre des spans, les champs des journaux, les entrées d'audit, le rapport d'erreur |
M1.22, M1.32, M1.35 | conductor | todo |
| M1.39 | all | slice | Exécution réelle | docker compose, scripts/demo.sh |
M1.38 | conductor | todo |
Les règles de chaque tranche
Section intitulée « Les règles de chaque tranche »- #M1.11 : une personne s'enregistre elle-même : l'identifiant de la personne est celui de l'acteur ; s'enregistrer deux fois met à jour le nom et les coordonnées et n'annonce rien de nouveau.
- #M1.12 : seul l'administrateur du réseau ouvre un cabinet, dans ce réseau (ADR-0003) ; le fuseau horaire est un fuseau IANA ; le premier responsable doit être une personne enregistrée ; un fuseau inconnu est refusé (
UNKNOWN_TIME_ZONE). - #M1.13 : un membre est une personne enregistrée avec un rôle par cabinet (responsable, praticien, assistant) ; ajouter deux fois est refusé (
ALREADY_MEMBER) ; le dernier responsable ne peut pas être retiré (LAST_MANAGER) ; retirer un membre révoque ses délégations, données et reçues (causemember-removed). - #M1.14 : le praticien et l'assistant sont des membres du cabinet avec ces rôles (
NOT_A_PRACTITIONER,NOT_AN_ASSISTANT) ; une fin dans le passé est refusée (DELEGATION_ENDS_IN_THE_PAST) ; une délégation active par paire ; révoquer deux fois est refusé (DELEGATION_NOT_ACTIVE) ; la délégation doit appartenir au poste du chemin. - #M1.15 : idempotent ; l'instant vient du
scheduledAtdu job. - #M1.16 : des tuples, dans l'unité de travail de la commande :
practice:<id>#<role>@user:<person>; pour un praticiendesk:<practice>.<person>#holder@user:<person>etdesk:...#practice@practice:<id>; pour une délégationdesk:<practice>.<practitioner>#delegate@user:<assistant>et, quand les disponibilités sont comprises,#availability_delegate;person:<id>#self@user:<id>. Retirés quand le fait prend fin. - #M1.19 : le praticien doit être connu dans le cabinet (
UNKNOWN_PRACTITIONER) ; le calendrier prend le fuseau horaire du cabinet ; valeurs par défaut : préavis 2 h, horizon 90 jours, limite 3. - #M1.20 : les plages d'un jour ne se chevauchent pas et finissent après avoir commencé (
INVALID_RANGE) ; une exception remplace son jour ; une indisponibilité qui couvre un rendez-vous actif est refusée (TIME_OFF_OVER_APPOINTMENTS) ; la durée et la grille sont des minutes positives, la grille divise 24 h. - #M1.22 : créneau sur la grille de son type, dans une seule plage d'ouverture de son jour en heure murale du cabinet (jours de changement d'heure testés en Europe/Paris), pas dans une indisponibilité, dans la fenêtre de réservation (
OUTSIDE_AVAILABILITY,OFF_GRID,BOOKING_TOO_LATE,BOOKING_TOO_FAR) ; aucun chevauchement avec un rendez-vous actif, battement compris (SLOT_TAKEN, répondu 409) ; au plus N rendez-vous futurs actifs de ce patient avec ce praticien (PATIENT_LIMIT_REACHED) ; un type qui demande une confirmation donne un rendez-vous demandé avec une échéance. - #M1.23 : la contrainte d'exclusion de PostgreSQL tranche entre deux transactions concurrentes ; la perdante reçoit
SLOT_TAKEN(409), pas une 500. - #M1.24 : un patient annule ou déplace jusqu'à 24 h avant le début (politiques ; le code du refus est le nom de la politique) ; le cabinet annule à tout moment avec un motif (
REASON_REQUIRED) ; déplacer est un seul changement d'agrégat, contrôlé comme une réservation, le rendez-vous étant ignoré dans son propre contrôle de chevauchement ; un rendez-vous fini ne change plus (APPOINTMENT_ENDED). - #M1.25 : terminé et absence seulement après le début (
APPOINTMENT_NOT_STARTED) ; l'expiration est idempotente et prend son instant descheduledAt. - #M1.26 : les recherches sont restreintes dans la requête SQL par le périmètre d'accès, paginées et filtrées avec les critères du kit (
filter[...],sort) ; l'agenda d'un cabinet est refusé à qui n'est pas membre de ce cabinet et restreint aux calendriers que l'acteur tient (run) ; dans la vue du jour, un créneau occupé que l'acteur n'a pas le droit de lire s'affiche comme occupé sans le patient. - #M1.27 : les recherches sont restreintes dans la requête SQL par le périmètre d'accès, paginées et filtrées avec les critères du kit (
filter[...],sort) ; l'agenda d'un cabinet est refusé à qui n'est pas membre de ce cabinet et restreint aux calendriers que l'acteur tient (run) ; dans la vue du jour, un créneau occupé que l'acteur n'a pas le droit de lire s'affiche comme occupé sans le patient. - #M1.28 : les recherches sont restreintes dans la requête SQL par le périmètre d'accès, paginées et filtrées avec les critères du kit (
filter[...],sort) ; l'agenda d'un cabinet est refusé à qui n'est pas membre de ce cabinet et restreint aux calendriers que l'acteur tient (run) ; dans la vue du jour, un créneau occupé que l'acteur n'a pas le droit de lire s'affiche comme occupé sans le patient. - #M1.29 : une liste d'attente par calendrier et par jour, ordre d'arrivée, une personne en attente une seule fois ; un créneau libéré va à la première personne en attente dont le type lui convient, comme un rendez-vous demandé retenu 30 minutes ; quand il expire, la personne suivante.
- #M1.32 : une notification par événement consommé et par destinataire (idempotente par identifiant d'événement) ; le mailer fait l'objet de nouvelles tentatives, puis l'événement part en file de rejet et est signalé.
- #M1.33 : un rappel par rendez-vous et par début, dû 24 h avant ; un rendez-vous déplacé en reçoit un nouveau ; l'envoi est idempotent par occurrence.
- #M1.35 : une issue porte l'état qu'elle pose (les rejeux et les livraisons dans le désordre aboutissent à la même ligne) ; l'occupation d'un calendrier et d'un jour est recalculée à partir des issues.
- #M1.35 : remplacée après la livraison (2026-10-10, product owner) : le second modèle de lecture, une ligne stockée par calendrier et par jour recomptée à chaque événement, a disparu. Une ligne par fait, calculée à la lecture : les issues sont la seule chose stockée, et
SearchOccupancyles mesure dans une seule requête SQL groupée par le portOccupancyReader. Raison : un chiffre stocké demandait un traitement particulier des événements dans le désordre et une réparation nocturne, tout cela pour garder une copie égale à ce que les issues disent déjà. - #M1.37 : remplacée en partie après la livraison (2026-10-10, product owner) :
VerifyOccupancy, son jobanalytics.verify-occupancy, sa permissionoccupancy.verifyet l'octroi à son acteur système sont retirés. Raison : ils existaient pour réparer les chiffres stockés de la ligne M1.35, et plus rien n'est stocké. La reconstruction des issues à partir de l'export deschedulingreste. - #M1.36 : restreinte aux calendriers que l'acteur mesure (le responsable du cabinet : tous ; un praticien : les siens) ; un autre cabinet est refusé.
Les permissions et l'élément sur lequel elles portent
Section intitulée « Les permissions et l'élément sur lequel elles portent »Chaque commande et chaque requête nomme sa permission et, dans son @Requires(..., { resource }),
l'élément sur lequel porte le droit, tel que le schéma des relations de src/platform/auth/ le
connaît. Une permission absente de cette liste est réservée aux acteurs système (jobs et
consommateurs : ressource { type: 'context', id: '<context>' }, telle que générée).
| Permission | Ressource de l'exigence | Qui la détient |
|---|---|---|
identity:person.register |
contexte (valeur par défaut générée) | toute personne connectée (jeton) |
identity:practice.open |
contexte | rôle network-admin (jeton) |
identity:member.add, identity:member.remove |
practice:<practiceId> |
les responsables du cabinet |
identity:delegation.grant, identity:delegation.revoke |
desk:<practiceId>.<practitionerId> |
le praticien du poste, les responsables du cabinet |
scheduling:calendar.create |
desk:<practiceId>.<practitionerId> |
le praticien du poste, les responsables du cabinet |
scheduling:calendar.set-opening-hours, .add-exception, .add-time-off, .define-appointment-type |
calendar:<calendarId> |
le praticien, les délégués dont la délégation comprend les disponibilités, les responsables |
scheduling:calendar.browse |
calendar:<calendarId> |
toute personne connectée (jeton) ; ce qu'elle voit de chaque créneau dépend de appointment.read |
scheduling:appointment.book, scheduling:waitlist.join |
calendar:<calendarId>, avec context: { selfService: <the patient is the actor> } |
rôle patient (jeton) pour soi-même ; le praticien, les délégués et les responsables pour n'importe qui |
scheduling:appointment.read |
appointment:<appointmentId> |
le patient du rendez-vous ; qui tient son calendrier (run) |
scheduling:appointment.confirm, .cancel, .reschedule |
appointment:<appointmentId> |
les mêmes, puis les politiques du préavis du patient |
scheduling:appointment.complete, .mark-no-show |
appointment:<appointmentId> |
qui tient son calendrier (run) |
scheduling:appointment.search |
contexte | toute personne connectée ; la recherche est restreinte par Access.scope(actor, appointment.read, 'appointment') |
scheduling:agenda.read |
practice:<practiceId> |
les membres du cabinet ; restreint par Access.scope(actor, agenda.read, 'calendar') aux calendriers qu'ils tiennent (run) |
notification:notification.read |
contexte | toute personne connectée ; restreint par Access.scope(actor, notification.read, 'person') à elle-même |
analytics:occupancy.read |
practice:<practiceId> |
les membres du cabinet ; restreint par Access.scope(actor, occupancy.read, 'calendar') aux calendriers qu'ils mesurent (les leurs ; tous pour un responsable) |
audit:trail.read |
(plateforme) | rôle platform-admin, lu par une élévation sur les réseaux |
Les relations écrites par les contextes (par un port à eux, dans l'unité de travail de la
commande, jamais par le domaine) : voir la règle M1.16 pour identity ; scheduling écrit
calendar:<id>#desk@desk:<practiceId>.<practitionerId>, calendar:<id>#practice@practice:<practiceId>,
appointment:<id>#patient@user:<patientId> et appointment:<id>#calendar@calendar:<calendarId>.