|
|
@@ -3,6 +3,7 @@
|
|
|
## 版本信息
|
|
|
| 版本 | 日期 | 描述 | 作者 |
|
|
|
|------|------|------|------|
|
|
|
+| 4.0 | 2026-01-02 | 根据实际项目结构更新:删除不存在的目录,添加新包 | James (Claude Code) |
|
|
|
| 3.3 | 2025-12-26 | 更新完整项目结构,包含allin-packages和mini-ui-packages | James |
|
|
|
| 3.2 | 2025-11-11 | 更新包结构,添加基础设施和业务模块包 | Winston |
|
|
|
| 3.1 | 2025-11-09 | 更新测试结构,清理重复测试文件 | James |
|
|
|
@@ -10,7 +11,7 @@
|
|
|
|
|
|
## 实际项目结构
|
|
|
```text
|
|
|
-188-179-template-6/
|
|
|
+186-175-template-6/
|
|
|
├── .bmad-core/ # BMad框架配置目录
|
|
|
│ ├── agents/ # 代理配置
|
|
|
│ ├── agent-teams/ # 团队配置
|
|
|
@@ -26,334 +27,182 @@
|
|
|
├── .github/ # GitHub Actions配置
|
|
|
│ └── workflows/ # CI/CD工作流
|
|
|
├── .git/ # Git版本控制
|
|
|
-├── allin-packages/ # AllIn业务包目录
|
|
|
-│ ├── channel-module/ # 渠道管理模块
|
|
|
-│ ├── channel-management-ui/ # 渠道管理UI
|
|
|
-│ ├── company-module/ # 企业管理模块
|
|
|
-│ ├── company-management-ui/ # 企业管理UI
|
|
|
-│ ├── disability-module/ # 残疾人管理模块
|
|
|
-│ ├── disability-person-management-ui/ # 残疾人个人管理UI
|
|
|
-│ ├── enums/ # 枚举类型包
|
|
|
-│ ├── order-module/ # 订单管理模块
|
|
|
-│ ├── order-management-ui/ # 订单管理UI
|
|
|
-│ ├── platform-module/ # 平台管理模块
|
|
|
-│ ├── platform-management-ui/ # 平台管理UI
|
|
|
-│ ├── salary-module/ # 薪资管理模块
|
|
|
-│ ├── salary-management-ui/ # 薪资管理UI
|
|
|
-│ └── statistics-module/ # 统计模块
|
|
|
-├── docs/ # 项目文档目录
|
|
|
-│ ├── architecture/ # 架构文档(分片)
|
|
|
-│ │ ├── coding-standards.md # 编码标准和测试策略
|
|
|
-│ │ ├── source-tree.md # 源码树和文件组织(本文件)
|
|
|
-│ │ ├── tech-stack.md # 技术栈
|
|
|
-│ │ └── ui-package-standards.md # UI包开发规范
|
|
|
-│ ├── prd/ # 产品需求文档(分片)
|
|
|
-│ ├── qa/ # QA文档
|
|
|
-│ ├── stories/ # 用户故事文档
|
|
|
-│ └── *.md # 其他项目文档
|
|
|
-├── mini/ # 商户小程序项目 (Taro + React)
|
|
|
+├── .roo/ # Roo配置
|
|
|
+├── docs/ # 项目文档目录
|
|
|
+│ ├── architecture/ # 架构文档(分片)
|
|
|
+│ │ ├── coding-standards.md # 编码标准和测试策略
|
|
|
+│ │ ├── source-tree.md # 源码树和文件组织(本文件)
|
|
|
+│ │ ├── tech-stack.md # 技术栈
|
|
|
+│ │ └── ui-package-standards.md # UI包开发规范
|
|
|
+│ ├── prd/ # 产品需求文档(分片)
|
|
|
+│ ├── stories/ # 用户故事文档
|
|
|
+│ ├── architecture.md # 架构总览
|
|
|
+│ ├── brief.md # 项目简述
|
|
|
+│ ├── development.md # 开发指南
|
|
|
+│ ├── error-handling.md # 错误处理
|
|
|
+│ ├── integration-testing-best-practices.md # 集成测试最佳实践
|
|
|
+│ ├── prd.md # PRD文档
|
|
|
+│ └── ui-architecture.md # UI架构
|
|
|
+├── mini/ # 商户小程序项目 (Taro + React)
|
|
|
│ ├── src/
|
|
|
-│ │ ├── app.tsx # 小程序入口
|
|
|
-│ │ ├── app.config.ts # 小程序配置
|
|
|
-│ │ ├── api.ts # API客户端
|
|
|
-│ │ ├── components/
|
|
|
-│ │ │ └── ui/ # UI组件库
|
|
|
-│ │ │ ├── avatar-upload.tsx # 头像上传组件
|
|
|
-│ │ │ ├── button.tsx # 按钮组件
|
|
|
-│ │ │ ├── card.tsx # 卡片组件
|
|
|
-│ │ │ ├── form.tsx # 表单组件
|
|
|
-│ │ │ ├── image.tsx # 图片组件
|
|
|
-│ │ │ ├── input.tsx # 输入框组件
|
|
|
-│ │ │ ├── label.tsx # 标签组件
|
|
|
-│ │ │ ├── navbar.tsx # 导航栏组件
|
|
|
-│ │ │ └── tab-bar.tsx # 标签栏组件
|
|
|
-│ │ ├── layouts/
|
|
|
-│ │ │ └── tab-bar-layout.tsx # 标签栏布局
|
|
|
-│ │ ├── pages/
|
|
|
-│ │ │ ├── explore/ # 探索页面
|
|
|
-│ │ │ │ ├── index.tsx
|
|
|
-│ │ │ │ └── index.config.ts
|
|
|
-│ │ │ ├── index/ # 首页
|
|
|
-│ │ │ │ ├── index.tsx
|
|
|
-│ │ │ │ └── index.config.ts
|
|
|
-│ │ │ ├── login/ # 登录页面
|
|
|
-│ │ │ │ ├── index.tsx
|
|
|
-│ │ │ │ ├── index.config.ts
|
|
|
-│ │ │ │ └── wechat-login.tsx # 微信登录
|
|
|
-│ │ │ ├── profile/ # 个人资料
|
|
|
-│ │ │ │ ├── index.tsx
|
|
|
-│ │ │ │ └── index.config.ts
|
|
|
-│ │ │ └── register/ # 注册页面
|
|
|
-│ │ │ ├── index.tsx
|
|
|
-│ │ │ └── index.config.ts
|
|
|
-│ │ ├── schemas/ # 验证模式
|
|
|
-│ │ └── utils/ # 工具函数
|
|
|
-│ ├── config/
|
|
|
-│ │ ├── dev.ts # 开发环境配置
|
|
|
-│ │ ├── index.ts # 配置入口
|
|
|
-│ │ └── prod.ts # 生产环境配置
|
|
|
-│ ├── tests/ # 测试文件
|
|
|
-│ ├── dist/ # 构建输出
|
|
|
+│ │ ├── app.tsx # 小程序入口
|
|
|
+│ │ ├── app.config.ts # 小程序配置
|
|
|
+│ │ ├── api/ # API目录
|
|
|
+│ │ ├── api.ts # API客户端
|
|
|
+│ │ ├── app.css # 全局样式
|
|
|
+│ │ ├── components/ # 组件目录
|
|
|
+│ │ ├── contexts/ # React Context
|
|
|
+│ │ ├── layouts/ # 布局组件
|
|
|
+│ │ ├── pages/ # 页面目录
|
|
|
+│ │ │ ├── address-edit/ # 地址编辑
|
|
|
+│ │ │ ├── address-manage/ # 地址管理
|
|
|
+│ │ │ ├── cart/ # 购物车
|
|
|
+│ │ │ ├── category/ # 分类
|
|
|
+│ │ │ ├── explore/ # 探索
|
|
|
+│ │ │ ├── goods-detail/ # 商品详情
|
|
|
+│ │ │ ├── goods-list/ # 商品列表
|
|
|
+│ │ │ ├── index/ # 首页
|
|
|
+│ │ │ ├── login/ # 登录
|
|
|
+│ │ │ ├── order-detail/ # 订单详情
|
|
|
+│ │ │ ├── order-list/ # 订单列表
|
|
|
+│ │ │ ├── order-submit/ # 提交订单
|
|
|
+│ │ │ ├── payment/ # 支付
|
|
|
+│ │ │ ├── payment-success/ # 支付成功
|
|
|
+│ │ │ ├── profile/ # 个人资料
|
|
|
+│ │ │ ├── register/ # 注册
|
|
|
+│ │ │ ├── search/ # 搜索
|
|
|
+│ │ │ └── search-result/ # 搜索结果
|
|
|
+│ │ ├── schemas/ # 验证模式
|
|
|
+│ │ └── utils/ # 工具函数
|
|
|
+│ ├── config/ # 配置目录
|
|
|
+│ │ ├── dev.ts # 开发环境配置
|
|
|
+│ │ ├── index.ts # 配置入口
|
|
|
+│ │ └── prod.ts # 生产环境配置
|
|
|
+│ ├── tests/ # 测试文件
|
|
|
+│ ├── dist/ # 构建输出
|
|
|
+│ ├── tdesign/ # TDesign组件库
|
|
|
│ └── package.json
|
|
|
-├── mini-talent/ # 人才小程序项目 (Taro + React)
|
|
|
-│ ├── src/ # 源代码
|
|
|
-│ ├── tests/ # 测试文件
|
|
|
-│ └── package.json
|
|
|
-├── mini-ui-packages/ # 小程序UI组件包目录
|
|
|
-│ ├── mini-charts/ # 小程序图表组件
|
|
|
-│ ├── mini-enterprise-auth-ui/ # 企业认证UI
|
|
|
-│ ├── mini-shared-ui-components/ # 共享UI组件
|
|
|
-│ ├── mini-testing-utils/ # 测试工具
|
|
|
-│ ├── rencai-attendance-ui/ # 人才考勤UI
|
|
|
-│ ├── rencai-auth-ui/ # 人才认证UI
|
|
|
-│ ├── rencai-dashboard-ui/ # 人才仪表盘UI
|
|
|
-│ ├── rencai-employment-ui/ # 人才就业UI
|
|
|
-│ ├── rencai-personal-info-ui/ # 人才个人信息UI
|
|
|
-│ ├── rencai-settings-ui/ # 人才设置UI
|
|
|
-│ ├── rencai-shared-ui/ # 人才共享UI
|
|
|
-│ ├── yongren-dashboard-ui/ # 用人仪表盘UI
|
|
|
-│ ├── yongren-order-management-ui/ # 用人订单管理UI
|
|
|
-│ ├── yongren-settings-ui/ # 用人设置UI
|
|
|
-│ ├── yongren-shared-ui/ # 用人共享UI
|
|
|
-│ ├── yongren-statistics-ui/ # 用人统计UI
|
|
|
-│ └── yongren-talent-management-ui/ # 用人人才管理UI
|
|
|
-├── packages/ # 核心共享包目录
|
|
|
+├── mini-ui-packages/ # 小程序UI组件包目录
|
|
|
+│ ├── mini-charts/ # 小程序图表组件
|
|
|
+│ ├── mini-shared-ui-components/ # 共享UI组件
|
|
|
+│ ├── mini-testing-utils/ # 测试工具
|
|
|
+│ ├── rencai-attendance-ui/ # 人才考勤UI
|
|
|
+│ ├── rencai-auth-ui/ # 人才认证UI
|
|
|
+│ ├── rencai-dashboard-ui/ # 人才仪表盘UI
|
|
|
+│ ├── rencai-employment-ui/ # 人才就业UI
|
|
|
+│ ├── rencai-personal-info-ui/ # 人才个人信息UI
|
|
|
+│ ├── rencai-settings-ui/ # 人才设置UI
|
|
|
+│ └── rencai-shared-ui/ # 人才共享UI
|
|
|
+├── packages/ # 核心共享包目录
|
|
|
│ # ==================== UI管理包 ====================
|
|
|
-│ ├── advertisement-management-ui/ # 广告管理UI
|
|
|
-│ ├── advertisement-type-management-ui/ # 广告类型管理UI
|
|
|
-│ ├── area-management-ui/ # 区域管理UI
|
|
|
-│ ├── auth-management-ui/ # 认证管理UI
|
|
|
-│ ├── bank-name-management-ui/ # 银行名称管理UI
|
|
|
-│ ├── delivery-address-management-ui/ # 收货地址管理UI
|
|
|
-│ ├── file-management-ui/ # 文件管理UI
|
|
|
-│ ├── goods-category-management-ui/ # 商品类别管理UI
|
|
|
-│ ├── goods-management-ui/ # 商品管理UI
|
|
|
-│ ├── merchant-management-ui/ # 商户管理UI
|
|
|
-│ ├── order-management-ui/ # 订单管理UI
|
|
|
-│ ├── supplier-management-ui/ # 供应商管理UI
|
|
|
-│ ├── user-management-ui/ # 用户管理UI
|
|
|
-│ # 多租户版本
|
|
|
-│ ├── advertisement-management-ui-mt/ # 广告管理UI(多租户)
|
|
|
+│ ├── advertisement-management-ui/ # 广告管理UI
|
|
|
+│ ├── advertisement-management-ui-mt/ # 广告管理UI(多租户)
|
|
|
+│ ├── advertisement-type-management-ui/ # 广告类型管理UI
|
|
|
│ ├── advertisement-type-management-ui-mt/ # 广告类型管理UI(多租户)
|
|
|
-│ ├── area-management-ui-mt/ # 区域管理UI(多租户)
|
|
|
-│ ├── auth-management-ui-mt/ # 认证管理UI(多租户)
|
|
|
-│ ├── bank-name-management-ui-mt/ # 银行名称管理UI(多租户)
|
|
|
-│ ├── delivery-address-management-ui-mt/ # 收货地址管理UI(多租户)
|
|
|
-│ ├── file-management-ui-mt/ # 文件管理UI(多租户)
|
|
|
-│ ├── goods-category-management-ui-mt/ # 商品类别管理UI(多租户)
|
|
|
-│ ├── goods-management-ui-mt/ # 商品管理UI(多租户)
|
|
|
-│ ├── merchant-management-ui-mt/ # 商户管理UI(多租户)
|
|
|
-│ ├── order-management-ui-mt/ # 订单管理UI(多租户)
|
|
|
-│ ├── supplier-management-ui-mt/ # 供应商管理UI(多租户)
|
|
|
-│ └── user-management-ui-mt/ # 用户管理UI(多租户)
|
|
|
+│ ├── area-management-ui/ # 区域管理UI
|
|
|
+│ ├── area-management-ui-mt/ # 区域管理UI(多租户)
|
|
|
+│ ├── auth-management-ui/ # 认证管理UI
|
|
|
+│ ├── auth-management-ui-mt/ # 认证管理UI(多租户)
|
|
|
+│ ├── credit-balance-management-ui-mt/ # 余额管理UI(多租户)
|
|
|
+│ ├── data-overview-ui-mt/ # 数据概览UI(多租户)
|
|
|
+│ ├── delivery-address-management-ui/ # 收货地址管理UI
|
|
|
+│ ├── delivery-address-management-ui-mt/ # 收货地址管理UI(多租户)
|
|
|
+│ ├── feie-printer-management-ui-mt/ # 飞鹅打印管理UI(多租户)
|
|
|
+│ ├── file-management-ui/ # 文件管理UI
|
|
|
+│ ├── file-management-ui-mt/ # 文件管理UI(多租户)
|
|
|
+│ ├── goods-category-management-ui/ # 商品类别管理UI
|
|
|
+│ ├── goods-category-management-ui-mt/ # 商品类别管理UI(多租户)
|
|
|
+│ ├── goods-management-ui/ # 商品管理UI
|
|
|
+│ ├── goods-management-ui-mt/ # 商品管理UI(多租户)
|
|
|
+│ ├── merchant-management-ui/ # 商户管理UI
|
|
|
+│ ├── merchant-management-ui-mt/ # 商户管理UI(多租户)
|
|
|
+│ ├── order-management-ui/ # 订单管理UI
|
|
|
+│ ├── order-management-ui-mt/ # 订单管理UI(多租户)
|
|
|
+│ ├── supplier-management-ui/ # 供应商管理UI
|
|
|
+│ ├── supplier-management-ui-mt/ # 供应商管理UI(多租户)
|
|
|
+│ ├── system-config-management-ui-mt/ # 系统配置管理UI(多租户)
|
|
|
+│ ├── tenant-management-ui/ # 租户管理UI
|
|
|
+│ ├── user-management-ui/ # 用户管理UI
|
|
|
+│ └── user-management-ui-mt/ # 用户管理UI(多租户)
|
|
|
│ # ==================== 业务模块包 ====================
|
|
|
-│ ├── advertisements-module/ # 广告模块
|
|
|
-│ ├── auth-module/ # 认证模块
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── services/
|
|
|
-│ │ │ │ ├── auth.service.ts # 认证服务
|
|
|
-│ │ │ │ └── mini-auth.service.ts # 小程序认证服务
|
|
|
-│ │ │ ├── schemas/
|
|
|
-│ │ │ │ └── auth.schema.ts # 认证Schema
|
|
|
-│ │ │ ├── routes/
|
|
|
-│ │ │ │ ├── login.route.ts # 登录路由
|
|
|
-│ │ │ │ ├── register.route.ts # 注册路由
|
|
|
-│ │ │ │ ├── mini-login.route.ts # 小程序登录路由
|
|
|
-│ │ │ │ ├── phone-decrypt.route.ts # 手机号解密路由
|
|
|
-│ │ │ │ ├── me.route.ts # 获取用户信息路由
|
|
|
-│ │ │ │ ├── update-me.route.ts # 更新用户信息路由
|
|
|
-│ │ │ │ ├── logout.route.ts # 登出路由
|
|
|
-│ │ │ │ └── sso-verify.route.ts # SSO验证路由
|
|
|
-│ │ │ └── middleware/
|
|
|
-│ │ │ ├── auth.middleware.ts # 认证中间件
|
|
|
-│ │ │ └── index.ts # 中间件导出
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── bank-names-module/ # 银行名称模块
|
|
|
-│ ├── delivery-address-module/ # 收货地址模块
|
|
|
-│ ├── file-module/ # 文件管理模块
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── entities/
|
|
|
-│ │ │ │ └── file.entity.ts # 文件实体
|
|
|
-│ │ │ ├── services/
|
|
|
-│ │ │ │ ├── file.service.ts # 文件服务
|
|
|
-│ │ │ │ └── minio.service.ts # MinIO服务
|
|
|
-│ │ │ ├── schemas/
|
|
|
-│ │ │ │ └── file.schema.ts # 文件Schema
|
|
|
-│ │ │ └── routes/
|
|
|
-│ │ │ ├── upload-policy/post.ts # 上传策略路由
|
|
|
-│ │ │ ├── multipart-policy/post.ts # 多部分上传策略路由
|
|
|
-│ │ │ ├── multipart-complete/post.ts # 完成多部分上传路由
|
|
|
-│ │ │ └── [id]/
|
|
|
-│ │ │ ├── get.ts # 获取文件详情路由
|
|
|
-│ │ │ ├── get-url.ts # 获取文件URL路由
|
|
|
-│ │ │ ├── download.ts # 文件下载路由
|
|
|
-│ │ │ └── delete.ts # 删除文件路由
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── geo-areas/ # 地理区域模块
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── modules/areas/
|
|
|
-│ │ │ │ ├── area.entity.ts # 地区实体
|
|
|
-│ │ │ │ ├── area.service.ts # 地区服务
|
|
|
-│ │ │ │ └── area.schema.ts # 地区Schema
|
|
|
-│ │ │ ├── api/
|
|
|
-│ │ │ │ ├── areas/index.ts # 公共地区API
|
|
|
-│ │ │ │ └── admin/areas/index.ts # 管理地区API
|
|
|
-│ │ │ └── index.ts # 包入口
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── goods-category-module/ # 商品类别模块
|
|
|
-│ ├── goods-module/ # 商品模块
|
|
|
-│ ├── merchant-module/ # 商户模块
|
|
|
-│ ├── orders-module/ # 订单模块
|
|
|
-│ ├── supplier-module/ # 供应商模块
|
|
|
-│ ├── tenant-module/ # 租户模块
|
|
|
-│ ├── user-module/ # 用户管理模块
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── entities/
|
|
|
-│ │ │ │ ├── user.entity.ts # 用户实体
|
|
|
-│ │ │ │ └── role.entity.ts # 角色实体
|
|
|
-│ │ │ ├── services/
|
|
|
-│ │ │ │ ├── user.service.ts # 用户服务
|
|
|
-│ │ │ │ └── role.service.ts # 角色服务
|
|
|
-│ │ │ ├── schemas/
|
|
|
-│ │ │ │ ├── user.schema.ts # 用户Schema
|
|
|
-│ │ │ │ └── role.schema.ts # 角色Schema
|
|
|
-│ │ │ └── routes/
|
|
|
-│ │ │ ├── user.routes.ts # 用户路由
|
|
|
-│ │ │ ├── role.routes.ts # 角色路由
|
|
|
-│ │ │ └── custom.routes.ts # 自定义路由
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ # 多租户版本
|
|
|
-│ ├── advertisements-module-mt/ # 广告模块(多租户)
|
|
|
-│ ├── auth-module-mt/ # 认证模块(多租户)
|
|
|
-│ ├── bank-names-module-mt/ # 银行名称模块(多租户)
|
|
|
-│ ├── delivery-address-module-mt/ # 收货地址模块(多租户)
|
|
|
-│ ├── file-module-mt/ # 文件管理模块(多租户)
|
|
|
-│ ├── goods-category-module-mt/ # 商品类别模块(多租户)
|
|
|
-│ ├── goods-module-mt/ # 商品模块(多租户)
|
|
|
-│ ├── merchant-module-mt/ # 商户模块(多租户)
|
|
|
-│ ├── orders-module-mt/ # 订单模块(多租户)
|
|
|
-│ ├── supplier-module-mt/ # 供应商模块(多租户)
|
|
|
-│ ├── tenant-module-mt/ # 租户模块(多租户)
|
|
|
-│ └── user-module-mt/ # 用户管理模块(多租户)
|
|
|
+│ ├── advertisements-module/ # 广告模块
|
|
|
+│ ├── advertisements-module-mt/ # 广告模块(多租户)
|
|
|
+│ ├── auth-module/ # 认证模块
|
|
|
+│ ├── auth-module-mt/ # 认证模块(多租户)
|
|
|
+│ ├── core-module-mt/ # 核心模块(多租户)
|
|
|
+│ ├── credit-balance-module-mt/ # 余额模块(多租户)
|
|
|
+│ ├── data-overview-module-mt/ # 数据概览模块(多租户)
|
|
|
+│ ├── delivery-address-module/ # 收货地址模块
|
|
|
+│ ├── delivery-address-module-mt/ # 收货地址模块(多租户)
|
|
|
+│ ├── feie-printer-module-mt/ # 飞鹅打印模块(多租户)
|
|
|
+│ ├── file-module/ # 文件管理模块
|
|
|
+│ ├── file-module-mt/ # 文件管理模块(多租户)
|
|
|
+│ ├── geo-areas/ # 地理区域模块
|
|
|
+│ ├── geo-areas-mt/ # 地理区域模块(多租户)
|
|
|
+│ ├── goods-category-module/ # 商品类别模块
|
|
|
+│ ├── goods-category-module-mt/ # 商品类别模块(多租户)
|
|
|
+│ ├── goods-module/ # 商品模块
|
|
|
+│ ├── goods-module-mt/ # 商品模块(多租户)
|
|
|
+│ ├── merchant-module/ # 商户模块
|
|
|
+│ ├── merchant-module-mt/ # 商户模块(多租户)
|
|
|
+│ ├── mini-payment/ # 小程序支付模块
|
|
|
+│ ├── mini-payment-mt/ # 小程序支付模块(多租户)
|
|
|
+│ ├── orders-module/ # 订单模块
|
|
|
+│ ├── orders-module-mt/ # 订单模块(多租户)
|
|
|
+│ ├── supplier-module/ # 供应商模块
|
|
|
+│ ├── supplier-module-mt/ # 供应商模块(多租户)
|
|
|
+│ ├── tenant-module-mt/ # 租户模块(多租户)
|
|
|
+│ ├── user-module/ # 用户管理模块
|
|
|
+│ └── user-module-mt/ # 用户管理模块(多租户)
|
|
|
│ # ==================== 共享基础设施包 ====================
|
|
|
-│ ├── core-module/ # 核心模块
|
|
|
-│ ├── shared-crud/ # 通用CRUD基础设施
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── services/
|
|
|
-│ │ │ │ ├── generic-crud.service.ts # 通用CRUD服务
|
|
|
-│ │ │ │ └── concrete-crud.service.ts # 具体CRUD服务
|
|
|
-│ │ │ └── routes/
|
|
|
-│ │ │ └── generic-crud.routes.ts # 通用CRUD路由
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── shared-test-util/ # 测试基础设施
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── integration-test-db.ts # 集成测试数据库工具
|
|
|
-│ │ │ └── integration-test-utils.ts # 集成测试断言工具
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── shared-types/ # 共享类型定义
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ └── index.ts # 类型定义导出
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── shared-ui-components/ # 共享UI组件
|
|
|
-│ ├── shared-utils/ # 共享工具函数
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── utils/
|
|
|
-│ │ │ │ ├── jwt.util.ts # JWT工具
|
|
|
-│ │ │ │ ├── errorHandler.ts # 错误处理
|
|
|
-│ │ │ │ ├── parseWithAwait.ts # 异步解析
|
|
|
-│ │ │ │ ├── logger.ts # 日志工具
|
|
|
-│ │ │ │ └── redis.util.ts # Redis会话管理
|
|
|
-│ │ │ └── data-source.ts # 数据库连接
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ └── package.json
|
|
|
-│ ├── mini-payment/ # 小程序支付模块
|
|
|
-│ │ ├── src/
|
|
|
-│ │ │ ├── entities/
|
|
|
-│ │ │ │ ├── payment.entity.ts # 支付实体
|
|
|
-│ │ │ │ └── payment.types.ts # 支付类型定义
|
|
|
-│ │ │ ├── services/
|
|
|
-│ │ │ │ └── payment.service.ts # 支付服务
|
|
|
-│ │ │ ├── schemas/
|
|
|
-│ │ │ │ └── payment.schema.ts # 支付Schema
|
|
|
-│ │ │ └── routes/
|
|
|
-│ │ │ └── payment/
|
|
|
-│ │ │ ├── create.ts # 支付创建路由
|
|
|
-│ │ │ ├── callback.ts # 支付回调路由
|
|
|
-│ │ │ └── status.ts # 支付状态查询路由
|
|
|
-│ │ ├── tests/
|
|
|
-│ │ │ └── integration/
|
|
|
-│ │ │ ├── payment.integration.test.ts # 支付集成测试
|
|
|
-│ │ │ └── payment-callback.integration.test.ts # 支付回调集成测试
|
|
|
-│ │ └── package.json
|
|
|
+│ ├── shared-crud/ # 通用CRUD基础设施
|
|
|
+│ ├── shared-test-util/ # 测试基础设施
|
|
|
+│ ├── shared-types/ # 共享类型定义
|
|
|
+│ ├── shared-ui-components/ # 共享UI组件
|
|
|
+│ ├── shared-utils/ # 共享工具函数
|
|
|
│ # ==================== 服务器包 ====================
|
|
|
-│ └── server/ # API服务器包
|
|
|
-│ ├── src/
|
|
|
-│ │ ├── api.ts # API路由导出
|
|
|
-│ │ └── index.ts # 服务器入口
|
|
|
-│ ├── tests/
|
|
|
-│ └── package.json
|
|
|
-├── scripts/ # 脚本文件目录
|
|
|
-├── web/ # Web管理后台 (Hono + React SSR)
|
|
|
+│ └── server/ # API服务器包
|
|
|
+├── scripts/ # 脚本文件目录
|
|
|
+├── tcb-shop-demo/ # TCB商城演示
|
|
|
+├── web/ # Web管理后台 (Vite + React)
|
|
|
│ ├── src/
|
|
|
-│ │ ├── client/ # 客户端代码
|
|
|
-│ │ │ ├── admin/ # 管理后台
|
|
|
-│ │ │ │ ├── components/ # 管理后台组件
|
|
|
-│ │ │ │ │ ├── AvatarSelector.tsx # 头像选择器
|
|
|
-│ │ │ │ │ ├── DataTablePagination.tsx # 表格分页
|
|
|
-│ │ │ │ │ ├── ErrorPage.tsx # 错误页面
|
|
|
-│ │ │ │ │ ├── FileSelector.tsx # 文件选择器
|
|
|
-│ │ │ │ │ ├── MinioUploader.tsx # MinIO上传器
|
|
|
-│ │ │ │ │ ├── NotFoundPage.tsx # 404页面
|
|
|
-│ │ │ │ │ └── ProtectedRoute.tsx # 路由保护
|
|
|
-│ │ │ │ ├── hooks/
|
|
|
-│ │ │ │ │ └── AuthProvider.tsx # 认证状态管理
|
|
|
-│ │ │ │ ├── layouts/
|
|
|
-│ │ │ │ │ └── MainLayout.tsx # 主布局
|
|
|
-│ │ │ │ ├── pages/
|
|
|
-│ │ │ │ │ ├── Dashboard.tsx # 仪表板
|
|
|
-│ │ │ │ │ ├── Files.tsx # 文件管理
|
|
|
-│ │ │ │ │ ├── Login.tsx # 登录页面
|
|
|
-│ │ │ │ │ └── Users.tsx # 用户管理
|
|
|
-│ │ │ │ ├── menu.tsx # 菜单配置
|
|
|
-│ │ │ │ ├── routes.tsx # 路由配置
|
|
|
-│ │ │ │ └── index.tsx # 管理后台入口
|
|
|
-│ │ │ ├── components/
|
|
|
-│ │ │ │ └── ui/ # shadcn/ui组件库
|
|
|
-│ │ │ │ ├── accordion.tsx # 手风琴组件
|
|
|
-│ │ │ │ ├── alert-dialog.tsx # 警告对话框
|
|
|
-│ │ │ │ ├── alert.tsx # 警告组件
|
|
|
-│ │ │ │ └── ... # 其他50+组件
|
|
|
-│ │ │ ├── api.ts # API客户端
|
|
|
-│ │ │ └── index.tsx # 前端入口
|
|
|
-│ │ ├── server/ # 服务器端代码 (SSR)
|
|
|
-│ │ │ ├── index.tsx # 服务器入口
|
|
|
-│ │ │ └── renderer.tsx # React渲染器
|
|
|
-│ │ └── share/ # 共享代码
|
|
|
+│ │ ├── assets/ # 静态资源
|
|
|
+│ │ ├── client/ # 客户端代码
|
|
|
+│ │ ├── server/ # 服务器端代码
|
|
|
+│ │ ├── share/ # 共享代码
|
|
|
+│ │ └── style.css # 全局样式
|
|
|
│ ├── tests/
|
|
|
-│ │ ├── e2e/ # E2E测试 (Playwright)
|
|
|
-│ │ ├── integration/ # Web集成测试
|
|
|
-│ │ │ └── client/ # 客户端集成测试
|
|
|
-│ │ └── unit/ # 单元测试
|
|
|
-│ │ └── client/ # 客户端单元测试
|
|
|
-│ │ ├── pages/ # 页面组件测试
|
|
|
-│ │ │ └── Users.test.tsx # 用户页面测试
|
|
|
-│ │ └── debug.test.tsx # 调试测试
|
|
|
+│ │ ├── e2e/ # E2E测试 (Playwright)
|
|
|
+│ │ ├── integration/ # 集成测试
|
|
|
+│ │ └── unit/ # 单元测试
|
|
|
+│ ├── public/ # 公共资源
|
|
|
│ └── package.json
|
|
|
-├── .gitignore # Git忽略文件
|
|
|
-├── .npmrc # NPM配置
|
|
|
-├── Dockerfile # Docker配置
|
|
|
-├── LICENSE # 许可证
|
|
|
-├── README.md # 项目说明
|
|
|
-├── package.json # 根项目配置
|
|
|
-├── pnpm-lock.yaml # 依赖锁定文件
|
|
|
-├── pnpm-workspace.yaml # pnpm workspace配置
|
|
|
-└── tsconfig.json # TypeScript配置
|
|
|
+├── .ai/ # AI辅助目录
|
|
|
+├── .eslintrc # ESLint配置
|
|
|
+├── .gitignore # Git忽略文件
|
|
|
+├── .npmrc # NPM配置
|
|
|
+├── CLAUDE.md # Claude开发指南
|
|
|
+├── Dockerfile # Docker配置
|
|
|
+├── cloudflared-config.yml # Cloudflared配置
|
|
|
+├── debug-print-task-issue.js # 调试脚本
|
|
|
+├── debug-print-task.js # 调试脚本
|
|
|
+├── debug-simple.js # 调试脚本
|
|
|
+├── fix-config-issue.js # 修复脚本
|
|
|
+├── fix-delay-scheduler.js # 修复脚本
|
|
|
+├── fix-delay-simple.js # 修复脚本
|
|
|
+├── fix-scheduler-autostart.js # 修复脚本
|
|
|
+├── package.json # 根项目配置
|
|
|
+├── pnpm-lock.yaml # 依赖锁定文件
|
|
|
+├── pnpm-workspace.yaml # pnpm workspace配置
|
|
|
+├── screenshot.js # 截图脚本
|
|
|
+├── system_config_mt_tenant1_insert.sql # 系统配置SQL
|
|
|
+├── test-log-cjs.cjs # 测试脚本
|
|
|
+├── test-log-fix.js # 测试脚本
|
|
|
+├── test-log-simple.js # 测试脚本
|
|
|
+├── test-print-task-log.js # 测试脚本
|
|
|
+├── test-user-consumption.js # 测试脚本
|
|
|
+├── test_schema.js # Schema测试
|
|
|
+└── tsconfig.json # TypeScript配置
|
|
|
```
|
|
|
|
|
|
## 项目结构概览
|
|
|
@@ -363,11 +212,9 @@
|
|
|
| 目录 | 用途 | 技术栈 |
|
|
|
|------|------|--------|
|
|
|
| `mini/` | 商户小程序 | Taro + React |
|
|
|
-| `mini-talent/` | 人才小程序 | Taro + React |
|
|
|
| `mini-ui-packages/` | 小程序UI组件包 | React + Taro |
|
|
|
-| `web/` | Web管理后台 | Hono + React SSR |
|
|
|
+| `web/` | Web管理后台 | Vite + React |
|
|
|
| `packages/` | 核心共享包 | Node.js + TypeScript |
|
|
|
-| `allin-packages/` | AllIn业务包 | Node.js + TypeScript |
|
|
|
| `docs/` | 项目文档 | Markdown |
|
|
|
|
|
|
### 包架构层次
|
|
|
@@ -379,6 +226,7 @@
|
|
|
业务模块层:
|
|
|
└── user-module → auth-module → file-module → geo-areas
|
|
|
└── goods-module → orders-module → merchant-module
|
|
|
+ └── mini-payment
|
|
|
└── (多租户版本: *-mt)
|
|
|
|
|
|
UI展示层:
|
|
|
@@ -388,19 +236,19 @@ UI展示层:
|
|
|
应用层:
|
|
|
└── server (API服务器)
|
|
|
└── web (Web管理后台)
|
|
|
- └── mini/mini-talent (小程序)
|
|
|
+ └── mini (商户小程序)
|
|
|
```
|
|
|
|
|
|
### 集成指南
|
|
|
|
|
|
- **文件命名**: 保持现有kebab-case命名约定
|
|
|
- **项目结构**: 采用monorepo模式,使用pnpm workspace管理多包依赖关系
|
|
|
-- **包管理**: 核心包在`packages/`,业务扩展包在`allin-packages/`,小程序UI组件在`mini-ui-packages/`
|
|
|
-- **小程序架构**: 基于Taro框架,支持多平台(微信小程序、H5等)
|
|
|
-- **Web应用架构**: 基于Hono + React SSR,使用shadcn/ui组件库
|
|
|
+- **包管理**: 核心包在`packages/`,小程序UI组件在`mini-ui-packages/`
|
|
|
+- **小程序架构**: 基于Taro框架,使用TDesign组件库
|
|
|
+- **Web应用架构**: 基于Vite + React,使用shadcn/ui组件库
|
|
|
- **模块化架构**: 采用分层包结构,支持按需安装和独立开发
|
|
|
- **多租户支持**: 核心模块和UI包都有对应的多租户版本(`-mt`后缀)
|
|
|
-- **API设计**: 使用Hono框架,RESTful API设计,支持文件分片上传
|
|
|
+- **API设计**: 使用Hono框架,RESTful API设计
|
|
|
- **数据库**: 使用PostgreSQL + TypeORM
|
|
|
- **存储**: 使用MinIO进行文件存储
|
|
|
- **测试结构**:
|
|
|
@@ -408,8 +256,9 @@ UI展示层:
|
|
|
- **业务模块包**: 每个模块包含完整的测试套件
|
|
|
- **server包**: 集成测试验证模块间协作
|
|
|
- **web应用**: 组件测试、集成测试和E2E测试
|
|
|
+ - **mini应用**: Jest单元测试
|
|
|
- **开发环境**: 多八多云端开发容器,包含Node.js 20.19.2、PostgreSQL 17、Redis 7、MinIO
|
|
|
-- **构建工具**: 使用Vite + pnpm,支持SSR构建
|
|
|
+- **构建工具**: 使用Vite + pnpm
|
|
|
|
|
|
### 架构优势
|
|
|
|
|
|
@@ -420,4 +269,4 @@ UI展示层:
|
|
|
- 更好的代码复用和维护性
|
|
|
- 独立的包版本管理
|
|
|
- 支持多租户架构
|
|
|
-- 小程序UI组件复用(rencai/yongren系列)
|
|
|
+- 小程序UI组件复用(rencai系列)
|