负责人列
数量口径
Director Command Console
导入数据
--
项目运营总控台
先看风险，再看责任与节点节奏；所有数字可下钻到项目明细。
生命周期压力
按节点日期与进度判断
项目阶段跑道
区域战情
主力店态
省份 × 店态明细矩阵
原始店态结构
数据表口径展开
店态明细运转矩阵
本月运转量
按真实店态
责任域节点矩阵
小组情况
团队完成口径
团队工作完成情况
成员关联明细
用于核对项目归属、缺日期和未映射人员。
负责人责任盘
负责人项目运营情况
按当前负责人责任盘统计，与上方团队花名册参与口径不同。
风险告警
团队负载工作台
当前平面方案计入负载，摆场 / 历史完成 / 关联记录只做统计
团队负载工作台
项目情况
内部 PRD / 运营规则 / 交接索引
开发文档
源氏木语门店项目运营中台 - 系统框架与交接说明，帮助管理者看懂数据口径，也帮助开发者快速定位维护入口。
- 阅读对象
- 管理者 / 运营 / 开发
- 路由格式
- #developer-docs/home
- 维护状态
- 框架已定，持续补全
总监先看系统总览、业务口径与规则、指标怎么看。
运营先看页面怎么用、数据来源与更新、异常与责任口径。
开发先看接口与技术维护、变更与验收、规则同步边界。
文档说明
这份文档不再按长文滚动阅读，而是按左侧目录切换独立子页面。每页先讲业务含义，再给运营口径，最后给开发维护入口。
本页将补充：维护人、更新节奏、写法约定、哪些章节已确认、哪些章节仍待补充。
系统总览
系统总览
说明这个运营中台解决什么问题、服务哪些角色、页面如何组织，以及系统框架与交接说明的维护入口。
产品定位
空间视觉门店项目运营看板用于统一查看项目进度、小组负载、延期风险、负责人责任和规则口径，辅助日常调度与复核。
本页将补充：用户角色、使用场景、与源表单的分工边界。
页面地图
- 运营看盘 - 总览、加盟看板、直营看板。
- 项目与小组 - 小组情况、项目情况。
- 开发文档 - 系统框架、规则口径、指标说明、接口与验收。
关键风险与维护点
路由加载边界、项目目录缓存、规则三层同步、团队预计算和负责人身份，是当前最需要谨慎维护的区域。
页面怎么用
页面怎么用
说明各页面分别回答什么业务问题、适合谁看，以及主要交互如何影响筛选和下钻。
运营看盘
总览展示全盘 KPI 与区域结构；加盟/直营看板按店态 profile 下钻，共享 profile-shared 模块。
本页将补充：各 KPI 含义、下钻弹窗、图表数据来源。
小组情况
负责人切换驱动 metrics、工作完成度、责任复核三组模块；含借调、负载与调度建议展示。
本页将补充：人员架构解析、完成度口径、负责人切换缓存策略。
项目情况
项目清单工作台支持搜索、筛选、下钻和详情懒加载；暂停/取消项目单独纳入查看，不影响默认总盘。
本页将补充：列定义、阶段展示、Deadline 复核入口。
开发模式页面
snapshot 标记 developerDocumentationVisible 时显示本文档；内网展示模式隐藏。
业务口径与规则
业务口径与规则
集中说明项目范围、负责人怎么算、阶段与进度、延期提醒规则、Deadline 和规则变更同步。
项目范围
默认统计推进项目；暂停/取消项目在项目情况页单独纳入，不影响默认总盘。
本页将补充：暂停/取消判定、店态面积分段、项目类型规则。
负责人身份
同名不同责任身份分开统计；显示名尽量贴近日常叫法，统计按 responsibility slot 归集。
阶段与进度
当前阶段与下一提醒统一读取阶段提醒口径表；下游事实可推动阶段向后，字段漏填只作为数据缺口。采购时间只表示采购中，采购完成情况已完成才进入待摆场；摆场开始时间填入即进入摆场中，摆场文件发出即默认摆场结束。
筛选参数
省区、店态、业务类型、阶段等筛选作用于项目情况与部分下钻；同页 hash 变化不触发全量重载。
规则来源与同步
把项目阶段口径、Deadline、提醒卡点和延期判定沉淀成统一规则，由后台硬规则驱动提醒与记录。可执行规则在代码与 JSON；人类可读在 docs/rules/operational-rulebook.md；运营摘要在本开发文档规则章节。不手写完整矩阵副本。
- 可执行规则 -
src/backend/hardDecorationDeadlineRules.mjs与data/rules/。 - 人类可读规则 -
docs/rules/operational-rulebook.md。 - 运营展示 - 本页摘要、状态、关键口径。
延期提醒规则
硬装 Deadline 仍按复尺时间 Y 和中国工作日矩阵生成；软装、采购、摆场先复用统一阶段提醒表输出下一动作，不把单个漏填字段当作主提醒。
- 复尺时间 Y - 进入平面方案启动约束。
- 阶段提醒表 - 统一输出待采购、待摆场、等待摆场结束、项目待闭环等动作。
- 数据缺口 - 上游字段漏填单独提示，不阻断已发生的下游阶段。
负责人责任身份与数据通道
负责人自然人、责任专业和业务范围分开处理；外部来源姓名保留原样，指标和选择器使用本地责任身份 id。
杨锦帆（硬装）
identityId resp-017，sourceName 仍为杨锦帆，只进入 CD负责人 / 硬装负责人等硬装槽位。
杨锦帆（软装）
identityId resp-018，sourceName 仍为杨锦帆，只进入 VM负责人 / 软装负责人等软装槽位。
待核对通道
多身份负责人仅命中负责人总列时，不进入明确主指标，进入待核对通道。
安全边界
本地切分只发生在责任身份解析、指标过滤和前端展示层，不回写来源表单。
紧急 / 非紧急待处理 Top5
团队工作完成情况模块的两列待处理队列。入选、分组、计划开业目标风险与排序口径与后台 teamWorkCompletionReview.mjs 保持一致。
人工标记紧急
项目状态等字段文本含紧急，且不含不紧急、非紧急、一般。
非紧急队列
含一般、不紧急、非紧急，或未填写优先级字段的项目；即使逾期也留在非紧急列并显示风险。
Top5 排序
按当天计划开业目标风险排序：逾期、今日交付、7天内、14天内、未来、目标待核对；日期待核对靠后，同风险带叠加公司阶段滞后，采购、摆场中、待闭环按中度补强。
口径边界
交付窗口按计划开业目标日计算，只保留为周期说明，不作为 Top5 主排序依据；紧急标记只作分组，不替代计划开业目标风险。
面积与店态 Deadline 矩阵
所有节点都以复尺时间 Y 为基准，Y+N 表示第 N 个中国工作日。法定双休和节假日不计入 Y+N；2000㎡以上暂按1500～2000㎡超体店时间定。
面积平面/躺平启动方案快截止了平面/躺平截止施工图启动施工图预计截止商场审核开始终审提醒商场终审结束
mini店：≤300㎡Y+1Y+4Y+6Y+7Y+10Y+10Y+13Y+15
中小店：300～450㎡Y+1Y+4Y+6Y+7Y+11Y+11Y+14Y+17
中店：450～650㎡Y+1Y+7Y+9Y+10Y+15Y+15Y+18Y+22
中大店：650～800㎡Y+1Y+9Y+11Y+12Y+18Y+18Y+21Y+25
大店：800～1000㎡Y+1Y+13Y+15Y+16Y+23Y+23Y+26Y+30
旗舰店：1000～1500㎡Y+1Y+13Y+15Y+16Y+22Y+22Y+25Y+30
超体店：1500～2000㎡Y+1Y+13Y+15Y+16Y+23Y+23Y+26Y+31
超体店：2000㎡以上（暂按1500～2000㎡）Y+1Y+13Y+15Y+16Y+23Y+23Y+26Y+31
变更同步
规则口径变更须同步：后端常量、日历数据、规则文档、本页规则章节、相关测试。
冲突先确认规则变更、一次性例外或保留现有规则；确认规则变更后同步后端规则、规则文档、前端摘要和相关测试；一次性例外不写入生效规则，只记录例外原因和适用项目。
指标怎么看
指标怎么看
说明总盘指标、小组完成度、提醒复核和下钻项目目录的读取方式。
总盘指标
由 metrics/composeDashboard 等模块汇总；总览/加盟/直营共用 metrics 接口，按 context 切片。
小组完成度
/api/team-work-completion 与 /api/team-responsibility-review 承载小组域统计，走 snapshot 缓存。
提醒与复核
关键日期、字段缺口、Deadline 提醒在前端 domain 层组装；异常进入复核队列，不直接改源数据。
下钻与项目目录
KPI 下钻走 resolveDrillProjects（fields=ids + 本地目录）；项目目录统一 project-catalog.mjs summary 视图。
数据来源与更新
数据来源与更新
说明外部源表单、同步入库、汇总数据生成和前端取数路径。
源表单来源
项目与人员数据来自外部源表单；表单字段含义与录入校验由业务侧维护，看板侧只读消费。
同步与存储
手动/自动同步将外部源数据写入本地数据库与 snapshot；前端通过 API 读取，不回写源表单。
汇总数据生成
小组页等重接口走 snapshot 签名缓存与预计算 worker，避免每次请求全量重算。
前端如何取数
首屏由 loadDashboard 编排；各页按需拉取 metrics、profile、team 域接口与项目目录。
接口与技术维护
接口与技术维护
给接手开发者定位前端结构、后端任务分工、接口、缓存和加载边界。
页面代码分工
public/ 按职责拆分，页面模块不互相引用（共享助手除外）。
后端任务分工
src/backend/ 负责同步、持久化、指标计算、规则引擎与 API 暴露。
仓库目录
public/、src/backend/、data/rules/、docs/rules/operational-rulebook.md、tests/ 是主要维护入口。
核心接口
snapshot、metrics、projects（summary/full/ids）、team 域接口、profile 等；大响应 gzip。
页面加载边界
showPage 只管外壳切换；loadDashboard 编排首屏；cache-first，仅显式刷新传 forceRefresh。
缓存与数据版本
projectsCatalogSignature 绑定 snapshot；源表单同步或签名变化须 invalidateProjectCaches。
变更与验收
变更与验收
说明不同改动域需要运行的测试、变更检查清单和维护交接记录。
测试地图
按改动域运行对应测试，防止加载边界与口径回退。
变更检查清单
改动前对照：是否触及路由/加载边界、规则三层、projects 路由、小组预加载顺序。
维护记录
每次改页面、规则或数据入口时，在此记录改动摘要、影响面与未补项。
数据详情
项目明细
0 项