源码树和文件组织
版本信息
| 版本 |
日期 |
描述 |
作者 |
| 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 |
| 3.0 |
2025-10-22 |
更新为 monorepo 结构，添加 packages/server |
Winston |
实际项目结构
186-175-template-6/
├── .bmad-core/ # BMad框架配置目录
│ ├── agents/ # 代理配置
│ ├── agent-teams/ # 团队配置
│ ├── checklists/ # 检查清单
│ ├── data/ # 知识库数据
│ ├── tasks/ # 任务定义
│ ├── templates/ # 模板文件
│ ├── workflows/ # 工作流定义
│ └── core-config.yaml # 核心配置文件
├── .claude/ # Claude CLI配置
│ └── commands/ # Claude命令定义
├── .gitea/ # Gitea配置
├── .github/ # GitHub Actions配置
│ └── workflows/ # CI/CD工作流
├── .git/ # Git版本控制
├── .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/ # 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-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-management-ui-mt/ # 广告管理UI（多租户）
│ ├── advertisement-type-management-ui/ # 广告类型管理UI
│ ├── advertisement-type-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/ # 广告模块
│ ├── 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/ # 用户管理模块（多租户）
│ # ==================== 共享基础设施包 ====================
│ ├── shared-crud/ # 通用CRUD基础设施
│ ├── shared-test-util/ # 测试基础设施
│ ├── shared-types/ # 共享类型定义
│ ├── shared-ui-components/ # 共享UI组件
│ ├── shared-utils/ # 共享工具函数
│ # ==================== 服务器包 ====================
│ └── server/ # API服务器包
├── scripts/ # 脚本文件目录
├── tcb-shop-demo/ # TCB商城演示
├── web/ # Web管理后台 (Vite + React)
│ ├── src/
│ │ ├── assets/ # 静态资源
│ │ ├── client/ # 客户端代码
│ │ ├── server/ # 服务器端代码
│ │ ├── share/ # 共享代码
│ │ └── style.css # 全局样式
│ ├── tests/
│ │ ├── e2e/ # E2E测试 (Playwright)
│ │ ├── integration/ # 集成测试
│ │ └── unit/ # 单元测试
│ ├── public/ # 公共资源
│ └── package.json
├── .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配置
项目结构概览
主要目录分类
| 目录 |
用途 |
技术栈 |
mini/ |
商户小程序 |
Taro + React |
mini-ui-packages/ |
小程序UI组件包 |
React + Taro |
web/ |
Web管理后台 |
Vite + React |
packages/ |
核心共享包 |
Node.js + TypeScript |
docs/ |
项目文档 |
Markdown |
包架构层次
基础设施层:
└── shared-types → shared-utils → shared-crud → shared-test-util
业务模块层:
└── user-module → auth-module → file-module → geo-areas
└── goods-module → orders-module → merchant-module
└── mini-payment
└── (多租户版本: *-mt)
UI展示层:
└── user-management-ui → auth-management-ui → file-management-ui
└── (多租户版本: *-ui-mt)
应用层:
└── server (API服务器)
└── web (Web管理后台)
└── mini (商户小程序)
集成指南
- 文件命名: 保持现有kebab-case命名约定
- 项目结构: 采用monorepo模式，使用pnpm workspace管理多包依赖关系
- 包管理: 核心包在
packages/，小程序UI组件在mini-ui-packages/
- 小程序架构: 基于Taro框架，使用TDesign组件库
- Web应用架构: 基于Vite + React，使用shadcn/ui组件库
- 模块化架构: 采用分层包结构，支持按需安装和独立开发
- 多租户支持: 核心模块和UI包都有对应的多租户版本（
-mt后缀）
- API设计: 使用Hono框架，RESTful API设计
- 数据库: 使用PostgreSQL + TypeORM
- 存储: 使用MinIO进行文件存储
- 测试结构:
- 基础设施包: 每个包独立的单元测试和集成测试
- 业务模块包: 每个模块包含完整的测试套件
- server包: 集成测试验证模块间协作
- web应用: 组件测试、集成测试和E2E测试
- mini应用: Jest单元测试
- 开发环境: 多八多云端开发容器，包含Node.js 20.19.2、PostgreSQL 17、Redis 7、MinIO
- 构建工具: 使用Vite + pnpm
架构优势
- 清晰的模块边界和职责分离
- 支持按需安装，减少包体积
- 基础设施和业务逻辑分离
- 统一的测试模式和工具
- 更好的代码复用和维护性
- 独立的包版本管理
- 支持多租户架构
- 小程序UI组件复用（rencai系列）
