@aiquants/daily-report 0.7.0 → 0.9.0

package/src/server/service.ts

@@ -419,6 +419,45 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
         }))
     }
 
+    /**
+     * Fetches only the first page of report ids for time-to-first-render (uncached).
+     * 最初の描画までの時間専用に、ID 一覧の先頭ページだけを取得する内部処理 (キャッシュ無し)。
+     *
+     * `ids-stream` の新規接続でキャッシュミスした場合、全量クエリの確定を待たずに
+     * この軽量クエリ (TOP n・インデックス順で n 行走査した時点で打ち切り) の結果を
+     * 最初のチャンクとして送出する。可視性述語と並び順は全量クエリと完全同一。
+     * `.top(n)` は `.select()` の直後でなければならない (drizzle-mssql の構造的制約)。
+     *
+     * @param externalId External user id. 外部ユーザー ID。
+     * @param limit Page size. ページサイズ。
+     * @returns First-page items in stream order. ストリーム順の先頭ページ。
+     */
+    const getDailyReportIdsFirstPageByExternalId = async (externalId: string, limit: number): Promise<DailyReportItem[]> => {
+        const userId = await getUserIdByExternalId(externalId)
+        if (!userId) {
+            return []
+        }
+        const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
+        const draftLabelJoinIds = await getDraftLabelJoinIds()
+
+        const result = await db
+            .select<{ reportHubId: number; businessDate: Date | string | null; sourceType: string }>({
+                reportHubId: DailyReportHub.id,
+                businessDate: DailyReportHub.businessDate,
+                sourceType: DailyReportHub.sourceType,
+            })
+            .top(limit)
+            .from(DailyReportHub)
+            .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
+            .where(and(isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DailyReportHub.userId), isNull(DraftLabelRelation.hubId))))
+            .orderBy(desc(DailyReportHub.businessDate), desc(DailyReportHub.id))
+
+        return result.map((item) => ({
+            ...item,
+            businessDate: formatDateValue(item.businessDate, "YYYY-MM-DD"),
+        }))
+    }
+
     /**
      * Fetches daily report details for the provided business date.
      * 指定した営業日の日報詳細を取得する内部処理。
@@ -1114,15 +1153,50 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
         return updatedStatus
     }
 
+    /**
+     * Resolves the SSE recipient for comment events on a possibly-draft report.
+     * 下書きの可能性がある日報のコメントイベントについて SSE の宛先を解決する処理。
+     *
+     * 下書きは所有者にしか見えないため、下書きラベルが付いている間はコメント本文も
+     * 所有者だけに配信する (無指定だと本文が全ユーザーへブロードキャストされる)。
+     * 公開済み (下書きラベル無し) は全員配信 = undefined を返す。
+     *
+     * @param hubId Parent hub id. 親日報の hub ID。
+     * @param ownerUserId Hub owner's raw user id. 所有者の内部ユーザー ID。
+     * @returns Recipient raw user id, or undefined to broadcast. 宛先 (全員配信は undefined)。
+     */
+    const resolveCommentRecipient = async (hubId: number, ownerUserId: number | null): Promise<number | undefined> => {
+        // 所有者不明 (共有日報など) は従来どおり全員配信
+        if (ownerUserId === null) return undefined
+        const draftIds = await getDraftLabelJoinIds()
+        const [rel] = await db
+            .select<{ hubId: number }>({ hubId: DailyReportHub_Label.hubId })
+            .top(1)
+            .from(DailyReportHub_Label)
+            .where(and(eq(DailyReportHub_Label.hubId, hubId), inArray(DailyReportHub_Label.labelId, draftIds)))
+        return rel ? ownerUserId : undefined
+    }
+
     /**
      * Adds a comment to a daily report.
      * 日報にコメントを追加する。
      */
     const addComment = async (userId: number, reportHubId: number, content: string, businessDate: string | null, clientTempId: string): Promise<DailyReportCommentItem> => {
-        const [hub] = await db.select<{ sourceType: string }>({ sourceType: DailyReportHub.sourceType }).top(1).from(DailyReportHub).where(eq(DailyReportHub.id, reportHubId))
-        if (hub && hub.sourceType.toLowerCase() !== "internal") {
+        const [hub] = await db
+            .select<{ sourceType: string; deletedAt: Date | string | null; userId: number | null }>({ sourceType: DailyReportHub.sourceType, deletedAt: DailyReportHub.deletedAt, userId: DailyReportHub.userId })
+            .top(1)
+            .from(DailyReportHub)
+            .where(eq(DailyReportHub.id, reportHubId))
+        // 存在しない / 論理削除済みの日報にはコメントを付けない (以前は hub 未取得でも
+        // フォールスルーして孤児コメントを INSERT していた)
+        if (!hub || hub.deletedAt) {
+            throw new Error("Not Found")
+        }
+        if (hub.sourceType.toLowerCase() !== "internal") {
             throw new Error("Comments are restricted for external daily report sources")
         }
+        // 下書きなら SSE を所有者宛に絞る (本文の全員配信を防ぐ)
+        const recipientRawUserId = await resolveCommentRecipient(reportHubId, hub.userId)
 
         const [inserted] = await db
             .insert<DailyReportCommentRow>(DailyReportCommentModel)
@@ -1167,6 +1241,7 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
                 reportHubId: reportHubId,
                 comment: commentItem,
                 clientTempId,
+                recipientRawUserId,
             }),
             "addComment",
         )
@@ -1194,6 +1269,15 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
         if (comments[0].userId !== userId) {
             throw new Error("Unauthorized")
         }
+        // 渡された reportHubId がコメントの実際の所属と一致することを確認する。
+        // 不一致のまま進むと、無関係な日報のキャッシュ無効化と SSE 配信を引き起こす
+        if (comments[0].hubId !== reportHubId) {
+            throw new Error("Not Found")
+        }
+
+        // 下書きなら削除イベントも所有者宛に絞る (comment-add と対称)
+        const [hubForDelete] = await db.select<{ userId: number | null }>({ userId: DailyReportHub.userId }).top(1).from(DailyReportHub).where(eq(DailyReportHub.id, reportHubId))
+        const recipientRawUserId = await resolveCommentRecipient(reportHubId, hubForDelete?.userId ?? null)
 
         await db.delete(DailyReportCommentModel).where(eq(DailyReportCommentModel.id, commentId))
 
@@ -1215,6 +1299,7 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
                 reportHubId: reportHubId,
                 commentId,
                 clientTempId,
+                recipientRawUserId,
             }),
             "deleteComment",
         )
@@ -1465,9 +1550,20 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
             }
         })
 
-        // キャッシュ無効化
+        // キャッシュ無効化: 一覧プレビューは詳細キャッシュから引くため、詳細を全プロセス横断で落とす。
+        // 以前は読み取りに使われないプレフィックスを無効化し epoch も上げていなかったため、
+        // 編集後の件名/本文が他ワーカーで古いまま配信されていた
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
         sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
         sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
+        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
+        // 編集内容は全ユーザーの一覧に映るため、営業日別一覧は全ユーザー分 + 全ワーカー横断で
+        // 無効化する (addComment と同じ流儀。編集者本人のキーだけでは他者へ古い件名が残る)
+        const editedBusinessDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
+        if (editedBusinessDate) {
+            sqlResultCache.invalidatePrefix(`daily-report:date:${editedBusinessDate}:user:`)
+            await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${editedBusinessDate}`)
+        }
 
         const fullDetail = await getDailyReportDetailById(reportHubId, userId, { forceRefresh: true })
         if (fullDetail) {
@@ -1600,6 +1696,7 @@ export function createDailyReportService(config: DailyReportServiceConfig) {
         getUserIdByExternalId,
         // 参照系
         getDailyReportIdsByExternalId,
+        getDailyReportIdsFirstPageByExternalId,
         getDailyReportsByBusinessDate,
         getDailyReportsByBusinessDateByExternalId,
         getDailyReportDetailById,

package/src/server/test-helpers/handlers-config.ts

@@ -51,15 +51,31 @@ export type HandlersFixtureOptions = {
     attachmentRateLimitPerMinute?: number
     /** 同時実行上限。 */
     attachmentConcurrency?: number
+    /** `intent=clearCache` (開発用の全キャッシュ破棄) を許可するか。 */
+    enableDevCacheClear?: boolean
+    /** ids ストリームが返すアイテム一覧 (ストリーム順で渡す)。 */
+    idsStreamItems?: Array<{ reportHubId: number; businessDate: string | null; sourceType?: string }>
+    /** ids 取得 (全量・先頭ページの両方) を失敗させるエラー。 */
+    idsStreamError?: Error
+    /** 全量クエリの解決を保留にする Promise (高速先頭ページ経路の検証用)。 */
+    idsStreamFullGate?: Promise<void>
+    /** 先頭ページの結果を上書きする (既定は idsStreamItems の先頭スライス)。 */
+    idsStreamFirstPageItems?: Array<{ reportHubId: number; businessDate: string | null; sourceType?: string }>
 }
 
 /** 呼び出し記録。テストが副作用を検証するために使う。 */
 export type HandlersFixtureCalls = {
+    /** `service.clearCache` の呼び出し回数。 */
+    clearCache: number
     /** `service.getAttachmentForUser` が受け取った `(attachmentId, viewerUserId)`。 */
     getAttachmentForUser: Array<[number, number]>
     readAttachment: Array<{ filePath: string; maxBytes: number; head: boolean; principal?: string }>
     markAttachmentMissing: number[]
     markAttachmentPresent: number[]
+    /** `service.getDailyReportIdsByExternalId` が受け取った `(externalId, forceRefresh)`。 */
+    getDailyReportIds: Array<[string, boolean]>
+    /** `service.getDailyReportIdsFirstPageByExternalId` が受け取った `(externalId, limit)`。 */
+    getDailyReportIdsFirstPage: Array<[string, number]>
 }
 
 /**
@@ -70,7 +86,7 @@ export type HandlersFixtureCalls = {
  * @returns The config and its call log. 設定と呼び出し記録。
  */
 export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { config: DailyReportHandlersConfig; calls: HandlersFixtureCalls } => {
-    const calls: HandlersFixtureCalls = { getAttachmentForUser: [], readAttachment: [], markAttachmentMissing: [], markAttachmentPresent: [] }
+    const calls: HandlersFixtureCalls = { clearCache: 0, getAttachmentForUser: [], readAttachment: [], markAttachmentMissing: [], markAttachmentPresent: [], getDailyReportIds: [], getDailyReportIdsFirstPage: [] }
 
     const user = options.user === undefined ? { id: TEST_EXTERNAL_USER_ID } : options.user
     const internalUserId = options.internalUserId === undefined ? TEST_INTERNAL_USER_ID : options.internalUserId
@@ -79,6 +95,20 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
 
     const service = {
         getUserIdByExternalId: async () => internalUserId,
+        clearCache: async () => {
+            calls.clearCache += 1
+        },
+        getDailyReportIdsByExternalId: async (externalId: string, opts?: { forceRefresh?: boolean }) => {
+            calls.getDailyReportIds.push([externalId, opts?.forceRefresh ?? false])
+            if (options.idsStreamError) throw options.idsStreamError
+            if (options.idsStreamFullGate) await options.idsStreamFullGate
+            return options.idsStreamItems ?? []
+        },
+        getDailyReportIdsFirstPageByExternalId: async (externalId: string, limit: number) => {
+            calls.getDailyReportIdsFirstPage.push([externalId, limit])
+            if (options.idsStreamError) throw options.idsStreamError
+            return options.idsStreamFirstPageItems ?? (options.idsStreamItems ?? []).slice(0, limit)
+        },
         getAttachmentForUser: async (attachmentId: number, viewerUserId: number) => {
             // 引数を記録する。記録しないと「閲覧者 ID を渡し忘れた」欠陥がテストに映らない
             calls.getAttachmentForUser.push([attachmentId, viewerUserId])
@@ -101,6 +131,7 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
         attachmentMaxBytes: options.attachmentMaxBytes,
         attachmentRateLimitPerMinute: options.attachmentRateLimitPerMinute,
         attachmentConcurrency: options.attachmentConcurrency,
+        enableDevCacheClear: options.enableDevCacheClear,
     }
 
     if (options.omitPorts) {
@@ -133,6 +164,22 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
  * @param init Optional method / query / headers. メソッド・クエリ・ヘッダーの任意指定。
  * @returns Loader args. loader 引数。
  */
+/**
+ * Builds loader args for the `:endpoint` API router.
+ * `:endpoint` API ルーター用の loader 引数を組み立てる処理。
+ *
+ * @param endpoint Endpoint segment (e.g. "ids-stream"). エンドポイントセグメント。
+ * @param init Optional method / query / signal. メソッド・クエリ・中断シグナルの任意指定。
+ * @returns Loader args. loader 引数。
+ */
+export const makeApiArgs = (endpoint: string, init: { method?: string; query?: string; signal?: AbortSignal } = {}) => ({
+    request: new Request(`http://localhost/daily_report/api/${endpoint}${init.query ?? ""}`, {
+        method: init.method ?? "GET",
+        signal: init.signal ?? undefined,
+    }),
+    params: { endpoint } as Record<string, string | undefined>,
+})
+
 export const makeAttachmentArgs = (token: string, init: { method?: string; query?: string; headers?: Record<string, string> } = {}) => ({
     request: new Request(`http://localhost/daily_report/api/attachment/${encodeURIComponent(token)}${init.query ?? ""}`, {
         method: init.method ?? "GET",

package/src/server.spec.ts

@@ -0,0 +1,49 @@
+/**
+ * Facade tests for createDailyReportServer: the wiring the explicit-enumeration call must forward.
+ * createDailyReportServer ファサードのテスト。明示列挙の結線が取りこぼしていないことを固定する。
+ */
+import { bigint, mssqlSchema, nvarchar, primaryKey } from "drizzle-orm/mssql-core"
+import { describe, expect, it } from "vitest"
+import { createDailyReportServer, type DailyReportDb } from "./server"
+import { defineDailyReportSchema } from "./server/schema"
+
+const testUsers = mssqlSchema("test").table("Users", { id: bigint("id", { mode: "number" }).notNull(), displayName: nvarchar("display_name", { length: 100 }) }, (t) => [primaryKey({ columns: [t.id] })])
+const tables = defineDailyReportSchema("test", { userTable: testUsers })
+
+/** どのクエリも空行を返す最小 db (clearCache 経路は DB に触れない)。 */
+const noopDb = { select: () => ({ from: () => ({ where: () => Promise.resolve([]), top: () => ({ from: () => ({ where: () => Promise.resolve([]) }) }) }) }) } as unknown as DailyReportDb
+
+/** clearCache の POST 引数。 */
+const clearCacheArgs = () => {
+    const body = new FormData()
+    body.set("intent", "clearCache")
+    return { request: new Request("http://localhost/daily_report/api/action", { method: "POST", body }), params: { endpoint: "action" } as Record<string, string | undefined> }
+}
+
+const makeServer = (enableDevCacheClear?: boolean) =>
+    createDailyReportServer({
+        db: noopDb,
+        tables,
+        userTable: testUsers,
+        resolveUserId: async () => 8,
+        encodeUserId: (id) => `ENC${id}`,
+        authenticate: async () => ({ user: { id: "ext-8" }, cookie: null }),
+        draftLabelName: "draft",
+        enableDevCacheClear,
+    })
+
+describe("createDailyReportServer: enableDevCacheClear の結線", () => {
+    it("既定 (未指定) では clearCache を 400 で拒否する", async () => {
+        const server = makeServer()
+        const res = await server.api.action(clearCacheArgs())
+        expect(res.status).toBe(400)
+    })
+
+    it("enableDevCacheClear:true をファサードへ渡すとハンドラまで伝播し 200 になる", async () => {
+        // ❗ この経路が createDailyReportServer の明示列挙で取りこぼされると、アプリが
+        //    フラグを渡しても黙って無視される (回帰検知の要)
+        const server = makeServer(true)
+        const res = await server.api.action(clearCacheArgs())
+        expect(res.status).toBe(200)
+    })
+})

package/src/server.ts

@@ -34,6 +34,12 @@ export type DailyReportServerConfig = Omit<DailyReportServiceConfig, "cache" | "
     attachmentConcurrency?: number
     /** 未ログイン時のリダイレクト先 (index.loader 用、既定 "/auth/login")。 */
     loginRedirectPath?: string
+    /**
+     * `intent=clearCache` (全サーバーキャッシュの一括破棄) を許可するか。既定 false。
+     * 開発用アフォーダンス。有効化すると認証済みなら誰でも全ワーカーのキャッシュを
+     * 無制限破棄できるため、本番では無効のままにする (消費アプリは開発環境のみ true 注入)。
+     */
+    enableDevCacheClear?: boolean
     /** SQL 結果キャッシュの既定 TTL (既定 60,000ms)。 */
     cacheDefaultTtlMs?: number
     /** 外部ソースアダプタ群 (レガシー日報テーブル等)。 */
@@ -80,6 +86,7 @@ export function createDailyReportServer(config: DailyReportServerConfig) {
         sseReader,
         streamKey: service.streamKey,
         loginRedirectPath: config.loginRedirectPath,
+        enableDevCacheClear: config.enableDevCacheClear,
         logger: config.logger,
     })
 

package/src/shared/business-date.spec.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest"
-import { formatBusinessDateDisplay, normalizeBusinessDateKey, parseBusinessDateKeyToDate } from "./business-date"
+import { formatBusinessDateDisplay, normalizeBusinessDateKey, parseBusinessDateKeyToDate, resolveTodayBusinessDateKey } from "./business-date"
 
 describe("business-date utils", () => {
     describe("normalizeBusinessDateKey", () => {
@@ -58,4 +58,25 @@ describe("business-date utils", () => {
             expect(parseBusinessDateKeyToDate("invalid")).toBeNull()
         })
     })
+
+    describe("resolveTodayBusinessDateKey", () => {
+        it("uses the LOCAL calendar day (getFullYear/Month/Date), not the UTC date", () => {
+            // ローカルコンストラクタで作った時刻はローカル getter で読むため、ホストの TZ に
+            // 依存せず必ずその暦日を返す (旧実装の toISOString は UTC 日付で前日へずれ得た)。
+            // ❗ この検証は toISOString と対比しない: 対比はホスト TZ 依存でテスト自体が脆くなる
+            const localMorning = new Date(2026, 7, 9, 2, 30, 0)
+            expect(resolveTodayBusinessDateKey(localMorning)).toBe("2026-08-09")
+            // 別の暦日でも成立する (getter 経由であることの確認)
+            expect(resolveTodayBusinessDateKey(new Date(2025, 11, 31, 23, 59, 59))).toBe("2025-12-31")
+        })
+
+        it("zero-pads month and day", () => {
+            expect(resolveTodayBusinessDateKey(new Date(2026, 0, 3, 12, 0, 0))).toBe("2026-01-03")
+        })
+
+        it("falls back to now for an invalid injected date", () => {
+            const result = resolveTodayBusinessDateKey(new Date(Number.NaN))
+            expect(result).toMatch(/^\d{4}-\d{2}-\d{2}$/)
+        })
+    })
 })

package/src/shared/business-date.ts

@@ -23,6 +23,26 @@ const normalizeFromDate = (value: Date): string | null => {
     return `${year}-${month}-${day}`
 }
 
+/**
+ * Returns today's business-date key (YYYY-MM-DD) in the local calendar.
+ * ローカルカレンダー上の「本日」の営業日キー (YYYY-MM-DD) を返す。
+ *
+ * `new Date().toISOString()` の日付部は UTC 日付になり、UTC より東のタイムゾーン
+ * (JST など) では深夜〜午前帯に前日へずれる。営業日はブラウザのローカル暦日で判定する
+ * ため、ローカル getter から直接組む。タイムゾーンはパッケージに固定しない (消費側の
+ * 実行環境が決める) 方針に沿う。
+ *
+ * @param now Clock injection for tests (defaults to the current time). テスト用の時刻注入 (既定は現在時刻)。
+ * @returns Local calendar day as YYYY-MM-DD. ローカル暦日の YYYY-MM-DD。
+ */
+export const resolveTodayBusinessDateKey = (now: Date = new Date()): string => {
+    if (Number.isNaN(now.getTime())) {
+        // 不正な Date が注入されたら現在時刻で解決する (空の営業日キーを返さない)
+        return resolveTodayBusinessDateKey(new Date())
+    }
+    return `${now.getFullYear()}-${zeroPad(now.getMonth() + 1)}-${zeroPad(now.getDate())}`
+}
+
 /**
  * Normalizes business date input into YYYY-MM-DD format string.
  * 営業日を YYYY-MM-DD 形式の文字列へ正規化する。

package/src/shared/comment-adapter.spec.ts

@@ -0,0 +1,38 @@
+/**
+ * Tests for comment adapters (legacy + relational merge, colour mapping).
+ * コメントアダプタ (レガシー + リレーショナル統合・色マッピング) のテスト。
+ */
+import { describe, expect, it } from "vitest"
+import { mergeComments, resolveCommentColorClass } from "./comment-adapter"
+
+describe("comment-adapter", () => {
+    describe("resolveCommentColorClass", () => {
+        // ダークカード上で暗色トークン単体だと文字が沈む。全分岐に dark: 対応を要求する
+        it.each([
+            [null, "text-gray-700 dark:text-gray-300"],
+            ["", "text-gray-700 dark:text-gray-300"],
+            ["red", "text-red-600 dark:text-red-400"],
+            ["赤", "text-red-600 dark:text-red-400"],
+            ["green", "text-green-600 dark:text-green-400"],
+            ["青", "text-blue-600 dark:text-blue-400"],
+            ["yellow", "text-yellow-600 dark:text-yellow-400"],
+            ["橙", "text-orange-500 dark:text-orange-400"],
+            ["unknown-colour", "text-gray-700 dark:text-gray-300"],
+        ])("maps %s to a class that carries a dark counterpart", (input, expected) => {
+            const result = resolveCommentColorClass(input)
+            expect(result).toBe(expected)
+            // すべての分岐がダークモード対応を必ず含む (退行検知)
+            expect(result).toContain("dark:")
+        })
+    })
+
+    describe("mergeComments", () => {
+        it("keeps legacy JSON comments (NI 由来) alongside relational comments", () => {
+            // レガシー経路は NI 旧日報テーブルの `コメント一覧` 列由来の実データ。撤去不可
+            const merged = mergeComments([{ name: "田中", text: "レガシー本文", color: "red" }], [{ id: 7, userName: "佐藤", content: "新規本文", createdAt: "2026-08-08 10:00:00", userId: "u1", isMine: false }], "u1")
+            expect(merged).toHaveLength(2)
+            expect(merged[0]).toMatchObject({ authorName: "田中", content: "レガシー本文", isLegacy: true })
+            expect(merged[1]).toMatchObject({ authorName: "佐藤", content: "新規本文", isLegacy: false, isMine: true })
+        })
+    })
+})

package/src/shared/comment-adapter.ts

@@ -48,31 +48,33 @@ export const mergeComments = (legacyComments: DailyReportComment[], modernCommen
  * コメント色のキーワードを Tailwind のテキストクラスに変換する関数。
  */
 export const resolveCommentColorClass = (color: string | null | undefined): string => {
+    // 各色にダークモードの明色対応を必ず添える。ダークカード上で暗色トークン
+    // (text-gray-700 など) 単体だと文字が背景に沈んで読めない
     if (!color) {
-        return "text-gray-700"
+        return "text-gray-700 dark:text-gray-300"
     }
 
     const normalized = color.toLowerCase()
 
     if (normalized.includes("red") || normalized.includes("赤")) {
-        return "text-red-600"
+        return "text-red-600 dark:text-red-400"
     }
 
     if (normalized.includes("green") || normalized.includes("緑")) {
-        return "text-green-600"
+        return "text-green-600 dark:text-green-400"
     }
 
     if (normalized.includes("blue") || normalized.includes("青")) {
-        return "text-blue-600"
+        return "text-blue-600 dark:text-blue-400"
     }
 
     if (normalized.includes("yellow") || normalized.includes("黄")) {
-        return "text-yellow-600"
+        return "text-yellow-600 dark:text-yellow-400"
     }
 
     if (normalized.includes("orange") || normalized.includes("橙")) {
-        return "text-orange-500"
+        return "text-orange-500 dark:text-orange-400"
     }
 
-    return "text-gray-700"
+    return "text-gray-700 dark:text-gray-300"
 }

package/src/shared/ids-stream.spec.ts

@@ -0,0 +1,65 @@
+/**
+ * Tests for the ids-stream ordering helpers (single source of truth for list order).
+ * ids ストリーム並び順ヘルパー (一覧順序の単一情報源) のテスト。
+ */
+import { describe, expect, it } from "vitest"
+import { compareIdsStreamOrder, findIdsStreamResumeIndex, isIdsStreamOrdered, upsertInIdsStreamOrder } from "./ids-stream"
+import type { DailyReportItem } from "./types"
+
+const item = (reportHubId: number, businessDate: string | null): DailyReportItem => ({ reportHubId, businessDate, sourceType: "Internal" })
+
+describe("compareIdsStreamOrder", () => {
+    it("orders businessDate DESC, then id DESC, with null dates last (SQL と同一)", () => {
+        const sorted = [item(1, "2026-08-01"), item(9, "2026-08-08"), item(3, null), item(5, "2026-08-08"), item(2, null)].sort(compareIdsStreamOrder)
+        expect(sorted.map((i) => i.reportHubId)).toEqual([9, 5, 1, 3, 2])
+    })
+})
+
+describe("isIdsStreamOrdered", () => {
+    it("accepts an ordered array and rejects date/id violations", () => {
+        expect(isIdsStreamOrdered([item(9, "2026-08-08"), item(5, "2026-08-08"), item(1, "2026-08-01"), item(3, null)])).toBe(true)
+        // 日付は揃っているが同日内の ID 昇順 (副キー違反)
+        expect(isIdsStreamOrdered([item(5, "2026-08-08"), item(9, "2026-08-08")])).toBe(false)
+        // 日付昇順
+        expect(isIdsStreamOrdered([item(1, "2026-08-01"), item(9, "2026-08-08")])).toBe(false)
+        expect(isIdsStreamOrdered([])).toBe(true)
+        expect(isIdsStreamOrdered([item(1, "2026-08-01")])).toBe(true)
+    })
+})
+
+describe("upsertInIdsStreamOrder", () => {
+    const base = [item(9, "2026-08-08"), item(5, "2026-08-08"), item(1, "2026-08-01"), item(3, null)]
+
+    it("inserts a new item at its ordered position (same-date id DESC を維持)", () => {
+        // 同日 (08-08) 内で 9 と 5 の間に入る
+        const next = upsertInIdsStreamOrder(base, item(7, "2026-08-08"))
+        expect(next.map((i) => i.reportHubId)).toEqual([9, 7, 5, 1, 3])
+        // 元配列は不変
+        expect(base.map((i) => i.reportHubId)).toEqual([9, 5, 1, 3])
+    })
+
+    it("inserts at head / before the null-date tail", () => {
+        expect(upsertInIdsStreamOrder(base, item(2, "2026-08-09")).map((i) => i.reportHubId)).toEqual([2, 9, 5, 1, 3])
+        expect(upsertInIdsStreamOrder(base, item(8, "2026-07-01")).map((i) => i.reportHubId)).toEqual([9, 5, 1, 8, 3])
+    })
+
+    it("moves an existing item when its businessDate changes (単一経路の更新)", () => {
+        const next = upsertInIdsStreamOrder(base, item(1, "2026-08-08"))
+        expect(next.map((i) => i.reportHubId)).toEqual([9, 5, 1, 3])
+        expect(next[2].businessDate).toBe("2026-08-08")
+        expect(next).toHaveLength(4)
+    })
+
+    it("null-date items land in id-DESC order within the tail", () => {
+        const next = upsertInIdsStreamOrder(base, item(6, null))
+        expect(next.map((i) => i.reportHubId)).toEqual([9, 5, 1, 6, 3])
+    })
+})
+
+describe("findIdsStreamResumeIndex", () => {
+    it("resumes strictly after the cursor", () => {
+        const items = [item(9, "2026-08-08"), item(5, "2026-08-08"), item(1, "2026-08-01")]
+        expect(findIdsStreamResumeIndex(items, { businessDate: "2026-08-08", reportHubId: 9 })).toBe(1)
+        expect(findIdsStreamResumeIndex(items, { businessDate: "2026-08-01", reportHubId: 1 })).toBe(3)
+    })
+})