@epoint-testtech/ep-stage-skill 0.0.11 → 0.0.13

package/codex-skill/ep-stage/code-list-generate/evals/fixtures/zwplace-req/docs//345/234/272/346/211/200/347/252/227/345/217/243/344/277/241/346/201/257/347/256/241/347/220/206/345/217/212/345/220/204/347/253/257/347/273/237/350/256/241/346/243/200/347/264/242/346/237/245/347/234/213_prd.md

@@ -0,0 +1,602 @@
+# 场所窗口信息管理及各端统计检索查看 — 需求规划文档/PRD
+
+> 版本：V1.0 | 编写人：AI需求助手 | 日期：2026-07-16
+
+## 修订记录
+
+| 版本 | 日期   | 修订人   | 修订内容 |
+| ---- | ------ | -------- | -------- |
+| V1.0 | 2026-07-16 | AI需求助手 | 初稿 |
+
+## 1. 需求概述
+
+### 1.1 需求名称
+场所窗口信息管理及各端统计检索查看
+
+### 1.2 需求类型
+- [✅] 新增功能
+- [ ] 功能优化
+- [ ] Bug修复
+- [ ] 界面调整
+
+### 1.3 需求优先级
+- [✅] 高
+- [ ] 中
+- [ ] 低
+
+### 1.4 需求目标
+建立标准化的场所窗口信息管理体系，实现场所数据的统一维护、第三方系统对接、管理者可视化统计大屏和移动端群众便捷查询，提升政务服务场所管理的规范性和透明度。
+
+---
+
+## 2. 业务背景
+
+### 2.1 业务场景描述
+政务服务场所（区级政务大厅、条线大厅、社区事务受理中心）和窗口信息目前缺乏统一管理标准，办事指南中场所信息不规范，群众查询不便，管理者无法实时掌握场所窗口整体情况。
+
+**核心用户角色**：
+- **业务管理员**：负责场所和窗口信息的维护、同步第三方数据
+- **领导/管理者**：通过统计大屏实时掌握场所窗口整体情况
+- **群众**：通过移动端查询场所和窗口详细信息
+
+### 2.2 用户痛点分析
+1. 场所信息分散，缺乏统一标准管理
+2. 窗口管理系统与内部系统数据不同步
+3. 管理者无法直观掌握场所窗口统计数据
+4. 群众查询场所窗口信息不便，缺乏移动端入口
+
+### 2.3 业务价值说明
+1. **规范管理**：统一场所窗口信息标准，提升数据质量
+2. **效率提升**：自动化同步第三方数据，减少人工维护成本
+3. **决策支持**：可视化大屏帮助管理者实时掌握整体情况
+4. **便民服务**：移动端群众查询提升服务体验
+
+### 2.4 与其他功能的关系
+- 依赖事项管理模块的场所信息关联
+- 与窗口管理系统（第三方）进行数据同步
+- 为移动端政务服务提供基础数据支撑
+
+---
+
+## 3. 功能模块
+
+### 大厅地址管理（create）
+全新开发的场所信息管理模块，支持场所CRUD、窗口维护、版本管理、草稿/在用状态流转。
+
+### 对接窗口管理系统（integrate）
+集成第三方窗口管理系统API，实现场所窗口数据自动同步。
+
+### 管理者统计大屏（create）
+全新开发的可视化统计大屏，实时展示场所窗口核心指标和分布情况。
+
+### 移动端群众查看（create）
+全新开发的移动端H5页面，支持层级下钻浏览和搜索功能。
+
+---
+
+## 4. 功能需求
+
+### 4.1 功能列表
+
+| 功能模块 | 功能编号 | 功能名称 | 功能描述 | 功能类型 | 二次开发涉及页面/后台路径 | 二次开发目标端 |
+|---------|---------|---------|--------|---------|---------|---------|
+| 大厅地址管理 | F001 | 场所列表管理 | 场所信息列表展示、筛选、分页、导出 | 功能新增 | | PC-管理端 |
+| 大厅地址管理 | F002 | 新增场所 | 跳转二级页面维护场所基本信息和窗口信息 | 功能新增 | | PC-管理端 |
+| 大厅地址管理 | F003 | 修改场所 | 修改场所信息，版本+1，保留历史数据 | 功能新增 | | PC-管理端 |
+| 大厅地址管理 | F004 | 删除场所 | 仅草稿状态可删除，在用数据不可删除 | 功能新增 | | PC-管理端 |
+| 大厅地址管理 | F005 | 同步窗口管理系统 | 从第三方接口同步场所窗口数据 | 功能新增 | | PC-管理端 |
+| 对接窗口管理系统 | F006 | 接口数据映射 | 窗口管理系统字段与本地字段映射转换 | 功能新增 | | PC-管理端 |
+| 对接窗口管理系统 | F007 | 同步冲突处理 | 处理同步数据与本地数据的冲突 | 功能新增 | | PC-管理端 |
+| 管理者统计大屏 | F008 | 核心指标展示 | 场所总数、窗口总数、平均场所窗口数 | 功能新增 | | PC-管理端 |
+| 管理者统计大屏 | F009 | 历史数据趋势图 | 近7天窗口增长趋势折线图 | 功能新增 | | PC-管理端 |
+| 管理者统计大屏 | F010 | 场所分类分布图 | 不同场所分类分布饼图 | 功能新增 | | PC-管理端 |
+| 管理者统计大屏 | F011 | 窗口类型分布图 | 不同窗口类型分布柱状图/饼图 | 功能新增 | | PC-管理端 |
+| 管理者统计大屏 | F012 | 定时刷新 | 每5分钟自动更新所有数据 | 功能新增 | | PC-管理端 |
+| 移动端群众查看 | F013 | 区划层级下钻 | 区→街道/镇→场所→窗口层级浏览 | 功能新增 | | H5-移动端 |
+| 移动端群众查看 | F014 | 场所详情查看 | 展示场所完整信息 | 功能新增 | | H5-移动端 |
+| 移动端群众查看 | F015 | 窗口详情查看 | 展示窗口完整信息 | 功能新增 | | H5-移动端 |
+| 移动端群众查看 | F016 | 搜索功能 | 按场所名称和窗口名称搜索 | 功能新增 | | H5-移动端 |
+
+### 4.2 功能详细说明
+
+#### 4.2.1 F001 场所列表管理
+
+**功能描述**:
+展示场所信息列表，支持按场所名称、场所分类筛选，支持导出功能。
+
+**输入条件**:
+- 筛选条件：场所名称（文本）、场所分类（下拉：区级政务大厅/条线大厅/社区事务受理中心）
+- 分页参数：页码、每页条数（默认20）
+
+**处理逻辑**:
+1. 加载场所列表数据，默认按创建时间倒序
+2. 根据筛选条件过滤数据
+3. 支持分页展示
+4. 点击【导出面板】导出当前筛选结果
+
+**输出结果**:
+- 列表字段：场所名称、场所分类、详细地址、统一对外服务时间、咨询电话、投诉电话、状态、操作
+- 详细地址 = 区划名称 + 街镇名称 + 路/弄/号 拼接
+
+**业务规则**:
+- 状态分为"草稿"和"在用"两种
+- 草稿状态数据可删除，在用状态不可删除
+- 列表仅展示在用和草稿状态的数据
+
+**约束条件**:
+- 场所名称长度不超过50字
+- 详细地址由三个字段自动拼接，不可手动编辑
+
+---
+
+#### 4.2.2 F002 新增场所
+
+**功能描述**:
+点击【新增场所】按钮跳转二级页面，维护场所基本信息和窗口信息。
+
+**输入条件**:
+- 场所基本信息：场所名称、场所分类、区划名称、街道名称、路/弄/号、是否社区办理、统一对外服务时间、咨询电话、投诉电话
+- 窗口信息：窗口名称、窗口类型、窗口地址（支持行编辑）
+
+**处理逻辑**:
+1. 填写场所基本信息
+2. 维护窗口列表信息（默认空，支持行编辑新增）
+3. 点击【保存】：数据状态为草稿
+4. 点击【保存并关闭】：数据状态为在用，生成初始版本
+
+**输出结果**:
+- 保存成功提示
+- 返回列表页或停留在编辑页
+
+**业务规则**:
+- 场所名称不能重复
+- 区划名称下拉选择上海市16个区划
+- 街道名称根据区划选择后联动展示对应街道
+- 窗口来源渠道默认为"手动维护"
+
+**约束条件**:
+- 场所名称、场所分类、区划名称为必填项
+- 窗口信息为非必填，默认为空
+
+---
+
+#### 4.2.3 F003 修改场所
+
+**功能描述**:
+点击列表【操作】按钮跳转二级页面修改场所信息，修改后版本+1，历史数据保留。
+
+**输入条件**:
+- 场所ID
+- 修改后的场所信息和窗口信息
+
+**处理逻辑**:
+1. 加载当前场所最新版本的详细信息
+2. 用户修改字段内容
+3. 保存时创建新版本，版本号+1
+4. 历史版本数据保留，可追溯
+
+**输出结果**:
+- 新版本数据状态为在用
+- 历史版本状态保持历史记录
+
+**业务规则**:
+- 每次修改生成新版本，版本号递增
+- 历史数据不可修改，仅可查阅
+- 窗口信息修改同样遵循版本管理规则
+
+**约束条件**:
+- 仅业务管理员角色可修改
+- 修改后需重新校验必填项
+
+---
+
+#### 4.2.4 F004 删除场所
+
+**功能描述**:
+仅草稿状态的数据可选择后删除，在用数据不可删除。
+
+**输入条件**:
+- 选中的场所ID列表
+
+**处理逻辑**:
+1. 校验选中数据的状态
+2. 过滤出草稿状态的数据
+3. 执行删除操作（软删除）
+4. 刷新列表
+
+**输出结果**:
+- 删除成功提示
+- 列表刷新
+
+**业务规则**:
+- 仅草稿状态可删除
+- 在用状态数据不可删除，按钮置灰或隐藏
+- 采用软删除，数据标记为已删除而非物理删除
+
+**约束条件**:
+- 批量删除时，仅删除符合条件的草稿数据
+- 删除操作需二次确认
+
+---
+
+#### 4.2.5 F005 同步窗口管理系统
+
+**功能描述**:
+业务管理员点击【同步窗口管理系统】按钮，从第三方接口获取场所窗口数据。
+
+**输入条件**:
+- 无（触发同步操作）
+
+**处理逻辑**:
+1. 调用窗口管理系统接口：`/rest/zwzx/query`
+2. 获取返回的场所窗口数据
+3. 字段映射转换（政务中心名称→场所名称等）
+4. 比对本地数据，判断是否发生变化
+5. 未变化：数据版本不变
+6. 已变化：版本+1，更新数据
+7. 窗口来源渠道标记为"窗口管理系统"
+
+**输出结果**:
+- 同步成功提示，展示同步数据条数
+- 同步失败提示，展示错误原因
+
+**业务规则**:
+- 仅业务管理员角色可操作
+- 同步数据与手动维护数据并存
+- 窗口来源渠道字段区分数据来源
+
+**约束条件**:
+- 接口调用需处理超时和异常
+- 同步过程需记录日志
+
+---
+
+#### 4.2.6 F006 接口数据映射
+
+**功能描述**:
+窗口管理系统字段与本地系统字段的映射转换。
+
+**输入条件**:
+- 窗口管理系统返回的原始数据
+
+**处理逻辑**:
+1. 解析接口返回数据
+2. 按映射关系转换字段：
+   - 政务中心名称 → 场所名称
+   - 场所分类 → 场所分类
+   - 是否统管社区 → 是否社区办理
+   - 区 → 区划名称
+   - 街镇 → 街道名称
+   - 详细地址 → 路/弄/号
+   - 咨询电话 → 咨询电话
+   - 投诉电话 → 投诉电话
+   - 综窗名称 → 窗口名称
+   - 综窗类型 → 窗口类型
+   - 综窗对外地址 → 窗口地址
+3. 缺失字段映射为默认值或空
+
+**输出结果**:
+- 转换后的本地数据格式
+
+**业务规则**:
+- 映射关系固定，不可配置
+- 接口中无对应字段标记为"/"的忽略
+
+**约束条件**:
+- 字段类型不一致时需做类型转换
+
+---
+
+#### 4.2.7 F007 同步冲突处理
+
+**功能描述**:
+处理同步数据与本地手动维护数据的冲突。
+
+**输入条件**:
+- 同步数据
+- 本地现有数据
+
+**处理逻辑**:
+1. 按场所名称+区划名称匹配数据
+2. 比对字段值是否发生变化
+3. 未变化：跳过，版本不变
+4. 已变化：以同步数据为准，版本+1
+5. 本地新增但接口无的数据：保留，标记为手动维护
+
+**输出结果**:
+- 冲突处理结果日志
+- 更新后的数据
+
+**业务规则**:
+- 同步数据优先级高于手动维护数据
+- 手动维护的数据不会被同步覆盖（通过窗口来源渠道区分）
+
+**约束条件**:
+- 需记录每次同步和冲突处理日志
+
+---
+
+#### 4.2.8 F008 核心指标展示
+
+**功能描述**:
+大屏顶部展示三个核心统计指标。
+
+**输入条件**:
+- 场所总数
+- 窗口总数
+
+**处理逻辑**:
+1. 查询场所总数（在用状态）
+2. 查询窗口总数（关联场所的窗口）
+3. 计算平均场所窗口数 = 窗口总数 / 场所总数（保留2位小数）
+4. 展示三个指标卡片
+
+**输出结果**:
+- 场所总数（数字）
+- 窗口总数（数字）
+- 平均场所窗口数（数字，保留2位小数）
+
+**业务规则**:
+- 仅统计在用状态的数据
+- 除数为0时平均值为0.00
+
+**约束条件**:
+- 数据需实时更新
+
+---
+
+#### 4.2.9 F009 历史数据趋势图
+
+**功能描述**:
+展示近7天的窗口增长趋势折线图。
+
+**输入条件**:
+- 近7天每天的窗口总数
+
+**处理逻辑**:
+1. 查询近7天每天的窗口总数（按创建时间统计）
+2. 生成折线图数据
+3. 展示趋势变化
+
+**输出结果**:
+- 折线图：X轴为日期，Y轴为窗口数量
+
+**业务规则**:
+- 固定展示近7天数据
+- 无数据的日期显示为0
+
+**约束条件**:
+- 需支持图表交互（悬停显示具体数值）
+
+---
+
+#### 4.2.10 F010 场所分类分布图
+
+**功能描述**:
+展示不同场所分类的分布情况饼图。
+
+**输入条件**:
+- 各场所分类的场所数量
+
+**处理逻辑**:
+1. 按场所分类统计场所数量
+2. 生成饼图数据
+3. 展示分类占比
+
+**输出结果**:
+- 饼图：分类名称和数量/占比
+
+**业务规则**:
+- 固定三个分类：区级政务大厅、条线大厅、社区事务受理中心
+- 显示具体数量和百分比
+
+**约束条件**:
+- 需支持图表交互（悬停显示详情）
+
+---
+
+#### 4.2.11 F011 窗口类型分布图
+
+**功能描述**:
+展示不同窗口类型的分布情况柱状图或饼图。
+
+**输入条件**:
+- 各窗口类型的窗口数量
+
+**处理逻辑**:
+1. 按窗口类型统计窗口数量
+2. 生成图表数据（默认柱状图）
+3. 展示类型分布
+
+**输出结果**:
+- 柱状图/饼图：类型名称和数量
+
+**业务规则**:
+- 窗口类型由业务数据决定，无固定枚举
+- 显示具体数量
+
+**约束条件**:
+- 需支持图表交互
+
+---
+
+#### 4.2.12 F012 定时刷新
+
+**功能描述**:
+大屏数据每5分钟自动更新。
+
+**输入条件**:
+- 无（定时触发）
+
+**处理逻辑**:
+1. 设置定时器，间隔5分钟
+2. 刷新所有统计数据
+3. 更新"最后更新于：YYYY-MM-DD HH:MM:SS"
+
+**输出结果**:
+- 所有图表和数据指标刷新
+- 更新时间显示
+
+**业务规则**:
+- 刷新时显示加载状态
+- 刷新失败时保留上次数据并提示
+
+**约束条件**:
+- 定时器在页面不可见时暂停（可选优化）
+
+---
+
+#### 4.2.13 F013 区划层级下钻
+
+**功能描述**:
+支持按区→街道/镇→场所→窗口的层级结构浏览。
+
+**输入条件**:
+- 当前层级和选择项
+
+**处理逻辑**:
+1. 默认展示上海市16个区
+2. 点击区，下钻展示该区下的街道/镇
+3. 点击街道，下钻展示该街道下的场所
+4. 点击场所，下钻展示该场所下的窗口
+5. 支持返回上一层级
+
+**输出结果**:
+- 当前层级的数据列表
+
+**业务规则**:
+- 层级关系固定：区→街道→场所→窗口
+- 每层点击后展示下一层数据
+
+**约束条件**:
+- 需支持面包屑导航或返回按钮
+
+---
+
+#### 4.2.14 F014 场所详情查看
+
+**功能描述**:
+展示场所的完整信息。
+
+**输入条件**:
+- 场所ID
+
+**处理逻辑**:
+1. 查询场所详细信息
+2. 查询关联的窗口列表
+3. 展示场所基本信息和窗口列表
+
+**输出结果**:
+- 场所名称、场所分类、详细地址、统一对外服务时间、咨询电话、投诉电话
+- 窗口列表：窗口名称、窗口类型、窗口地址
+
+**业务规则**:
+- 展示所有非敏感字段
+- 窗口列表为空时显示"暂无窗口信息"
+
+**约束条件**:
+- 详情页仅展示，不可编辑
+
+---
+
+#### 4.2.15 F015 窗口详情查看
+
+**功能描述**:
+展示窗口的完整信息。
+
+**输入条件**:
+- 窗口ID
+
+**处理逻辑**:
+1. 查询窗口详细信息
+2. 展示窗口基本信息
+
+**输出结果**:
+- 窗口名称、窗口类型、窗口地址、所属场所
+
+**业务规则**:
+- 展示所有非敏感字段
+
+**约束条件**:
+- 详情页仅展示，不可编辑
+
+---
+
+#### 4.2.16 F016 搜索功能
+
+**功能描述**:
+支持按场所名称和窗口名称搜索。
+
+**输入条件**:
+- 搜索关键词
+
+**处理逻辑**:
+1. 用户输入搜索关键词
+2. 模糊匹配场所名称和窗口名称
+3. 展示匹配结果列表
+4. 点击结果跳转到对应详情页
+
+**输出结果**:
+- 搜索结果列表
+
+**业务规则**:
+- 支持模糊搜索（包含匹配）
+- 无搜索结果时显示"未找到相关结果"
+
+**约束条件**:
+- 搜索响应时间<1秒
+- 支持搜索历史记录（可选）
+
+---
+
+## 5. 非功能需求
+
+### 5.1 性能需求
+- **响应时间**: PC端列表加载<2秒，移动端页面加载<1.5秒，大屏图表渲染<3秒
+- **并发用户数**: 支持100并发用户访问
+- **数据处理量**: 单次同步接口数据量不超过1000条
+
+### 5.2 安全需求
+- **权限控制**: 
+  - 业务管理员：场所增删改查、同步操作
+  - 普通业务人员：仅查看
+  - 领导/管理者：大屏查看
+  - 群众：移动端查看
+- **数据加密**: 敏感传输数据使用HTTPS加密
+- **审计日志**: 记录场所数据的增删改操作日志
+
+### 5.3 兼容性需求
+- **PC端**: 支持Chrome、Edge、Firefox最新两个版本
+- **移动端**: 支持iOS Safari、Android Chrome，适配主流手机屏幕
+- **大屏**: 支持1920x1080及以上分辨率
+
+---
+
+## 6. 数据字典
+
+### 6.1 场所分类
+| 代码值 | 显示文本 | 说明 |
+|--------|---------|------|
+| district_hall | 区级政务大厅 | 区级综合政务服务场所 |
+| line_hall | 条线大厅 | 部门专属服务场所 |
+| community_center | 社区事务受理中心 | 社区级服务场所 |
+
+### 6.2 数据状态
+| 代码值 | 显示文本 | 说明 |
+|--------|---------|------|
+| draft | 草稿 | 新增未正式发布 |
+| active | 在用 | 正式发布使用中 |
+
+### 6.3 窗口来源渠道
+| 代码值 | 显示文本 | 说明 |
+|--------|---------|------|
+| manual | 手动维护 | 业务人员手动录入 |
+| system_sync | 窗口管理系统 | 第三方系统同步 |
+
+---
+
+## 变更记录
+
+| 版本号 | 变更日期   | 变更人 | 变更内容 |
+|--------|-----------|--------|----------|
+| V1.0   | 2026-07-16 | AI需求助手 | 初始版本 |