415 lines
9.5 KiB
Markdown
415 lines
9.5 KiB
Markdown
---
|
||
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 系统中
|