Aller au contenu

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
  • #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 (cause member-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 scheduledAt du job.
  • #M1.16 : des tuples, dans l'unité de travail de la commande : practice:<id>#<role>@user:<person> ; pour un praticien desk:<practice>.<person>#holder@user:<person> et desk:...#practice@practice:<id> ; pour une délégation desk:<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 de scheduledAt.
  • #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 SearchOccupancy les mesure dans une seule requête SQL groupée par le port OccupancyReader. 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 job analytics.verify-occupancy, sa permission occupancy.verify et 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 de scheduling reste.
  • #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>.