@pzy560117/codex-harness 0.1.3 → 0.1.5

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/prd-lite.md

@@ -1,41 +1,41 @@
-# Ticket Filter Demo PRD-Lite
-
-## 1. 背景
-
-- 业务背景: 客服主管需要在工单列表中快速筛选高优先级工单，并保存常用视图。
-- 当前问题: 每次进入系统都要重复配置筛选条件，效率低且容易遗漏。
-- 为什么现在做: 当前团队的工单量增长，手动筛选成本过高。
-
-## 2. 目标
-
-- 业务目标: 提升主管查看和分派工单的效率。
-- 用户目标: 可以按状态、优先级、负责人筛选工单，并保存自己的常用视图。
-- 不做什么: 不做跨用户共享视图；不做复杂图表分析。
-
-## 3. 用户与角色
-
-| 角色 | 使用场景 | 权限差异 |
-| --- | --- | --- |
-| 主管 | 筛选、保存视图、批量分派 | 可创建和删除自己的视图 |
-| 客服 | 查看工单列表 | 只能使用系统默认筛选 |
-
-## 4. 范围
-
-- In scope: 列表筛选、保存视图、空态/错误态、无权限限制
-- Out of scope: 共享视图、导出 Excel、复杂报表
-
-## 5. 页面 / 流程影响
-
-- 受影响页面: 工单列表页
-- 受影响流程: 工单查询、保存筛选视图
-- 受影响接口: `/tickets`、`/ticket-views`
-
-## 6. 成功标准
-
-- 主管可以保存视图并刷新后继续使用
-- 筛选结果可正确展示空态、加载态和错误态
-
-## 7. 风险与依赖
-
-- 主要风险: 设计稿只覆盖 happy path 会导致状态缺失
-- 外部依赖: 需要统一 OpenAPI contract 和 generated client
+# Ticket Filter Demo PRD-Lite
+
+## 1. 背景
+
+- 业务背景: 客服主管需要在工单列表中快速筛选高优先级工单，并保存常用视图。
+- 当前问题: 每次进入系统都要重复配置筛选条件，效率低且容易遗漏。
+- 为什么现在做: 当前团队的工单量增长，手动筛选成本过高。
+
+## 2. 目标
+
+- 业务目标: 提升主管查看和分派工单的效率。
+- 用户目标: 可以按状态、优先级、负责人筛选工单，并保存自己的常用视图。
+- 不做什么: 不做跨用户共享视图；不做复杂图表分析。
+
+## 3. 用户与角色
+
+| 角色 | 使用场景 | 权限差异 |
+| --- | --- | --- |
+| 主管 | 筛选、保存视图、批量分派 | 可创建和删除自己的视图 |
+| 客服 | 查看工单列表 | 只能使用系统默认筛选 |
+
+## 4. 范围
+
+- In scope: 列表筛选、保存视图、空态/错误态、无权限限制
+- Out of scope: 共享视图、导出 Excel、复杂报表
+
+## 5. 页面 / 流程影响
+
+- 受影响页面: 工单列表页
+- 受影响流程: 工单查询、保存筛选视图
+- 受影响接口: `/tickets`、`/ticket-views`
+
+## 6. 成功标准
+
+- 主管可以保存视图并刷新后继续使用
+- 筛选结果可正确展示空态、加载态和错误态
+
+## 7. 风险与依赖
+
+- 主要风险: 设计稿只覆盖 happy path 会导致状态缺失
+- 外部依赖: 需要统一 OpenAPI contract 和 generated client

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/requirement-interface-matrix.md

@@ -1,32 +1,32 @@
-# Requirement Interface Matrix
-
-## 1. 需求到界面映射
-
-| Requirement ID | 需求摘要 | 用户角色 | 关联页面 / 视图 | 页面状态 | UI 元素 / 操作 | 关联字段 | 依赖接口 | 验收标准 | 覆盖状态 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| FR-001 | 按状态、优先级、负责人筛选工单 | 主管 / 客服 | ticket-list | default / empty / loading / error | `TicketFilterBar` | status, priority, assigneeId | `GET /tickets` | AC-001 | Covered |
-| FR-002 | 保存当前筛选视图 | 主管 | ticket-list / saved-view-modal | default / validation-error / permission_denied | `SavedViewModal` | name, filters | `POST /ticket-views` | AC-002 | Covered |
-| FR-003 | 无权限用户不能保存视图 | 客服 | ticket-list | permission_denied | 保存视图按钮隐藏 | role | `GET /ticket-views` | AC-003 | Covered |
-
-## 2. 界面到需求反查
-
-| Page ID | 页面 / 视图 | 页面目标 | 覆盖需求 | 未覆盖需求 | 多余功能风险 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- |
-| ticket-list | 工单列表页 | 筛选工单并管理个人视图 | FR-001, FR-002, FR-003 | 无 | 无导出、无共享视图 | |
-| saved-view-modal | 保存视图弹窗 | 命名并保存当前筛选条件 | FR-002 | 无 | 不支持共享给他人 | |
-
-## 3. 状态到需求映射
-
-| Page ID | State | 触发需求 / 业务规则 | 用户可见表现 | 依赖数据 / 接口 | 验收标准 | 设计图 |
-| --- | --- | --- | --- | --- | --- | --- |
-| ticket-list | default | FR-001 | 筛选条、保存视图按钮、工单表格 | `GET /tickets` | AC-001 | IMG-001 |
-| ticket-list | empty | FR-001 | 空态文案和清除筛选入口 | `GET /tickets` 返回空列表 | AC-E001 | IMG-002 |
-| ticket-list | loading | FR-001 | 表格骨架屏，筛选操作禁用 | `GET /tickets` 请求中 | AC-E002 | IMG-003 |
-| ticket-list | error | FR-001 | 内联错误提示和重试按钮 | `GET /tickets` 报错 | AC-E003 | IMG-004 |
-| ticket-list | permission_denied | FR-003 | 客服不显示保存视图入口 | 用户角色 | AC-003 | IMG-005 |
-
-## 4. 缺口清单
-
-| Gap ID | 缺口类型 | 描述 | 影响阶段 | 处理方式 | 负责人 | 截止 |
-| --- | --- | --- | --- | --- | --- | --- |
-| GAP-000 | 无 | 当前 demo 的 P0/P1 需求已有界面映射 | - | - | - | - |
+# Requirement Interface Matrix
+
+## 1. 需求到界面映射
+
+| Requirement ID | 需求摘要 | 用户角色 | 关联页面 / 视图 | 页面状态 | UI 元素 / 操作 | 关联字段 | 依赖接口 | 验收标准 | 覆盖状态 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| FR-001 | 按状态、优先级、负责人筛选工单 | 主管 / 客服 | ticket-list | default / empty / loading / error | `TicketFilterBar` | status, priority, assigneeId | `GET /tickets` | AC-001 | Covered |
+| FR-002 | 保存当前筛选视图 | 主管 | ticket-list / saved-view-modal | default / validation-error / permission_denied | `SavedViewModal` | name, filters | `POST /ticket-views` | AC-002 | Covered |
+| FR-003 | 无权限用户不能保存视图 | 客服 | ticket-list | permission_denied | 保存视图按钮隐藏 | role | `GET /ticket-views` | AC-003 | Covered |
+
+## 2. 界面到需求反查
+
+| Page ID | 页面 / 视图 | 页面目标 | 覆盖需求 | 未覆盖需求 | 多余功能风险 | 备注 |
+| --- | --- | --- | --- | --- | --- | --- |
+| ticket-list | 工单列表页 | 筛选工单并管理个人视图 | FR-001, FR-002, FR-003 | 无 | 无导出、无共享视图 | |
+| saved-view-modal | 保存视图弹窗 | 命名并保存当前筛选条件 | FR-002 | 无 | 不支持共享给他人 | |
+
+## 3. 状态到需求映射
+
+| Page ID | State | 触发需求 / 业务规则 | 用户可见表现 | 依赖数据 / 接口 | 验收标准 | 设计图 |
+| --- | --- | --- | --- | --- | --- | --- |
+| ticket-list | default | FR-001 | 筛选条、保存视图按钮、工单表格 | `GET /tickets` | AC-001 | IMG-001 |
+| ticket-list | empty | FR-001 | 空态文案和清除筛选入口 | `GET /tickets` 返回空列表 | AC-E001 | IMG-002 |
+| ticket-list | loading | FR-001 | 表格骨架屏，筛选操作禁用 | `GET /tickets` 请求中 | AC-E002 | IMG-003 |
+| ticket-list | error | FR-001 | 内联错误提示和重试按钮 | `GET /tickets` 报错 | AC-E003 | IMG-004 |
+| ticket-list | permission_denied | FR-003 | 客服不显示保存视图入口 | 用户角色 | AC-003 | IMG-005 |
+
+## 4. 缺口清单
+
+| Gap ID | 缺口类型 | 描述 | 影响阶段 | 处理方式 | 负责人 | 截止 |
+| --- | --- | --- | --- | --- | --- | --- |
+| GAP-000 | 无 | 当前 demo 的 P0/P1 需求已有界面映射 | - | - | - | - |

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/state-matrix.yaml

@@ -1,14 +1,14 @@
-page: ticket-list
-states:
-  default:
-    description: 显示最近工单列表和默认筛选条
-  empty:
-    description: 筛选后无结果，展示空态文案和清除筛选入口
-  loading:
-    description: 查询工单时展示骨架屏和禁用操作
-  error:
-    description: 查询失败时展示错误提示和重试按钮
-  permission_denied:
-    description: 普通客服不可见保存视图入口
-  responsive_mobile:
-    description: 移动端筛选条折叠为抽屉
+page: ticket-list
+states:
+  default:
+    description: 显示最近工单列表和默认筛选条
+  empty:
+    description: 筛选后无结果，展示空态文案和清除筛选入口
+  loading:
+    description: 查询工单时展示骨架屏和禁用操作
+  error:
+    description: 查询失败时展示错误提示和重试按钮
+  permission_denied:
+    description: 普通客服不可见保存视图入口
+  responsive_mobile:
+    description: 移动端筛选条折叠为抽屉

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/generated/model/Ticket.ts

@@ -1,6 +1,6 @@
-export type Ticket = {
-  id: string;
-  title: string;
-  status: "open" | "pending" | "resolved";
-  priority: "low" | "medium" | "high";
-};
+export type Ticket = {
+  id: string;
+  title: string;
+  status: "open" | "pending" | "resolved";
+  priority: "low" | "medium" | "high";
+};

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/generated/ticket-api.ts

@@ -1,35 +1,35 @@
-/**
- * Example generated client output.
- * In a real project this file should be generated from contracts/openapi.yaml by Orval.
- */
-
-export type Ticket = {
-  id: string;
-  title: string;
-  status: "open" | "pending" | "resolved";
-  priority: "low" | "medium" | "high";
-};
-
-export type ListTicketsParams = {
-  status?: Ticket["status"];
-  priority?: Ticket["priority"];
-  assigneeId?: string;
-};
-
-export async function listTickets(params: ListTicketsParams): Promise<Ticket[]> {
-  const query = new URLSearchParams(
-    Object.entries(params).reduce<Record<string, string>>((accumulator, [key, value]) => {
-      if (value) {
-        accumulator[key] = value;
-      }
-      return accumulator;
-    }, {}),
-  );
-
-  const response = await fetch(`/tickets?${query.toString()}`);
-  if (!response.ok) {
-    throw new Error(`Failed to list tickets: ${response.status}`);
-  }
-
-  return response.json();
-}
+/**
+ * Example generated client output.
+ * In a real project this file should be generated from contracts/openapi.yaml by Orval.
+ */
+
+export type Ticket = {
+  id: string;
+  title: string;
+  status: "open" | "pending" | "resolved";
+  priority: "low" | "medium" | "high";
+};
+
+export type ListTicketsParams = {
+  status?: Ticket["status"];
+  priority?: Ticket["priority"];
+  assigneeId?: string;
+};
+
+export async function listTickets(params: ListTicketsParams): Promise<Ticket[]> {
+  const query = new URLSearchParams(
+    Object.entries(params).reduce<Record<string, string>>((accumulator, [key, value]) => {
+      if (value) {
+        accumulator[key] = value;
+      }
+      return accumulator;
+    }, {}),
+  );
+
+  const response = await fetch(`/tickets?${query.toString()}`);
+  if (!response.ok) {
+    throw new Error(`Failed to list tickets: ${response.status}`);
+  }
+
+  return response.json();
+}

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/http-client.ts

@@ -1,8 +1,8 @@
-export async function httpClient<T>(url: string, init?: RequestInit): Promise<T> {
-  const response = await fetch(url, init);
-  if (!response.ok) {
-    throw new Error(`HTTP ${response.status}`);
-  }
-
-  return response.json() as Promise<T>;
-}
+export async function httpClient<T>(url: string, init?: RequestInit): Promise<T> {
+  const response = await fetch(url, init);
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}`);
+  }
+
+  return response.json() as Promise<T>;
+}

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/ui/TicketFilterBar.tsx

@@ -1,72 +1,72 @@
-type TicketFilter = {
-  status?: "open" | "pending" | "resolved";
-  priority?: "low" | "medium" | "high";
-  assigneeId?: string;
-};
-
-type TicketFilterBarProps = {
-  value: TicketFilter;
-  dirty?: boolean;
-  loading?: boolean;
-  onChange: (next: TicketFilter) => void;
-  onSaveView?: () => void;
-};
-
-export function TicketFilterBar({
-  value,
-  dirty = false,
-  loading = false,
-  onChange,
-  onSaveView,
-}: TicketFilterBarProps) {
-  return (
-    <section aria-label="Ticket filters">
-      <div>
-        <label>
-          Status
-          <select
-            value={value.status ?? ""}
-            disabled={loading}
-            onChange={(event) =>
-              onChange({
-                ...value,
-                status: (event.target.value || undefined) as TicketFilter["status"],
-              })
-            }
-          >
-            <option value="">All</option>
-            <option value="open">Open</option>
-            <option value="pending">Pending</option>
-            <option value="resolved">Resolved</option>
-          </select>
-        </label>
-
-        <label>
-          Priority
-          <select
-            value={value.priority ?? ""}
-            disabled={loading}
-            onChange={(event) =>
-              onChange({
-                ...value,
-                priority: (event.target.value || undefined) as TicketFilter["priority"],
-              })
-            }
-          >
-            <option value="">All</option>
-            <option value="low">Low</option>
-            <option value="medium">Medium</option>
-            <option value="high">High</option>
-          </select>
-        </label>
-      </div>
-
-      <div>
-        {dirty ? <span>Unsaved filter changes</span> : <span>Filters synced</span>}
-        <button type="button" disabled={loading || !onSaveView} onClick={onSaveView}>
-          Save view
-        </button>
-      </div>
-    </section>
-  );
-}
+type TicketFilter = {
+  status?: "open" | "pending" | "resolved";
+  priority?: "low" | "medium" | "high";
+  assigneeId?: string;
+};
+
+type TicketFilterBarProps = {
+  value: TicketFilter;
+  dirty?: boolean;
+  loading?: boolean;
+  onChange: (next: TicketFilter) => void;
+  onSaveView?: () => void;
+};
+
+export function TicketFilterBar({
+  value,
+  dirty = false,
+  loading = false,
+  onChange,
+  onSaveView,
+}: TicketFilterBarProps) {
+  return (
+    <section aria-label="Ticket filters">
+      <div>
+        <label>
+          Status
+          <select
+            value={value.status ?? ""}
+            disabled={loading}
+            onChange={(event) =>
+              onChange({
+                ...value,
+                status: (event.target.value || undefined) as TicketFilter["status"],
+              })
+            }
+          >
+            <option value="">All</option>
+            <option value="open">Open</option>
+            <option value="pending">Pending</option>
+            <option value="resolved">Resolved</option>
+          </select>
+        </label>
+
+        <label>
+          Priority
+          <select
+            value={value.priority ?? ""}
+            disabled={loading}
+            onChange={(event) =>
+              onChange({
+                ...value,
+                priority: (event.target.value || undefined) as TicketFilter["priority"],
+              })
+            }
+          >
+            <option value="">All</option>
+            <option value="low">Low</option>
+            <option value="medium">Medium</option>
+            <option value="high">High</option>
+          </select>
+        </label>
+      </div>
+
+      <div>
+        {dirty ? <span>Unsaved filter changes</span> : <span>Filters synced</span>}
+        <button type="button" disabled={loading || !onSaveView} onClick={onSaveView}>
+          Save view
+        </button>
+      </div>
+    </section>
+  );
+}

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/plans/features/ticket-filter.dev-plan.md

@@ -1,48 +1,48 @@
-# DEV-PLAN
-
-## 1. 基本信息
-
-- `feature_id`: `FEAT-TICKET-FILTER`
-- `title`: `工单筛选与保存视图`
-
-## 2. 真相源
-
-- Product Spec: `docs/product/prd-lite.md`
-- Design Brief: `docs/design/design-brief.md`
-- Frontend Quality Rules: `docs/harness/frontend-quality-rules.md`
-- Frontend Architecture: `docs/design/frontend-architecture.md`
-- 状态矩阵: `docs/product/state-matrix.yaml`
-- Component Map: `docs/design/component-map.md`
-- Screen States: `docs/design/screen-states.md`
-- Contract: `contracts/openapi.yaml`
-
-## 3. Phase 划分
-
-### Phase 1
-
-- 目标: 冻结 Product Spec、Design Brief、状态矩阵和前端质量等级
-- 交付物: `docs/product/*`、`docs/design/design-brief.md`
-
-### Phase 2
-
-- 目标: 完成 frontend-architecture、component-map、screen-states、contract
-- 交付物: `frontend-architecture.md`、`component-map.md`、`screen-states.md`、`openapi.yaml`
-
-### Phase 3
-
-- 目标: 实现前端组件与页面
-- 交付物: `TicketFilterBar`、`TicketFilterDrawer`、`SavedViewModal`、`TicketTable`、stories
-
-### Phase 4
-
-- 目标: 联调、E2E、visual regression、a11y smoke 和 responsive screenshots
-- 交付物: generated client、mock、测试、desktop/mobile 截图证据
-
-## 4. Task 拆分
-
-| Task ID | Phase | 目标 | 依赖 | 验证命令 | 状态 |
-| --- | --- | --- | --- | --- | --- |
-| T001 | P2 | 冻结 OpenAPI 与 generated client | P1 | contract validate | todo |
-| T002 | P3 | 实现 `TicketFilterBar`、响应式筛选抽屉与 stories | T001 | typecheck + story | todo |
-| T003 | P3 | 实现 `SavedViewModal` 与 stories | T001 | typecheck + unit | todo |
-| T004 | P4 | 联调、响应式、a11y 与视觉回归 | T002,T003 | e2e + visual + a11y smoke | todo |
+# DEV-PLAN
+
+## 1. 基本信息
+
+- `feature_id`: `FEAT-TICKET-FILTER`
+- `title`: `工单筛选与保存视图`
+
+## 2. 真相源
+
+- Product Spec: `docs/product/prd-lite.md`
+- Design Brief: `docs/design/design-brief.md`
+- Frontend Quality Rules: `docs/harness/frontend-quality-rules.md`
+- Frontend Architecture: `docs/design/frontend-architecture.md`
+- 状态矩阵: `docs/product/state-matrix.yaml`
+- Component Map: `docs/design/component-map.md`
+- Screen States: `docs/design/screen-states.md`
+- Contract: `contracts/openapi.yaml`
+
+## 3. Phase 划分
+
+### Phase 1
+
+- 目标: 冻结 Product Spec、Design Brief、状态矩阵和前端质量等级
+- 交付物: `docs/product/*`、`docs/design/design-brief.md`
+
+### Phase 2
+
+- 目标: 完成 frontend-architecture、component-map、screen-states、contract
+- 交付物: `frontend-architecture.md`、`component-map.md`、`screen-states.md`、`openapi.yaml`
+
+### Phase 3
+
+- 目标: 实现前端组件与页面
+- 交付物: `TicketFilterBar`、`TicketFilterDrawer`、`SavedViewModal`、`TicketTable`、stories
+
+### Phase 4
+
+- 目标: 联调、E2E、visual regression、a11y smoke 和 responsive screenshots
+- 交付物: generated client、mock、测试、desktop/mobile 截图证据
+
+## 4. Task 拆分
+
+| Task ID | Phase | 目标 | 依赖 | 验证命令 | 状态 |
+| --- | --- | --- | --- | --- | --- |
+| T001 | P2 | 冻结 OpenAPI 与 generated client | P1 | contract validate | todo |
+| T002 | P3 | 实现 `TicketFilterBar`、响应式筛选抽屉与 stories | T001 | typecheck + story | todo |
+| T003 | P3 | 实现 `SavedViewModal` 与 stories | T001 | typecheck + unit | todo |
+| T004 | P4 | 联调、响应式、a11y 与视觉回归 | T002,T003 | e2e + visual + a11y smoke | todo |

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/progress.txt

@@ -1 +1 @@
-
+

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/stories/TicketFilterBar.stories.tsx

@@ -1,33 +1,33 @@
-import type { Meta, StoryObj } from "@storybook/react";
-import { TicketFilterBar } from "../packages/ui/TicketFilterBar";
-
-const meta = {
-  title: "Ticket Filter/TicketFilterBar",
-  component: TicketFilterBar,
-  args: {
-    value: {
-      status: "open",
-      priority: "high",
-    },
-    onChange: () => {},
-    onSaveView: () => {},
-  },
-} satisfies Meta<typeof TicketFilterBar>;
-
-export default meta;
-
-type Story = StoryObj<typeof meta>;
-
-export const Default: Story = {};
-
-export const Dirty: Story = {
-  args: {
-    dirty: true,
-  },
-};
-
-export const Loading: Story = {
-  args: {
-    loading: true,
-  },
-};
+import type { Meta, StoryObj } from "@storybook/react";
+import { TicketFilterBar } from "../packages/ui/TicketFilterBar";
+
+const meta = {
+  title: "Ticket Filter/TicketFilterBar",
+  component: TicketFilterBar,
+  args: {
+    value: {
+      status: "open",
+      priority: "high",
+    },
+    onChange: () => {},
+    onSaveView: () => {},
+  },
+} satisfies Meta<typeof TicketFilterBar>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
+
+export const Dirty: Story = {
+  args: {
+    dirty: true,
+  },
+};
+
+export const Loading: Story = {
+  args: {
+    loading: true,
+  },
+};