はじめに

「累計が目標を超えた瞬間に達成イベントを出す」という処理を実装していたところ、同じ日の記録を編集しただけで、未達成のはずなのに達成扱いになる不具合に遭遇しました。

原因は、保存は「上書き」なのに、達成判定だけが「加算」前提で計算していたことです。
この記事では、その再現条件と、置き換え方式で直す実装、そしてテストの書き方をまとめます。

こんな人におすすめ

  • 日別・ユーザー別のレコードを UPSERT で保存している方
  • 保存前に「この更新で閾値を跨ぐか」をメモリ上で予測している方
  • 達成バッジやマイルストーン通知のような一度きりのイベントを実装している方
  • モックを使った単体テストが、本当にバグを検出できているか不安な方

何が起きていたのか

日別のレコードは、次のように同じキー(ユーザー・項目・日付)で衝突したら値を置き換える形で保存していました。

INSERT INTO daily_logs (user_id, item_id, log_date, count)
VALUES (?, ?, ?, ?)
ON CONFLICT (user_id, item_id, log_date)
DO UPDATE SET count = excluded.count;

一方、達成判定は「更新前の累計 + 今回の値」を in-memory で計算していました。

// 問題のあるコード(加算前提)
const after = { ...before, currentCount: before.currentCount + safeCount }

目標が 100 で、累計 80 がすべて当日分だったとします。
この日の値を 90 に直すと、DB 上の正しい累計は 90 で、未達成のままです。
しかし加算前提だと 80 + 90 = 170 となり、目標を跨いだと誤判定して達成イベントが出てしまいます。

ポイントは、更新前の累計(before)に「この日の既存値」という自分自身の寄与がすでに含まれていることです。
新規登録なら加算で正しく、同じ日の再編集になった瞬間に壊れるので、気づきにくい不具合でした。

置き換え方式で書き直す

永続化が置き換えなら、見込み値の計算も置き換えで書きます。
「更新前の累計からその日の既存値を引き、新しい値を足す」を小さな純粋関数にまとめました。

type Snapshot = { currentCount: number }

function findDayCount(
  rows: Array<{ item_id: number; count: number }>,
  itemId: number,
): number {
  const row = rows.find((r) => Number(r.item_id) === Number(itemId))
  return row ? toNonNegativeInteger(row.count) : 0
}

function replaceDayCount(
  before: Snapshot,
  previousDayCount: number,
  nextDayCount: number,
): Snapshot {
  return {
    ...before,
    currentCount: Math.max(0, before.currentCount - previousDayCount) + nextDayCount,
  }
}

findDayCount は当日のレコード群から対象項目の既存値を探し、無ければ 0 を返します。
replaceDayCount で差し引いたあとに Math.max(0, ...) で下限を 0 に揃えているのは、データ不整合があっても累計が負にならないようにする防御です。

取得は Promise.all で並列化する

既存値を取るために当日レコードを読む必要がありますが、累計スナップショットとは互いに独立しています。
そのため Promise.all に相乗りさせれば、追加のレイテンシはほとんど出ません。

const [beforeSnapshot, dayRows] = await Promise.all([
  getSnapshot(db, userId, itemId),
  listRowsByDate(db, userId, logDate),
])

const after = replaceDayCount(
  beforeSnapshot,
  findDayCount(dayRows, itemId),
  safeCount,
)

この「前の値を引いて新しい値を足す」を 1 か所に閉じ込めておくと、単発の編集と、別日の記録をコピーする処理の両方から再利用できます。
コピーも「コピー先へ上書き」なので、コピー先に既存値があれば同じように差し引く必要があるためです。

テストは「跨がない」と「跨ぐ」の両方を書く

テストでは、誤検知を防ぐケースだけでなく、本当に跨ぐケースが検出され続けることも固定します。

import { describe, it, expect } from 'vitest'

describe('replaceDayCount', () => {
  it('同じ日を 80 → 90 に直しても目標 100 は未達成のまま', () => {
    const after = replaceDayCount({ currentCount: 80 }, 80, 90)
    expect(after.currentCount).toBe(90)
    expect(after.currentCount >= 100).toBe(false)
  })

  it('同じ日を 80 → 120 に直すと実際に目標を跨ぐ', () => {
    const after = replaceDayCount({ currentCount: 80 }, 80, 120)
    expect(after.currentCount >= 100).toBe(true)
  })

  it('不整合で既存値が累計より大きくても負にならない', () => {
    const after = replaceDayCount({ currentCount: 10 }, 50, 5)
    expect(after.currentCount).toBe(5)
  })
})

もう一点、モックの粒度にも注意が必要でした。
全日付で同じ値を返すモックだと、コピー元とコピー先を取り違えていてもテストが通ってしまいます。
日付引数によって返り値を分けるモックに直すことで、取り違えを検出できるようになりました。

const listRowsByDate = vi.fn(async (_db, _userId, date: string) =>
  date === '2026-11-10' ? [{ item_id: 1, count: 80 }] : [],
)

つまづきやすいポイント

  • 新規登録では再現しません: 既存値が 0 なら加算でも置き換えでも同じ結果になるため、同じ日の再編集まで試さないと見つかりません
  • コピー・インポート系も対象です: 上書きコピーは編集と同じ構造なので、コピー先の既存値を差し引き忘れると同じ不具合が出ます
  • 並列取得でも順序を意識してください: Promise.all の結果は渡した順に返りますが、取り違えないよう分割代入の名前を明確にしておくと安全です
  • 同時リクエストには別の対策が要ります: before が古くなる競合は置き換え方式でも残るため、必要なら楽観ロックなどを検討してください

まとめ

DB 側が UPSERT(置換)なら、メモリ上の「更新後の値」の予測も置換で書くのが基本です。
before に自分自身の寄与が含まれていることを忘れると、同じ日を直すたびに累計がずれます。
差し引きを小さな純粋関数に閉じ込め、「跨がない」「跨ぐ」の両ケースをテストで固定しておくと、再発を防ぎやすくなります。