Files
template-5/.workbuddy/teams/_auto_c02960235460481c84382169b26bf90c/inboxes/team-lead.json
赵忠林 4507cd484e style(rider): 优化骑手中心界面及功能入口样式
- 添加骑手订单统计数据,支持待取货、配送中、已完成与今日任务
- 增加刷新按钮,便捷更新统计数据
- 优化头像及用户信息展示,增加主题样式和背景装饰
- 新增快捷功能入口,展示待取货订单数量红点提醒
- 登录未授权时提示并引导登录
- 调整色彩风格,将多处组件背景色由浅蓝色调整为深蓝色,提高视觉一致性
- 管理页新增内容管理工具的基础UI布局
- 扫码确认页重构授权登录页面,改用科技风格设计,增加动态粒子动画和渐变光晕效果
- 协议打开方式改为跳转网页视图,移除旧版弹窗
- 修正部分组件样式,调整按钮及文本颜色,提升视觉效果和交互体验
2026-04-10 19:36:37 +08:00

38 lines
32 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[
{
"id": "msg-1775818699653-fa49wy",
"from": "pc-explorer",
"to": "team-lead",
"type": "message",
"content": "收到任务开始探索PC端项目 /Users/gxwebsoft/VUE/websopy-pc 的功能结构。我会分析路由配置、src目录结构、API文件和状态管理然后给出详细的功能模块清单。",
"timestamp": "2026-04-10T10:58:19.653Z",
"read": true
},
{
"id": "msg-1775818788555-vk3aef",
"from": "pc-explorer",
"to": "team-lead",
"type": "message",
"content": "## PC端项目功能结构分析报告\n\n### 项目基本信息\n- **项目路径**: `/Users/gxwebsoft/VUE/websopy-pc`\n- **技术栈**: Nuxt 3 + Vue 3 + TypeScript + Ant Design Vue\n- **架构**: 基于文件系统的路由Nuxt Pages\n\n---\n\n### 一、页面路由结构\n\n#### 1. 公开页面(无需登录)\n| 路由路径 | 页面功能 | 描述 |\n|---------|---------|------|\n| `/` | 首页 | 平台介绍、产品矩阵、核心能力展示、OpenClaw AI生态 |\n| `/login` | 登录页 | 扫码登录、手机号+短信验证码登录、图形验证码 |\n| `/agreement` | 用户协议 | 注册协议页面 |\n| `/privacy` | 隐私政策 | 隐私政策页面 |\n| `/contact` | 联系我们 | 联系表单 |\n| `/products` | 产品列表 | 展示所有可购买产品 |\n| `/market` | 应用市场 | 应用商店/模板市场 |\n| `/market/[id]` | 应用详情 | 单个应用/模板详情页 |\n| `/articles` | 文章列表 | CMS文章列表 |\n| `/flow` | 开通流程 | 产品购买开通流程说明 |\n| `/deploy` | 部署说明 | 私有化部署介绍 |\n| `/platform` | 平台介绍 | 平台能力介绍 |\n| `/miniapp` | 小程序 | 小程序相关介绍 |\n| `/website` | 网站构建 | 网站构建产品介绍 |\n| `/shop` | 商城系统 | 商城系统介绍 |\n| `/oa` | OA系统 | OA办公系统介绍 |\n| `/ai-agent` | AI智能体 | OpenClaw AI智能体介绍 |\n| `/openclaw` | OpenClaw | OpenClaw生态详情 |\n| `/developer-center` | 开发者中心 | 开发者文档入口 |\n| `/qr-confirm` | 扫码确认 | 扫码登录确认页 |\n| `/wx-scan` | 微信扫码 | 微信扫码相关 |\n| `/bind-phone` | 绑定手机 | 手机号绑定页面 |\n| `/create-app` | 创建应用 | 应用创建向导 |\n\n#### 2. 用户控制台(/console/*- 需要登录\n| 路由路径 | 页面功能 | 关键业务逻辑 |\n|---------|---------|-------------|\n| `/console` | 控制台首页 | 欢迎区、快捷入口、最近使用应用列表 |\n| `/console/apps` | 应用中心 | 我的应用列表、应用详情抽屉 |\n| `/console/products` | 已购产品 | 已购买的产品授权与订阅管理 |\n| `/console/orders` | 订单记录 | 历史订单与账单查询 |\n| `/console/coupons` | 优惠券 | 可用优惠券管理 |\n| `/console/invoices` | 发票记录 | 发票申请与记录 |\n| `/console/tickets` | 工单管理 | 技术支持工单提交与跟踪 |\n| `/console/notifications` | 消息通知 | 系统通知中心 |\n| `/console/app-review` | 应用审核 | 应用上架审核状态 |\n| `/console/logout` | 退出登录 | 登出处理 |\n\n**账号管理子模块(/console/account/***\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/console/account` | 账户信息 |\n| `/console/account/kyc` | 实名认证 |\n| `/console/account/members` | 成员管理(团队与权限) |\n| `/console/account/security` | 账号安全(密码与安全设置) |\n\n**租户管理子模块(/console/tenant/***\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/console/tenant` | 租户首页 |\n| `/console/tenant/unopened` | 未开通提示 |\n\n**邀请管理子模块(/console/invites/***\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/console/invites` | 应用邀请列表 |\n\n#### 3. 开发者中心(/developer/*- 需要开发者权限\n| 路由路径 | 页面功能 | 关键业务逻辑 |\n|---------|---------|-------------|\n| `/developer` | 开发者首页 | 数据概览、快捷入口、最近动态、公告、服务状态 |\n| `/developer/apps` | 应用中心 | 查看订阅的应用与后台入口 |\n| `/developer/apikeys` | API Key管理 | 创建、查看和管理API Key |\n| `/developer/source` | 源码与仓库 | 申请仓库权限、获取完整源代码 |\n| `/developer/git` | Git账号绑定 | 绑定Gitea账号获取仓库访问权限 |\n| `/developer/requests` | 权限申请记录 | 权限申请历史记录 |\n| `/developer/support` | 支持与反馈 | 问题反馈入口 |\n| `/developer/tickets` | 工单处理 | 开发者工单管理 |\n\n**CI/CD与部署/developer/***\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/developer/build` | 构建任务 |\n| `/developer/pipeline` | 流水线管理 |\n| `/developer/publish` | 发布管理 |\n| `/developer/versions` | 版本管理 |\n\n**资源中心(/developer/resources/***\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/developer/resources` | 资源总览 |\n| `/developer/resources/servers` | 服务器管理 |\n| `/developer/resources/databases` | 数据库管理 |\n| `/developer/resources/domains` | 域名管理 |\n| `/developer/resources/git` | 代码仓库 |\n\n**数据统计**\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/developer/analytics` | 数据统计 |\n\n**开发文档(/developer/docs/***\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/developer/docs` | 文档首页 |\n| `/developer/docs/[...slug]` | 动态文档页 |\n\n#### 4. 平台管理后台(/admin/*- 需要管理员权限\n| 路由路径 | 页面功能 | 关键业务逻辑 |\n|---------|---------|-------------|\n| `/admin` | 管理首页 | 核心数据统计、待办事项、快速入口 |\n| `/admin/app-review` | 应用审核 | 待审核应用列表、审核操作 |\n| `/admin/git-review` | Git审核 | Git账号审核 |\n| `/admin/apps` | 应用管理 | 全平台应用管理 |\n| `/admin/market` | 应用市场 | 上架应用管理 |\n| `/admin/users` | 用户管理 | 所有用户管理 |\n| `/admin/developers` | 开发者管理 | 开发者账号管理 |\n| `/admin/tickets` | 工单处理 | 全平台工单处理 |\n| `/admin/articles` | 文章管理 | CMS文章管理 |\n| `/admin/article-categories` | 文章分类 | 文章分类管理 |\n| `/admin/announcements` | 公告管理 | 平台公告管理 |\n| `/admin/settings` | 平台设置 | 系统配置 |\n\n#### 5. 邀请相关\n| 路由路径 | 页面功能 |\n|---------|---------|\n| `/invite/accept` | 接受邀请 |\n\n---\n\n### 二、API接口模块结构\n\n#### 1. 应用相关 API (`/app/*`)\n- `apikey/` - API Key管理\n- `appConfig/` - 应用配置\n- `appCredential/` - 应用凭证\n- `appEvent/` - 应用事件\n- `appProduct/` - 应用产品\n- `appResource/` - 应用资源\n- `appUser/` - 应用用户\n- `appVersion/` - 应用版本\n- `article/` - 文章\n- `articleCategory/` - 文章分类\n- `cloudCredential/` - 云凭证\n- `invite/` - 邀请管理\n- `notification/` - 通知\n- `setting/` - 设置\n- `userCache/` - 用户缓存\n- `cicd.ts` - CI/CD相关\n\n#### 2. CMS内容管理 API (`/cms/*`)\n- `cmsAd/` - 广告管理\n- `cmsArticle/` - 文章管理\n- `cmsArticleCategory/` - 文章分类\n- `cmsContactLead/` - 联系线索\n- `cmsDesign/` - 设计管理\n- `cmsDomain/` - 域名管理\n- `cmsForm/` - 表单管理\n- `cmsNavigation/` - 导航管理\n- `cmsOrder/` - 订单管理\n- `cmsStatistics/` - 统计\n- `cmsTemplate/` - 模板管理\n- `cmsWebsite/` - 网站管理\n- `cmsWebsiteField/` - 网站字段配置\n\n#### 3. 系统管理 API (`/system/*`)\n- `access-key/` - 访问密钥\n- `appstore/` - 应用商店\n- `cache/` - 缓存管理\n- `chat/` - 聊天\n- `company/` - 企业/公司\n- `companyGit/` - 企业Git\n- `dict/` - 字典\n- `domain/` - 域名\n- `environment/` - 环境\n- `file/` - 文件管理\n- `login-record/` - 登录记录\n- `menu/` - 菜单\n- `modules/` - 模块\n- `operation-record/` - 操作记录\n- `order/` - 订单\n- `organization/` - 组织\n- `payment/` - 支付\n- `plug/` - 插件\n- `role/` - 角色\n- `setting/` - 设置\n- `tenant/` - 租户\n- `user/` - 用户\n- `userRole/` - 用户角色\n- `version/` - 版本\n- `website/` - 网站\n\n#### 4. 用户相关 API (`/user/*`)\n- `balance-log/` - 余额日志\n- `feedback/` - 反馈\n- `grade/` - 等级\n- `recharge/` - 充值\n- `referee/` - 推荐人\n- `userCoupon/` - 用户优惠券\n\n#### 5. 商城相关 API (`/shop/*`)\n- `shopCoupon/` - 优惠券\n- `shopDealer*` - 分销商相关\n- `shopExpress/` - 物流快递\n- `shopGift/` - 礼品\n- `shopGoods/` - 商品\n- `shopMerchant/` - 商户\n- `shopOrder/` - 订单\n- `shopUser/` - 商城用户\n\n#### 6. 认证相关 API (`/passport/*`)\n- `login/` - 登录相关(短信登录、验证码)\n- `qrLogin/` - 扫码登录\n\n#### 7. 开发者相关 API (`/developer/*`)\n- `index.ts` - 开发者相关接口\n\n---\n\n### 三、状态管理\n\n项目未使用Pinia/Vuex等传统状态管理库而是使用以下方式\n\n1. **Composables** (`/app/composables/`)\n - `useAppPermission.ts` - 应用权限管理\n - `useNotificationCenter.ts` - 通知中心\n - `usePageSeo.ts` - 页面SEO\n - `useQRCode.ts` - 二维码\n - `useResourceAccess.ts` - 资源访问控制\n\n2. **工具函数** (`/app/utils/`)\n - `token-util.ts` - Token管理\n - `permission.ts` - 权限工具\n\n3. **本地存储**\n - `localStorage`存储:`UserId`, `TenantId`, `Token`\n\n---\n\n### 四、布局系统\n\n| 布局文件 | 用途 | 特点 |\n|---------|------|------|\n| `default.vue` | 默认布局 | 基础布局 |\n| `console.vue` | 用户控制台 | 左侧深色侧边栏(深蓝黑)顶部Header带用户菜单 |\n| `admin.vue` | 管理后台 | 左侧深色侧边栏(深红黑),管理员标识 |\n| `developer.vue` | 开发者中心 | 浅色侧边栏,分组导航,权限控制 |\n| `blank.vue` | 空白布局 | 极简布局 |\n| `oa.vue` | OA系统 | OA专用布局 |\n\n---\n\n### 五、关键业务逻辑总结\n\n#### 1. 权限体系\n- **普通用户**: 可访问控制台、购买产品、管理订单\n- **开发者**: 额外访问开发者中心管理API Key、源码权限\n- **管理员**: 访问平台管理后台,审核应用、管理用户\n\n#### 2. 应用生命周期\n创建应用 → 选择产品 → 配置应用 → 开发/部署 → 上架审核 → 发布上线\n\n#### 3. 核心功能模块\n1. **产品购买与开通**: 选择产品 → 下单支付 → 自动开通租户 → 初始化模块 → 交付上线\n2. **应用管理**: 创建、配置、版本管理、发布\n3. **开发者工具**: API Key管理、源码访问、CI/CD流水线\n4. **资源管理**: 服务器、数据库、域名、SSL证书\n5. **内容管理**: 文章、公告、工单、通知\n\n#### 4. 多租户架构\n- 支持SaaS多租户\n- 私有化部署选项\n- 租户隔离的数据和资源\n\n---\n\n### 六、文件统计\n- **总Vue页面**: 102个\n- **API接口文件**: 275个TypeScript文件\n- **主要页面目录**: \n - `pages/`: 22个根页面\n - `pages/admin/`: 12个管理页面\n - `pages/console/`: 17个控制台页面\n - `pages/developer/`: 26个开发者页面",
"timestamp": "2026-04-10T10:59:48.555Z",
"read": true
},
{
"id": "msg-1775818789671-5yckhr",
"from": "java-explorer",
"to": "team-lead",
"type": "message",
"content": "# Java后端API接口结构分析报告\n\n## 项目概述\n项目路径`/Users/gxwebsoft/JAVA/websopy-java`\n共发现 **172个Controller**按模块划分为app(应用管理)、cms(内容管理)、shop(商城)、payment(支付)四大模块\n\n---\n\n## 一、应用管理模块 (app)\n\n### 1.1 应用产品管理 `/api/app/product`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询应用列表 |\n| `/list` | GET | 获取我的应用列表 |\n| `/my/page` | GET | 分页查询我的应用(创建者) |\n| `/joined/page` | GET | 分页查询我参与的应用 |\n| `/detail/{id}` | GET | 获取应用详情 |\n| `/info/{code}` | GET | 根据标识获取应用 |\n| `/create` | POST | 创建应用 |\n| `/update` | PUT | 更新应用 |\n| `/delete/{id}` | DELETE | 删除应用 |\n| `/submit/{id}` | POST | 提交审核 |\n| `/approve/{id}` | POST | 审核通过 |\n| `/reject/{id}` | POST | 审核拒绝 |\n| `/publish/{id}` | POST | 上架应用 |\n| `/unpublish/{id}` | POST | 下架应用 |\n| `/regenerateSecret/{id}` | POST | 重新生成密钥 |\n| `/market/page` | GET | 应用市场分页 |\n| `/accessible` | GET | 获取可访问的应用列表(带角色信息) |\n\n### 1.2 应用成员管理 `/api/app/app-user`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询应用成员 |\n| `/` | GET | 查询全部应用成员 |\n| `/{id}` | GET | 根据id查询应用成员 |\n| `/` | POST | 添加应用成员(手动添加) |\n| `/invite` | POST | 邀请用户成为应用成员 |\n| `/` | PUT | 修改应用成员信息 |\n| `/role/{id}/{role}` | PUT | 修改成员角色 |\n| `/{id}` | DELETE | 移除应用成员 |\n| `/invites/pending` | GET | 查询待确认邀请列表 |\n| `/invites/pending/count` | GET | 统计待确认邀请数量 |\n| `/invites/{inviteId}/accept` | POST | 接受邀请加入应用 |\n| `/invites/{inviteId}/reject` | POST | 拒绝邀请 |\n| `/check-access` | GET | 检查开发者中心访问权限 |\n\n### 1.3 开发者资源管理 `/api/app/developer-resource`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询资源列表(支持协作权限) |\n| `/` | GET | 查询资源列表 |\n| `/{resourceId}` | GET | 获取资源详情 |\n| `/stats` | GET | 统计各类型资源数量 |\n| `/` | POST | 新增资源 |\n| `/` | PUT | 修改资源 |\n| `/{resourceId}` | DELETE | 删除资源(逻辑删除) |\n| `/test-connection` | POST | 测试服务器数据库连接 |\n| `/test-ssh` | POST | 测试服务器SSH连接 |\n| `/server-status/{resourceId}` | GET | 获取1Panel服务器状态 |\n| `/retry-create-database/{resourceId}` | POST | 重试创建数据库 |\n| `/reset-password/{resourceId}` | POST | 重置数据库密码 |\n| `/refresh-storage/{resourceId}` | POST | 刷新存储桶信息 |\n\n### 1.4 应用密钥凭证 `/api/app/app-credential`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询应用密钥凭证 |\n| `/` | GET | 查询全部应用密钥凭证 |\n| `/{id}` | GET | 根据id查询应用密钥凭证 |\n| `/` | POST | 创建应用密钥凭证 |\n| `/` | PUT | 修改应用密钥凭证 |\n| `/resetSecret/{id}` | POST | 重置AppSecret |\n| `/status/{id}/{status}` | PUT | 禁用/启用凭证 |\n| `/{id}` | DELETE | 删除应用密钥凭证 |\n\n### 1.5 云账号凭证 `/api/app/cloud-credential`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询凭证列表 |\n| `/` | GET | 查询凭证列表(不分页) |\n| `/{id}` | GET | 获取凭证详情 |\n| `/` | POST | 新增凭证 |\n| `/` | PUT | 修改凭证 |\n| `/{id}` | DELETE | 删除凭证 |\n| `/test-connection` | POST | 测试凭证连接 |\n| `/test/{id}` | POST | 根据ID测试凭证连接 |\n| `/providers` | GET | 获取支持的云服务商列表 |\n\n### 1.6 CI/CD管理 `/api/app/cicd`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/pipeline/page` | GET | 分页查询流水线 |\n| `/pipeline/app/{appId}` | GET | 查询应用的所有流水线 |\n| `/pipeline/{id}` | GET | 查询流水线详情 |\n| `/pipeline` | POST | 创建流水线 |\n| `/pipeline` | PUT | 更新流水线 |\n| `/pipeline/{id}` | DELETE | 删除流水线 |\n| `/pipeline/{id}/toggle` | POST | 启用/禁用流水线 |\n| `/pipeline/{id}/status` | GET | 获取流水线状态 |\n| `/build/page` | GET | 分页查询构建记录 |\n| `/build/app/{appId}` | GET | 查询应用的所有构建记录 |\n| `/build/{id}` | GET | 查询构建详情 |\n| `/build/latest/{appId}` | GET | 获取应用最新构建 |\n| `/build/trigger` | POST | 触发构建 |\n| `/build/{id}/log` | GET | 获取构建日志 |\n| `/build/{id}/cancel` | POST | 取消构建 |\n| `/build/{id}/retry` | POST | 重试构建 |\n| `/build/stats/{appId}` | GET | 获取构建统计 |\n| `/webhook/gitea` | POST | Gitea Webhook回调 |\n| `/config` | GET | 获取CI系统配置 |\n\n### 1.7 权限申请 `/api/app/developer/permission-requests`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 获取权限申请列表 |\n| `/` | GET | 查询全部权限申请 |\n| `/{id}` | GET | 根据id查询权限申请 |\n| `/stats` | GET | 获取权限申请统计 |\n| `/available-repos` | GET | 获取可申请的仓库列表 |\n| `/` | POST | 提交权限申请 |\n| `/{id}/approve` | PUT | 审核权限申请-通过 |\n| `/{id}/reject` | PUT | 审核权限申请-拒绝 |\n\n### 1.8 应用工单管理 `/api/app/ticket`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/my` | GET | 查询我的工单(分页) |\n| `/submit` | POST | 提交工单 |\n| `/{ticketId}/close` | PUT | 关闭工单 |\n| `/list` | GET | 查询所有工单(技术人员) |\n| `/{ticketId}` | GET | 获取工单详情 |\n| `/status` | PUT | 更新工单状态 |\n| `/assign` | PUT | 分配处理人 |\n| `/{ticketId}/replies` | GET | 获取工单回复列表 |\n| `/reply` | POST | 提交工单回复 |\n| `/stats` | GET | 工单统计数据 |\n| `/staff-list` | GET | 获取技术人员列表 |\n\n---\n\n## 二、商城模块 (shop)\n\n### 2.1 订单管理 `/api/shop/shop-order`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询订单 |\n| `/` | GET | 查询全部订单 |\n| `/{id}` | GET | 根据id查询订单 |\n| `/` | POST | 添加订单 |\n| `/legacy` | POST | 添加订单(兼容旧版本) |\n| `/` | PUT | 修改订单(含退款处理) |\n| `/{id}` | DELETE | 删除订单 |\n| `/repair` | PUT | 修复订单 |\n| `/total` | GET | 统计订单总金额 |\n| `/cancel/{id}` | PUT | 取消订单 |\n| `/auto-cancel/trigger` | POST | 手动触发订单自动取消任务 |\n| `/auto-cancel/status` | GET | 获取自动取消任务状态 |\n| `/notify/{tenantId}` | POST | 微信支付异步通知 |\n| `/payment-status` | PUT | 更新订单支付状态 |\n\n### 2.2 商品管理 `/api/shop/shop-goods`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询商品 |\n| `/` | GET | 查询全部商品 |\n| `/{id}` | GET | 根据id查询商品 |\n| `/` | POST | 添加商品 |\n| `/` | PUT | 修改商品 |\n| `/{id}` | DELETE | 删除商品 |\n| `/data` | GET | 统计信息 |\n\n### 2.3 购物车管理 `/api/shop/shop-cart`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询购物车 |\n| `/` | GET | 查询全部购物车 |\n| `/{id}` | GET | 根据id查询购物车 |\n| `/` | POST | 添加购物车 |\n| `/` | PUT | 修改购物车 |\n| `/{id}` | DELETE | 删除购物车 |\n\n### 2.4 优惠券管理 `/api/shop/shop-coupon`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/list` | POST | 可领取优惠券列表 |\n| `/page` | GET | 分页查询优惠券 |\n| `/` | GET | 查询全部优惠券 |\n| `/{id}` | GET | 根据id查询优惠券 |\n| `/` | POST | 添加优惠券 |\n| `/` | PUT | 修改优惠券 |\n| `/{id}` | DELETE | 删除优惠券 |\n\n### 2.5 收货地址管理 `/api/shop/shop-user-address`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询收货地址 |\n| `/` | GET | 查询全部收货地址 |\n| `/{id}` | GET | 根据id查询收货地址 |\n| `/` | POST | 添加收货地址 |\n| `/` | PUT | 修改收货地址 |\n| `/{id}` | DELETE | 删除收货地址 |\n\n### 2.6 用户记录管理 `/api/shop/shop-user`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询用户记录 |\n| `/` | GET | 查询全部用户记录 |\n| `/{userId}` | GET | 根据userId查询用户记录 |\n| `/` | POST | 添加用户记录 |\n| `/` | PUT | 修改用户记录 |\n| `/{id}` | DELETE | 删除用户记录 |\n\n---\n\n## 三、支付模块 (payment)\n\n### 3.1 统一支付接口 `/api/payment`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/create` | POST | 创建支付订单 |\n| `/create-with-order` | POST | 创建支付订单(包含订单信息) |\n| `/query` | GET | 查询支付状态 |\n| `/refund` | POST | 申请退款 |\n| `/refund/query` | GET | 查询退款状态 |\n| `/close` | POST | 关闭订单 |\n| `/types` | GET | 获取支持的支付类型 |\n| `/strategy/{paymentType}` | GET | 获取支付策略信息 |\n| `/strategies` | GET | 获取所有支付策略信息 |\n| `/support/{paymentType}` | GET | 检查支付类型支持情况 |\n| `/update-status` | PUT | 手动更新支付状态 |\n| `/config/check` | GET | 检查支付配置 |\n| `/query-recent` | GET | 查询用户最近的支付订单 |\n\n---\n\n## 四、内容管理模块 (cms)\n\n### 4.1 文章管理 `/api/cms/cms-article`\n| API路径 | 方法 | 功能描述 |\n|---------|------|----------|\n| `/page` | GET | 分页查询文章 |\n| `/` | GET | 查询全部文章 |\n| `/{id}` | GET | 根据id查询文章 |\n| `/getByCode/{code}` | GET | 根据code查询文章 |\n| `/` | POST | 添加文章 |\n| `/` | PUT | 修改文章 |\n| `/{id}` | DELETE | 删除文章 |\n| `/getPrevious/{id}` | GET | 读取上一篇 |\n| `/getNext/{id}` | GET | 读取下一篇 |\n| `/data` | GET | 统计信息 |\n| `/checkArticlePassword` | GET | 密码校验 |\n| `/import` | POST | 批量导入文章 |\n| `/findTags` | GET | 按标签分页查询 |\n| `/pageTags` | GET | 按标签分页查询 |\n| `/getByIds` | GET | 按IDS查询 |\n\n---\n\n## 五、核心业务实体结构\n\n### 5.1 AppProduct (应用产品)\n- 核心字段productId, productName, productCode, productSecret\n- 应用类型:网站/微信小程序/抖音小程序/百度小程序/支付宝小程序/Android/iOS/macOS/Windows/插件\n- 发布状态developing/pending_review/published/rejected/deprecated\n- 价格类型free/one_time/subscription\n\n### 5.2 AppUser (应用成员)\n- 核心字段id, appId, userId, role\n- 角色类型owner/admin/developer/viewer\n- 邀请状态0-正常, 1-待确认, 2-已拒绝\n\n### 5.3 ShopOrder (订单)\n- 核心字段orderId, orderNo, totalPrice, payPrice, payStatus\n- 订单状态0未使用,1已完成,2已取消,3取消中,4退款申请中,5退款被拒绝,6退款成功\n- 支付方式0余额,1微信,2支付宝,3银联,4现金,5POS机,6免费,7积分\n\n---\n\n## 六、权限控制说明\n\n项目使用Spring Security进行权限控制主要权限前缀\n- `app:` - 应用管理权限\n- `shop:` - 商城管理权限\n- `cms:` - 内容管理权限\n\n主要权限操作\n- `:list` - 查询权限\n- `:save` - 新增权限\n- `:update` - 修改权限\n- `:remove` - 删除权限\n\n---\n\n## 七、模块依赖关系\n\n```\napp模块 (应用管理)\n ├── 依赖:用户系统 (common/system)\n ├── 依赖:支付系统 (payment)\n └── 关联:商城 (shop)、内容管理 (cms)\n\nshop模块 (商城)\n ├── 依赖:支付系统 (payment)\n └── 依赖:用户系统 (common/system)\n\ncms模块 (内容管理)\n └── 依赖:用户系统 (common/system)\n\npayment模块 (支付)\n └── 独立模块被app和shop依赖\n```\n\n---\n\n报告完成共分析了172个Controller覆盖应用管理、商城、支付、内容管理四大业务模块。",
"timestamp": "2026-04-10T10:59:49.671Z",
"read": true
},
{
"id": "msg-1775818820679-lu2dwx",
"from": "miniapp-explorer",
"to": "team-lead",
"type": "message",
"content": "\n# 微信小程序端完整功能分析报告\n\n## 一、项目概览\n\n这是一个基于 Taro + React 的微信小程序项目,采用 NutUI 组件库,主要功能是 SaaS 多租户电商平台的小程序端(桂乐淘)。\n\n---\n\n## 二、页面路由配置\n\n### 2.1 主包页面TabBar\n\n| 路由路径 | 页面功能 | 说明 |\n|---------|---------|------|\n| pages/index/index | 首页 | SaaS 产品展示、快捷导航、联系咨询 |\n| pages/cart/cart | 购物车 | 商品勾选、数量修改、结算跳转 |\n| pages/user/user | 个人中心 | 用户信息、订单入口、设置 |\n| pages/category/index | 商品分类 | CMS 文章分类浏览 |\n\n### 2.2 子包 - passport认证模块\n\n| 路由路径 | 页面功能 |\n|---------|---------|\n| passport/login | 账号密码登录 |\n| passport/sms-login | 短信验证码登录 |\n| passport/forget | 忘记密码 |\n| passport/setting | 服务配置 |\n| passport/agreement | 服务协议与隐私政策 |\n| passport/phone-auth/index | 手机号授权 |\n| passport/qr-login/index | 扫码登录 |\n| passport/qr-confirm/index | 扫码确认 |\n| passport/unified-qr/index | 统一二维码 |\n| passport/webview/index | 网页容器 |\n\n### 2.3 子包 - shop商城模块\n\n| 路由路径 | 页面功能 | API 接口 |\n|---------|---------|----------|\n| shop/category/index | 商品分类页 | cmsNavigation, cmsArticle |\n| shop/goodsDetail/index | 商品详情 | shopGoods, shopGoodsSpec, shopGoodsSku |\n| shop/orderConfirm/index | 订单确认 | shopUserAddress, payment, shopUserCoupon |\n| shop/orderConfirmCart/index | 购物车结算 | 同上 |\n| shop/orderDetail/index | 订单详情 | shopOrder |\n| shop/comments/index | 商品评价 | shopGoods |\n| shop/search/index | 商品搜索 | shopGoods |\n\n### 2.4 子包 - user用户中心\n\n| 路由路径 | 页面功能 | API 接口 |\n|---------|---------|----------|\n| user/order/order | 我的订单 | shopOrder |\n| user/order/logistics | 物流信息 | logistics |\n| user/order/evaluate | 订单评价 | shopOrderGoods |\n| user/order/refund | 退款售后 | afterSale |\n| user/order/progress | 进度查询 | shopOrder |\n| user/company/company | 企业认证 | company |\n| user/profile/profile | 个人资料 | user |\n| user/setting/setting | 账号设置 | - |\n| user/userVerify/index | 实名认证 | userVerify |\n| user/address/index | 收货地址 | shopUserAddress |\n| user/address/add | 新增地址 | shopUserAddress |\n| user/address/wxAddress | 微信地址 | - |\n| user/help/index | 帮助中心 | cmsArticle |\n| user/about/index | 关于我们 | - |\n| user/wallet/wallet | 钱包/余额 | balance-log |\n| user/coupon/index | 我的优惠券 | shopUserCoupon |\n| user/points/points | 积分中心 | points |\n| user/gift/index | 水票管理 | shopGift |\n| user/gift/redeem | 兑换水票 | shopGift |\n| user/gift/detail | 水票详情 | shopGift |\n| user/gift/add | 领取水票 | shopGift |\n| user/store/verification | 礼品卡核销 | shopStore |\n| user/store/orders | 门店订单 | shopOrder |\n| user/theme/index | 主题设置 | - |\n| user/poster/poster | 海报生成 | - |\n| user/chat/conversation | 会话列表 | shopChatConversation |\n| user/chat/message | 消息列表 | shopChatMessage |\n| user/chat/message/add | 发起聊天 | shopChatMessage |\n\n### 2.5 子包 - dealer分销模块\n\n| 路由路径 | 页面功能 | API 接口 |\n|---------|---------|----------|\n| dealer/index | 分销中心 | shopDealerUser |\n| dealer/apply/add | 申请成为分销商 | shopDealerApply |\n| dealer/withdraw/index | 提现申请 | shopDealerWithdraw |\n| dealer/orders/index | 分销订单 | shopDealerOrder |\n| dealer/capital/index | 资金明细 | shopDealerCapital |\n| dealer/team/index | 我的团队 | shopDealerReferee |\n| dealer/qrcode/index | 邀请二维码 | - |\n| dealer/invite-stats | 邀请统计 | - |\n| dealer/info | 分销商信息 | shopDealerUser |\n\n### 2.6 子包 - coupon优惠券\n\n| 路由路径 | 页面功能 | API 接口 |\n|---------|---------|----------|\n| coupon/index | 优惠券中心 | shopCoupon, shopUserCoupon |\n\n### 2.7 子包 - cms内容管理\n\n| 路由路径 | 页面功能 | API 接口 |\n|---------|---------|----------|\n| cms/category/index | CMS 分类 | cmsNavigation |\n| cms/detail/index | 文章详情 | cmsArticle |\n\n### 2.8 子包 - store门店模块\n\n| 路由路径 | 页面功能 | API 接口 |\n|---------|---------|----------|\n| store/index | 门店中心 | shopStore, shopStoreUser |\n| store/orders/index | 门店订单 | shopOrder |\n\n### 2.9 子包 - rider配送模块\n\n| 路由路径 | 页面功能 |\n|---------|---------|\n| rider/index | 配送员中心 |\n| rider/orders/index | 配送订单 |\n\n### 2.10 子包 - admin管理模块\n\n| 路由路径 | 页面功能 |\n|---------|---------|\n| admin/index | 管理员首页 |\n| admin/article/index | 文章管理 |\n\n---\n\n## 三、API 接口结构\n\n### 3.1 Shop 模块(商城)\n\n```\nshop/goods - 商品\nshop/goodsCategory - 商品分类\nshop/goodsSku - SKU\nshop/goodsSpec - 规格\nshop/order - 订单\nshop/orderGoods - 订单商品\nshop/userAddress - 收货地址\nshop/userCoupon - 用户优惠券\nshop/userReferee - 推荐关系\nshop/coupon - 优惠券\nshop/gift - 礼品/水票\nshop/express - 物流\nshop/expressTemplate - 运费模板\nshop/store - 门店\nshop/storeUser - 门店用户\nshop/storeRider - 配送员\nshop/merchant - 商户\nshop/dealerUser - 分销用户\nshop/dealerApply - 分销申请\nshop/dealerOrder - 分销订单\nshop/dealerCapital - 分销资金\nshop/dealerWithdraw - 分销提现\nshop/dealerReferee - 分销推荐\nshop/dealerSetting - 分销设置\nshop/commissionRole - 分销角色\nshop/chatConversation - 会话\nshop/chatMessage - 消息\n```\n\n### 3.2 User 模块\n\n```\nuser/balance-log - 余额日志\nuser/points - 积分\nuser/index - 用户信息\n```\n\n### 3.3 Passport 模块\n\n```\npassport/login - 登录\npassport/wx-login - 微信登录\npassport/qr-login - 扫码登录\n```\n\n### 3.4 System 模块\n\n```\nsystem/user - 用户管理\nsystem/company - 企业管理\nsystem/tenant - 租户管理\nsystem/role - 角色权限\nsystem/menu - 菜单\nsystem/payment - 支付方式\nsystem/parameter - 参数配置\nsystem/dict - 字典\nsystem/file - 文件上传\nsystem/setting - 系统设置\nsystem/access-key - 访问密钥\nsystem/appstore - 应用商店\nsystem/plugin - 插件管理\nsystem/version - 版本管理\nsystem/white-domain - 白名单域名\n```\n\n### 3.5 CMS 模块\n\n```\ncms/navigation - 导航分类\ncms/article - 文章内容\ncms/websiteField - 网站配置\n```\n\n---\n\n## 四、状态管理\n\n### 4.1 HooksuseCart, useUser, useConfig\n\n- **useCart**: 购物车状态管理,本地存储持久化\n- **useUser**: 用户登录状态、权限管理\n- **useConfig**: 网站配置(主题、站点信息)\n- **useDealerUser**: 分销用户状态\n- **useShopInfo**: 门店信息\n- **useTheme**: 主题样式管理\n\n### 4.2 本地存储\n\n- `access_token`: 登录令牌\n- `User`: 用户信息\n- `UserId`: 用户ID\n- `TenantId`: 租户ID\n- `cart_items`: 购物车商品\n- `checkout_items`: 结算商品\n- `config`: 网站配置\n- `search_history`: 搜索历史\n- `selected_store`: 选中的门店\n\n---\n\n## 五、核心业务流程\n\n### 5.1 登录流程\n\n1. 自动登录:微信 OpenID → loginByOpenId → 获取 token\n2. 账号登录:手机号+密码 → login\n3. 短信登录:手机号+验证码 → sms-login\n4. 扫码登录qr-login → qr-confirm 确认\n\n### 5.2 商品购买流程\n\n1. 首页/分类 → 商品详情\n2. 选择规格(可选)\n3. 加入购物车 / 直接购买\n4. 购物车结算 / 立即购买 → 订单确认\n5. 选择地址、支付方式、优惠券\n6. 发起支付(微信支付/余额)\n7. 订单创建 → 支付回调 → 订单完成\n\n### 5.3 分销流程\n\n1. 申请成为分销商 → dealer/apply/add\n2. 获取邀请二维码 → dealer/qrcode\n3. 邀请好友注册 → 建立上下级关系\n4. 好友下单 → 获得佣金奖励\n5. 佣金提现 → dealer/withdraw\n\n---\n\n## 六、关键业务逻辑\n\n### 6.1 邀请关系追踪\n\n- 从分享链接进入时,解析 `inviter/source/t` 参数\n- 存储邀请参数,注册后绑定邀请关系\n- 支持多级分销(一级、二级、三级)\n\n### 6.2 优惠券系统\n\n- 支持满减券(10)、折扣券(20)、免费券(30)\n- 智能推荐最优优惠券\n- 使用条件校验(门槛金额)\n\n### 6.3 多门店支持\n\n- 用户可选择归属门店\n- 店员绑定门店关系\n- 门店订单管理\n- 礼品卡核销\n\n### 6.4 主题定制\n\n- 支持主题色配置\n- 渐变背景样式\n- 用户主题偏好存储\n\n---\n\n## 七、技术栈\n\n- **框架**: Taro 3.x + React\n- **UI组件**: NutUI (nutui/nutui-react-taro)\n- **图标**: @nutui/icons-react-taro\n- **状态管理**: React Hooks + 本地存储\n- **网络请求**: 统一 API 模块\n- **样式**: SCSS + Tailwind CSS\n",
"timestamp": "2026-04-10T11:00:20.679Z",
"read": true
}
]