スタッフを 1 人削除した。続けて月間の AI シフト生成を開くと、候補の欄に、いま消した人が並んでいる。
そのまま生成して保存した。月間カレンダーに、削除したはずの人の勤務がずらりと入った。シフトを共有するページにも、同じ顔ぶれで載った。
自社のシフト管理 SaaS である Shift Bud を手元で動かし、この不具合を再現したときの様子だ。原因は、スタッフを読む側の条件の抜けだった。同じ穴は、論理削除を使う Web アプリならどこにでも開く。見つけ方と、逆に「削除済みも数えないといけない読み取り」の見分け方までを書く。
消す処理は丁寧で、読む側に条件が無かった
Shift Bud のスタッフ削除は論理削除で、行は消さずに deletedAt に日時を入れる。労働関係の記録には法定の保存期間があるので、既存のシフト(先の予定も含めて)には名前を写して残し、スタッフへの参照だけを外す。予約や休暇申請からの参照も外す。これを 1 つのトランザクションでやっている。消す側は手厚い。
ところが、スタッフ一覧・AI 生成の候補・人数の集計・シフトを作る前の存在確認が通る staff の repository は、どの読み取りも deletedAt を見ていなかった。同じ User テーブルを読む別の場所(ログインや課金の席数)は、ちゃんと絞っていた。
削除の処理が既存のシフトからその人への参照を残らず外した数秒後に、AI が新しいシフトをその人に結び直した。
論理削除にすると、外部キーは何も言わない
物理削除なら、こうはならない。いない人にシフトを作ろうとすれば、外部キーが止める。Prisma 7 と SQLite で両方を試した。
// 論理削除したあとで、その人にシフトを作る
await prisma.user.update({ where: { id }, data: { deletedAt: new Date() } });
await prisma.shift.create({ data: { date: '2026-12-01', staffId: id } });
| 削除のしかた | 削除した人へのシフト作成 |
|---|---|
物理削除(prisma.user.delete) | P2003(外部キー違反)で落ちる |
論理削除(deletedAt を入れる) | そのまま作られる |
DB から見れば、論理削除した人はまだいる。論理削除を選んだ時点で、外部キーがしていた「いない人を指させない」仕事は、アプリの読み取りに移る。論理削除は消す処理ではなく、その表を読むすべての場所に条件を足す約束だ。
Shift Bud には、書き込みの前に staffId を確かめる門番がもともとあった。外部キーは staffId の 1 列だけでテナントを見ないので、別のテナントのスタッフを指しても DB は通してしまう。それを弾くために置いたものだ。
門番の判定は、repository の読み取りそのものだ。だから読み取りを直すだけで、シフトの単体作成・一括保存・AI 生成の保存がすべて 404 で止まる。実際の修正もそうなった。
条件は 1 か所に置いて、全部の読み取りを通す
直し方は、有効な行の条件を repository の中の 1 か所に置き、読み取りは必ずそこを通すことだ。テナントの条件も同じ式に入れておくと、片方だけ書き忘れることがない。
import type { PrismaClient } from './generated/prisma/client';
export class StaffRepository {
constructor(private readonly prisma: PrismaClient) {}
// 有効なスタッフの条件。読み取りはすべてここを通す
private active(tenantId: string) {
return { tenantId, deletedAt: null };
}
findAll(tenantId: string) {
return this.prisma.user.findMany({
where: this.active(tenantId),
orderBy: { name: 'asc' },
});
}
findById(id: string, tenantId: string) {
return this.prisma.user.findFirst({ where: { id, ...this.active(tenantId) } });
}
async exists(id: string, tenantId: string) {
const n = await this.prisma.user.count({ where: { id, ...this.active(tenantId) } });
return n > 0;
}
// 例外: 一意制約は削除済みの行にも掛かるので、削除済みも数える
async emailExists(email: string, tenantId: string) {
const n = await this.prisma.user.count({ where: { email, tenantId } });
return n > 0;
}
}
メールの重複チェックだけが条件を通していないのはわざとで、理由は後の節に書く。
全クエリに自動で条件を足す手もある。Prisma なら Client extensions の query で user.findMany に割り込める。Prisma 7.10 で試すと、prisma.user.findMany() は確かに削除済みを返さなくなった。ところが prisma.shift.findMany({ include: { staff: true } }) で引いたスタッフは、削除済みのまま出てきた。自動にしても、関連から引く道は別に塞ぐ必要がある。
絞り忘れは、grep で候補を出し、対のテストで確かめる
見つけるのは 2 段でやる。まず、その表を読んでいるのに deletedAt が一度も出てこないファイルを洗い出す。user は自分のモデル名に、src はソースの場所に置き換える。
grep -rlE --include='*.ts' --exclude='*.test.ts' \
'\.user\.(findMany|findFirst|findFirstOrThrow|findUnique|findUniqueOrThrow|count|aggregate|groupBy)\(' src \
| xargs -r grep -L deletedAt
Shift Bud の修正前のコードで流すと、2 つのファイルが出た。1 つは今回の staff の repository。もう 1 つは紹介プログラムの「同じ人が自分を紹介していないか」の確認だ。このファイルは削除済みを除かずに比べている。問うているのは「同じ人か」で、削除した人の行も同じ人の記録なので、筆者はそれでよいと見て触らなかった。grep が出すのは候補で、答えではない。修正後に流すと、紹介の 1 ファイルだけが残る。xargs -r を外すと、候補が 0 件のときに GNU の xargs が (standard input) と出す。
grep はファイル単位なので、どこかに deletedAt があれば素通りする。ログインなどが使う user の repository では、一覧はオプションを渡さなければ削除済みを除くのに、同じファイルの件数のメソッドは渡さなければ数える。いまの呼び出し元は「除く」を渡しているので害はないが、grep には見えない。関連の include で引く読み取りも、grep の網には掛からない。
そこで 2 段目に、メソッド単位のテストを置く。削除済みかどうか以外は同じ 2 行を置いて、読み取りを全部呼ぶ。
import assert from 'node:assert/strict';
import { after, beforeEach, test } from 'node:test';
import { prisma } from './db'; // 自分の PrismaClient
import { StaffRepository } from './staff-repository';
const repo = new StaffRepository(prisma);
const tenantId = 't1';
// 削除済みかどうか以外は同じ 2 行を置く
beforeEach(async () => {
await prisma.shift.deleteMany();
await prisma.user.deleteMany();
await prisma.user.create({
data: { id: 'active', tenantId, name: 'A', email: 'a@example.com' },
});
await prisma.user.create({
data: { id: 'gone', tenantId, name: 'B', email: 'b@example.com', deletedAt: new Date() },
});
});
after(() => prisma.$disconnect());
test('読み取りは有効な行だけを返す', async () => {
assert.deepEqual((await repo.findAll(tenantId)).map((u) => u.id), ['active']);
assert.equal((await repo.findById('active', tenantId))?.id, 'active');
assert.equal(await repo.findById('gone', tenantId), null);
assert.equal(await repo.exists('active', tenantId), true);
assert.equal(await repo.exists('gone', tenantId), false);
});
test('emailExists だけは削除済みも数える', async () => {
assert.equal(await repo.emailExists('b@example.com', tenantId), true);
});
走らせるには tsx を入れて node --import tsx --test staff-repository.test.ts とする。有効な行の条件から deletedAt: null を外すと、1 本目が actual: [ 'active', 'gone' ] で落ちる。逆にメールの重複チェックまで有効な行の条件を通すと、2 本目が落ちる。絞り忘れと絞りすぎの両方を、このテストが止める。
直すと、古いテストが落ちることがある。Shift Bud では、予約の既存テストの 1 本が「削除済みスタッフでも名前を解決する(リファクタ前の挙動を保つ)」という名前だった。漏れていた挙動を、仕様として大事に守っていた。落ちたテストは、期待値を書き換える前に名前を読む。
削除済みも数える読み取りの見分け方
全部に条件を足せば終わり、ではない。読み取りが何を問うているかで決める。
| 読み取りの問い | 削除済みを | 例 |
|---|---|---|
| いま、いる人は誰か | 除く | 一覧、AI 生成の候補、人数の集計 |
| この ID に新しく紐付けてよいか | 除く | シフトを作る前の存在確認 |
| この値はもう使われているか | 含める | メールアドレスの重複チェック |
| 同じ人か | 含める | 自分で自分を紹介していないかの確認 |
メールの重複チェックを「含める」側に置くのは、DB の一意制約(テナントとメールの組)が削除済みの行にも掛かっているからだ。チェックだけ削除済みを除くと、チェックは「空いている」と答え、直後の作成が一意制約で落ちる。手元で試すと、チェックは 0 件を返し、作成は P2002 になった。用意しておいた「登録済みです」の案内は出ず、何が返るかは一意制約違反の扱い次第になる(拾っていなければサーバーエラー)。
裏返すと、削除した人と同じメールでは登録し直せない。登録し直せるようにしたいなら、アプリの条件ではなく DB の制約のほうを変える。PostgreSQL なら、WHERE "deletedAt" IS NULL を付けた部分一意インデックスで、有効な行の中だけを一意にできる。どちらを選ぶかは、辞めた人が戻ってくる業務かどうかで決まる。
自分でやれる範囲と、残る難所
grep を流して対のテストを置くところまでは、今日できる。読み取りが 1 つの repository に集まっていれば、条件を 1 か所に置く修正もすぐ終わる。
手間がかかるのは 2 つだ。1 つは、読み取りが repository の外に散っている構成。サービスから直接 ORM を呼ぶ箇所、関連の include、生の SQL は、どれも網から漏れやすい。もう 1 つは、直す前に作られたデータだ。削除した人を指したまま作られたシフトは、コードを直しても残る。Shift Bud ではこれを変換せず、名前の無いシフトとして表示されることを受け入れた。どれを直してどれを残すかは、コードではなく業務の判断になる。削除した人が発行済みのトークンで入ってくる問題も同じ根から生えていて、こちらは削除したユーザーの JWT を止める 3 方式の記事で比べた。
まとめ
- 論理削除にすると、外部キーは削除した行への参照を止めない。その仕事は、表を読むすべての場所の条件に移る
- 有効な行の条件は 1 か所に置き、grep で候補を出し、削除済みかどうかだけが違う 2 行のテストで読み取りごとに確かめる
- 「いまいるか」を問う読み取りは削除済みを除き、「その値は使われたか」を問う読み取り(一意制約の事前チェックなど)は含める
削除済みを数えるかどうかは、外部キーも ORM の拡張も代わりに決めてくれない。読み取りごとに、それが「いまいるか」を問うのか「もう使われたか」を問うのかを決めて、条件に書く。



