@epoint-testtech/ep-stage-skill 0.0.10 → 0.0.12

package/codex-skill/ep-stage/code-list-generate/assets/example-zwplace.json5

@@ -0,0 +1,588 @@
+{
+  schemaVersion: 'ep-stage-code-list/v1-draft',
+
+  requirement: {
+    id: 'REQ0011',
+    name: '场所窗口信息管理及各端统计检索查看',
+    type: '新增功能',
+    priority: '高',
+    targetEnds: ['PC-管理端', 'H5-移动端'],
+    businessRoles: [
+      {
+        label: '业务管理员',
+        targetEnd: 'PC-管理端',
+        responsibilities: ['维护场所和窗口信息', '同步第三方窗口管理系统数据'],
+        evidence: ['场所窗口信息管理及各端统计检索查看_prd.md#2.1 核心用户角色'],
+      },
+      {
+        label: '领导/管理者',
+        targetEnd: 'PC-管理端',
+        responsibilities: ['通过统计大屏查看场所窗口整体情况'],
+        evidence: ['场所窗口信息管理及各端统计检索查看_prd.md#2.1 核心用户角色'],
+      },
+      {
+        label: '群众',
+        targetEnd: 'H5-移动端',
+        responsibilities: ['通过移动端查询场所和窗口详细信息'],
+        evidence: ['场所窗口信息管理及各端统计检索查看_prd.md#2.1 核心用户角色'],
+      },
+    ],
+  },
+
+  sourceRoot: {
+    root: 'F:/001-Proj/ep-stage/knowledge-project/epoint-web-v9.5.2',
+    pathBase: 'knowledgeRoot',
+    sourceFilesAreRelativeTo: 'sourceRoot.root',
+  },
+
+  // 兼容当前 CLI 读取器的顶层字段；语义等同 module.id / module.name。
+  module: 'zwplace',
+  moduleName: '场所窗口信息管理',
+  description: '场所窗口信息管理模块，当前出码主要覆盖 PC 管理端大厅地址管理、窗口子表维护和同步入口。',
+
+  systems: [
+    {
+      name: '集成受理平台',
+      version: '8.4',
+      frameVersion: '950',
+      targetEnd: 'PC-管理端',
+      // 登录地址（loginUrl）：研发可在出码总结时补齐；留空时由 glue-generate-testcase 交互补充。
+      defaultLoginUrl: 'http://192.168.203.46:8100/epoint-web/frame/pages/login/login',
+      evidence: ['plan.md#上下文 project_context'],
+    },
+  ],
+
+  // 测试访问数据模板：用于生成 credentials.json5。
+  // code_list.json5 是上游出码总结事实源；若账号、密码、角色、权限不能由上游明确给出，可先留空，由生成用例环节交互补齐。
+  testAccess: {
+    systems: [
+      {
+        systemName: '集成受理平台',
+        loginUrl: '',
+        roles: [
+          {
+            role: '业务管理员',
+            username: '',
+            password: '',
+            permissions: ['新增', '修改', '删除', '导出', '同步', '查看'],
+          },
+          {
+            role: '领导/管理者',
+            username: '',
+            password: '',
+            permissions: ['查看统计大屏'],
+          },
+          {
+            role: '群众',
+            username: '',
+            password: '',
+            permissions: ['移动端查询查看'],
+          },
+        ],
+      },
+    ],
+  },
+
+  moduleInfo: {
+    id: 'zwplace',
+    name: '场所窗口信息管理',
+    packagePath: 'com.epoint.zwplace',
+    frontendBasePath: 'src/main/webapp/perpage/zwplace',
+    backendBasePath: 'src/main/java/com/epoint/zwplace',
+    deriveRule: '从页面目录 perpage/zwplace 与 Java 包 com.epoint.zwplace 归纳模块标识。',
+  },
+
+  implementedScope: [
+    {
+      featureId: 'F001',
+      featureName: '场所列表管理',
+      implementedBy: ['pages.list', 'backend.actions.GxhZwPlaceListAction'],
+    },
+    {
+      featureId: 'F002',
+      featureName: '新增场所',
+      implementedBy: ['pages.add', 'backend.actions.GxhZwPlaceAddAction'],
+    },
+    {
+      featureId: 'F003',
+      featureName: '修改场所',
+      implementedBy: ['pages.edit', 'backend.actions.GxhZwPlaceEditAction'],
+    },
+    {
+      featureId: 'F004',
+      featureName: '删除场所',
+      implementedBy: ['pages.list.toolbarActions.delete', 'backend.actions.GxhZwPlaceListAction.methods.deleteSelect'],
+    },
+    {
+      featureId: 'F005',
+      featureName: '同步窗口管理系统',
+      implementationStatus: 'entry_exists_service_stub',
+      implementedBy: ['pages.list.toolbarActions.syncWindowSystem', 'backend.dao.GxhZwPlaceService.methods.syncWindowSystem'],
+      note: '页面和 Action 有同步入口；Service 当前返回“同步功能暂未实现，请联系管理员配置窗口管理系统接口。”',
+    },
+  ],
+
+  prdMentionedButNotImplemented: [
+    {
+      featureIds: ['F008', 'F009', 'F010', 'F011', 'F012'],
+      featureName: '管理者统计大屏',
+      reason: 'PRD 描述了统计大屏能力，但 sourceFiles.frontend / sourceFiles.actions / sourceFiles.services 未提供对应统计大屏页面或后端实现文件。',
+    },
+    {
+      featureIds: ['F013', 'F014', 'F015', 'F016'],
+      featureName: '移动端群众查看',
+      reason: 'PRD 描述了移动端群众查看能力，但 sourceFiles.frontend / sourceFiles.actions / sourceFiles.services 未提供 H5 页面或移动端接口实现文件。',
+    },
+    {
+      featureIds: ['F006', 'F007'],
+      featureName: '窗口管理系统接口数据映射与同步冲突处理',
+      reason: 'PRD 描述了接口映射和冲突处理；当前出码只发现同步入口和 service stub，未发现真实第三方接口调用、映射或冲突处理实现。',
+    },
+  ],
+
+  sourceFiles: {
+    frontend: [
+      { role: 'list', path: 'src/main/webapp/perpage/zwplace/gxhzwplacelist.html', title: '场所信息管理列表' },
+      { role: 'add', path: 'src/main/webapp/perpage/zwplace/gxhzwplaceadd.html', title: '场所信息管理添加' },
+      { role: 'edit', path: 'src/main/webapp/perpage/zwplace/gxhzwplaceedit.html', title: '场所信息管理编辑' },
+      { role: 'detail', path: 'src/main/webapp/perpage/zwplace/gxhzwplacedetail.html', title: '场所信息管理详情' },
+    ],
+    actions: [
+      { name: 'GxhZwPlaceListAction', path: 'src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java', restController: 'gxhzwplacelistaction' },
+      { name: 'GxhZwPlaceAddAction', path: 'src/main/java/com/epoint/zwplace/action/GxhZwPlaceAddAction.java', restController: 'gxhzwplaceaddaction' },
+      { name: 'GxhZwPlaceEditAction', path: 'src/main/java/com/epoint/zwplace/action/GxhZwPlaceEditAction.java', restController: 'gxhzwplaceeditaction' },
+      { name: 'GxhZwPlaceDetailAction', path: 'src/main/java/com/epoint/zwplace/action/GxhZwPlaceDetailAction.java', restController: 'gxhzwplacedetailaction' },
+    ],
+    services: [
+      { name: 'IGxhZwPlaceService', path: 'src/main/java/com/epoint/zwplace/api/IGxhZwPlaceService.java', kind: 'interface' },
+      { name: 'GxhZwPlaceServiceImpl', path: 'src/main/java/com/epoint/zwplace/impl/GxhZwPlaceServiceImpl.java', kind: 'serviceImpl' },
+      { name: 'GxhZwPlaceService', path: 'src/main/java/com/epoint/zwplace/impl/GxhZwPlaceService.java', kind: 'dao' },
+    ],
+    entities: [
+      { name: 'GxhZwPlace', path: 'src/main/java/com/epoint/zwplace/api/entity/GxhZwPlace.java', table: 'gxh_zw_place' },
+      { name: 'GxhZwWindow', path: 'src/main/java/com/epoint/zwplace/api/entity/GxhZwWindow.java', table: 'gxh_zw_window' },
+      { name: 'GxhZwPlaceHistory', path: 'src/main/java/com/epoint/zwplace/api/entity/GxhZwPlaceHistory.java', table: 'gxh_zw_place_history' },
+    ],
+  },
+
+  pages: [
+    {
+      pageId: 'gxhzwplacelist',
+      role: 'list',
+      title: '场所信息管理列表',
+      path: 'src/main/webapp/perpage/zwplace/gxhzwplacelist.html',
+      initAction: 'gxhzwplacelistaction',
+      // 待测页面直达链接（directUrl）：优先在上游出码总结中补齐；留空时由 glue-generate-testcase 交互补充。
+      directUrl: 'http://192.168.203.46:8100/epoint-web/perpage/zwplace/gxhzwplacelist.html',
+      description: '场所信息列表展示，支持分页、排序、查询、删除、导出、同步窗口管理系统、修改和查看。',
+      queryFields: [
+        {
+          label: '场所名称',
+          bind: 'dataBean.placename',
+          component: 'mini-textbox',
+          elementHints: [{ attr: 'bind', value: 'dataBean.placename' }],
+        },
+        {
+          label: '场所分类',
+          bind: 'dataBean.placecategory',
+          component: 'mini-combobox',
+          modelRef: 'placecategoryModel',
+          elementHints: [{ attr: 'id', value: 'placecategory' }, { attr: 'action', value: 'placecategoryModel' }],
+        },
+        {
+          label: '状态',
+          bind: 'dataBean.status',
+          component: 'mini-combobox',
+          modelRef: 'statusModel',
+          elementHints: [{ attr: 'id', value: 'status' }, { attr: 'action', value: 'statusModel' }],
+        },
+      ],
+      toolbarActions: [
+        { label: '新增场所信息管理', actionName: 'openAdd', opens: 'pages.add' },
+        { label: '删除选定', actionName: 'deleteData', backendMethod: 'deleteSelect' },
+        { label: '导出', component: 'mini-dataexport', backendMethod: 'getExportModel', elementHints: [{ attr: 'id', value: 'dataexport' }, { attr: 'gridId', value: 'datagrid' }] },
+        { label: '同步窗口管理系统', actionName: 'syncWindowSystem', backendMethod: 'syncWindowSystem' },
+      ],
+      // 兼容当前 glue-generate-testcase 读取器；语义等同 toolbarActions 的按钮摘要。
+      buttons: [
+        { label: '新增场所信息管理', action: 'create', backendMethod: null },
+        { label: '删除选定', action: 'delete', backendMethod: 'deleteSelect' },
+        { label: '导出', action: 'export', backendMethod: 'getExportModel' },
+        { label: '同步窗口管理系统', action: 'custom', customAction: 'syncWindowSystem', backendMethod: 'syncWindowSystem' },
+      ],
+      rowActions: [
+        { label: '修改', actionName: 'openEdit', opens: 'pages.edit' },
+        { label: '查看', actionName: 'openDetail', opens: 'pages.detail' },
+      ],
+      dataGrid: {
+        id: 'datagrid',
+        idField: 'rowguid',
+        backendMethod: 'getDataGridData',
+        columns: [
+          { field: 'placename', label: '场所名称' },
+          { field: 'placecategory', label: '场所分类', dataOptions: "{code:'场所分类'}" },
+          { field: 'address', label: '详细地址', renderer: 'addressRenderer' },
+          { field: 'servicetime', label: '统一对外服务时间' },
+          { field: 'consultphone', label: '咨询电话' },
+          { field: 'complaintphone', label: '投诉电话' },
+          { field: 'status', label: '状态', dataOptions: "{code:'数据状态'}" },
+          { field: 'version', label: '版本号' },
+        ],
+      },
+      backendMethods: ['getDataGridData', 'deleteSelect', 'getExportModel', 'syncWindowSystem', 'getPlacecategoryModel', 'getStatusModel'],
+      evidence: ['sourceFiles.frontend[role=list]', 'sourceFiles.actions[name=GxhZwPlaceListAction]'],
+    },
+
+    {
+      pageId: 'gxhzwplaceadd',
+      role: 'add',
+      title: '场所信息管理添加',
+      path: 'src/main/webapp/perpage/zwplace/gxhzwplaceadd.html',
+      initAction: 'gxhzwplaceaddaction',
+      description: '新增场所信息，维护场所基础字段和窗口信息子表。',
+      formFields: [
+        { label: '场所名称', bind: 'dataBean.placename', component: 'mini-textbox', required: true, maxLength: 50 },
+        { label: '场所分类', bind: 'dataBean.placecategory', component: 'mini-combobox', required: true, modelRef: 'placecategoryModel' },
+        { label: '区划名称', bind: 'dataBean.districtname', component: 'mini-combobox', required: true, modelRef: 'districtModel' },
+        { label: '街道名称', bind: 'dataBean.streetname', component: 'mini-textbox', required: true, maxLength: 50 },
+        { label: '路/弄/号', bind: 'dataBean.address', component: 'mini-textbox', required: true, maxLength: 50 },
+        { label: '是否社区办理', bind: 'dataBean.iscommunity', component: 'mini-combobox', required: true, modelRef: 'iscommunityModel' },
+        { label: '统一对外服务时间', bind: 'dataBean.servicetime', component: 'mini-textbox', required: true, maxLength: 100 },
+        { label: '咨询电话', bind: 'dataBean.consultphone', component: 'mini-textbox', maxLength: 20 },
+        { label: '投诉电话', bind: 'dataBean.complaintphone', component: 'mini-textbox', maxLength: 20 },
+      ],
+      toolbarActions: [
+        { label: '保存', actionName: 'save', backendMethod: 'saveDraft' },
+        { label: '保存并关闭', actionName: 'saveAndClose', backendMethod: 'add' },
+        { label: '关闭', actionName: "epoint.closeDialog('close')" },
+      ],
+      buttons: [
+        { label: '保存', action: 'save', customAction: 'saveDraft', backendMethod: 'saveDraft' },
+        { label: '保存并关闭', action: 'create', backendMethod: 'add' },
+        { label: '关闭', action: 'cancel', backendMethod: null },
+      ],
+      rowActions: [],
+      childGrids: [
+        {
+          id: 'windowGrid',
+          label: '窗口信息',
+          actions: [{ label: '添加窗口', actionName: 'addWindow' }, { label: '删除选中', actionName: 'deleteSelectedWindow' }],
+          columns: [
+            { field: 'windowname', label: '窗口名称', required: true },
+            { field: 'windowtype', label: '窗口类型', required: true, modelRef: 'windowtypeModel' },
+            { field: 'windowaddress', label: '窗口地址' },
+          ],
+        },
+      ],
+      backendMethods: ['saveDraft', 'add', 'getStreetList', 'getPlacecategoryModel', 'getDistrictModel', 'getIscommunityModel', 'getWindowtypeModel', 'getWindowtypeData'],
+      evidence: ['sourceFiles.frontend[role=add]', 'sourceFiles.actions[name=GxhZwPlaceAddAction]'],
+    },
+
+    {
+      pageId: 'gxhzwplaceedit',
+      role: 'edit',
+      title: '场所信息管理编辑',
+      path: 'src/main/webapp/perpage/zwplace/gxhzwplaceedit.html',
+      initAction: 'gxhzwplaceeditaction',
+      description: '编辑场所信息，保存并关闭时版本号加一并归档历史数据。',
+      formFields: ['same_as_pages.add.formFields'],
+      childGrids: ['same_as_pages.add.childGrids'],
+      toolbarActions: [
+        { label: '保存', actionName: 'save', backendMethod: 'saveDraft' },
+        { label: '保存并关闭', actionName: 'saveAndClose', backendMethod: 'save' },
+        { label: '关闭', actionName: "epoint.closeDialog('close')" },
+      ],
+      buttons: [
+        { label: '保存', action: 'save', customAction: 'saveDraft', backendMethod: 'saveDraft' },
+        { label: '保存并关闭', action: 'update', backendMethod: 'save' },
+        { label: '关闭', action: 'cancel', backendMethod: null },
+      ],
+      rowActions: [],
+      backendMethods: ['pageLoad', 'saveDraft', 'save', 'getStreetList', 'getPlacecategoryModel', 'getDistrictModel', 'getIscommunityModel', 'getWindowtypeModel', 'getWindowtypeData'],
+      evidence: ['sourceFiles.frontend[role=edit]', 'sourceFiles.actions[name=GxhZwPlaceEditAction]'],
+    },
+
+    {
+      pageId: 'gxhzwplacedetail',
+      role: 'detail',
+      title: '场所信息管理详情',
+      path: 'src/main/webapp/perpage/zwplace/gxhzwplacedetail.html',
+      initAction: 'gxhzwplacedetailaction',
+      description: '查看场所信息详情和窗口信息列表，只读展示。',
+      buttons: [
+        { label: '关闭', action: 'cancel', backendMethod: null },
+      ],
+      rowActions: [],
+      backendMethods: ['pageLoad', 'getWindowtypeModel', 'getWindowtypeData'],
+      evidence: ['sourceFiles.frontend[role=detail]', 'sourceFiles.actions[name=GxhZwPlaceDetailAction]'],
+    },
+  ],
+
+  backend: {
+    callChain: '前端页面 -> Action -> IGxhZwPlaceService -> GxhZwPlaceServiceImpl -> GxhZwPlaceService(DAO) -> 数据库',
+    actions: [
+      {
+        name: 'GxhZwPlaceListAction',
+        restController: 'gxhzwplacelistaction',
+        methods: [
+          { name: 'deleteSelect', description: '删除选中数据；非 DRAFT 状态返回“在用数据不可删除！”。' },
+          { name: 'getDataGridData', description: '按 placename like、placecategory eq、status eq 查询分页列表。' },
+          { name: 'syncWindowSystem', description: '调用 service.syncWindowSystem 并返回消息。' },
+          { name: 'getExportModel', description: '返回列表导出字段配置。' },
+          { name: 'getPlacecategoryModel', description: '读取“场所分类”代码项。' },
+          { name: 'getStatusModel', description: '读取“数据状态”代码项。' },
+        ],
+      },
+      {
+        name: 'GxhZwPlaceAddAction',
+        restController: 'gxhzwplaceaddaction',
+        methods: [
+          { name: 'saveDraft', description: '保存草稿，状态 DRAFT，数据源 MANUAL。' },
+          { name: 'add', description: '保存并关闭，状态 ACTIVE，版本 V1，数据源 MANUAL。' },
+          { name: 'checkPlacenameUnique', description: '按 placename 校验唯一性。' },
+          { name: 'saveWindows', description: '保存窗口子表。' },
+          { name: 'getStreetList', description: '按 districtname 查询街道列表。' },
+        ],
+      },
+      {
+        name: 'GxhZwPlaceEditAction',
+        restController: 'gxhzwplaceeditaction',
+        methods: [
+          { name: 'pageLoad', description: '按 guid 加载场所和窗口列表。' },
+          { name: 'saveDraft', description: '保存草稿，版本号和状态不变。' },
+          { name: 'save', description: '保存并关闭，归档历史数据，版本号加一，草稿状态改为 ACTIVE。' },
+          { name: 'updateWindows', description: '先删除原窗口子表，再插入本次窗口数据。' },
+        ],
+      },
+      {
+        name: 'GxhZwPlaceDetailAction',
+        restController: 'gxhzwplacedetailaction',
+        methods: [
+          { name: 'pageLoad', description: '按 guid 加载场所和窗口列表。' },
+          { name: 'getWindowtypeData', description: '返回窗口类型数据给前端渲染。' },
+        ],
+      },
+    ],
+    services: [
+      {
+        name: 'GxhZwPlaceService',
+        kind: 'dao',
+        methods: [
+          'insert',
+          'deleteByGuid',
+          'update',
+          'countGxhZwPlace',
+          'find',
+          'findList',
+          'paginatorList',
+          'insertWindow',
+          'deleteWindows',
+          'findWindowList',
+          'archivePlace',
+          'syncWindowSystem',
+          'findStreetList',
+        ],
+      },
+    ],
+  },
+
+  dataModels: [
+    {
+      ref: 'placecategoryModel',
+      label: '场所分类',
+      sourceKind: 'dictionary_runtime',
+      actionMethods: ['GxhZwPlaceListAction.getPlacecategoryModel', 'GxhZwPlaceAddAction.getPlacecategoryModel', 'GxhZwPlaceEditAction.getPlacecategoryModel'],
+      dictionaryCode: '场所分类',
+      optionsKnownAtStaticTime: false,
+    },
+    {
+      ref: 'statusModel',
+      label: '状态',
+      sourceKind: 'dictionary_runtime',
+      actionMethods: ['GxhZwPlaceListAction.getStatusModel'],
+      dictionaryCode: '数据状态',
+      optionsKnownAtStaticTime: false,
+    },
+    {
+      ref: 'districtModel',
+      label: '区划名称',
+      sourceKind: 'static_options',
+      actionMethods: ['GxhZwPlaceAddAction.getDistrictModel', 'GxhZwPlaceEditAction.getDistrictModel'],
+      options: ['黄浦区', '徐汇区', '长宁区', '静安区', '普陀区', '虹口区', '杨浦区', '闵行区', '宝山区', '嘉定区', '浦东新区', '金山区', '松江区', '青浦区', '奉贤区', '崇明区'],
+    },
+    {
+      ref: 'iscommunityModel',
+      label: '是否社区办理',
+      sourceKind: 'static_options',
+      actionMethods: ['GxhZwPlaceAddAction.getIscommunityModel', 'GxhZwPlaceEditAction.getIscommunityModel'],
+      options: ['是', '否'],
+    },
+    {
+      ref: 'windowtypeModel',
+      label: '窗口类型',
+      sourceKind: 'dictionary_runtime',
+      actionMethods: ['GxhZwPlaceAddAction.getWindowtypeModel', 'GxhZwPlaceEditAction.getWindowtypeModel', 'GxhZwPlaceDetailAction.getWindowtypeModel'],
+      dictionaryCode: '窗口类型',
+      optionsKnownAtStaticTime: false,
+    },
+    {
+      ref: 'streetList',
+      label: '街道名称',
+      sourceKind: 'db_runtime',
+      actionMethods: ['GxhZwPlaceAddAction.getStreetList', 'GxhZwPlaceEditAction.getStreetList'],
+      dependency: 'districtname',
+      optionsKnownAtStaticTime: false,
+    },
+  ],
+
+  entities: [
+    {
+      name: 'GxhZwPlace',
+      table: 'gxh_zw_place',
+      description: '场所信息实体。',
+      fields: [
+        { name: 'placename', type: 'String(50)', label: '场所名称' },
+        { name: 'placecategory', type: 'String(20)', label: '场所分类' },
+        { name: 'districtname', type: 'String(50)', label: '区划名称' },
+        { name: 'streetname', type: 'String(50)', label: '街道名称' },
+        { name: 'address', type: 'String(50)', label: '路/弄/号' },
+        { name: 'iscommunity', type: 'String(10)', label: '是否社区办理' },
+        { name: 'servicetime', type: 'String(100)', label: '统一对外服务时间' },
+        { name: 'consultphone', type: 'String(20)', label: '咨询电话' },
+        { name: 'complaintphone', type: 'String(20)', label: '投诉电话' },
+        { name: 'status', type: 'String(20)', label: '状态' },
+        { name: 'version', type: 'String(20)', label: '版本号' },
+        { name: 'datasource', type: 'String(20)', label: '窗口来源渠道' },
+        { name: 'centercode', type: 'String(50)', label: '政务中心编号' },
+      ],
+    },
+    {
+      name: 'GxhZwWindow',
+      table: 'gxh_zw_window',
+      description: '窗口信息实体。',
+      fields: [
+        { name: 'placeguid', type: 'String(50)', label: '所属场所 GUID' },
+        { name: 'windowname', type: 'String(100)', label: '窗口名称' },
+        { name: 'windowtype', type: 'String(20)', label: '窗口类型' },
+        { name: 'windowaddress', type: 'String(200)', label: '窗口地址' },
+        { name: 'windowguid', type: 'String(50)', label: '窗口编号' },
+      ],
+    },
+    {
+      name: 'GxhZwPlaceHistory',
+      table: 'gxh_zw_place_history',
+      description: '场所历史记录实体，用于保存归档版本。',
+      fields: [],
+    },
+  ],
+
+  businessRules: [
+    {
+      ruleId: 'delete.onlyDraftAllowed',
+      description: '仅草稿状态数据可删除，非 DRAFT 状态删除时被阻断。',
+      scope: ['delete'],
+      sourceKind: 'static_scan',
+      assertionHint: '在用数据不可删除！',
+      evidence: ['src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java#deleteSelect'],
+    },
+    {
+      ruleId: 'placename.unique',
+      description: '新增和编辑保存前校验场所名称唯一性。',
+      scope: ['create', 'update'],
+      sourceKind: 'static_scan',
+      assertionHint: '场所名称已存在！',
+      evidence: [
+        'src/main/java/com/epoint/zwplace/action/GxhZwPlaceAddAction.java#checkPlacenameUnique',
+        'src/main/java/com/epoint/zwplace/action/GxhZwPlaceEditAction.java#checkPlacenameUnique',
+      ],
+    },
+    {
+      ruleId: 'create.saveAndCloseActive',
+      description: '新增保存并关闭时状态为 ACTIVE，版本为 V1，数据源为 MANUAL。',
+      scope: ['create'],
+      sourceKind: 'static_scan',
+      evidence: ['src/main/java/com/epoint/zwplace/action/GxhZwPlaceAddAction.java#add'],
+    },
+    {
+      ruleId: 'update.archiveAndVersionPlusOne',
+      description: '编辑保存并关闭时归档历史数据，版本号加一；草稿状态改为 ACTIVE。',
+      scope: ['update'],
+      sourceKind: 'static_scan',
+      evidence: ['src/main/java/com/epoint/zwplace/action/GxhZwPlaceEditAction.java#save'],
+    },
+    {
+      ruleId: 'windowGrid.requiredFields',
+      description: '窗口子表每行窗口名称、窗口类型不能为空。',
+      scope: ['create', 'update', 'windowGrid'],
+      sourceKind: 'static_scan',
+      assertionHints: ['第N行窗口名称不能为空！', '第N行窗口类型不能为空！'],
+      evidence: ['src/main/webapp/perpage/zwplace/gxhzwplaceadd.html#validateWindows'],
+    },
+  ],
+
+  integrations: [
+    {
+      integrationId: 'syncWindowSystem',
+      label: '同步窗口管理系统',
+      trigger: '列表页按钮“同步窗口管理系统”',
+      currentImplementation: 'service_stub',
+      staticMessage: '同步功能暂未实现，请联系管理员配置窗口管理系统接口。',
+      prdExpectedEndpoint: '/rest/zwzx/query',
+      prdFieldMappings: [
+        { from: '政务中心名称', to: '场所名称' },
+        { from: '场所分类', to: '场所分类' },
+        { from: '是否统管社区', to: '是否社区办理' },
+        { from: '区', to: '区划名称' },
+        { from: '街镇', to: '街道名称' },
+        { from: '详细地址', to: '路/弄/号' },
+        { from: '咨询电话', to: '咨询电话' },
+        { from: '投诉电话', to: '投诉电话' },
+        { from: '综窗名称', to: '窗口名称' },
+        { from: '综窗类型', to: '窗口类型' },
+        { from: '综窗对外地址', to: '窗口地址' },
+      ],
+      evidence: [
+        '场所窗口信息管理及各端统计检索查看_prd.md#4.2.5 F005 同步窗口管理系统',
+        'src/main/java/com/epoint/zwplace/impl/GxhZwPlaceService.java#syncWindowSystem',
+      ],
+    },
+  ],
+
+  routeHints: {
+    contextPathHint: '/epoint-web',
+    rule: '运行环境 origin + contextPathHint + 页面 path 去掉 src/main/webapp 后的路径。',
+    pages: [
+      { pageId: 'gxhzwplacelist', routePath: '/perpage/zwplace/gxhzwplacelist.html' },
+      { pageId: 'gxhzwplaceadd', routePath: '/perpage/zwplace/gxhzwplaceadd.html' },
+      { pageId: 'gxhzwplaceedit', routePath: '/perpage/zwplace/gxhzwplaceedit.html' },
+      { pageId: 'gxhzwplacedetail', routePath: '/perpage/zwplace/gxhzwplacedetail.html' },
+    ],
+    runtimeOriginRequired: true,
+  },
+
+  downstreamRuntimeNeeds: [
+    {
+      needId: 'runtime.origin',
+      description: '真实运行环境 origin 需要由运行配置或人工交互提供。',
+    },
+    {
+      needId: 'dictionary.placecategory.firstEffectiveOption',
+      description: '场所分类字典值来自运行态代码项；首个有效值需要打开真实系统读取。',
+      relatedDataModel: 'placecategoryModel',
+    },
+    {
+      needId: 'dictionary.status.firstEffectiveOption',
+      description: '状态字典值来自运行态代码项；首个有效值需要打开真实系统读取。',
+      relatedDataModel: 'statusModel',
+    },
+    {
+      needId: 'dictionary.windowtype.firstEffectiveOption',
+      description: '窗口类型字典值来自运行态代码项；窗口子表测试时需要打开真实系统读取。',
+      relatedDataModel: 'windowtypeModel',
+    },
+    {
+      needId: 'locator.finalPlaywrightLocator',
+      description: 'code_list.json5 只提供 HTML/MiniUI 元素线索；最终 Playwright locator 由 contract 生成器和运行态验证确认。',
+    },
+  ],
+}

package/codex-skill/ep-stage/code-list-generate/evals/evals.json

@@ -0,0 +1,47 @@
+{
+  "skill_name": "code-list-generate",
+  "evals": [
+    {
+      "id": 0,
+      "prompt": "我们是上游研发，刚完成需求 REQ0011「场所窗口信息管理及各端统计检索查看」的出码，需要把出码总结交给下游测试团队，下游用它生成自动化测试用例。下游要求的输入文件是 code_list.json5。\n\n源码根：<FIXTURE>/zwplace-req（前端页面在 src/main/webapp/perpage/zwplace/，后端在 src/main/java/com/epoint/zwplace/）\n需求文档（PRD）：<FIXTURE>/zwplace-req/docs/场所窗口信息管理及各端统计检索查看_prd.md\n\n请通读源码和 PRD，生成 code_list.json5 写到：<OUTPUTS>/code_list.json5",
+      "expected_output": "符合 ep-stage-code-list/v1-draft 的 code_list.json5：module=zwplace；pages 覆盖 list/add/edit/detail 四角色；list 页按钮正确分类 create/delete/export/custom；queryFields 区分输入框与下拉；add 页含窗口信息子表；businessRules 含删除阻断规则（assertionHint 含『不可删除』）；entities 覆盖 gxh_zw_place/gxh_zw_window；无凭据；路径可解析",
+      "files": [],
+      "assertions": [
+        "产物文件存在且 JSON5 可解析",
+        "四大必填字段齐全（module/moduleName/systems/pages）",
+        "module 标识正确（zwplace）",
+        "pages 覆盖 list/add/edit/detail 四角色",
+        "list 页按钮分类：含 create/delete/export",
+        "「同步窗口管理系统」分类为 custom",
+        "queryFields ≥3 且输入框/下拉区分正确（场所名称=textbox；场所分类/状态=combobox）",
+        "add 页含窗口信息子表（≥2 列且含 windowname 字段）",
+        "businessRules 含删除阻断规则且提示含「不可删除」",
+        "entities 覆盖 gxh_zw_place 与 gxh_zw_window",
+        "dataModels 区分 dictionary_runtime 与 static_options",
+        "edit 页「保存并关闭」action=update 且 backendMethod=save",
+        "sourceRoot.root 提供且 pages[].path 全部可解析",
+        "无明文凭据（password 类字段全部留空）",
+        "关键事实带 evidence 溯源（pages 或 businessRules）"
+      ]
+    },
+    {
+      "id": 1,
+      "prompt": "我们是上游研发，刚完成「方案资源管理」模块（英文标识 schemeresource）的出码，需要把出码总结交给下游测试团队生成自动化测试用例，输入文件是 code_list.json5。\n\n源码根：<FIXTURE>/schemeresource-req（前端页面在 src/main/webapp/perpage/schemeresource/，后端在 src/main/java/com/epoint/schemeresource/）\n\n需求文档还没整理好，先按源码出一份。请生成 code_list.json5 写到：<OUTPUTS>/code_list.json5",
+      "expected_output": "符合契约的 code_list.json5：module=schemeresource；pages 覆盖 list/add/edit/detail；list 页按钮含 create/delete/export；queryFields 从源码提取（名称/类型/简介）；无 PRD 时 requirement 事实不编造（留空、省略或标注待补），运行态不可知的值进 downstreamRuntimeNeeds；无凭据；路径可解析",
+      "files": [],
+      "assertions": [
+        "产物文件存在且 JSON5 可解析",
+        "四大必填字段齐全（module/moduleName/systems/pages）",
+        "module 标识正确（schemeresource）",
+        "pages 覆盖 list/add/edit/detail 四角色",
+        "list 页按钮含 create/delete/export 分类",
+        "list 页 queryFields ≥2 且 label 来自源码（名称/类型/简介）",
+        "sourceRoot.root 提供且 pages[].path 全部可解析",
+        "无明文凭据（password 类字段全部留空）",
+        "关键事实带 evidence 溯源（pages 或 businessRules）",
+        "无 PRD 时不编造需求事实（qualitative：requirement 节缺失/留空/标注待补均为通过；编造具体需求ID、章节 evidence 为不通过）",
+        "运行态不可知的值不捏造为静态事实（qualitative：字典选项、真实 origin 等应留空、省略或登记到 downstreamRuntimeNeeds）"
+      ]
+    }
+  ]
+}