# zhctprompt Codex 工作空间

本目录是 Codex 的全局工作空间，用于放置跨仓库项目说明、产品设计方法、方案输出方法、架构设计、任务拆分和临时分析材料。公司级企业微信微盘派生知识库单独放在 `../work_company_knowledge/`，作为产品人、交付人、开发人共同使用的资料检索入口。

本目录只放工作空间资料。代码仓库统一放在与 `zhctprompt` 同级的 `zhctproject` 目录下；产品设计、方案、UI 原型和架构图资料按受控项目放在 `work_<project>/`。

新的一级业务组织入口在 `../modules/`：

- `../modules/product/`：产品模块，包含 UI 模块、产品方案、架构图、原型和开发项目资料入口。
- `../modules/product/ui/`：UI 模块，集中蓝湖抽样源材料、当前设计规范和蓝湖 MCP/Stitch/GemDesign 入口。
- `../modules/product/development/`：开发模块，按产品视角组织 `store`、`ai_api`、`ai_store`、`ai_app`、`sch1.0new` 等开发项目。
- `../modules/project/`：项目模块，承接企业微盘内所有项目/主题索引。
- `../work_codex_video_harness/`：用户操作手册视频生成工具项目控制入口，团队 skill 为 `../standards-stack/agent-skills/skills/operation-manual-video/SKILL.md`。

本说明不绑定个人电脑的绝对路径。每位同事可以把整体项目目录 `zhct` 放到自己的任意本地目录，只需要保持下面的相对目录结构一致。

文档中的相对路径默认以 `zhct` 整体目录为基准，例如 `zhctproject/store/application/...`、`zhctprompt/work_store/api-docs/...`、`zhctproject/ai_api/app/...`。

## 目录结构

```text
zhct
├── zhctprompt
│   ├── work           # 全局工作空间：跨项目文档、规划、临时分析材料
│   ├── modules        # 产品模块 / 项目模块入口
│   ├── work_store     # store 工作空间：智慧营养健康餐厅资料
│   ├── work_ai_api    # ai_api 工作空间：AI运动营养师 API 资料
│   ├── work_ai_store  # ai_store 工作空间：AI运动营养师 PC 端资料
│   ├── work_ai_app    # ai_app 工作空间：AI运动营养师 uniapp 小程序资料
│   ├── work_sch1.0new # sch1.0new 工作空间：体育训练管理系统资料
│   ├── work_sxtyj_gdfxfj # sxtyj 广东反兴奋剂分支工作空间
│   ├── work_ydysskz   # ydysskz 工作空间：运动员膳食 / 智慧餐厅运动员版本资料
│   ├── work_qc        # qc 工作空间：智慧食堂售前轻采集系统资料
│   ├── work_food_safety # food_safety 工作空间：食品安全智慧管理云平台资料
│   ├── work_win_deploy_guoxin # win_deploy_guoxin 工作空间：国信 Windows 部署仓库资料
│   ├── product_pingan_yunchu # 平安云厨工作空间：产品方案、UI 原型、设计规范和架构图
│   ├── work_chongqing_huanwei # 重庆环卫项目工作空间：妙雀 308 咖啡机接入资料
│   └── work_company_knowledge # 企业微信微盘派生知识库：产品/交付/开发共享索引
└── zhctproject
    ├── store          # zhct：智慧营养健康餐厅代码仓库
    ├── ai_api         # aizhct：AI运动营养师 API，给 uniapp 和 PC 端提供接口
    ├── ai_store       # aizhct：AI运动营养师 PC 端代码仓库
    ├── ai_app         # aizhct：AI运动营养师 uniapp 微信小程序代码仓库
    ├── qc             # 智慧食堂售前轻采集系统代码仓库
    ├── food_safety    # 食品安全智慧管理云平台代码仓库或软链
    └── win_deploy_guoxin # 国信 Windows 部署仓库，按需拉取
```

## 工作空间映射

| 新目录 | 用途 | 迁移来源 |
| --- | --- | --- |
| `zhctprompt/work` | 全局工作空间 | 从原全局工作空间复制 |
| `zhctprompt/work_store` | store 工作空间 | 从原 store 工作空间复制 |
| `zhctprompt/work_ai_api` | ai_api 工作空间 | 从原 ai_api 工作空间复制 |
| `zhctprompt/work_ai_store` | ai_store 工作空间 | 新建 |
| `zhctprompt/work_ai_app` | ai_app 工作空间 | 新建 |
| `zhctprompt/work_sch1.0new` | sch1.0new 工作空间 | 新建 |
| `zhctprompt/work_sxtyj_gdfxfj` | sxtyj 广东反兴奋剂分支工作空间 | 从 `kx/sxtyj` 的 `fxfj_0110` 分支建立 |
| `zhctprompt/work_ydysskz` | ydysskz 工作空间 | 从 `hlss/ydysskz` 的智慧餐厅运动员版本建立 |
| `zhctprompt/work_qc` | qc 工作空间 | 新建 |
| `zhctprompt/work_food_safety` | food_safety 工作空间 | 新建 |
| `zhctprompt/work_win_deploy_guoxin` | win_deploy_guoxin 工作空间 | 新建 |
| `zhctprompt/product_pingan_yunchu` | 平安云厨产品设计与方案工作空间 | 从本机同步空间平安云厨交付物复制 |
| `zhctprompt/work_chongqing_huanwei` | 重庆环卫项目资料：妙雀 308 咖啡机接入与产品化 | 从用户提供的两份妙雀 Word 文档建立 |
| `zhctprompt/work_miaoque_318k_payment_integration` | 妙雀 318K 支付二维码参数对比与接入资料 | 从用户提供的 318K PDF 建立 |
| `zhctprompt/work_binzhou_health_tech_vocational_college` | 滨州健康科技职业学院项目资料：一卡通对接文档、OpenAPI 和联调控制资料 | 从用户提供的 Apifox OpenAPI JSON 和 Word 接口文档建立 |
| `zhctprompt/work_company_knowledge` | 公司微盘知识库 | 从企业微信微盘 `项目交付管理共享空间` 和 `数字技术中心知识库` 抽取派生索引 |

## 受控项目资料落位

当 `zhctprompt` 管理新的受控项目时：

- 项目专属资料放 `work_<project-name>/`，例如 `work_sch1.0new/`。
- 产品设计、方案输出、UI 原型、设计规范和架构图等项目专属资料同样放 `work_<project-name>/`，例如 `product_pingan_yunchu/`。
- 企业微信微盘中的公司级历史项目、标准产品、产品、交付、研发、运维、安全等资料，不批量复制原件，统一抽取索引到 `work_company_knowledge/`。
- 跨项目方法和临时分析放 `work/`。
- 通用 governance、prompt 和 agent skill 放 `standards-stack/`。
- 外部方法、文章、仓库、会议材料或项目证据如果要沉淀成持续更新的个人/团队 wiki，先按 `standards-stack/agent-skills/skills/llm-wiki-knowledge-base/SKILL.md` 在 `work/<date-topic>/` 保存来源索引，再把稳定结论编译到 `standards-stack/llm-wiki/` 或对应 `work_<project>/`。
- 不要在 `zhctprompt` 里复制业务代码或完整 SQL dump。

详细规则见 `CONTROLLED_PROJECT_WORKSPACE_PLACEMENT.md`。

## Codex 团队 Skill 交接

当需要把本项目的 Codex skills 复制给同事使用时，以 `standards-stack/agent-skills/` 为真源：

- 交接说明：`../standards-stack/agent-skills/CODEX_TEAM_SKILL_HANDOFF.md`
- 逐项清单：`../standards-stack/agent-skills/CODEX_TEAM_SKILL_MANIFEST.tsv`
- 执行 skill：`../standards-stack/agent-skills/skills/codex-team-skill-handoff/SKILL.md`

个人 `~/.codex` 目录只作为盘点来源，不作为团队复制包。

## 仓库映射

| 目录 | 项目 | 仓库 |
| --- | --- | --- |
| `zhctproject/store` | 智慧营养健康餐厅 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/store.git` |
| `zhctproject/ai_api` | AI运动营养师 API | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_api.git` |
| `zhctproject/ai_store` | AI运动营养师 PC 端 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_store.git` |
| `zhctproject/ai_app` | AI运动营养师 uniapp 微信小程序 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_app.git` |
| `zhctproject/qc` | 智慧食堂售前轻采集系统 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/qingcai/qc.git` |
| `002-kxxk/sch1.0new` | 体育训练管理系统 | `https://codeup.aliyun.com/60069db88deaa14d9e02b875/kx/sch1.0new.git` |
| `zhctproject/sxtyj` | 科训 / 广东反兴奋剂项目 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/kx/sxtyj.git` |
| `zhctproject/ydysskz` | 运动员膳食 / 智慧餐厅运动员版本 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/hlss/ydysskz.git` |
| `zhctproject/food_safety` | 食品安全智慧管理云平台 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/food_safety.git` |
| `zhctproject/win_deploy_guoxin` | 国信 Windows 部署仓库 | `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/environment_deployment/win_deploy_guoxin.git` |

## 首次拉取代码

假设当前已经在 `zhct/zhctprompt/work` 目录下，先进入代码仓库目录：

```bash
cd ../../zhctproject
```

克隆智慧营养健康餐厅：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/store.git store
```

克隆 AI运动营养师 API：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_api.git ai_api
```

克隆 AI运动营养师 PC 端：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_store.git ai_store
```

克隆 AI运动营养师 uniapp 微信小程序：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_app.git ai_app
```

克隆智慧食堂售前轻采集系统：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/qingcai/qc.git qc
```

克隆 food_safety 食品安全智慧管理云平台：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/food_safety.git food_safety
```

克隆 win_deploy_guoxin 国信 Windows 部署仓库：

```bash
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/environment_deployment/win_deploy_guoxin.git win_deploy_guoxin
```

克隆 sch1.0new 体育训练管理系统：

```bash
git clone https://codeup.aliyun.com/60069db88deaa14d9e02b875/kx/sch1.0new.git sch1.0new
```

也可以一次性执行：

```bash
cd ../../zhctproject

git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/store.git store
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_api.git ai_api
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_store.git ai_store
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/zhct/ai_app.git ai_app
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/qingcai/qc.git qc
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/food_safety.git food_safety
git clone g***@codeup.aliyun.com:60069db88deaa14d9e02b875/environment_deployment/win_deploy_guoxin.git win_deploy_guoxin
```

## 日常更新代码

分别进入每个仓库执行：

```bash
cd ../../zhctproject

git -C store pull --ff-only

git -C ai_api pull --ff-only

git -C ai_store pull --ff-only

git -C ai_app pull --ff-only

git -C qc pull --ff-only
git -C food_safety pull --ff-only
git -C win_deploy_guoxin pull --ff-only
```

## 注意事项

- 拉取代码前需要先确认本机 SSH key 已经有云效 Codeup 仓库权限。
- 如果目标目录已经存在且不是空目录，不要直接重复执行 `git clone`，先检查目录内容。
- 日常更新建议使用 `git pull --ff-only`，如果本地有冲突或需要合并，会停止并提示人工处理。