transaction の途中で書き込みが失敗すると、transaction は取り消され(rollback)、そこまでの書き込みは破棄されます。防止できる事故は、監査記録の保存だけが失敗して、予約だけが診察中になることです。
状態と監査記録を1回で保存する
修正後: 監査記録の保存に失敗
storeAtomicallyが transaction を開始します。- 予約を再度取得します。
CheckedInであるため先へ進みます。 saveStateが状態を書き込みます。まだ未確定です。appendAuditが書き込みに失敗し、AppointmentPersistenceErrorを投げます。- 例外で transaction が取り消され、未確定だった状態の行も消えます。予約は
CheckedInのままで、監査記録もありません。 ResultAsyncの内側の Promise(非同期処理の結果を表す値)が reject(非同期処理が例外で終わること)すると、結果はOkにもErrにもならず、awaitした場所で例外になります。状態だけが残ることはありません。
呼び出し元のコード
examples/session-06/src/useCase/startExamination.ts:69-70 呼び出し元 await deps.stateStore. save(event.aggregateState);
await deps.eventLog. append(event); examples/session-06-solution/src/useCase/startExamination.ts:89 呼び出し元 .andThrough(deps.examinationStartedStore.store) 実装のコード
examples/session-06/src/adaptor/secondary/sqlite/appointmentStore.ts:182, 100-102 実装 save: async (appointment) => saveState(database, appointment),
…
executor
.insert(appointmentsTable)
.values(row) examples/session-06/src/adaptor/secondary/sqlite/appointmentStore.ts:185, 118, 120 実装 append: async (event) => appendAudit(database, event),
…
executor. insert(auditLogsTable). values(toAuditRow(event)). run();
…
throw new AppointmentPersistenceError("append-audit", cause); examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:185-188 実装 store: (event) =>
ResultAsync. fromSafePromise(
Promise.resolve(). then(() => storeAtomically(event)),
). andThen((result) => result), examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:148-149 実装 const storeAtomically = (event: ExaminationStarted) =>
database. transaction((transaction) => {
… examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:150-151 実装 const current = findInTransaction(transaction, event.appointmentId);
if (current === undefined || current.kind !== "CheckedIn") {
… examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:158-161 実装 const committedEvent = Appointment. startExamination({
eventId: event.eventId,
occurredAt: event.occurredAt,
})(current, event.aggregateState.veterinarianId); examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:151-156 実装 if (current === undefined || current.kind !== "CheckedIn") {
return err({
kind: "AppointmentConflict",
appointmentId: event.appointmentId,
} as const);
} examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:163, 99-101, 106 実装 saveState(transaction, committedEvent.aggregateState);
…
executor
.insert(appointmentsTable)
.values(row)
…
.run(); examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:164, 117, 119 実装 appendAudit(transaction, committedEvent);
…
executor. insert(auditLogsTable). values(toAuditRow(event)). run();
…
throw new AppointmentPersistenceError("append-audit", cause); examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:149, 165-166 実装 database. transaction((transaction) => {
…
return ok(undefined);
}); 「保存済み」ははじめからある行、「未確定」は transaction の中だけにある行、「確定」は書き込みが残った行です。