@allbluecn/web-app 0.18.2 → 0.19.0

package/src/components/story/views/timeline/__tests__/sentinel-geometry.test.ts

@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+// sentinelMirrorTop 几何契约锁定（复审修复轮 2）。
+// 量纲取自真实实测帧：topOffset=49、clientHeight=755、scrollHeight=8274、
+// rowH=28（h-7）。derived：overlayH = topOffset + clientHeight = 804、
+// maxScroll = scrollHeight - clientHeight = 7519、
+// maxTop（行完整可见上限）= overlayH - rowH = 776。
+import { describe, expect, it } from "vitest";
+
+import { sentinelMirrorTop } from "../sentinel-geometry";
+
+const TOP_OFFSET = 49;
+const CLIENT_H = 755;
+const SCROLL_H = 8274;
+const ROW_H = 28;
+// custom 滚动条无布局空隙：覆盖层高与 viewport 底缘齐平
+const OVERLAY_H = TOP_OFFSET + CLIENT_H;
+const MAX_SCROLL = SCROLL_H - CLIENT_H;
+// 行整体位于覆盖层裁剪盒内的充分必要条件：top + rowH ≤ overlayH
+const at = (scrollTop: number, scrollHeight = SCROLL_H) =>
+  sentinelMirrorTop({
+    scrollTop,
+    scrollHeight,
+    clientHeight: CLIENT_H,
+    rowH: ROW_H,
+    topOffset: TOP_OFFSET,
+  });
+
+describe("sentinelMirrorTop（哨兵镜像几何）", () => {
+  it("顶部未到底：镜像行整体在覆盖层裁剪盒之外（被裁剪，不触发）", () => {
+    const top = at(0);
+    expect(top).toBe(TOP_OFFSET + SCROLL_H - ROW_H);
+    // 行底越过覆盖层底缘 → 完全被 overflow-hidden 裁掉
+    expect(top + ROW_H).toBeGreaterThan(OVERLAY_H);
+  });
+
+  it("滚到底：行恰好完整进入覆盖层（底边贴缘）→ 触发窗口", () => {
+    const top = at(MAX_SCROLL);
+    expect(top).toBe(OVERLAY_H - ROW_H);
+    expect(top).toBeGreaterThanOrEqual(0);
+    expect(top + ROW_H).toBe(OVERLAY_H);
+    // 触发窗口 = 最后 rowH 滚动行程：顶边越入盒缘即非零交集（触发），
+    // 此前行顶在盒缘之外（零交集，不触发）
+    expect(at(MAX_SCROLL - ROW_H)).toBe(OVERLAY_H);
+    expect(at(MAX_SCROLL - ROW_H + 1)).toBeLessThan(OVERLAY_H);
+  });
+
+  it("加载后 scrollHeight 增大：镜像整体退回裁剪盒之外 → 重新武装", () => {
+    // 一页 200 行落地后（滚动位置停在底部不变）
+    const top = at(MAX_SCROLL, SCROLL_H + 7200);
+    expect(top).toBe(at(MAX_SCROLL) + 7200);
+    expect(top + ROW_H).toBeGreaterThan(OVERLAY_H);
+  });
+
+  it("hasMore=false 终态：滚到底行完整可见（「已全部加载」标签可达）且计算幂等", () => {
+    const first = at(MAX_SCROLL);
+    const second = at(MAX_SCROLL);
+    expect(first).toBe(second);
+    expect(first + ROW_H).toBeLessThanOrEqual(OVERLAY_H);
+  });
+});

package/src/components/story/views/timeline/__tests__/use-date-commit.test.tsx

@@ -0,0 +1,372 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2026 AllBlue Contributors
+
+// 甘特改期乐观提交 hook 的行为钉：
+// ① 提交成功 → override map 含新日期（乐观写入先于落库）
+// ② serverFn reject → override 被清除（受控 events 天然还原）+ toast.error 被调
+// ③ cancelled 只读：commitStoryRange 返回 false，不调 serverFn、不写 override
+// ④ start-only（有 startDate 无 targetDate）提交只带 startDate —— 不传
+//    targetDate 键（updateStoryFn 部分更新契约：undefined = 保持原 null），
+//    杜绝拖位置隐式造出截止日期
+import { act, renderHook, waitFor } from "@testing-library/react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+vi.mock("@/components/ui/toast", () => ({
+  toast: {
+    success: vi.fn(),
+    error: vi.fn(),
+    info: vi.fn(),
+    warning: vi.fn(),
+    message: vi.fn(),
+  },
+}));
+
+import { toast } from "@/components/ui/toast";
+import { useDateCommit, type StoryDateOverride } from "../use-date-commit";
+import type { DateCommittableStory } from "../use-date-commit";
+
+const updateStory = vi.fn<(args: { data: Record<string, unknown> }) => Promise<unknown>>();
+
+function makeOptions(overrides: Map<string, StoryDateOverride>) {
+  return {
+    onCommit: (id: string, dates: StoryDateOverride) => {
+      overrides.set(id, dates);
+    },
+    onReject: (id: string) => {
+      overrides.delete(id);
+    },
+  };
+}
+
+afterEach(() => {
+  vi.clearAllMocks();
+});
+
+describe("useDateCommit", () => {
+  it("提交成功 → override map 含新日期，payload 为区间回写", async () => {
+    updateStory.mockResolvedValue({});
+    const overrides = new Map<string, StoryDateOverride>();
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, makeOptions(overrides)),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s1",
+      state: "todo",
+      startDate: "2026-10-01",
+      targetDate: "2026-10-05",
+    };
+    let accepted = false;
+    act(() => {
+      // 甘特半开区间：start=10-02，end=10-07 → targetDate = end-1 = 10-06
+      accepted = result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 7),
+      );
+    });
+
+    expect(accepted).toBe(true);
+    expect(updateStory).toHaveBeenCalledTimes(1);
+    expect(updateStory.mock.calls[0][0]).toEqual({
+      data: { storyId: "s1", startDate: "2026-10-02", targetDate: "2026-10-06" },
+    });
+    expect(overrides.get("s1")).toEqual({
+      startDate: "2026-10-02",
+      targetDate: "2026-10-06",
+    });
+    // 在途标记：提交中 pending=true，落库后 false
+    expect(result.current.isCommitPending("s1")).toBe(true);
+    await act(async () => {
+      await Promise.resolve();
+    });
+    expect(result.current.isCommitPending("s1")).toBe(false);
+    expect(toast.success).toHaveBeenCalled();
+  });
+
+  it("serverFn reject → override 清除 + toast.error 被调", async () => {
+    updateStory.mockRejectedValue(new Error("network down"));
+    const overrides = new Map<string, StoryDateOverride>();
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, makeOptions(overrides)),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s2",
+      state: "in_progress",
+      startDate: "2026-10-01",
+      targetDate: "2026-10-05",
+    };
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 7),
+      );
+    });
+    // 乐观态先写入
+    expect(overrides.has("s2")).toBe(true);
+    // 失败后清除（受控 events 由派生自动还原原位）
+    await waitFor(() => {
+      expect(overrides.has("s2")).toBe(false);
+    });
+    expect(toast.error).toHaveBeenCalled();
+  });
+
+  it("cancelled 需求提交被拒：不调 serverFn、不写 override", () => {
+    updateStory.mockResolvedValue({});
+    const overrides = new Map<string, StoryDateOverride>();
+    const onCommit = vi.fn();
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, {
+        onCommit,
+        onReject: (id) => overrides.delete(id),
+      }),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s3",
+      state: "cancelled",
+      startDate: "2026-10-01",
+      targetDate: "2026-10-05",
+    };
+    let accepted = true;
+    act(() => {
+      accepted = result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 7),
+      );
+    });
+
+    expect(accepted).toBe(false);
+    expect(updateStory).not.toHaveBeenCalled();
+    expect(onCommit).not.toHaveBeenCalled();
+  });
+
+  it("连拖竞态：第一次提交的迟到 reject 不清除第二次提交的 override", async () => {
+    let rejectFirst: (e: unknown) => void = () => {};
+    let resolveSecond: () => void = () => {};
+    const first = new Promise((_, rej) => {
+      rejectFirst = rej;
+    });
+    const second = new Promise<void>((res) => {
+      resolveSecond = res;
+    });
+    updateStory.mockReturnValueOnce(first).mockReturnValueOnce(second);
+    const overrides = new Map<string, StoryDateOverride>();
+    const onReject = vi.fn((id: string) => {
+      overrides.delete(id);
+    });
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, {
+        onCommit: (id, d) => overrides.set(id, d),
+        onReject,
+      }),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s1",
+      state: "todo",
+      startDate: "2026-10-01",
+      targetDate: "2026-10-05",
+    };
+    // 拖到 D1（请求 1 在途）→ 再拖到 D2（请求 2 在途）
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 7),
+      );
+    });
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 3),
+        new Date(2026, 9, 8),
+      );
+    });
+    expect(overrides.get("s1")).toEqual({
+      startDate: "2026-10-03",
+      targetDate: "2026-10-07",
+    });
+
+    // 请求 1 迟到失败：override（D2）不被冲掉、不弹失败 toast
+    await act(async () => {
+      rejectFirst(new Error("stale network failure"));
+      await Promise.resolve();
+    });
+    expect(overrides.get("s1")).toEqual({
+      startDate: "2026-10-03",
+      targetDate: "2026-10-07",
+    });
+    expect(onReject).not.toHaveBeenCalled();
+    expect(toast.error).not.toHaveBeenCalled();
+
+    // 请求 2 成功：DB=D2，UI=D2，无分叉
+    await act(async () => {
+      resolveSecond();
+      await Promise.resolve();
+    });
+    expect(toast.success).toHaveBeenCalled();
+    expect(overrides.get("s1")).toEqual({
+      startDate: "2026-10-03",
+      targetDate: "2026-10-07",
+    });
+  });
+
+  it("start-only 条形提交只写 startDate：payload 不含 targetDate 键，override 保持 null", () => {
+    updateStory.mockResolvedValue({});
+    const overrides = new Map<string, StoryDateOverride>();
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, makeOptions(overrides)),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s4",
+      state: "todo",
+      startDate: "2026-10-01",
+      targetDate: null,
+    };
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 3), // 合成 end = start+1
+      );
+    });
+
+    const payload = updateStory.mock.calls[0][0] as {
+      data: Record<string, unknown>;
+    };
+    expect(payload.data.storyId).toBe("s4");
+    expect(payload.data.startDate).toBe("2026-10-02");
+    // 关键：不传 targetDate 键 → updateStoryFn 保持原 targetDate=null
+    expect("targetDate" in payload.data).toBe(false);
+    expect(overrides.get("s4")).toEqual({
+      startDate: "2026-10-02",
+      targetDate: null,
+    });
+  });
+
+  it("连拖竞态：第一次提交的迟到成功静默（toast 不弹、override 保持第二次提交值）", async () => {
+    // R-7 seq 守卫扩展成功路径：非最新提交的成功不代表用户最终意图
+    //（后续提交已接管），success toast 只能由最新提交触发
+    let resolveFirst: () => void = () => {};
+    let resolveSecond: () => void = () => {};
+    const first = new Promise<void>((res) => {
+      resolveFirst = res;
+    });
+    const second = new Promise<void>((res) => {
+      resolveSecond = res;
+    });
+    updateStory.mockReturnValueOnce(first).mockReturnValueOnce(second);
+    const overrides = new Map<string, StoryDateOverride>();
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, makeOptions(overrides)),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s5",
+      state: "todo",
+      startDate: "2026-10-01",
+      targetDate: "2026-10-05",
+    };
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 7),
+      );
+    });
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 3),
+        new Date(2026, 9, 8),
+      );
+    });
+    const d2 = { startDate: "2026-10-03", targetDate: "2026-10-07" };
+    expect(overrides.get("s5")).toEqual(d2);
+
+    // 请求 1（旧位置 D1）迟到成功：toast 不弹、override 不动（D2 接管）
+    await act(async () => {
+      resolveFirst();
+      await Promise.resolve();
+    });
+    expect(toast.success).not.toHaveBeenCalled();
+    expect(overrides.get("s5")).toEqual(d2);
+
+    // 请求 2（D2，最新）成功：toast 弹出
+    await act(async () => {
+      resolveSecond();
+      await Promise.resolve();
+    });
+    expect(toast.success).toHaveBeenCalledTimes(1);
+    expect(overrides.get("s5")).toEqual(d2);
+  });
+
+  it("seq 条目 settle 后收口：后完成提交清理后，先完成提交的迟到 reject 恒静默", async () => {
+    // commitSeq 无界增长收口的语义自洽证明：条目删除后 get(id) 恒 undefined
+    // ≠ seq → 迟到 reject 不冲 override、不弹失败 toast
+    let resolveSecond: () => void = () => {};
+    let rejectFirst: (e: unknown) => void = () => {};
+    const first = new Promise((_, rej) => {
+      rejectFirst = rej;
+    });
+    const second = new Promise<void>((res) => {
+      resolveSecond = res;
+    });
+    updateStory.mockReturnValueOnce(first).mockReturnValueOnce(second);
+    const overrides = new Map<string, StoryDateOverride>();
+    const onReject = vi.fn((id: string) => {
+      overrides.delete(id);
+    });
+    const { result } = renderHook(() =>
+      useDateCommit(updateStory, {
+        onCommit: (id, d) => overrides.set(id, d),
+        onReject,
+      }),
+    );
+
+    const story: DateCommittableStory = {
+      id: "s6",
+      state: "todo",
+      startDate: "2026-10-01",
+      targetDate: "2026-10-05",
+    };
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 2),
+        new Date(2026, 9, 7),
+      );
+    });
+    act(() => {
+      result.current.commitStoryRange(
+        story,
+        new Date(2026, 9, 3),
+        new Date(2026, 9, 8),
+      );
+    });
+
+    // 请求 2（最新）先成功 → seq 条目被其 settle 收口删除
+    await act(async () => {
+      resolveSecond();
+      await Promise.resolve();
+    });
+    expect(toast.success).toHaveBeenCalledTimes(1);
+
+    // 请求 1 迟到失败：get(id)=undefined ≠ seq → 静默（无 onReject / 无 toast）
+    await act(async () => {
+      rejectFirst(new Error("stale network failure"));
+      await Promise.resolve();
+    });
+    expect(onReject).not.toHaveBeenCalled();
+    expect(toast.error).not.toHaveBeenCalled();
+    expect(overrides.get("s6")).toEqual({
+      startDate: "2026-10-03",
+      targetDate: "2026-10-07",
+    });
+  });
+});

package/src/components/story/views/timeline/i18n.ts

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+/**
+ * 需求时间轴的甘特 i18n 装配：labels 全量走 paraglide 词条（story_gantt_* /
+ * story_gantt_nav_*），禁止硬编码中文字面量；formats 为 date-fns 模板常量
+ * （配合 gantt 的 locale 参数本地化渲染）；functions 由 mergeGanttI18n
+ * 重新绑定到合并后的 labels/formats（continues 等文案自动流入默认渲染器）。
+ */
+import { m } from "@/paraglide/messages.js";
+import { getLocale } from "@/paraglide/runtime.js";
+import { enUS, zhCN, type Locale } from "date-fns/locale";
+import {
+  mergeGanttI18n,
+  type GanttI18nConfig,
+} from "@/components/reui/gantt/gantt-i18n";
+
+/**
+ * date-fns locale：随 paraglide 当前语言装配（zh → zhCN / 其他 → enUS），
+ * 供 Gantt 的 locale prop 驱动轴标签/导航标题/跳转日历的本地化渲染，
+ * zhCN 附带周一起始。仓库先例 agent-card.tsx（zhCN 硬选，此处按语言条件化）。
+ * 函数而非模块常量：locale 须在渲染时求值（测试的 overwriteGetLocale 在
+ * beforeAll 里晚于模块求值；SSR/客户端各自的 cookie locale 也各自生效）。
+ */
+export function ganttDateFnsLocale(): Locale {
+  return getLocale() === "zh" ? zhCN : enUS;
+}
+
+export function buildGanttI18n(): GanttI18nConfig {
+  return mergeGanttI18n({
+    labels: {
+      today: m.story_gantt_nav_today(),
+      previous: m.story_gantt_nav_previous(),
+      next: m.story_gantt_nav_next(),
+      addEvent: m.story_gantt_nav_add_event(),
+      addTask: m.story_gantt_nav_add_task(),
+      allDay: m.story_gantt_nav_all_day(),
+      loading: m.story_gantt_nav_loading(),
+      event: m.story_gantt_nav_event(),
+      // R-8：en 复数在装配层分支——reui labels 本就支持函数值，但 paraglide
+      // plugin-message-format 是扁平 JSON（正则解析 {var}，不支持 ICU match
+      // 复数），只能在装配层判断。zh 无复数形态不受影响（恒走 {count} 词条）。
+      // events 的唯一消费点（gantt-view 离屏 chip）有 length===1 卫兵，单数
+      // 分支属防御；durationDays 单数可达（resize 指示器对 1 天条形显示
+      // "1 days"）。
+      events: (count) =>
+        getLocale() === "zh"
+          ? m.story_gantt_nav_events({ count })
+          : count === 1
+            ? `1 ${m.story_gantt_nav_event()}`
+            : m.story_gantt_nav_events({ count }),
+      week: (weekNumber) => m.story_gantt_nav_week({ week: weekNumber }),
+      resources: m.story_gantt_nav_resources(),
+      goToDate: m.story_gantt_nav_go_to_date(),
+      scheduleHint: m.story_gantt_nav_schedule_hint(),
+      scheduleHintDrag: m.story_gantt_nav_schedule_hint_drag(),
+      reorder: m.story_gantt_nav_reorder(),
+      selectView: m.story_gantt_nav_select_view(),
+      zoomIn: m.story_gantt_nav_zoom_in(),
+      zoomOut: m.story_gantt_nav_zoom_out(),
+      resizePanel: m.story_gantt_nav_resize_panel(),
+      jumpToBar: (title) => m.story_gantt_nav_jump_to_bar({ title }),
+      progress: (percent) => m.story_gantt_nav_progress({ percent }),
+      durationDays: (days) =>
+        getLocale() === "zh"
+          ? m.story_gantt_nav_duration_days({ days })
+          : days === 1
+            ? `1 ${m.story_gantt_nav_day()}`
+            : m.story_gantt_nav_duration_days({ days }),
+      continues: m.story_gantt_nav_continues(),
+      planned: (rangeLabel) => m.story_gantt_nav_planned({ range: rangeLabel }),
+      milestone: m.story_gantt_milestone(),
+      scales: {
+        day: m.story_gantt_nav_scale_day(),
+        week: m.story_gantt_nav_scale_week(),
+        month: m.story_gantt_nav_scale_month(),
+        quarter: m.story_gantt_nav_scale_quarter(),
+        year: m.story_gantt_nav_scale_year(),
+      },
+    },
+  });
+}