# 产品资料和项目目录纠偏规则

更新时间：2026-06-02

## 这个文件怎么用

当 Agent 把产品资料、设计资料或项目资料建错目录时，直接提示它：

```text
请按 /Users/wiscourper/Documents/workspace/zhct/zhctprompt/PRODUCT_DIRECTORY_RULE.md 这个规则重新判断目录。
```

如果是项目启动、Docker、本地运行、业务代码仓库位置等问题，继续按：

```text
/Users/wiscourper/Documents/workspace/zhct/zhctprompt/README.md
```

## 最重要的一句话

代码、交付、客户部署、接口联调、排障和运维控制资料用 `work_`；产品方案、PRD、UI、设计、原型、设计规范、架构图和产品评审资料用 `product_`。

## 顶层目录判断

| 资料类型 | 正确路径 | 说明 |
| --- | --- | --- |
| 业务代码仓库 | `zhctproject/<repo>/` | 只放业务代码，不复制进 `zhctprompt`。 |
| 代码项目控制资料 | `zhctprompt/work_<project>/` | 项目地图、启动方式、接口、排障、部署、验收、QA。 |
| 客户交付和部署资料 | `zhctprompt/work_<project>/` | 客户现场、部署记录、设备联调、运维和交付证据。 |
| 产品/设计专项资料 | `zhctprompt/product_<project-or-topic>/` | 产品方案、PRD、UI、原型、设计规范、架构图、评审。 |
| 产品线通用资料 | `zhctprompt/modules/product/products/<product-line>/` | 产品线总览、战略、通用需求、通用方案、产品线级 UI 和架构。 |
| 跨产品通用资料 | `zhctprompt/modules/product/<module>/` | 跨产品战略、需求、UI 基底、软件平台化、评审工作台。 |
| 跨项目过程资料 | `zhctprompt/work/YYYY-MM-DD-topic/` | 临时 intake、过程证据、调研草稿、归属未定资料。 |
| 未来 Agent 必须遵守的规则 | `zhctprompt/standards-stack/` | 治理标准、skill、流程规范、任务契约。 |

## `work_` 和 `product_` 的边界

### 放进 `work_<project>/`

- 代码仓库说明、启动方式、项目地图
- 接口文档、联调记录、设备接入记录
- 客户部署、交付进度、验收清单
- 排障记录、运维脚本说明、数据库口径
- MR、云效、测试、截图、视频等项目执行证据

### 放进 `product_<project-or-topic>/`

- 产品方案、售前方案、客户方案、产品简介
- PRD、需求分析、用户故事、业务流程、验收标准
- UI、蓝湖、设计规范、视觉稿、原型任务包
- 可执行设计原型、演示原型
- 架构图、流程图、时序图、UML、模型图
- 产品评审、设计评审、多人打分、复盘

## 当前已确认的产品/设计项目

| 项目 | 正确目录 | 说明 |
| --- | --- | --- |
| 平安云厨 | `zhctprompt/product_pingan_yunchu/` | 产品设计、方案、UI 原型和架构图资料。 |

原 `work_pingan_yunchu/` 已迁移为 `product_pingan_yunchu/`，后续不要再新建 `work_pingan_yunchu/`。

## 当前产品线目录

| 产品线 | 正确目录 | 关联项目示例 |
| --- | --- | --- |
| 智慧餐厅 / 智慧营养健康餐厅 | `zhctprompt/modules/product/products/smart-canteen/` | `store`、`qc`、`product_pingan_yunchu`、`work_laidisen` |
| AI 运动营养师 | `zhctprompt/modules/product/products/ai-nutritionist/` | `ai_api`、`ai_store`、`ai_app` |
| 食品安全 | `zhctprompt/modules/product/products/food-safety/` | `food_safety`、`win_deploy_guoxin` |
| 科学训练 | `zhctprompt/modules/product/products/science-training/` | `sch1.0new`、`sxtyj` |

详细映射以 `zhctprompt/modules/product/products/product-line-map.csv` 为准。

## 纠偏流程

当发现目录建错或归档路径不对时：

1. 先判断资料本质：代码交付、产品设计、产品线通用、跨项目过程、还是未来规则。
2. 如果是代码、交付、客户部署、接口、排障、运维，迁到 `work_<project>/`。
3. 如果是产品方案、PRD、UI、原型、架构图、产品评审，迁到 `product_<project-or-topic>/`。
4. 如果是产品线通用资料，迁到 `modules/product/products/<product-line>/`。
5. 如果归属不确定，先放 `work/YYYY-MM-DD-topic/`，并写清楚待确认项。
6. 迁移后更新对应 `README.md`、`source-index.md`、`summary.md` 或产品线映射。

## 禁止事项

- 不把业务源码副本放进 `product_`。
- 不把产品方案、UI 原型、设计规范默认塞进 `work_`。
- 不在 `zhctproject/<repo>` 里维护与代码运行、发布、迁移、测试无关的产品说明，除非用户明确要求。
- 不把大视频、压缩包、完整素材包、完整数据库转储整包复制进 Git。
- 不把账号密码、手机号、客户隐私、生产配置、密钥或证书写入可提交文件。

## 关联规则文件

- `zhctprompt/modules/product/PRODUCT_AND_DESIGN_PROJECT_PREFIX_RULE.md`
- `zhctprompt/standards-stack/prompt/governance/PRODUCT_MATERIAL_PLACEMENT_STANDARD.md`
- `zhctprompt/work/CONTROLLED_PROJECT_WORKSPACE_PLACEMENT.md`
- `zhctprompt/standards-stack/agent-skills/skills/product-material-placement/SKILL.md`
- `zhctprompt/standards-stack/agent-skills/skills/controlled-project-workspace-placement/SKILL.md`