refactor: 项目技能拆分到 skills-projects/

将 coolbuy (3) 和 enjoysa (2) 共 5 个项目特定技能从 skills/ 移至 skills-projects/，保持通用技能与业务项目技能分离。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 11:21:53 +10:30
parent 40b36a8e41
commit ea266e9cce
14 changed files with 100 additions and 94 deletions
--- a/skills-projects/coolbuy-legacy-plugin/skills/SKILL.md
+++ b/skills-projects/coolbuy-legacy-plugin/skills/SKILL.md
@@ -0,0 +1,414 @@
+---
+name: coolbuy-legacy
+description: 酷采2.0团购管理系统测试与维护。用于酷采2.0系统的功能测试、问题排查、需求验证和对比测试。当用户提到酷采2.0、百丽、李宁、遗留系统测试相关任务时自动激活。
+---
+
+# Coolbuy Legacy (酷采2.0) Skill
+
+酷采2.0团购管理系统，服务于百丽、李宁等客户的遗留系统，采用 Vue 2 + Element UI + Java Spring 技术栈。
+
+## 项目信息
+
+| 项目 | 值 |
+|------|-----|
+| 项目编号 | P264 |
+| 项目名称 | 酷采 2.0 |
+| AI-Proj 项目ID | 164 |
+| 源码路径 | `/Users/donglinlai/workspace/coolbuy-legacy` |
+| Git 仓库 | `git@gitea.pipexerp.com:pipexerp/coolbuy-legacy.git` |
+| 主分支 | main |
+| 技术栈 | Vue 2 + Element UI + Java Spring |
+
+---
+
+## 系统访问
+
+### 测试环境
+
+| 项目 | 值 |
+|------|-----|
+| 测试地址 | http://47.105.185.154:9300/login |
+| 管理员账号 | 19090009801 |
+| 密码 | 123456 |
+| 客户账号 | 17761202551 / 202551 |
+| 服务器 | 47.105.185.154 |
+
+### 主要客户
+
+- **百丽集团** - 大型鞋业零售集团
+- **李宁体育** - 知名体育用品品牌
+
+---
+
+## 架构概览
+
+```
+coolbuy-legacy/
+├── cool_lining/module-provider/    # Java 后端服务
+│   └── src/main/java/com/jzg/module/
+│       ├── action/                 # 控制器层
+│       │   ├── prd/                # 商品模块控制器
+│       │   ├── order/              # 订单模块控制器
+│       │   └── customer/           # 客户模块控制器
+│       ├── dao/model/              # 数据模型
+│       │   ├── prd/                # 商品实体
+│       │   ├── order/              # 订单实体
+│       │   └── customer/           # 客户实体
+│       └── manager/                # 业务逻辑层
+│           ├── prd/                # 商品业务逻辑
+│           ├── order/              # 订单业务逻辑
+│           └── customer/           # 客户业务逻辑
+└── ln_admin/                       # Vue 2 前端
+    └── src/views2/module/          # 业务模块页面
+        ├── prd/                    # 商品管理页面
+        ├── order/                  # 订单管理页面
+        └── customer/               # 客户管理页面
+```
+
+---
+
+## 主要功能模块
+
+### 核心业务模块
+
+1. **推广方案管理**
+   - 促销活动配置
+   - 折扣规则设置
+   - 活动效果统计
+
+2. **销售管理**
+   - 订单处理流程
+   - 销售数据统计
+   - 客户下单管理
+
+3. **草稿单管理**
+   - 未完成订单保存
+   - 草稿单编辑
+   - 批量转正式单
+
+4. **Y码直客**
+   - 直客订单管理
+   - Y码生成与核销
+   - 直客价格体系
+
+5. **库存管理**
+   - 库存查询
+   - 库存调拨
+   - 库存预警
+
+6. **货盘管理**
+   - 货盘创建
+   - 货盘分配
+   - 货盘跟踪
+
+7. **协同仓管理**
+   - 多仓协同
+   - 仓库调度
+   - 发货管理
+
+8. **价格管理**
+   - 商品定价
+   - 客户价格体系
+   - 最低折扣限制
+
+9. **资金管理**
+   - 账户余额
+   - 充值记录
+   - 消费明细
+
+10. **产品管理** ⭐
+    - 商品信息维护
+    - SPU/SKU管理
+    - 商品分类
+
+11. **基础功能**
+    - 客户管理
+    - 用户权限
+    - 系统配置
+
+12. **数据看板**
+    - 销售数据分析
+    - 库存报表
+    - 业务概览
+
+13. **公告通知**
+    - 系统公告
+    - 消息推送
+    - 通知管理
+
+14. **起售数量设置**
+    - 最小起售量
+    - 批量设置
+    - 规则配置
+
+---
+
+## 与酷采3.0的对比
+
+### 技术栈差异
+
+| 项目 | 酷采2.0 (Legacy) | 酷采3.0 (PaaS) |
+|------|------------------|----------------|
+| 前端框架 | Vue 2 | React 18 |
+| UI组件库 | Element UI | Ant Design |
+| 前端构建 | Webpack | Vite |
+| 后端语言 | Java | Go |
+| 后端框架 | Spring Boot | Gin + go-zero |
+| 数据库 | MySQL | PostgreSQL |
+| 架构模式 | 单体应用 | 微服务 |
+| 部署方式 | 传统部署 | Docker + K8s |
+
+### 业务差异
+
+| 功能 | 酷采2.0 | 酷采3.0 |
+|------|---------|---------|
+| 多租户 | ❌ 单租户 | ✅ 多租户 SaaS |
+| 客户隔离 | 账号级别 | 企业级别 |
+| 定制化 | 客户专属部署 | 配置化租户 |
+| 扩展性 | 垂直扩展 | 水平扩展 |
+
+---
+
+## 测试任务管理
+
+### AI-Proj 项目集成
+
+当前项目在 AI-Proj 系统中的ID为 **164**，包含以下测试任务：
+
+#### 客户最低折扣申请限制功能测试
+
+**父任务**: #4725 (in_progress)
+
+**测试用例**:
+- ✅ TC001: 按客户类型配置最低折扣 [P0] - #4726
+- ✅ TC002: 按特定客户配置最低折扣 [P0] - #4727
+- ✅ TC003: 折扣下限输入验证 [P1] - #4728
+- ✅ TC004: 阈值导入模板 [P1] - #4729
+- ✅ TC005: 折扣低于下限 - 拦截 [P0] - #4730
+- ✅ TC006: 折扣等于下限 - 通过 [P0] - #4731
+- ✅ TC007: 折扣高于下限 - 通过 [P1] - #4732
+- 🔄 TC008: 多商品触发限制 - 罗列提示 [P0] - #4733
+- ⏳ TC009: 非一级账号不受限 [P1] - #4734
+- ⏳ TC010: 审核修改折扣低于下限 - 拦截 [P0] - #4735
+- ⏳ TC011: 审核修改折扣等于下限 - 通过 [P0] - #4736
+- ⏳ TC012: 限价标签显示 [P1] - #4737
+- ⏳ TC013: 提示文字验证 [P1] - #4738
+
+### 查询任务
+
+```javascript
+// 获取酷采2.0项目任务列表
+mcp__ai-proj__list_tasks({ projectId: 164 })
+
+// 获取特定任务详情
+mcp__ai-proj__get_detailed_task_info({ taskId: 4725 })
+
+// 获取任务文档
+mcp__ai-proj__get_task_document({ taskId: 4725 })
+```
+
+---
+
+## Chrome DevTools 浏览器自动化
+
+### 启动调试模式
+
+```bash
+# macOS
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
+  --remote-debugging-port=9222 \
+  --user-data-dir=/tmp/chrome-debug
+```
+
+### 验证连接
+
+```bash
+curl http://127.0.0.1:9222/json/version
+```
+
+### 验证码处理规则
+
+**重要**: 当访问需要验证码的系统时：
+
+1. **不要**使用脚本截图方式获取验证码（验证码会快速过期）
+2. **直接提醒用户**：
+   - 请在浏览器中输入验证码
+   - 或请帮我点击登录按钮
+3. 用户操作完成后再继续自动化流程
+
+示例提示：
+```
+浏览器已打开登录页面，验证码需要手动输入。请在 Chrome 浏览器中：
+1. 输入验证码
+2. 点击登录按钮
+完成后告诉我，我将继续后续操作。
+```
+
+### 常用 MCP 操作
+
+```javascript
+// 列出所有页面
+mcp__chrome-devtools__list_pages()
+
+// 选择页面
+mcp__chrome-devtools__select_page({ pageId: 1 })
+
+// 导航到URL
+mcp__chrome-devtools__navigate_page({
+  type: "url",
+  url: "http://47.105.185.154:9300/login"
+})
+
+// 截图
+mcp__chrome-devtools__take_screenshot({
+  format: "png",
+  filePath: "/tmp/screenshot.png"
+})
+
+// 获取页面快照
+mcp__chrome-devtools__take_snapshot()
+
+// 点击元素
+mcp__chrome-devtools__click({ uid: "element_uid" })
+
+// 填写表单
+mcp__chrome-devtools__fill({
+  uid: "input_uid",
+  value: "text"
+})
+
+// 执行JavaScript
+mcp__chrome-devtools__evaluate_script({
+  function: "() => { return document.title; }"
+})
+```
+
+---
+
+## 常见测试场景
+
+### 1. 客户最低折扣测试
+
+**测试步骤**:
+1. 登录管理员账号 (19090009801)
+2. 进入价格管理 → 最低折扣配置
+3. 配置客户类型或特定客户的最低折扣
+4. 使用客户账号 (17761202551) 登录
+5. 创建订单，测试折扣限制规则
+
+**验证点**:
+- 折扣低于下限时系统拦截
+- 折扣等于或高于下限时通过
+- 多商品触发时正确罗列提示
+- 非一级账号不受限制
+
+### 2. 订单流程测试
+
+**测试步骤**:
+1. 客户账号登录
+2. 选择商品加入购物车
+3. 提交订单
+4. 审核订单 (管理员)
+5. 发货处理
+6. 订单完成
+
+### 3. 库存管理测试
+
+**测试步骤**:
+1. 查询库存
+2. 创建库存调拨单
+3. 审核调拨单
+4. 确认入库
+5. 验证库存变化
+
+---
+
+## 需求对比测试流程
+
+当酷采3.0实现新功能时，需要与酷采2.0进行对比：
+
+### 测试流程
+
+1. **功能分析**
+   - 在酷采2.0中找到对应功能
+   - 记录现有实现方式
+   - 识别差异点
+
+2. **页面对比**
+   - 截图酷采2.0界面
+   - 对比UI/UX差异
+   - 记录交互流程
+
+3. **数据对比**
+   - 对比数据模型
+   - 验证业务规则
+   - 确认边界条件
+
+4. **性能对比**
+   - 记录响应时间
+   - 对比并发能力
+   - 评估用户体验
+
+---
+
+## 问题排查
+
+### 常见问题
+
+1. **登录失败**
+   - 检查账号密码是否正确
+   - 验证码是否过期
+   - 网络连接是否正常
+
+2. **页面加载慢**
+   - 检查网络状况
+   - 清除浏览器缓存
+   - 查看服务器日志
+
+3. **数据不同步**
+   - 刷新页面
+   - 检查数据库连接
+   - 查看后端日志
+
+### 日志查看
+
+```bash
+# SSH到测试服务器
+ssh root@47.105.185.154
+
+# 查看应用日志
+tail -f /path/to/coolbuy/logs/application.log
+
+# 查看错误日志
+tail -f /path/to/coolbuy/logs/error.log
+```
+
+---
+
+## 相关技能
+
+- `coolbuy-paas` - 酷采3.0 SaaS租户端开发
+- `coolbuy-platform` - 酷采3.0平台管理端
+- `dev-test` - 软件测试技能
+- `req` - 需求管理技能
+- `siyuan` - 思源笔记（含酷采相关文档）
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-21 | 初始版本，创建酷采2.0独立技能 |
+
+---
+
+## 注意事项
+
+⚠️ **重要提醒**:
+
+1. 酷采2.0为遗留系统，主要用于参考和对比测试
+2. 新功能开发应在酷采3.0 (coolbuy-paas) 中进行
+3. 测试环境数据仅供测试使用，请勿在生产环境操作
+4. 百丽、李宁等客户仍在使用此系统，测试时注意不要影响生产数据
+5. 发现问题及时记录到 AI-Proj 系统中