--- 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 系统中