Files
ai-proj-helper/plugins/coolbuy-legacy-plugin/skills/SKILL.md

9.5 KiB
Raw Blame History

name, description
name description
coolbuy-legacy 酷采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

查询任务

// 获取酷采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 浏览器自动化

启动调试模式

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/chrome-debug

验证连接

curl http://127.0.0.1:9222/json/version

验证码处理规则

重要: 当访问需要验证码的系统时:

  1. 不要使用脚本截图方式获取验证码(验证码会快速过期)
  2. 直接提醒用户
    • 请在浏览器中输入验证码
    • 或请帮我点击登录按钮
  3. 用户操作完成后再继续自动化流程

示例提示:

浏览器已打开登录页面,验证码需要手动输入。请在 Chrome 浏览器中:
1. 输入验证码
2. 点击登录按钮
完成后告诉我,我将继续后续操作。

常用 MCP 操作

// 列出所有页面
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. 数据不同步

    • 刷新页面
    • 检查数据库连接
    • 查看后端日志

日志查看

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