@microi.net/cli 5.9.5 → 5.9.6

package/skills/microi-system-delivery/references/progressive-01-/346/240/207/345/207/206/345/267/245/344/275/234/346/265/201.md

@@ -7,7 +7,7 @@
 统计都应来自真实字段或真实接口引擎；配置写 `diy_table`，禁止写入 `sys_menu`。即使用户
 没有逐项指定，也必须写入类型感知的合理默认值，不能交付空 Banner。
 
-<!-- microi-progressive:chunk id=microi-system-delivery-005 sha256=8f34122f08c3cee8f4aed5054c012cb560904442ea080fa2fc3d495b73b53a25 -->
+<!-- microi-progressive:chunk id=microi-system-delivery-005 sha256=32039bfdbd18bb97f3f93974ace75169c9d90df4c0702ff76134f1c9a9282912 -->
 ## 完整系统开发默认交付清单（原推荐提示词 1–8）
 
 以下八项来自官网最后编号版推荐提示词，是完整系统新建/开发的默认交付要求。
@@ -62,6 +62,42 @@
 - 页面、控制台或网络报错要定位并修复本次交付相关问题，回归后给出证据；外部服务阻断如实记录，不能声称未验证的路径已通过。
 - 完成后只关闭本次 AI 创建的临时浏览器、服务和进程，并回读清理结果；不得遗留孤儿进程，也不得结束用户或其它任务共享的服务。按 `playwright-e2e` 维护测试与截图产物。
 
+## 菜单先行与经营报表增补要求（强制）
+
+本节是原 1–8 项之外的必读增补，两项要求共同执行，不替换或删减上方清单。
+完整系统开发默认执行；局部修改只处理需求内菜单、页面和指标；只读分析不写菜单、页面或验收数据。
+默认规范不能代替开发租户写入授权，也不授权客户部署、生产数据变更或全库重建。
+
+### 先展示完整菜单，再逐项交付真实页面
+
+1. 需求分析结束、现有资源盘点完成后，在业务蓝图中列出本次完整菜单树：业务域父菜单、业务功能、统计看板、老板报表、领导报表及需求内日志/设置。每个叶菜单记录稳定 Key、标题、父级、排序、目标角色和最终页面类型；复用已有正确菜单，不把已交付功能切回开发中。
+2. 菜单骨架使用独立 Manifest，只包含 `SecondMenu` 父菜单、用户可见业务/报表的 `Component` 占位叶菜单及必要菜单权限，不预绑定尚不存在的业务表、页面或微服务。独立执行 `microi_plan_system` 和 `dryRun`，在已授权的开发租户范围内优先落地，让用户立即看见功能结构。占位叶菜单使用 `OpenType=Component`、`ComponentPath=/ai-engine/developing`、`IsMicroiService=0`，并保存各自独立、稳定的业务 `Url`。一个共享 Vue 组件服务多个菜单，不能共用业务 URL 或复制多份源码。隐藏 `TableChild` 等数据/授权载体不使用占位组件，仍按原规范保留 `Diy`、真实表绑定及 `Display=0/AppDisplay=0`。
+3. 共享页面在路由内容区按可用宽高 100% 展示“AI 正在开发中…”及当前菜单标题。菜单身份与名称来自平台生成的 `route.meta.Id/title`，不能从任意 URL 参数拼接 HTML。持续轻量动画必须支持平台明暗主题、窄屏和减少动态效果偏好；动画只表达等待，不模拟真实开发进度。没有可回读任务状态时不展示虚构百分比、完成数、倒计时或预计完成时间。
+4. 菜单写入后回读 `Id/ParentId/Url/OpenType/ComponentPath/IsMicroiService/Sort` 与角色权限，逐个点击检查身份、标题、访问标签、刷新及切换。随后用分阶段最终资源 Manifest 开发业务表、接口和页面；先回读真实资源 Id，再更新已有菜单绑定，不用尚不存在的资源约束阻塞菜单骨架生成。蓝图记录每个菜单的实际状态、最终绑定及证据；占位不计作已开发页面或已交付功能。
+5. 先在已授权且可访问的候选运行入口独立预验收该菜单的真实页面，覆盖业务、权限、数据及截图，不要求尚指向占位的原业务 URL 提前显示新页面。通过后记录本菜单切换前绑定，更新同一条 `sys_menu` 的 `OpenType`、`ComponentPath` 或真实 MicroService/界面引擎/报表绑定，并按最终打开方式设置 `IsMicroiService`。保持 `Id/ParentId/Url/Sort`、角色/按钮权限及关联，不删除重建或改变无关配置。刷新菜单并移除该菜单旧占位缓存，回读配置，再从原菜单及原 URL 做最终验收；微服务预验收前先发布并验证产物和页面绑定，不能只保存源码就切换。
+6. 切换或原入口最终验收失败时，仅恢复该菜单记录的占位绑定或原正确绑定，刷新并回读，保留失败证据与待完成记录。中断、失败或未完成均保持诚实状态，存量已完成页面继续可用；最终交付逐菜单核对，不能靠改文案、隐藏未完成菜单或把占位视为成功来清零。
+
+占位组件是吾码框架前端能力，目标前端版本必须实际包含 `/ai-engine/developing`。
+旧前端先按用户授权完成框架升级；未升级时先交付菜单规划并准确记录版本依赖，保留原可用路由，不能创建指向不存在组件的白屏菜单或把任意外部 URL 当作等价交付。检查版本不授权自动升级客户容器。具体配置读取 `module-engine`。
+
+### 默认交付业务统计、老板经营与领导管理报表
+
+- 完整系统蓝图必须主动设计基于界面引擎（Page Engine）的统计报表，覆盖需求相关的业务运营统计、老板经营决策和领导管理分析，不等用户逐条要求。按业务域、角色和决策任务组织报表菜单；允许复用同一真实指标源并按角色提供视图，避免为了凑数量重复页面。逐项列出各类报表及适用指标；不适用指标说明业务依据，不伪造不存在的利润、成本、业绩或风险数据。
+- 业务统计关注数量、金额、状态、趋势、分布、效率和异常；老板经营视角关注经营规模、收入/成本/利润（存在可核对来源时）、回款/现金与经营风险；领导管理视角关注部门/人员绩效、任务进展、待办/逾期、资源利用及达成情况。最终指标由需求与实际业务模型决定，不能机械套用无关行业指标，也不能只交一张无意义总数卡。
+- 每项指标在蓝图中定义名称、数据源、计算公式、单位/精度、业务状态、时间字段、时区、区间边界、维度和可见角色；比较类指标明确同比/环比基期。前端筛选与后端查询口径一致，日期、部门/人员/项目等条件在服务端生效；统计接口继续按当前租户和真实用户数据范围授权，不能因老板/领导菜单名称就授予跨租户或全库读取。
+- 使用真实业务表、数据源和接口引擎批量聚合，不下载全量明细在前端拼统计，不用随机数、模板演示数或本页合计冒充全量指标。界面引擎负责看板、图表、趋势与分析；需要分页明细、汇总表、查询和导出时配合 `report-engine` 的虚拟报表。列表 `StatisticsFields`、模块 Hero、菜单/按钮角标只是局部提示，不能替代这三类决策报表。
+- 报表必须有合理的周期/维度筛选、加载、空数据、无权限和失败状态。真实零值显示为零；未配置、缺数据源或请求失败不能伪装为零。支持从指标/图表穿透到授权业务明细，带上同一筛选条件，并校验明细合计与统计一致；确无可穿透明细的汇总明确说明来源与限制。
+- 先把报表入口纳入菜单骨架，再开发真实指标与界面引擎页面。通过管理员、老板/领导业务角色、普通及无权限角色测试，覆盖时间边界、筛选组合、零/空/失败、跨部门/跨租户拒绝、明细对账、电脑/移动与明暗主题截图；保存并回读 `mic_page`、绑定菜单、数据源及统计接口。示例 JSON 只证明排版，不能证明真实报表已交付。细节读取 `page-engine`、`report-engine` 和 `datasource-engine`。
+
+### 新增验收清单
+
+- [ ] 原 1–8 项逐条仍有实现与验收记录，没有被两项增补取代。
+- [ ] 菜单骨架独立 Manifest 通过 plan/dryRun 并在授权范围落地，没有预绑定不存在的资源；仅可见业务/报表叶菜单使用占位及 `IsMicroiService=0`，URL 各自独立，隐藏数据载体和存量已完成功能保持正确绑定。
+- [ ] 开发中页填满可用内容区，当前菜单身份/标题正确；持续动画、明暗/窄屏和减少动态效果可用，无假进度。
+- [ ] 候选真实页面先独立预验收，再以真实资源 Id 更新同一菜单及正确打开方式标记；保留 Id、URL、层级、排序、权限和关联，刷新菜单/旧缓存后通过原入口最终验收；失败精确恢复本菜单原绑定，仍在占位的菜单列为未完成。
+- [ ] 三类界面引擎统计报表已按需求覆盖，指标口径与数据来源完整，筛选和权限在服务端生效。
+- [ ] 统计与同口径明细对账，穿透、时间边界、零/空/失败、角色隔离及跨端截图通过；局部/只读任务没有超范围创建资源。
+
 ## 标准工作流
 
 ### 1. 需求蓝图阶段
@@ -70,6 +106,7 @@
 - 用 `business-blueprint` 或同等文档固定：角色、菜单、状态机、关键表、接口引擎、按钮、任务调度、业务时间窗口、费率和权限边界。
 - 用户新增或纠正规则后，立即同步到蓝图/方案文档，避免后续实现忘记业务口径。
 - 生成系统前，用 MCP 读取现有 `diy_table`、`diy_field`、`sys_menu`、`sys_apiengine`，不要重复造表或编造字段。
+- 按上方增补要求形成完整菜单树、逐菜单最终页面计划，以及业务/老板/领导三类界面引擎统计报表和指标口径。
 
 ### 2. MCP 建模阶段
 
@@ -78,6 +115,7 @@
 - 创建复杂系统优先使用 Manifest：表、字段、菜单、按钮、接口引擎、权限、页面、打印、工作流、任务统一规划。
 - 先 dry-run：`microi_plan_system` / `microi_generate_system dryRun:true`。
 - 用户确认后真实写入，并立即 `microi_validate_system`。
+- 真实写入先落地已授权的新菜单骨架，再逐项建模、实现与验收；菜单从共享开发中组件切到真实页面的时机与身份保护按上方增补要求执行，不把占位页当最终验收成功。
 - 所有写操作前必须确认 MCP 绑定的 API Server、OsClient 和用户指定租户一致；多个 MCP 同时存在时，读写不能跨服务器混用。
 - 对资金/资产类生产数据执行清理、重算、修复、补发、扣减前，必须留下可审计痕迹：中文备注 SQL、维护接口说明、执行时间、影响行数、回读验证结果。能用小范围条件时不要全表更新。
 - 写入菜单时，业务按钮一次性配齐 `MoreBtns`、`FormBtns`、`PageBtns`、`BatchSelectMoreBtns`、`PageTabs`，按钮前端只负责交互，后端逻辑放接口引擎。

package/skills/microi-system-delivery/references/progressive-02-/350/207/252/345/212/250/345/214/226/346/265/213/350/257/225/345/277/205/351/241/273/350/246/206/347/233/226/347/232/204/345/235/221.md

@@ -2,7 +2,7 @@
 
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
-<!-- microi-progressive:chunk id=microi-system-delivery-006 sha256=1dd7c9face286616c392ece855acac7d1a3358afbad904a4ff6da5f10c0a8e01 -->
+<!-- microi-progressive:chunk id=microi-system-delivery-006 sha256=bc1fbdecb428b0a94d04d55d22e5c14f61354097cbaa2a059574f47fb41f5bdc -->
 ## 自动化测试必须覆盖的坑
 
 ### 后端统一测试与发布门禁
@@ -69,8 +69,8 @@
 ### 网络与接口契约
 
 - 拦截全部请求，404、5xx、CORS/ORB、图片加载失败、字符串 `null`、空响应、非 JSON 全部失败。
-- 页面出现“请求失败”“网络错误”“开发中”“待开发”“null”等文案，默认失败。
-- 扫描源码禁止残留 `开发中|待开发`。
+- 页面出现“请求失败”“网络错误”“null”等文案默认失败；最终业务入口出现“开发中”“待开发”判为未交付。菜单骨架阶段的预期占位可验证菜单身份、布局和动画，但不计已完成业务功能。
+- 最终交付业务源码禁止残留 `开发中|待开发`；精确排除平台共享 `ai-engine/developing.vue` 及其专属占位测试，不扩大到业务页面或其它源码。
 - 所有 `callEngine('xxx')` 必须有接口契约测试覆盖：HTTP ok、标准 DosResult、必要字段非空。
 
 ### 真实业务闭环