Initial commit: One Pipe System

完整的管理系统，包含账户管理、卡片管理、套餐管理、财务管理等功能模块。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

openspec/changes/add-customer-account-management/proposal.md

@@ -0,0 +1,34 @@
+# Change: 客户账户管理功能
+
+## Why
+运营平台需要统一查看和管理所有客户（包括代理商和企业客户）的账户佣金情况，包括佣金总额、可提现金额、待入账金额、已提现金额等财务数据。目前系统缺少集中的客户账户财务视图，运营人员无法高效地了解客户的佣金和提现状况。
+
+## What Changes
+- 新增客户账户管理页面（`src/views/finance/customer-account/index.vue`）
+- 提供客户账户列表查询功能，支持按客户账号、客户名称、客户类型筛选
+- 展示客户的佣金相关财务数据：
+  - 佣金总额
+  - 可提现金额
+  - 待入账金额
+  - 已提现金额
+  - 提现次数
+  - 最后提现时间
+- 提供查看客户账户详情功能
+- 提供查看客户流水记录功能（入口）
+- 添加国际化支持（中英文）
+- 添加路由配置（财务模块下）
+
+## Impact
+- 新增规范：`specs/customer-account-management/spec.md`
+- 新增文件：
+  - `src/views/finance/customer-account/index.vue`
+- 修改文件：
+  - `src/router/routes/asyncRoutes.ts`（添加路由）
+  - `src/router/routesAlias.ts`（添加路由别名）
+  - `src/locales/langs/zh.json`（添加中文翻译）
+  - `src/locales/langs/en.json`（添加英文翻译）
+  - `docs/功能.md`（文档更新）
+- 依赖模块：
+  - Element Plus 组件（ElTable, ElForm, ElDialog 等）
+  - 现有的 ArtTable 组件
+  - 后端 API（待对接）

openspec/changes/add-customer-account-management/specs/customer-account-management/spec.md

@@ -0,0 +1,144 @@
+# 客户账户管理规范
+
+## ADDED Requirements
+
+### Requirement: 客户账户列表查询
+系统 SHALL 提供客户账户列表查询功能，运营人员可以查看所有客户的账户财务信息。
+
+#### Scenario: 查询所有客户账户
+- **WHEN** 运营人员访问客户账户管理页面
+- **THEN** 系统显示所有客户账户列表，包含以下字段：
+  - 客户账号
+  - 客户名称
+  - 客户类型（代理商/企业客户）
+  - 佣金总额
+  - 可提现金额
+  - 待入账金额
+  - 已提现金额
+  - 提现次数
+  - 最后提现时间
+
+#### Scenario: 按客户账号搜索
+- **WHEN** 运营人员在搜索框输入客户账号并点击查询
+- **THEN** 系统返回匹配该账号的客户记录
+
+#### Scenario: 按客户名称搜索
+- **WHEN** 运营人员在搜索框输入客户名称并点击查询
+- **THEN** 系统返回名称包含该关键词的客户记录
+
+#### Scenario: 按客户类型筛选
+- **WHEN** 运营人员选择客户类型（代理商或企业客户）并点击查询
+- **THEN** 系统返回该类型的所有客户记录
+
+#### Scenario: 组合条件搜索
+- **WHEN** 运营人员同时使用多个搜索条件（如账号 + 类型）并点击查询
+- **THEN** 系统返回同时满足所有条件的客户记录
+
+#### Scenario: 重置搜索条件
+- **WHEN** 运营人员点击重置按钮
+- **THEN** 系统清空所有搜索条件并显示完整列表
+
+### Requirement: 分页功能
+系统 SHALL 支持客户账户列表的分页展示，以提高大数据量下的性能和用户体验。
+
+#### Scenario: 默认分页显示
+- **WHEN** 运营人员首次访问页面
+- **THEN** 系统默认显示第 1 页，每页 20 条记录
+
+#### Scenario: 切换页码
+- **WHEN** 运营人员点击分页器的页码
+- **THEN** 系统跳转到对应页面并加载数据
+
+#### Scenario: 调整每页显示数量
+- **WHEN** 运营人员选择不同的每页显示数量（10/20/50/100）
+- **THEN** 系统重新加载数据并按新的数量显示
+
+#### Scenario: 显示总记录数
+- **WHEN** 数据加载完成后
+- **THEN** 分页器显示总记录数
+
+### Requirement: 客户账户详情查看
+系统 SHALL 提供客户账户详情查看功能，展示客户的完整财务信息。
+
+#### Scenario: 打开详情对话框
+- **WHEN** 运营人员点击某个客户的"查看详情"按钮
+- **THEN** 系统弹出详情对话框，展示以下信息：
+  - 客户账号
+  - 客户名称
+  - 客户类型
+  - 联系电话
+  - 佣金总额
+  - 可提现金额
+  - 待入账金额
+  - 已提现金额
+  - 提现次数
+  - 最后提现时间
+  - 注册时间
+  - 备注
+
+#### Scenario: 关闭详情对话框
+- **WHEN** 运营人员点击对话框关闭按钮或遮罩层
+- **THEN** 系统关闭详情对话框
+
+### Requirement: 客户流水记录入口
+系统 SHALL 提供客户流水记录查看入口，方便运营人员查看客户的佣金流水明细。
+
+#### Scenario: 触发流水记录查看
+- **WHEN** 运营人员点击某个客户的"流水记录"按钮
+- **THEN** 系统导航到该客户的流水记录页面或打开流水记录对话框
+
+### Requirement: 数据展示样式
+系统 SHALL 使用不同的视觉样式区分不同类型的数据，提升可读性。
+
+#### Scenario: 客户类型标签样式
+- **WHEN** 列表或详情中显示客户类型
+- **THEN** 代理商显示为绿色标签，企业客户显示为蓝色标签
+
+#### Scenario: 金额颜色区分
+- **WHEN** 列表或详情中显示金额数据
+- **THEN** 可提现金额使用绿色高亮，待入账金额使用橙色高亮
+
+#### Scenario: 金额格式化
+- **WHEN** 系统显示金额数据
+- **THEN** 金额显示为货币格式，保留两位小数，前缀人民币符号"¥"
+
+### Requirement: 国际化支持
+系统 SHALL 支持中英文双语界面，所有文案通过国际化文件管理。
+
+#### Scenario: 中文界面显示
+- **WHEN** 系统语言设置为中文
+- **THEN** 所有界面文案显示为中文
+
+#### Scenario: 英文界面显示
+- **WHEN** 系统语言设置为英文
+- **THEN** 所有界面文案显示为英文
+
+### Requirement: 数据权限控制
+系统 SHALL 根据运营人员的权限角色，控制其可见的客户账户范围。
+
+#### Scenario: 管理员权限
+- **WHEN** 管理员访问客户账户页面
+- **THEN** 系统显示所有客户账户
+
+#### Scenario: 普通运营人员权限
+- **WHEN** 普通运营人员访问客户账户页面
+- **THEN** 系统仅显示其权限范围内的客户账户
+
+### Requirement: 异常处理与用户反馈
+系统 SHALL 在操作过程中提供清晰的用户反馈和错误处理。
+
+#### Scenario: 查询成功反馈
+- **WHEN** 用户执行搜索操作且成功返回结果
+- **THEN** 系统显示成功消息提示
+
+#### Scenario: 查询失败处理
+- **WHEN** API 请求失败或超时
+- **THEN** 系统显示错误消息，并提示用户重试
+
+#### Scenario: 数据加载状态
+- **WHEN** 系统正在加载数据
+- **THEN** 显示加载动画或骨架屏，防止用户误操作
+
+#### Scenario: 空数据提示
+- **WHEN** 查询结果为空
+- **THEN** 系统显示"暂无数据"提示

openspec/changes/add-customer-account-management/tasks.md

@@ -0,0 +1,51 @@
+# 实现任务清单
+
+## 1. 前端页面实现
+- [x] 1.1 创建客户账户管理页面组件 `src/views/finance/customer-account/index.vue`
+  - [x] 1.1.1 实现搜索表单（客户账号、客户名称、客户类型）
+  - [x] 1.1.2 实现数据表格展示（使用 ArtTable）
+  - [x] 1.1.3 实现分页功能
+  - [x] 1.1.4 实现详情对话框
+  - [x] 1.1.5 添加操作按钮（查看详情、流水记录）
+- [x] 1.2 添加路由配置
+  - [x] 1.2.1 在 `src/router/routes/asyncRoutes.ts` 中添加路由
+  - [x] 1.2.2 在 `src/router/routesAlias.ts` 中添加路由别名
+- [x] 1.3 添加国际化支持
+  - [x] 1.3.1 在 `src/locales/langs/zh.json` 中添加中文文案
+  - [x] 1.3.2 在 `src/locales/langs/en.json` 中添加英文文案
+
+## 2. API 集成（待实现）
+- [ ] 2.1 创建 API 模块 `src/api/modules/customerAccountApi.ts`
+  - [ ] 2.1.1 实现客户账户列表查询接口
+  - [ ] 2.1.2 实现客户账户详情查询接口
+  - [ ] 2.1.3 实现客户流水记录查询接口
+- [ ] 2.2 定义 TypeScript 类型
+  - [ ] 2.2.1 定义客户账户数据类型 `CustomerAccount`
+  - [ ] 2.2.2 定义搜索参数类型 `CustomerAccountSearchParams`
+  - [ ] 2.2.3 定义流水记录类型 `CustomerAccountFlow`
+- [ ] 2.3 替换页面中的模拟数据为真实 API 调用
+
+## 3. 流水记录功能（待实现）
+- [ ] 3.1 创建流水记录子页面或对话框
+- [ ] 3.2 实现流水记录列表展示
+- [ ] 3.3 实现流水记录筛选和分页
+
+## 4. 权限控制（待实现）
+- [ ] 4.1 配置页面访问权限（后台权限系统）
+- [ ] 4.2 添加按钮级权限控制（如需要）
+
+## 5. 测试与优化
+- [ ] 5.1 单元测试（工具函数、业务逻辑）
+- [ ] 5.2 集成测试（API 调用）
+- [ ] 5.3 性能优化（大数据量处理）
+- [ ] 5.4 用户体验优化（加载状态、错误处理）
+
+## 6. 文档更新
+- [x] 6.1 更新 `docs/功能.md` 功能列表
+
+## 当前状态
+- ✅ 第 1 阶段（前端页面框架）已完成，使用模拟数据
+- ⏳ 第 2 阶段（API 集成）待实现
+- ⏳ 第 3 阶段（流水记录）待实现
+- ⏳ 第 4 阶段（权限控制）待实现
+- ⏳ 第 5 阶段（测试优化）待实现