---
name: "programming-workflow"
description: "Standard fix/development workflow for xinan projects. Invoke when doing any code modification, bug fixing, or feature development involving xinan-fashion shop or miniprogram."
---

# 🧑‍💻 编程工作流 (Programming Workflow)

**核心铁律**: 流程比记忆可靠。先走流程，再调经验。知识库只占60-70%，永远先核查再动手。

---

## 一、标准工作流（每次必走）

```
1. 收集素材 (Goal/Context/Constraints/Done when)
2. 先读当前文件（不信记忆）
3. 备份（git commit 或 cp）
4. 改最小范围
5. 运行 lint + typecheck + test
6. 确认行为符合预期
7. 记录经验到知识库
```

## 二、知识库快速参考

| 内容 | 文件 |
|:-----|:------|
| **铁律/经验/原则** | `ant-backups/knowledge-base/TRAE-经验书.md` |
| **小程序细节** | `ant-backups/knowledge-base/编程经验库-小程序.md` |
| **商城细节** | `ant-backups/knowledge-base/编程经验库-商城.md` |
| **全部API** | `ant-backups/knowledge-base/API接口速查库.md` |
| **标准流程** | `ant-backups/knowledge-base/编程经验库-标准工作流.md` |

## 三、项目快速索引

### 小程序 (原生微信小程序 + Express.js)
- 前端: `/media/zhengjie/WORKSPACE/003/projects/xinan-miniprogram/miniprogram-xinan-fashion/`
- 后端: `/media/zhengjie/WORKSPACE/003/projects/xinan-miniprogram/miniapp/`
- 部署: `4hao:/data/xinan-miniapp/` (PM2: xinan-miniapp, 端口3003)
- API域名: `shop.hunanningyang.cloud`（注意是ningyang不是ningyuan）
- Nginx路径: `/api/miniapp/`（不是/api/v1/）
- 图片优先级: `cover_url > image_url > scene_images`

### 商城 (Next.js 16 + FastAPI)
- 源码: `4hao:/data/xinan-fashion/`
- 部署: PM2 shop-frontend (端口3000, 当前errored)
- API: `https://shop.hunanningyuan.cloud/api/v1/` → FastAPI 8891
- 价格公式: `¥{retail_price * 0.35}`
- CDN: `img.hunanningyuan.cloud`
- ⚠️ Next.js 16 有breaking changes，改前查 `node_modules/next/dist/docs/`

## 四、标准排查流程

```
1. 看状态（健康检查/logs/进程）
2. 收集证据（错误信息/复现步骤）
3. 对比正常环境（diff配置/diff代码）
4. 定位根因（不是表象）
5. 最小修复
6. 验证
7. 记录到知识库
```

## 五、常见陷阱提示

- `color` 字段不是颜色，是价格（分）
- 小程序API域名是 `ningyang` 不是 `ningyuan`
- 商城API走 `/api/v1/`，小程序API走 `/api/miniapp/`
- 商城无真实支付（仅alert）
- 可能有其他智能体(Codex/OpenClaw)中途改过配置，**先核查**