@pactor-app/skills 1.33.0 → 1.35.0

package/pactor-prd/template/src/server/yaml/models/data-list.yaml

@@ -0,0 +1,344 @@
+# 数据列表标准骨架 —— 「搜索 + 表格 + 抽屉新建/编辑」数据列表页的复制起点。
+# 本页已注册进 sitemap.yaml（菜单「页面骨架 / 数据列表」，路径 /models/data-list），
+# 在模板工程中可直接运行预览；生成业务列表页时复制本文件到 yaml/<模块>/ 下，
+# 替换页面信息、字段、接口名（data-list → 业务资源名）与文案。
+# 结构与交互约定见 skills/pactor-prd/references/page-templates.md「数据列表标准模型」。
+dsl: "1.0"
+page:
+  id: data-list
+  title: 数据列表
+  name: dataList
+state:
+  # 搜索条件镜像：Form submit 后写入，驱动列表请求参数
+  keyword: ""
+  status: all
+  editingId: ""
+  # 表单条件显隐镜像（onValuesChange 写入；按页面需要增减，可多个）
+  fType: ""
+dataSources:
+  list:
+    type: http
+    autoLoad: true
+    request:
+      method: GET
+      url: /api/d/data-list
+      params:
+        keyword: ${state.keyword}
+        status: ${state.status}
+  editing: # 编辑预填；autoLoad: false，打开抽屉前手动 reload
+    type: http
+    autoLoad: false
+    request:
+      method: GET
+      url: /api/d/data-list/${state.editingId}
+body:
+  type: Page
+  children:
+    - type: Breadcrumb
+      props:
+        items:
+          - label: 页面骨架
+          - label: 数据列表
+    # 标题行：左标题 + 副标题，右新建按钮
+    - type: Flex
+      props:
+        justify: space-between
+        align: center
+      children:
+        - type: Flex
+          props:
+            direction: vertical
+            gap: 2
+          children:
+            - type: Typography
+              props:
+                variant: h3
+                text: 数据列表
+            - type: Typography
+              props:
+                variant: muted
+                text: 标准列表示例：搜索 + 表格 + 抽屉新建/编辑，复制本页生成业务列表。
+        - type: Button
+          props:
+            text: + 新建记录
+            variant: primary
+          events:
+            onClick:
+              - action: setState # 清空编辑态与显隐镜像
+                params:
+                  editingId: ""
+                  fType: ""
+              - action: reload # 清空 editing 数据（editingId 为空 → 空对象）
+                params:
+                  dataSource: editing
+              - action: overlay.open # 锚点 &entityDrawer 在此定义，表格行内用 *entityDrawer 引用
+                params:
+                  overlay: &entityDrawer
+                    type: drawer
+                    title: "${state.editingId == '' ? '新建记录' : '编辑记录'}"
+                    width: 720
+                    content:
+                      type: Form
+                      props:
+                        name: entityForm
+                        layout: vertical
+                        initialValues: ${data.editing}
+                      events:
+                        # 条件显隐字段镜像到 state（其他字段变化时保持原值）
+                        onValuesChange:
+                          - action: setState
+                            params:
+                              fType: "${event.type != null ? event.type : state.fType}"
+                        onSubmit:
+                          - action: request
+                            params:
+                              method: POST
+                              url: /api/d/ops/data-list-save
+                              body:
+                                id: ${state.editingId}
+                                name: ${event.name}
+                                code: ${event.code}
+                                type: ${event.type}
+                                extra: ${event.extra}
+                                sort: ${event.sort}
+                                status: ${event.status}
+                          - action: message
+                            params:
+                              messageType: success
+                              text: 已保存（演示）
+                          - action: overlay.close
+                      children:
+                        # 分区结构：标题 → 分割线 → 字段组（不用 Card）；多个分区重复此结构
+                        - type: Flex
+                          props:
+                            direction: vertical
+                            gap: middle
+                          children:
+                            - type: Text
+                              props:
+                                text: 基本信息
+                                strong: true
+                            - type: Separator
+                            - type: Flex
+                              props:
+                                direction: vertical
+                                gap: small
+                              children:
+                                - type: Field
+                                  props:
+                                    label: 名称
+                                    required: true
+                                  children:
+                                    - type: Input
+                                      props:
+                                        name: name
+                                        placeholder: 请输入名称
+                                        rules:
+                                          - required: true
+                                            message: 请输入名称
+                                # 编辑时禁用关键字段
+                                - type: Field
+                                  props:
+                                    label: 编码
+                                    required: true
+                                  children:
+                                    - type: Input
+                                      props:
+                                        name: code
+                                        placeholder: 大写字母 + 下划线，如 DEMO_ITEM
+                                        disabled: ${state.editingId != ''}
+                                        rules:
+                                          - required: true
+                                            message: 请输入编码
+                                # 成对字段用 Grid 两列
+                                - type: Grid
+                                  props:
+                                    columns: 2
+                                    gap: 16
+                                  children:
+                                    - type: Field
+                                      props:
+                                        label: 类型
+                                        required: true
+                                      children:
+                                        - type: Select
+                                          props:
+                                            name: type
+                                            placeholder: 请选择类型
+                                            options: ${data.list.filters.type}
+                                            rules:
+                                              - required: true
+                                                message: 请选择类型
+                                    - type: Field
+                                      props:
+                                        label: 状态
+                                      children:
+                                        - type: Select
+                                          props:
+                                            name: status
+                                            value: 启用
+                                            options: ${data.list.filters.status}
+                                - type: Grid
+                                  props:
+                                    columns: 2
+                                    gap: 16
+                                  children:
+                                    - type: Field
+                                      props:
+                                        label: 排序
+                                      children:
+                                        - type: NumberInput
+                                          props:
+                                            name: sort
+                                            className: w-full
+                                            min: 0
+                                            precision: 0
+                                # 条件显隐字段：依赖镜像 state
+                                - when: ${state.fType == '高级'}
+                                  type: Field
+                                  props:
+                                    label: 扩展说明
+                                  children:
+                                    - type: Input
+                                      props:
+                                        name: extra
+                                        placeholder: 高级类型的扩展配置说明
+                        # 底部按钮：取消关抽屉，保存触发 Form onSubmit
+                        - type: Flex
+                          props:
+                            justify: end
+                            gap: small
+                            className: mt-4
+                          children:
+                            - type: Button
+                              props:
+                                text: 取消
+                              events:
+                                onClick:
+                                  - action: overlay.close
+                            - type: Button
+                              props:
+                                text: 保存
+                                variant: primary
+                                submit: true
+                                htmlType: submit
+              - action: reload # overlay.open 阻塞到关闭，关闭后刷新列表
+                params:
+                  dataSource: list
+    # 搜索栏：Form(layout: inline) + Field 包裹控件
+    - type: Card
+      children:
+        - type: Form
+          props:
+            name: search
+            layout: inline
+          events:
+            onSubmit:
+              - action: setState
+                params:
+                  keyword: ${event.keyword}
+                  status: ${event.status}
+              - action: reload
+                params:
+                  dataSource: list
+          children:
+            - type: Field
+              props:
+                label: 编码/名称
+              children:
+                - type: Input
+                  props:
+                    name: keyword
+                    placeholder: 支持模糊查询
+            - type: Field
+              props:
+                label: 状态
+              children:
+                - type: Select
+                  props:
+                    name: status
+                    placeholder: 请选择状态
+                    options: ${data.list.filters.status} # 选项由接口下发
+            # 按钮也放进 Field：label 为 U+00A0 不间断空格（普通空格会被压缩），与左侧控件基线对齐
+            - type: Field
+              props:
+                label: " "
+              children:
+                - type: Flex
+                  props:
+                    gap: small
+                    align: center
+                  children:
+                    - type: Button
+                      props:
+                        text: 查询
+                        submit: true
+                        htmlType: submit
+                    - type: Button
+                      props:
+                        text: 重置
+                      events:
+                        onClick:
+                          - action: form.setValues
+                            params:
+                              form: search
+                              values:
+                                keyword: ""
+                                status: all
+                          - action: setState
+                            params:
+                              keyword: ""
+                              status: all
+                          - action: reload
+                            params:
+                              dataSource: list
+        # 表格：名称列/操作列按钮统一 variant: link size: small
+        - type: Table
+          props:
+            dataSource: ${data.list.items}
+            rowKey: id
+            pagination: false
+            className: mt-4
+            columns:
+              - title: 名称
+                cell:
+                  type: Button
+                  props:
+                    text: ${row.name}
+                    variant: link
+                    size: small
+                  events:
+                    onClick: &editRow # 行点击 = 编辑，锚点在此定义
+                      - action: setState # 写入编辑 id + 显隐镜像（取自行数据，不等 editing 接口）
+                        params:
+                          editingId: ${row.id}
+                          fType: ${row.type}
+                      - action: reload
+                        params:
+                          dataSource: editing
+                      - action: overlay.open
+                        params:
+                          overlay: *entityDrawer
+                      - action: reload
+                        params:
+                          dataSource: list
+              - title: 编码
+                dataIndex: code
+              - title: 类型
+                dataIndex: type
+              - title: 状态
+                dataIndex: status
+              - title: 操作
+                cell:
+                  type: Button
+                  props:
+                    text: 编辑
+                    variant: link
+                    size: small
+                  events:
+                    onClick: *editRow # 与名称列同一动作
+        - type: Text
+          props:
+            text: 共 ${data.list.total} 条
+            type: secondary
+            className: mt-3

package/pactor-prd/template/src/server/yaml/provider/provider-detail.yaml

@@ -12,12 +12,12 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/providers/${route.params.code}
+      url: /api/d/providers/${route.params.code}
   upstream:
     type: http
     request:
       method: GET
-      url: /api/data/providers/${route.params.code}/pull-models
+      url: /api/d/providers/${route.params.code}/pull-models
 body:
   type: Page
   children:

package/pactor-prd/template/src/server/yaml/provider/provider-edit.yaml

@@ -10,7 +10,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/providers/${route.params.code}
+      url: /api/d/providers/${route.params.code}
 body:
   type: Page
   children:

package/pactor-prd/template/src/server/yaml/provider/provider-list.yaml

@@ -14,7 +14,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/providers
+      url: /api/d/providers
       params:
         keyword: ${state.keyword}
         status: ${state.statusChip}

package/pactor-prd/template/src/server/yaml/route/route-detail.yaml

@@ -10,7 +10,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/routes/${route.params.code}
+      url: /api/d/routes/${route.params.code}
 body:
   type: Page
   children:

package/pactor-prd/template/src/server/yaml/route/route-edit.yaml

@@ -10,7 +10,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/routes/${route.params.code}
+      url: /api/d/routes/${route.params.code}
 body:
   type: Page
   children:

package/pactor-prd/template/src/server/yaml/route/route-list.yaml

@@ -14,7 +14,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/routes
+      url: /api/d/routes
       params:
         status: ${state.statusChip}
         type: ${state.typeChip}

package/pactor-prd/template/src/server/yaml/sitemap.yaml

@@ -49,6 +49,14 @@ pages:
     }
   # 模块二：模型路由 / 路由（卡片式列表 + 单页纵向详情 + 单页表单）
   - { id: route-list, path: /routes, title: 路由, version: 1, lazy: true }
+  # 页面骨架：数据列表标准模型（搜索 + 表格 + 抽屉新建/编辑），可复制生成业务列表页
+  - {
+      id: data-list,
+      path: /models/data-list,
+      title: 数据列表,
+      version: 1,
+      lazy: true,
+    }
   - {
       id: route-create,
       path: /routes/new,
@@ -116,6 +124,19 @@ menus:
           title: 路由,
           layout: admin,
         }
+  - id: skeletons
+    type: group
+    title: 页面骨架
+    icon: folder
+    order: 4
+    children:
+      - {
+          id: data-list,
+          type: page,
+          pageId: data-list,
+          title: 数据列表,
+          layout: admin,
+        }
   # 隐藏页（不出现在菜单，经列表页跳转进入；activeMenu 保持所属菜单高亮）
   - {
       id: provider-create,
@@ -234,15 +255,11 @@ layouts:
               props: { className: shell-content }
               children:
                 - type: PageOutlet
-  # 登录页外壳：login-page 全屏渐变容器，样式见 app/login.css
+  # 登录页外壳：纯页面出口（登录页由 Login 业务组件自带整页品牌视觉与背景装饰）
   login:
     dsl: "1.0"
     body:
-      type: Flex
-      props:
-        className: login-page
-      children:
-        - type: PageOutlet
+      type: PageOutlet
   # 裸布局：无外壳，页面铺满
   blank:
     dsl: "1.0"

package/pactor-prd/references/mock-data-routes.md

@@ -1,66 +0,0 @@
-# mock 数据路由模板
-
-页面 DSL 的 http 数据源统一入口：`app/api/data/[...path]/route.ts`。目标：原型阶段零后端依赖；接真实后端时只改这一层，页面 yaml 不动。
-
-## 命名约定
-
-- **单段路径**：`/api/data/projects`、`/api/data/project-members`——列表/选项类一律单段 kebab-case
-- **禁止** `/api/data/project/members` 这种两段写法：`[...path]` 会把第二段当详情 id 解析（`project/detail?id=members`），踩过的坑
-- 详情：`/api/data/<resource>/<code|id>`；子资源：`/api/data/<resource>/<code>/<sub>`
-- 数据源 url 与页面 id 语义对应：`project-list` 页 → `/api/data/projects`
-
-## 路由模板
-
-```ts
-// app/api/data/[...path]/route.ts
-/**
- * 页面数据接口（mock）：页面 DSL 的 http 数据源统一入口。
- * 接入真实后端时改写 ROUTE_TABLE 的实现（或调整 baseUrl 直连后端）。
- */
-
-/** 单段路径 → mock handler */
-const ROUTE_TABLE: Record<string, (params: Record<string, unknown>) => unknown> = {
-  projects: (params) => filterProjects(params),   // mock 函数就近定义或放 src/server/mocks/
-  "project-members": () => PROJECT_MEMBERS,
-};
-
-/** 详情：<resource>/<id> */
-const DETAIL_TABLE: Record<string, (id: string) => unknown> = {
-  projects: (code) => PROJECTS.find((p) => p.code === code) ?? null,
-};
-
-export async function GET(
-  request: Request,
-  context: { params: Promise<{ path: string[] }> },
-) {
-  const { path } = await context.params;
-  const params = Object.fromEntries(new URL(request.url).searchParams.entries());
-
-  if (path.length === 1) {
-    const handler = ROUTE_TABLE[path[0]!];
-    if (!handler) return Response.json({ error: `未知数据接口: /api/data/${path.join("/")}` }, { status: 404 });
-    return Response.json(handler(params) ?? null);
-  }
-  if (path.length === 2) {
-    const handler = DETAIL_TABLE[path[0]!];
-    if (!handler) return Response.json({ error: "未知详情接口" }, { status: 404 });
-    return Response.json(handler(path[1]!) ?? null);
-  }
-  return Response.json({ error: "不支持的接口路径" }, { status: 404 });
-}
-```
-
-注意：`context.params` 的具体类型以目标项目的 Next 版本为准（Next 15+ 为 Promise）。
-
-## mock 数据要求
-
-- 字段名与线框图「区域说明/字段说明」逐一对齐，不臆造字段
-- 每类数据至少覆盖：正常多条、触发告警/特殊态的条目（如「待填密钥」）、以及空态可被演示（如筛选到无结果）
-- 筛选参数在 handler 内真实过滤（列表页筛选闭环依赖它），不是返回全量
-- 选项类接口（如下拉的操作人列表）单独注册单段路径，页面 `options: ${data.xxx}` 绑定
-
-## 替换为真实接口
-
-1. 直接把 ROUTE_TABLE handler 改为 `fetch` 真实后端（服务端转发，带鉴权头）
-2. 或调整 pactor 数据源 baseUrl 直连后端，`/api/data/*` 层整体退役
-页面 yaml 的 dataSources 声明两种方案下都无需改动——这就是必须 `type: http` 的原因。

package/pactor-prd/template/app/api/data/[...parts]/route.ts

@@ -1,118 +0,0 @@
-import { cookies } from "next/headers";
-
-import { findUserBySession, SESSION_COOKIE } from "@/server/accounts";
-import { corsHeaders, corsPreflight } from "@/server/cors";
-import { pactorServices } from "@/pactor/services";
-
-/**
- * 页面数据接口（mock）：页面 DSL 的 http 数据源统一入口。
- * URL 路径段 → 服务名映射（scripts/to-http-dsl.mjs 中的同一张表）；
- * 接入真实后端时改写本表（或在 src/pactor/config.ts 调整 baseUrl 直连后端）。
- *
- * 查询参数原为 service 包装层的入参（布尔快筛在 DSL 侧是一族一个参数），
- * 经 HTTP 序列化为字符串，此处把 'true'/'false' 还原为布尔后再复用
- * 与客户端注册表同一套包装层（src/pactor/services.ts）。
- * 接口侧鉴权：匿名一律 401。
- */
-
-/** 路径段 → 服务名 */
-const ROUTE_TABLE: Record<string, string> = {
-  dashboard: "dashboard.query",
-  providers: "provider.list",
-  models: "model.list",
-  routes: "route.list",
-  clients: "client.list",
-  "client-templates": "clientTemplate.list",
-  "call-logs": "callLog.list",
-  costs: "cost.list",
-  audit: "audit.list",
-  "audit-operators": "audit.operators",
-  "ops/model-usage": "ops.modelUsage",
-  "ops/provider-usage": "ops.providerUsage",
-  "ops/client-usage": "ops.clientUsage",
-  "ops/provider-availability": "ops.availability",
-};
-
-/** 详情 / 子资源：<res>/<code|id> 或 <res>/<code>/<sub> */
-const DETAIL_TABLE: Record<string, string> = {
-  providers: "provider.detail",
-  models: "model.detail",
-  routes: "route.detail",
-  clients: "client.detail",
-  "client-templates": "clientTemplate.detail",
-  "call-logs": "callLog.detail",
-  costs: "cost.detail",
-  audit: "audit.detail",
-};
-
-const SUB_TABLE: Record<string, string> = {
-  "providers/pull-models": "provider.pullModels",
-  "client-templates/created-clients": "clientTemplate.createdClients",
-};
-
-/** 详情类服务的标识参数名（code / id） */
-const ID_PARAM: Record<string, string> = {
-  "callLog.detail": "id",
-  "cost.detail": "id",
-  "audit.detail": "id",
-};
-
-function resolveService(parts: string[]): { service: string; id?: string } | null {
-  if (parts.length === 0 || parts.length > 3) return null;
-  if (parts.length === 1 || parts.length === 2 && parts[0] === "ops") {
-    const service = ROUTE_TABLE[parts.join("/")];
-    return service ? { service } : null;
-  }
-  const [resource, id, sub] = parts;
-  if (parts.length === 3) {
-    const service = SUB_TABLE[`${resource}/${sub}`];
-    return service ? { service, id } : null;
-  }
-  const service = DETAIL_TABLE[resource];
-  return service ? { service, id } : null;
-}
-
-/** query string → 服务入参：'true'/'false' 还原为布尔，其余保持字符串 */
-function coerceParams(searchParams: URLSearchParams): Record<string, unknown> {
-  const params: Record<string, unknown> = {};
-  for (const [key, value] of searchParams.entries()) {
-    params[key] = value === "true" ? true : value === "false" ? false : value;
-  }
-  return params;
-}
-
-export async function GET(
-  request: Request,
-  context: RouteContext<"/api/data/[...parts]">,
-) {
-  const store = await cookies();
-  const user = findUserBySession(store.get(SESSION_COOKIE)?.value);
-  if (!user) {
-    return Response.json(
-      { error: "未登录" },
-      { status: 401, headers: corsHeaders(request) },
-    );
-  }
-
-  const { parts } = await context.params;
-  const resolved = resolveService(parts);
-  if (!resolved) {
-    return Response.json(
-      { error: `未知数据接口: /api/data/${parts.join("/")}` },
-      { status: 404, headers: corsHeaders(request) },
-    );
-  }
-
-  const params = coerceParams(new URL(request.url).searchParams);
-  if (resolved.id !== undefined) {
-    params[ID_PARAM[resolved.service] ?? "code"] = resolved.id;
-  }
-
-  const result = await pactorServices[resolved.service](params);
-  return Response.json(result ?? null, {
-    headers: { "cache-control": "no-store", ...corsHeaders(request) },
-  });
-}
-
-/** 预检（跨源带凭据 / 自定义头时） */
-export const OPTIONS = corsPreflight;