@aiquants/daily-report 0.1.1

package/src/server/service.ts

@@ -0,0 +1,1308 @@
+/**
+ * Data-access service for daily reports (drizzle mssql), fully DI-configured.
+ * 日報データアクセスサービス (drizzle mssql)。依存はすべて DI で注入する。
+ *
+ * キャッシュキー・無効化順序・SSE publish 順序を含むデータアクセスロジックの中核。
+ */
+import { aliasedTable, and, asc, desc, eq, getColumns, inArray, isNull, or, sql } from "drizzle-orm"
+import { normalizeBusinessDateKey } from "../shared/business-date"
+import { createLogger, type DailyReportLogger, LogLevel } from "../shared/logger"
+import { commentAddMessageSchema, commentDeleteMessageSchema, reportCreateMessageSchema, reportDeleteMessageSchema, reportPublishMessageSchema, reportUpdateMessageSchema, statusUpdateMessageSchema } from "../shared/sse-schema"
+import type { DailyReportComment, DailyReportCommentItem, DailyReportDetail, DailyReportInterviewer, DailyReportItem, DailyReportLabelDef } from "../shared/types"
+import type { EpochStore, SqlResultCache, SqlResultCacheQueryOptions } from "./cache"
+import type { DailyReportExternalSource } from "./external-source"
+import type { DailyReportEncodeUserId, DailyReportRedisProvider, DailyReportResolveUserId } from "./ports"
+import type { DailyReportTables, DailyReportUserTable } from "./schema"
+
+export type { SqlResultCacheQueryOptions }
+
+// ---- 行型 (drizzle $inferSelect の構造的置き換え) ----
+
+/** DailyReportHub の行型。 */
+export type DailyReportHubRow = {
+    id: number
+    sourceType: string
+    sourceId: string
+    sourceIdNum: number | null
+    businessDate: Date | string | null
+    userId: number | null
+    title: string | null
+    summary: string | null
+    createdAt: Date | string
+    createdBy: string
+    updatedAt: Date | string
+    updatedBy: string
+    deletedAt: Date | string | null
+    deletedBy: string | null
+}
+
+/** DailyReportInternal の行型。 */
+export type DailyReportInternalRow = {
+    hubId: number
+    body: string | null
+    metadata: string | null
+    createdAt: Date | string
+    createdBy: string
+    updatedAt: Date | string
+    updatedBy: string
+}
+
+/** DailyReportUserStatus の行型。 */
+export type DailyReportUserStatusRow = {
+    hubId: number
+    userId: number
+    isRead: boolean
+    isStarred: boolean
+    createdAt: Date | string
+    createdBy: string
+    updatedAt: Date | string
+    updatedBy: string
+}
+
+/** DailyReportComment の行型。 */
+export type DailyReportCommentRow = {
+    id: number
+    hubId: number
+    userId: number
+    body: string
+    createdAt: Date | string
+    createdBy: string
+    updatedAt: Date | string
+    updatedBy: string
+}
+
+// ---- 必要最小の drizzle ビルダ形 (公開契約はサービス関数のシグネチャで厳格化) ----
+
+type Rows<T> = PromiseLike<T[]>
+interface SelectChain<T> extends Rows<T> {
+    from(t: unknown): SelectChain<T>
+    innerJoin(t: unknown, on: unknown): SelectChain<T>
+    leftJoin(t: unknown, on: unknown): SelectChain<T>
+    where(cond: unknown): SelectChain<T>
+    orderBy(...cols: unknown[]): SelectChain<T>
+    top(n: number): SelectChain<T>
+}
+interface InsertChain<T> {
+    output(): { values(v: unknown): PromiseLike<T[]> }
+    values(v: unknown): PromiseLike<unknown>
+}
+interface UpdateChain<T> {
+    set(v: unknown): {
+        where(cond: unknown): PromiseLike<unknown>
+        output(): { where(cond: unknown): PromiseLike<T[]> }
+    }
+}
+interface DeleteChain {
+    where(cond: unknown): PromiseLike<unknown>
+}
+
+/** サービスが要求する drizzle mssql データベースの最小面 (トランザクション込み)。 */
+export interface DailyReportDb {
+    select<T = Record<string, unknown>>(fields?: unknown): SelectChain<T>
+    insert<T = Record<string, unknown>>(t: unknown): InsertChain<T>
+    update<T = Record<string, unknown>>(t: unknown): UpdateChain<T>
+    delete(t: unknown): DeleteChain
+    transaction<T>(fn: (tx: DailyReportDb) => Promise<T>, config?: unknown): Promise<T>
+}
+
+/** getColumns へ構造型テーブルを渡すための境界キャスト。 */
+const cols = (t: unknown) => getColumns(t as Parameters<typeof getColumns>[0])
+
+// ---- サービス設定 ----
+
+export type DailyReportServiceConfig = {
+    /** drizzle mssql データベースハンドル。 */
+    db: DailyReportDb
+    /** 日報 6 テーブル (アプリ既存モデルまたは defineDailyReportSchema 生成物)。 */
+    tables: DailyReportTables
+    /** 表示名解決に使う外部ユーザーテーブル ({ id, displayName })。 */
+    userTable: DailyReportUserTable
+    /** 外部ユーザー ID → 内部数値 ID の解決ポート。 */
+    resolveUserId: DailyReportResolveUserId
+    /** 内部数値 ID の難読化ポート。 */
+    encodeUserId: DailyReportEncodeUserId
+    /** SSE publish / epoch 用 redis (省略時は SSE publish スキップ・epoch 無効)。 */
+    redis?: DailyReportRedisProvider
+    /** レガシー等の外部ソースアダプタ群。 */
+    externalSources?: DailyReportExternalSource[]
+    /** SQL 結果キャッシュ (facade が生成して注入)。 */
+    cache: SqlResultCache
+    /** クロスワーカー epoch ストア (facade が生成して注入)。 */
+    epochs: EpochStore
+    /**
+     * 下書きラベル名 (必須)。ドラフトのクロスユーザー可視性フィルタに使うため、
+     * サイレントな既定値を持たせず消費アプリが自 DB のラベル名を必ず注入する。
+     */
+    draftLabelName: string
+    /** SSE Redis Stream キー (既定 "daily-report:sse-stream")。 */
+    streamKey?: string
+    /** SSE Stream の MAXLEN (既定 10000)。 */
+    streamMaxLen?: number
+    /** IDs 一覧キャッシュ TTL (既定 180,000ms)。 */
+    idsTtlMs?: number
+    /** 営業日別キャッシュ TTL (既定 300,000ms)。 */
+    businessDateTtlMs?: number
+    /** 外部 ID → 内部 ID のプロセス内キャッシュを無効化 (テスト用)。 */
+    disableUserIdCache?: boolean
+    /** ロガー (既定は console ベース)。 */
+    logger?: DailyReportLogger
+}
+
+/** createDailyReportService の返却型。 */
+export type DailyReportService = ReturnType<typeof createDailyReportService>
+
+/**
+ * Creates the daily-report data-access service bound to the injected dependencies.
+ * 注入された依存に束縛された日報データアクセスサービスを生成する処理。
+ */
+export function createDailyReportService(config: DailyReportServiceConfig) {
+    const { db, tables, userTable: users, resolveUserId, encodeUserId, redis, cache: sqlResultCache, epochs } = config
+    const { hub: DailyReportHub, internal: DailyReportInternal, comment: DailyReportCommentModel, label: DailyReportLabel, hubLabel: DailyReportHub_Label, userStatus: DailyReportUserStatus } = tables
+    const externalSources = config.externalSources ?? []
+    const draftLabelName = config.draftLabelName
+    const logger = config.logger ?? createLogger(LogLevel.INFO, "[DailyReportService]")
+
+    const DAILY_REPORT_IDS_CACHE_KEY = "daily-report:ids"
+    const DAILY_REPORT_IDS_TTL_MS = config.idsTtlMs ?? 180_000
+    const DAILY_REPORT_IDS_EPOCH_KEY = "daily-report:ids:epoch"
+
+    const DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX = "daily-report:business-date:"
+    const DAILY_REPORT_BUSINESS_DATE_TTL_MS = config.businessDateTtlMs ?? 300_000
+
+    /** 営業日キャッシュのクロスワーカー epoch プレフィックス */
+    const DAILY_REPORT_DATE_EPOCH_PREFIX = "daily-report:date-epoch:"
+    /** レポート詳細キャッシュのクロスワーカー epoch プレフィックス */
+    const DAILY_REPORT_DETAIL_EPOCH_PREFIX = "daily-report:detail-epoch:"
+
+    const DAILY_REPORT_SSE_STREAM_KEY = config.streamKey ?? "daily-report:sse-stream"
+    const DAILY_REPORT_SSE_STREAM_MAXLEN = config.streamMaxLen ?? 10000
+
+    const incrementRedisEpoch = (key: string) => epochs.incrementEpoch(key)
+
+    /**
+     * Publishes a message to the SSE Redis Stream.
+     * SSE 用の Redis Stream にメッセージを追加する。
+     */
+    const publishToSseStream = async (message: Record<string, unknown>, callerName: string): Promise<void> => {
+        const client = await redis?.getClient()
+        if (!client) {
+            logger.warn(`[SSE] Redis client unavailable (${callerName})`)
+            return
+        }
+        const publishStartMs = Date.now()
+        try {
+            await client.xAdd(DAILY_REPORT_SSE_STREAM_KEY, "*", { data: JSON.stringify(message) }, { TRIM: { strategy: "MAXLEN", strategyModifier: "~", threshold: DAILY_REPORT_SSE_STREAM_MAXLEN } })
+            const publishDurationMs = Date.now() - publishStartMs
+            if (publishDurationMs > 1000) {
+                logger.warn(`[SSE] Slow publish (${callerName}): ${publishDurationMs}ms`)
+            }
+        } catch (e) {
+            logger.error(`[SSE] Redis publish failed (${callerName}):`, e)
+        }
+    }
+
+    type DatePattern = "YYYY-MM-DD HH:mm:ss" | "YYYY-MM-DD"
+
+    /**
+     * Formats date-like values to a given pattern (ja-JP locale semantics preserved).
+     * 日付相当の値を指定パターンに整形する処理。
+     */
+    const formatDateValue = (value: Date | string | null | undefined, pattern: DatePattern): string | null => {
+        if (!value) {
+            return null
+        }
+
+        const dateValue = value instanceof Date ? value : new Date(value)
+        if (Number.isNaN(dateValue.getTime())) {
+            return typeof value === "string" ? value : null
+        }
+
+        // ja-JP ロケールの YYYY/MM/DD (HH:mm:ss) を生成しハイフン区切りへ正規化する
+        const opts: Intl.DateTimeFormatOptions = pattern === "YYYY-MM-DD HH:mm:ss" ? { year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit", second: "2-digit" } : { year: "numeric", month: "2-digit", day: "2-digit" }
+        const formatted = pattern === "YYYY-MM-DD HH:mm:ss" ? dateValue.toLocaleString("ja-JP", opts) : dateValue.toLocaleDateString("ja-JP", opts)
+        return formatted.replace(/\//g, "-")
+    }
+
+    /**
+     * Masks a raw audit-actor value (created_by / updated_by) before client exposure.
+     * 監査列 (created_by / updated_by) をクライアント公開前にマスクする処理。
+     *
+     * Internal 由来の値は String(userId) の生内部 ID のため、数値なら encodeUserId で難読化する。
+     * 非数値 (外部ソース由来の氏名やシステム文字列) はそのまま返す。null / 空文字は null。
+     * userId フィールドと同じ難読化を監査列にも適用し、内部 ID の横流し漏洩を防ぐ。
+     */
+    const maskAuditActor = (value: string | null | undefined): string | null => {
+        if (value == null || value === "") return null
+        return /^\d+$/.test(value) ? encodeUserId(Number(value)) : value
+    }
+
+    type RawJsonComment = {
+        id: number
+        content: string
+        createdAt: string
+        userId: number
+        userName: string
+    }
+
+    type RawJsonLabel = {
+        id: number
+        name: string
+        color: string | null
+    }
+
+    /** 詳細クエリ 1 行 (外部ソース列は `ext_<sourceType>` キーで同居)。 */
+    type HubQueryRow = {
+        hub: DailyReportHubRow
+        internal: DailyReportInternalRow | null
+        isRead?: boolean | null
+        isStarred?: boolean | null
+        creatorName?: string | null
+    } & Record<string, unknown>
+
+    type HubRecord = HubQueryRow & {
+        labels?: RawJsonLabel[]
+        comments?: RawJsonComment[]
+    }
+
+    /** 外部ソースアダプタの select 追加フィールドを構築する。 */
+    const externalSelections = (): Record<string, unknown> => {
+        const out: Record<string, unknown> = {}
+        for (const adapter of externalSources) {
+            out[`ext_${adapter.sourceType}`] = cols(adapter.table)
+        }
+        return out
+    }
+
+    /** 外部ソースアダプタの LEFT JOIN を select チェーンへ適用する。 */
+    const applyExternalJoins = <T>(chain: SelectChain<T>): SelectChain<T> => {
+        let c = chain
+        for (const adapter of externalSources) {
+            c = c.leftJoin(adapter.table, and(eq(DailyReportHub.sourceType, adapter.sourceType), eq(DailyReportHub.sourceIdNum, adapter.idColumn)))
+        }
+        return c
+    }
+
+    /**
+     * Converts a Hub record into a DailyReportDetail structure.
+     * Hub レコードを DailyReportDetail に変換する処理。
+     */
+    const mapHubRecord = (row: HubRecord, currentUserId?: number): DailyReportDetail => {
+        const { hub, internal } = row
+
+        let content = hub.summary
+        let interviewers: DailyReportInterviewer[] = []
+        let category: string | null = null
+        let creationCategory: string | null = null
+        let visitTimeFrom: string | null = null
+        let visitTimeTo: string | null = null
+        let customerName: string | null = null
+        let employeeName: string | null = null
+        let comments: DailyReportComment[] = []
+
+        // 外部ソースアダプタ優先 → Internal の順で表示フィールドを解決する
+        const adapter = externalSources.find((a) => a.sourceType === hub.sourceType)
+        const externalRow = adapter ? (row[`ext_${adapter.sourceType}`] as Record<string, unknown> | null | undefined) : undefined
+        if (adapter && externalRow) {
+            const fields = adapter.mapRow(externalRow)
+            if (fields.content !== undefined) content = fields.content
+            if (fields.employeeName !== undefined) employeeName = fields.employeeName
+            if (fields.category !== undefined) category = fields.category
+            if (fields.creationCategory !== undefined) creationCategory = fields.creationCategory
+            if (fields.visitTimeFrom !== undefined) visitTimeFrom = fields.visitTimeFrom
+            if (fields.visitTimeTo !== undefined) visitTimeTo = fields.visitTimeTo
+            if (fields.customerName !== undefined) customerName = fields.customerName
+            if (fields.interviewers !== undefined) interviewers = fields.interviewers
+            if (fields.comments !== undefined) comments = fields.comments
+        } else if (hub.sourceType === "Internal" && internal) {
+            content = internal.body
+            // Internal specific mappings if any
+        }
+
+        const labelsRaw = row.labels ?? []
+        const commentItemsRaw = row.comments ?? []
+
+        return {
+            reportHubId: hub.id,
+            date: formatDateValue(hub.businessDate, "YYYY-MM-DD"),
+            author: row.creatorName ?? maskAuditActor(hub.createdBy) ?? "",
+            userId: hub.userId ? encodeUserId(hub.userId) : "",
+            createdAt: formatDateValue(hub.createdAt, "YYYY-MM-DD HH:mm:ss"),
+            updatedAt: formatDateValue(hub.updatedAt, "YYYY-MM-DD HH:mm:ss"),
+            updatedBy: maskAuditActor(hub.updatedBy),
+            employeeName: employeeName ?? row.creatorName ?? maskAuditActor(hub.createdBy),
+            category,
+            creationCategory,
+            visitTimeFrom,
+            visitTimeTo,
+            customerName,
+            interviewers,
+            subject: hub.title,
+            content,
+            comments,
+            isRead: row.isRead ?? false,
+            isStarred: row.isStarred ?? false,
+            labels: labelsRaw.map((l) => ({
+                id: l.id,
+                name: l.name,
+                color: l.color,
+            })),
+            commentItems: commentItemsRaw.map((c) => ({
+                ...c,
+                userId: encodeUserId(c.userId),
+                isMine: currentUserId ? c.userId === currentUserId : false,
+            })),
+        }
+    }
+
+    /**
+     * Fetches daily report IDs alongside normalized business dates.
+     * 日報 ID と正規化済み営業日を取得する内部処理。
+     */
+    const fetchDailyReportIdsByUserId = async (userId: number): Promise<DailyReportItem[]> => {
+        const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
+
+        const result = await db
+            .select<{ reportHubId: number; businessDate: Date | string | null }>({
+                reportHubId: DailyReportHub.id,
+                businessDate: DailyReportHub.businessDate,
+            })
+            .from(DailyReportHub)
+            .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), eq(DraftLabelRelation.labelId, db.select({ id: DailyReportLabel.id }).top(1).from(DailyReportLabel).where(eq(DailyReportLabel.name, draftLabelName)))))
+            .where(and(isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, 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.
+     * 指定した営業日の日報詳細を取得する内部処理。
+     */
+    const fetchDailyReportsByBusinessDate = async (normalizedBusinessDate: string): Promise<DailyReportDetail[]> => {
+        const rows = await applyExternalJoins(
+            db
+                .select<HubQueryRow>({
+                    hub: cols(DailyReportHub),
+                    internal: cols(DailyReportInternal),
+                    creatorName: users.displayName,
+                    ...externalSelections(),
+                })
+                .from(DailyReportHub),
+        )
+            .leftJoin(DailyReportInternal, eq(DailyReportHub.id, DailyReportInternal.hubId))
+            .leftJoin(users, eq(DailyReportHub.userId, users.id))
+            .where(and(eq(DailyReportHub.businessDate, sql`${normalizedBusinessDate}`), isNull(DailyReportHub.deletedAt)))
+            .orderBy(desc(DailyReportHub.id))
+
+        return rows.map((row) => mapHubRecord(row))
+    }
+
+    /**
+     * Builds a deterministic cache key for business-date caches.
+     * 営業日キャッシュ用の一意キーを生成する処理。
+     */
+    const buildBusinessDateCacheKey = (normalizedBusinessDate: string): string => {
+        return `${DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX}${normalizedBusinessDate}`
+    }
+
+    /**
+     * Resolves the internal user ID from an external ID (with process-local caching).
+     * 外部 ID から内部ユーザー ID を解決する (プロセス内キャッシュ付き)。
+     */
+    const userIdCache = new Map<string, number>()
+
+    const getUserIdByExternalId = async (externalId: string): Promise<number | null> => {
+        if (!config.disableUserIdCache && userIdCache.has(externalId)) {
+            return userIdCache.get(externalId) ?? null
+        }
+
+        const userId = await resolveUserId(externalId)
+        if (userId !== null && !config.disableUserIdCache) {
+            userIdCache.set(externalId, userId)
+        }
+        return userId
+    }
+
+    /**
+     * Retrieves daily report IDs and their normalized business dates.
+     * 日報 ID と正規化済み営業日を取得する処理。
+     */
+    const getDailyReportIdsByExternalId = async (externalId: string, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportItem[]> => {
+        const userId = await getUserIdByExternalId(externalId)
+        if (!userId) {
+            return []
+        }
+
+        const cacheKey = `${DAILY_REPORT_IDS_CACHE_KEY}:user:${userId}`
+        return sqlResultCache.getOrFetch<DailyReportItem>({
+            cacheKey,
+            fetcher: async () => {
+                const res = await fetchDailyReportIdsByUserId(userId)
+                return res
+            },
+            forceRefresh,
+            snapshot,
+            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_IDS_TTL_MS,
+            epochKey: DAILY_REPORT_IDS_EPOCH_KEY,
+        }) as Promise<DailyReportItem[]>
+    }
+
+    /**
+     * Retrieves daily report details for a business date (⚠️ NOT per-user filtered).
+     * 指定した営業日に紐づく日報詳細を取得する処理 (⚠️ ユーザー別フィルタなし)。
+     *
+     * ⚠️ SECURITY: この関数は下書きラベルによる可視性フィルタ (他ユーザーの下書きを隠す) と
+     * ユーザー別の既読/スター状態を **適用しない**。取得結果は全ユーザーの下書きを含み得るため、
+     * HTTP レスポンス / SSR loader / SSE へ **直接返してはならない**。ユーザー向け配信には
+     * 必ず {@link getDailyReportsByBusinessDateByExternalId} を使うこと。
+     * (本関数は管理・バッチ・テスト用途に限定する。)
+     */
+    const getDailyReportsByBusinessDate = (businessDate: string, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail[]> => {
+        const normalizedBusinessDate = normalizeBusinessDateKey(businessDate)
+        if (!normalizedBusinessDate) {
+            return Promise.resolve([])
+        }
+
+        return sqlResultCache.getOrFetch<DailyReportDetail>({
+            cacheKey: buildBusinessDateCacheKey(normalizedBusinessDate),
+            fetcher: () => fetchDailyReportsByBusinessDate(normalizedBusinessDate),
+            forceRefresh,
+            snapshot,
+            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_BUSINESS_DATE_TTL_MS,
+        }) as Promise<DailyReportDetail[]>
+    }
+
+    /**
+     * Retrieves the ID of the draft label.
+     * 下書きラベルの ID を取得する（キャッシュ付き）。
+     */
+    let cachedDraftLabelId: number | null = null
+    const getDraftLabelId = async (): Promise<number | null> => {
+        if (cachedDraftLabelId !== null) return cachedDraftLabelId
+        const [label] = await db.select<{ id: number }>({ id: DailyReportLabel.id }).top(1).from(DailyReportLabel).where(eq(DailyReportLabel.name, draftLabelName))
+
+        if (label) {
+            cachedDraftLabelId = label.id
+            return cachedDraftLabelId
+        }
+        return null
+    }
+
+    /**
+     * Retrieves daily report details for a business date with user-specific status and relations.
+     * 指定した営業日の日報詳細を、ユーザー状態と関連データを含めて取得する。
+     */
+    const getDailyReportsByBusinessDateByExternalId = async (businessDate: string, externalId: string, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail[]> => {
+        const userId = await getUserIdByExternalId(externalId)
+        if (!userId) {
+            return []
+        }
+
+        const normalizedBusinessDate = normalizeBusinessDateKey(businessDate)
+        if (!normalizedBusinessDate) {
+            return []
+        }
+
+        const cacheKey = `daily-report:date:${normalizedBusinessDate}:user:${userId}`
+
+        return sqlResultCache.getOrFetch<DailyReportDetail>({
+            cacheKey,
+            fetcher: async () => {
+                const draftLabelId = await getDraftLabelId()
+                const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
+
+                const rows = await applyExternalJoins(
+                    db
+                        .select<HubQueryRow>({
+                            hub: cols(DailyReportHub),
+                            internal: cols(DailyReportInternal),
+                            isRead: DailyReportUserStatus.isRead,
+                            isStarred: DailyReportUserStatus.isStarred,
+                            creatorName: users.displayName,
+                            ...externalSelections(),
+                        })
+                        .from(DailyReportHub),
+                )
+                    .leftJoin(DailyReportInternal, eq(DailyReportHub.id, DailyReportInternal.hubId))
+                    .leftJoin(DailyReportUserStatus, and(eq(DailyReportHub.id, DailyReportUserStatus.hubId), eq(DailyReportUserStatus.userId, userId)))
+                    .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), eq(DraftLabelRelation.labelId, draftLabelId ?? -1)))
+                    .leftJoin(users, eq(DailyReportHub.userId, users.id))
+                    .where(and(eq(DailyReportHub.businessDate, sql`${normalizedBusinessDate}`), isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DraftLabelRelation.hubId))))
+                    .orderBy(desc(DailyReportHub.id))
+
+                if (rows.length === 0) {
+                    return []
+                }
+
+                const hubIds = rows.map((r) => r.hub.id)
+
+                // Drizzle ORM batch queries to fetch labels and comments
+                const allLabels = await db
+                    .select<{ hubId: number; id: number; name: string; color: string | null }>({
+                        hubId: DailyReportHub_Label.hubId,
+                        id: DailyReportLabel.id,
+                        name: DailyReportLabel.name,
+                        color: DailyReportLabel.color,
+                    })
+                    .from(DailyReportHub_Label)
+                    .innerJoin(DailyReportLabel, eq(DailyReportHub_Label.labelId, DailyReportLabel.id))
+                    .where(inArray(DailyReportHub_Label.hubId, hubIds))
+
+                const allComments = await db
+                    .select<{ hubId: number; id: number; body: string; createdAt: Date | string; userId: number; userName: string | null }>({
+                        hubId: DailyReportCommentModel.hubId,
+                        id: DailyReportCommentModel.id,
+                        body: DailyReportCommentModel.body,
+                        createdAt: DailyReportCommentModel.createdAt,
+                        userId: DailyReportCommentModel.userId,
+                        userName: users.displayName,
+                    })
+                    .from(DailyReportCommentModel)
+                    .leftJoin(users, eq(DailyReportCommentModel.userId, users.id))
+                    .where(inArray(DailyReportCommentModel.hubId, hubIds))
+                    .orderBy(asc(DailyReportCommentModel.createdAt))
+
+                const labelsMap = new Map<number, RawJsonLabel[]>()
+                const commentsMap = new Map<number, RawJsonComment[]>()
+
+                for (const label of allLabels) {
+                    let list = labelsMap.get(label.hubId)
+                    if (!list) {
+                        list = []
+                        labelsMap.set(label.hubId, list)
+                    }
+                    list.push({
+                        id: label.id,
+                        name: label.name,
+                        color: label.color,
+                    })
+                }
+
+                for (const comment of allComments) {
+                    let list = commentsMap.get(comment.hubId)
+                    if (!list) {
+                        list = []
+                        commentsMap.set(comment.hubId, list)
+                    }
+                    list.push({
+                        id: comment.id,
+                        content: comment.body,
+                        createdAt: formatDateValue(comment.createdAt, "YYYY-MM-DD HH:mm:ss") || "",
+                        userId: comment.userId,
+                        userName: comment.userName || "",
+                    })
+                }
+
+                return rows.map((row) => {
+                    const hubId = row.hub.id
+                    return mapHubRecord(
+                        {
+                            ...row,
+                            labels: labelsMap.get(hubId) || [],
+                            comments: commentsMap.get(hubId) || [],
+                        },
+                        userId,
+                    )
+                })
+            },
+            forceRefresh,
+            snapshot,
+            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_BUSINESS_DATE_TTL_MS,
+            epochKey: `${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedBusinessDate}`,
+        }) as Promise<DailyReportDetail[]>
+    }
+
+    /**
+     * Retrieves a single daily report detail by ID with user-specific status and relations.
+     * 指定した日報詳細を、ユーザー状態と関連データを含めて取得する。
+     */
+    const getDailyReportDetailById = async (reportHubId: number, userId: number, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail | null> => {
+        const cacheKey = `daily-report:detail:${reportHubId}:user:${userId}`
+
+        const results = (await sqlResultCache.getOrFetch<DailyReportDetail>({
+            cacheKey,
+            fetcher: async () => {
+                const rows = await applyExternalJoins(
+                    db
+                        .select<HubQueryRow>({
+                            hub: cols(DailyReportHub),
+                            internal: cols(DailyReportInternal),
+                            isRead: DailyReportUserStatus.isRead,
+                            isStarred: DailyReportUserStatus.isStarred,
+                            creatorName: users.displayName,
+                            ...externalSelections(),
+                        })
+                        .from(DailyReportHub),
+                )
+                    .leftJoin(DailyReportInternal, eq(DailyReportHub.id, DailyReportInternal.hubId))
+                    .leftJoin(DailyReportUserStatus, and(eq(DailyReportHub.id, DailyReportUserStatus.hubId), eq(DailyReportUserStatus.userId, userId)))
+                    .leftJoin(users, eq(DailyReportHub.userId, users.id))
+                    .where(and(eq(DailyReportHub.id, reportHubId), isNull(DailyReportHub.deletedAt)))
+
+                if (rows.length === 0) {
+                    return []
+                }
+
+                const hubId = rows[0].hub.id
+
+                // Fetch labels and comments via Drizzle ORM
+                const labels = await db
+                    .select<{ id: number; name: string; color: string | null }>({
+                        id: DailyReportLabel.id,
+                        name: DailyReportLabel.name,
+                        color: DailyReportLabel.color,
+                    })
+                    .from(DailyReportHub_Label)
+                    .innerJoin(DailyReportLabel, eq(DailyReportHub_Label.labelId, DailyReportLabel.id))
+                    .where(eq(DailyReportHub_Label.hubId, hubId))
+
+                const comments = await db
+                    .select<{ id: number; body: string; createdAt: Date | string; userId: number; userName: string | null }>({
+                        id: DailyReportCommentModel.id,
+                        body: DailyReportCommentModel.body,
+                        createdAt: DailyReportCommentModel.createdAt,
+                        userId: DailyReportCommentModel.userId,
+                        userName: users.displayName,
+                    })
+                    .from(DailyReportCommentModel)
+                    .leftJoin(users, eq(DailyReportCommentModel.userId, users.id))
+                    .where(eq(DailyReportCommentModel.hubId, hubId))
+                    .orderBy(asc(DailyReportCommentModel.createdAt))
+
+                const labelsMapped = labels.map((l) => ({
+                    id: l.id,
+                    name: l.name,
+                    color: l.color,
+                }))
+
+                const commentsMapped = comments.map((c) => ({
+                    id: c.id,
+                    content: c.body,
+                    createdAt: formatDateValue(c.createdAt, "YYYY-MM-DD HH:mm:ss") || "",
+                    userId: c.userId,
+                    userName: c.userName || "",
+                }))
+
+                return [
+                    mapHubRecord(
+                        {
+                            ...rows[0],
+                            labels: labelsMapped,
+                            comments: commentsMapped,
+                        },
+                        userId,
+                    ),
+                ]
+            },
+            forceRefresh,
+            snapshot,
+            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_BUSINESS_DATE_TTL_MS,
+            epochKey: `${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`,
+        })) as DailyReportDetail[]
+
+        return results[0] ?? null
+    }
+
+    /**
+     * Retrieves a single daily report detail by ID with user-specific status and relations.
+     * 指定した日報詳細を、ユーザー状態と関連データを含めて取得する。
+     */
+    const getDailyReportDetailByIdByExternalId = async (reportHubId: number, externalId: string, options: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail | null> => {
+        const userId = await getUserIdByExternalId(externalId)
+        if (!userId) {
+            return null
+        }
+        return getDailyReportDetailById(reportHubId, userId, options)
+    }
+
+    /**
+     * Sets the starred status of a daily report for a user.
+     * ユーザーの日報スター状態を設定する。
+     */
+    const setStarStatus = async (userId: number, reportHubId: number, businessDate: string | null, isStarred: boolean, clientTempId: string): Promise<DailyReportUserStatusRow> => {
+        const existing = await db
+            .select<DailyReportUserStatusRow>()
+            .top(1)
+            .from(DailyReportUserStatus)
+            .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
+
+        let updatedStatus: DailyReportUserStatusRow
+
+        if (existing.length > 0) {
+            if (existing[0].isStarred !== isStarred) {
+                const rows = await db
+                    .update<DailyReportUserStatusRow>(DailyReportUserStatus)
+                    .set({
+                        isStarred: isStarred,
+                        updatedAt: new Date(),
+                        updatedBy: String(userId),
+                    })
+                    .output()
+                    .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
+                updatedStatus = rows[0]
+            } else {
+                updatedStatus = existing[0]
+            }
+        } else {
+            const rows = await db
+                .insert<DailyReportUserStatusRow>(DailyReportUserStatus)
+                .output()
+                .values({
+                    hubId: reportHubId,
+                    userId,
+                    isStarred: isStarred,
+                    isRead: false,
+                    createdAt: new Date(),
+                    createdBy: String(userId),
+                    updatedAt: new Date(),
+                    updatedBy: String(userId),
+                })
+            updatedStatus = rows[0]
+        }
+
+        if (businessDate) {
+            const normalizedDate = normalizeBusinessDateKey(businessDate)
+            if (normalizedDate) {
+                sqlResultCache.invalidate(`daily-report:date:${normalizedDate}:user:${userId}`)
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
+            }
+        }
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}:user:${userId}`)
+        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
+
+        await publishToSseStream(
+            statusUpdateMessageSchema.parse({
+                type: "status-update",
+                reportHubId: reportHubId,
+                recipientRawUserId: userId,
+                statusType: "star",
+                value: isStarred,
+                clientTempId,
+            }),
+            "setStarStatus",
+        )
+
+        return updatedStatus
+    }
+
+    /**
+     * Sets the read status of a daily report for a user.
+     * ユーザーの日報既読状態を設定する。
+     */
+    const setReadStatus = async (userId: number, reportHubId: number, businessDate: string | null, isRead: boolean, clientTempId: string): Promise<DailyReportUserStatusRow> => {
+        const existing = await db
+            .select<DailyReportUserStatusRow>()
+            .top(1)
+            .from(DailyReportUserStatus)
+            .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
+
+        let updatedStatus: DailyReportUserStatusRow
+
+        if (existing.length > 0) {
+            if (existing[0].isRead !== isRead) {
+                const rows = await db
+                    .update<DailyReportUserStatusRow>(DailyReportUserStatus)
+                    .set({
+                        isRead: isRead,
+                        updatedAt: new Date(),
+                        updatedBy: String(userId),
+                    })
+                    .output()
+                    .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
+                updatedStatus = rows[0]
+            } else {
+                updatedStatus = existing[0]
+            }
+        } else {
+            const rows = await db
+                .insert<DailyReportUserStatusRow>(DailyReportUserStatus)
+                .output()
+                .values({
+                    hubId: reportHubId,
+                    userId,
+                    isRead: isRead,
+                    isStarred: false,
+                    createdAt: new Date(),
+                    createdBy: String(userId),
+                    updatedAt: new Date(),
+                    updatedBy: String(userId),
+                })
+            updatedStatus = rows[0]
+        }
+
+        if (businessDate) {
+            const normalizedDate = normalizeBusinessDateKey(businessDate)
+            if (normalizedDate) {
+                sqlResultCache.invalidate(`daily-report:date:${normalizedDate}:user:${userId}`)
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
+            }
+        }
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}:user:${userId}`)
+        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
+
+        await publishToSseStream(
+            statusUpdateMessageSchema.parse({
+                type: "status-update",
+                reportHubId: reportHubId,
+                recipientRawUserId: userId,
+                statusType: "read",
+                value: isRead,
+                clientTempId,
+            }),
+            "setReadStatus",
+        )
+
+        return updatedStatus
+    }
+
+    /**
+     * Adds a comment to a daily report.
+     * 日報にコメントを追加する。
+     */
+    const addComment = async (userId: number, reportHubId: number, content: string, businessDate: string | null, clientTempId: string): Promise<DailyReportCommentItem> => {
+        const [inserted] = await db
+            .insert<DailyReportCommentRow>(DailyReportCommentModel)
+            .output()
+            .values({
+                hubId: reportHubId,
+                userId,
+                body: content,
+                createdAt: new Date(),
+                createdBy: String(userId),
+                updatedAt: new Date(),
+                updatedBy: String(userId),
+            })
+
+        const [user] = await db.select<{ displayName: string | null }>({ displayName: users.displayName }).top(1).from(users).where(eq(users.id, userId))
+        const userName = user?.displayName ?? "Unknown"
+
+        // コメントは全ユーザーに表示されるため、date キャッシュも全ユーザー分を無効化
+        if (businessDate) {
+            const normalizedDate = normalizeBusinessDateKey(businessDate)
+            if (normalizedDate) {
+                sqlResultCache.invalidatePrefix(`daily-report:date:${normalizedDate}:user:`)
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
+            }
+        }
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
+        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
+        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
+
+        const commentItem: DailyReportCommentItem = {
+            id: inserted.id,
+            userId: encodeUserId(inserted.userId),
+            userName: userName,
+            content: inserted.body,
+            createdAt: formatDateValue(inserted.createdAt, "YYYY-MM-DD HH:mm:ss") ?? "",
+            isMine: true,
+        }
+
+        await publishToSseStream(
+            commentAddMessageSchema.parse({
+                type: "comment-add",
+                reportHubId: reportHubId,
+                comment: commentItem,
+                clientTempId,
+            }),
+            "addComment",
+        )
+
+        return commentItem
+    }
+
+    /**
+     * Finds a daily report comment by ID.
+     * 日報コメントをIDで検索する。
+     */
+    const findDailyReportCommentById = async (tx: DailyReportDb, commentId: number) => {
+        return await tx.select<DailyReportCommentRow>().top(1).from(DailyReportCommentModel).where(eq(DailyReportCommentModel.id, commentId))
+    }
+
+    /**
+     * Deletes a comment from a daily report.
+     * 日報のコメントを削除する。
+     */
+    const deleteComment = async (userId: number, reportHubId: number, commentId: number, businessDate: string | null, clientTempId: string): Promise<void> => {
+        const comments = await findDailyReportCommentById(db, commentId)
+        if (comments.length === 0) {
+            throw new Error("Not Found")
+        }
+        if (comments[0].userId !== userId) {
+            throw new Error("Unauthorized")
+        }
+
+        await db.delete(DailyReportCommentModel).where(eq(DailyReportCommentModel.id, commentId))
+
+        // コメントは全ユーザーに表示されるため、date キャッシュも全ユーザー分を無効化
+        if (businessDate) {
+            const normalizedDate = normalizeBusinessDateKey(businessDate)
+            if (normalizedDate) {
+                sqlResultCache.invalidatePrefix(`daily-report:date:${normalizedDate}:user:`)
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
+            }
+        }
+        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
+        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
+        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
+
+        await publishToSseStream(
+            commentDeleteMessageSchema.parse({
+                type: "comment-delete",
+                reportHubId: reportHubId,
+                commentId,
+                clientTempId,
+            }),
+            "deleteComment",
+        )
+    }
+
+    /**
+     * Creates a new draft daily report.
+     * 新しい日報（下書き）を作成する。
+     */
+    const createDailyReport = async (userId: number, businessDate: string, clientTempId: string): Promise<DailyReportDetail> => {
+        logger.info("createDailyReport called", { userId, businessDate })
+
+        // ユーザー名取得
+        const [user] = await db.select<{ displayName: string | null }>({ displayName: users.displayName }).from(users).where(eq(users.id, userId))
+        const userName = user?.displayName ?? encodeUserId(userId)
+
+        try {
+            const result = await db.transaction(async (tx) => {
+                logger.info("Starting transaction")
+                // 1. Hub作成
+                const sourceId = `internal-temp-${Date.now()}-${Math.random()}` // 一時的なID
+                const [hub] = await tx
+                    .insert<DailyReportHubRow>(DailyReportHub)
+                    .output()
+                    .values({
+                        sourceType: "Internal",
+                        sourceId: sourceId,
+                        businessDate: new Date(businessDate),
+                        userId: userId,
+                        title: "(無題)",
+                        createdAt: new Date(),
+                        createdBy: String(userId),
+                        updatedAt: new Date(),
+                        updatedBy: String(userId),
+                    })
+
+                // sourceId を id と同じ値に更新 (Internal の場合の正規化)
+                await tx
+                    .update(DailyReportHub)
+                    .set({ sourceId: String(hub.id) })
+                    .where(eq(DailyReportHub.id, hub.id))
+
+                logger.info("Hub created", hub)
+
+                // 2. Internal作成
+                await tx.insert(DailyReportInternal).values({
+                    hubId: hub.id,
+                    body: "",
+                    createdAt: new Date(),
+                    createdBy: String(userId),
+                    updatedAt: new Date(),
+                    updatedBy: String(userId),
+                })
+                logger.info("Internal created")
+
+                // 3. ラベル付与
+                logger.info("Calling getDraftLabelId")
+                const draftLabelId = await getDraftLabelId()
+                logger.info("draftLabelId", draftLabelId)
+                const labels: DailyReportLabelDef[] = []
+                if (draftLabelId) {
+                    await tx.insert(DailyReportHub_Label).values({
+                        hubId: hub.id,
+                        labelId: draftLabelId,
+                        createdAt: new Date(),
+                        createdBy: String(userId),
+                    })
+                    labels.push({ id: draftLabelId, name: draftLabelName, color: null })
+                }
+                logger.info("Label assigned")
+
+                // 4. 詳細オブジェクト構築
+                return {
+                    reportHubId: hub.id,
+                    date: businessDate,
+                    createdAt: formatDateValue(hub.createdAt, "YYYY-MM-DD HH:mm:ss"),
+                    author: userName,
+                    userId: encodeUserId(userId),
+                    employeeName: userName,
+                    // 監査列と同様、クライアント公開時は生内部 ID を難読化する (mapHubRecord と整合)
+                    updatedBy: encodeUserId(userId),
+                    updatedAt: formatDateValue(hub.updatedAt, "YYYY-MM-DD HH:mm:ss"),
+                    category: null,
+                    creationCategory: null,
+                    visitTimeFrom: null,
+                    visitTimeTo: null,
+                    customerName: null,
+                    interviewers: [],
+                    subject: hub.title,
+                    content: "",
+                    comments: [],
+                    isRead: true, // 自分で作ったので既読
+                    isStarred: false,
+                    labels: labels,
+                    commentItems: [],
+                }
+            })
+
+            // キャッシュ無効化
+            const normalizedBusinessDate = normalizeBusinessDateKey(businessDate)
+            if (normalizedBusinessDate) {
+                sqlResultCache.invalidate(`daily-report:date:${normalizedBusinessDate}:user:${userId}`)
+            }
+            sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
+            sqlResultCache.invalidate(`${DAILY_REPORT_IDS_CACHE_KEY}:user:${userId}`)
+            // ❗ 順序重要: invalidate → incrementRedisEpoch → publishToSseStream
+            await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
+            if (normalizedBusinessDate) {
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedBusinessDate}`)
+            }
+
+            const fullDetail = await getDailyReportDetailById(result.reportHubId, userId, { forceRefresh: true })
+
+            if (fullDetail) {
+                // 下書き判定
+                const draftLabelId = await getDraftLabelId()
+                const isDraft = draftLabelId ? fullDetail.labels.some((l) => l.id === draftLabelId) : false
+                await publishToSseStream(
+                    reportCreateMessageSchema.parse({
+                        type: "report-create",
+                        reportHubId: fullDetail.reportHubId,
+                        report: fullDetail,
+                        clientTempId,
+                        recipientRawUserId: isDraft ? userId : undefined,
+                    }),
+                    "createDailyReport",
+                )
+            }
+
+            return fullDetail ?? result
+        } catch (e) {
+            logger.error("Error in createDailyReport", e)
+            throw e
+        }
+    }
+
+    // --- Internal Repository Layer ---
+
+    /**
+     * Finds a DailyReportHub by ID.
+     * 日報HubをIDで検索する。
+     */
+    const findDailyReportHubById = async (tx: DailyReportDb, reportHubId: number) => {
+        return await tx.select<DailyReportHubRow>().top(1).from(DailyReportHub).where(eq(DailyReportHub.id, reportHubId))
+    }
+
+    /**
+     * Updates a DailyReportHub.
+     * 日報Hubを更新する。
+     */
+    const updateDailyReportHub = async (tx: DailyReportDb, reportHubId: number, data: Partial<DailyReportHubRow>) => {
+        await tx.update(DailyReportHub).set(data).where(eq(DailyReportHub.id, reportHubId))
+    }
+
+    /**
+     * Updates a DailyReportInternal.
+     * 日報Internalを更新する。
+     */
+    const updateDailyReportInternal = async (tx: DailyReportDb, hubId: number, data: Partial<DailyReportInternalRow>) => {
+        await tx.update(DailyReportInternal).set(data).where(eq(DailyReportInternal.hubId, hubId))
+    }
+
+    /**
+     * Deletes a label from a DailyReportHub.
+     * 日報Hubからラベルを削除する。
+     */
+    const deleteDailyReportLabel = async (tx: DailyReportDb, hubId: number, labelId: number) => {
+        await tx.delete(DailyReportHub_Label).where(and(eq(DailyReportHub_Label.hubId, hubId), eq(DailyReportHub_Label.labelId, labelId)))
+    }
+
+    // --- Service Layer ---
+
+    /**
+     * Logically deletes a daily report.
+     * 日報を論理削除する。
+     */
+    const deleteDailyReport = async (reportHubId: number, userId: number, clientTempId: string): Promise<void> => {
+        const report = await findDailyReportHubById(db, reportHubId)
+        if (!report.length || report[0].deletedAt) {
+            throw new Error("Not Found")
+        }
+        if (report[0].userId !== userId) {
+            throw new Error("Unauthorized")
+        }
+
+        await updateDailyReportHub(db, reportHubId, {
+            deletedAt: new Date(),
+            deletedBy: String(userId),
+            updatedAt: new Date(),
+            updatedBy: String(userId),
+        })
+
+        // キャッシュ無効化
+        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
+        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
+        // 削除されたレポートは全ユーザーの一覧から消えるため、全ユーザーの IDs キャッシュを invalidate
+        sqlResultCache.invalidatePrefix(DAILY_REPORT_IDS_CACHE_KEY)
+        // ❗ 順序重要: invalidatePrefix → incrementRedisEpoch → publishToSseStream
+        await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
+        if (report[0].businessDate) {
+            const normalizedDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
+            if (normalizedDate) {
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
+            }
+        }
+
+        await publishToSseStream(
+            reportDeleteMessageSchema.parse({
+                type: "report-delete",
+                reportHubId: reportHubId,
+                clientTempId,
+            }),
+            "deleteDailyReport",
+        )
+    }
+
+    /**
+     * Updates an existing daily report.
+     * 日報を更新する。
+     */
+    const updateDailyReport = async (reportHubId: number, userId: number, data: { title?: string; content?: string }, clientTempId: string): Promise<void> => {
+        const report = await findDailyReportHubById(db, reportHubId)
+        if (!report.length || report[0].deletedAt) {
+            throw new Error("Not Found")
+        }
+        if (report[0].userId !== userId) {
+            throw new Error("Unauthorized")
+        }
+
+        await db.transaction(async (tx) => {
+            if (data.title !== undefined) {
+                await updateDailyReportHub(tx, reportHubId, {
+                    title: data.title,
+                    updatedAt: new Date(),
+                    updatedBy: String(userId),
+                })
+            }
+            if (data.content !== undefined) {
+                await updateDailyReportInternal(tx, reportHubId, {
+                    body: data.content,
+                    updatedAt: new Date(),
+                    updatedBy: String(userId),
+                })
+            }
+        })
+
+        // キャッシュ無効化
+        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
+        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
+
+        const fullDetail = await getDailyReportDetailById(reportHubId, userId, { forceRefresh: true })
+        if (fullDetail) {
+            // 下書き判定
+            const draftLabelId = await getDraftLabelId()
+            const isDraft = draftLabelId ? fullDetail.labels.some((l) => l.id === draftLabelId) : false
+            await publishToSseStream(
+                reportUpdateMessageSchema.parse({
+                    type: "report-update",
+                    reportHubId: fullDetail.reportHubId,
+                    report: fullDetail,
+                    clientTempId,
+                    recipientRawUserId: isDraft ? userId : undefined,
+                }),
+                "updateDailyReport",
+            )
+        }
+    }
+
+    /**
+     * Publishes a draft daily report.
+     * 日報を公開する（下書きラベルを削除）。
+     */
+    const publishDailyReport = async (reportHubId: number, userId: number, clientTempId: string): Promise<DailyReportDetail | null> => {
+        const report = await findDailyReportHubById(db, reportHubId)
+        if (!report.length) {
+            throw new Error("Not Found")
+        }
+        if (report[0].userId !== userId) {
+            throw new Error("Unauthorized")
+        }
+
+        const draftLabelId = await getDraftLabelId()
+        if (!draftLabelId) return null
+
+        await deleteDailyReportLabel(db, reportHubId, draftLabelId)
+
+        // キャッシュ無効化
+        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
+        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
+        // 公開によりドラフトが全ユーザーに可視化されるため、全ユーザーの IDs キャッシュを invalidate
+        sqlResultCache.invalidatePrefix(DAILY_REPORT_IDS_CACHE_KEY)
+        // ❗ 順序重要: invalidatePrefix → incrementRedisEpoch → publishToSseStream
+        await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
+        if (report[0].businessDate) {
+            const normalizedDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
+            if (normalizedDate) {
+                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
+            }
+        }
+
+        // ユーザーごとの営業日別一覧キャッシュも無効化
+        const normalizedBusinessDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
+        if (normalizedBusinessDate) {
+            sqlResultCache.invalidate(`daily-report:date:${normalizedBusinessDate}:user:${userId}`)
+        }
+
+        const fullDetail = await getDailyReportDetailById(reportHubId, userId, { forceRefresh: true })
+        if (fullDetail) {
+            await publishToSseStream(
+                reportPublishMessageSchema.parse({
+                    type: "report-publish",
+                    reportHubId: fullDetail.reportHubId,
+                    report: fullDetail,
+                    clientTempId,
+                }),
+                "publishDailyReport",
+            )
+        }
+        return fullDetail ?? null
+    }
+
+    return {
+        // 定数 (アプリ側の互換 export 用)
+        streamKey: DAILY_REPORT_SSE_STREAM_KEY,
+        streamMaxLen: DAILY_REPORT_SSE_STREAM_MAXLEN,
+        // ユーザー解決
+        getUserIdByExternalId,
+        // 参照系
+        getDailyReportIdsByExternalId,
+        getDailyReportsByBusinessDate,
+        getDailyReportsByBusinessDateByExternalId,
+        getDailyReportDetailById,
+        getDailyReportDetailByIdByExternalId,
+        getDraftLabelId,
+        // 更新系
+        setStarStatus,
+        setReadStatus,
+        addComment,
+        deleteComment,
+        createDailyReport,
+        updateDailyReport,
+        publishDailyReport,
+        deleteDailyReport,
+        // リポジトリヘルパー (統合テスト等からの直接利用向け)
+        findDailyReportHubById,
+        updateDailyReportHub,
+        updateDailyReportInternal,
+        deleteDailyReportLabel,
+    }
+}