项目目录树

# 项目目录树

> **文档版本**: v1.1.0
> **最后更新**: 2025-01-15
> **用途**: 记录项目中每个文件和目录的用途，便于 AI 快速理解项目结构

---

## &#128193; 根目录配置文件

```
/workspace/projects/
├── &#128196; package.json                    # 项目依赖配置，定义所有 npm scripts
├── &#128196; package-lock.json               # 依赖锁定文件（自动生成）
├── &#128196; pnpm-lock.yaml                  # pnpm 依赖锁定文件
├── &#128196; tsconfig.json                   # TypeScript 编译配置
├── &#128196; tailwind.config.ts              # Tailwind CSS 配置
├── &#128196; postcss.config.mjs              # PostCSS 配置
├── &#128196; components.json                 # shadcn/ui 组件配置
├── &#128196; .prettierrc.js                  # Prettier 格式化配置
├── &#128196; .eslintrc.json                  # ESLint 代码检查配置
├── &#128196; .editorconfig                   # 编辑器配置
├── &#128196; .gitignore                      # Git 忽略文件配置
├── &#128196; .clinerules                     # AI 开发铁律文件（核心规范）
├── &#128196; .coze                           # Coze 部署配置
├── &#128196; ecosystem.config.cjs            # PM2 进程管理配置
├── &#128196; drizzle.config.ts               # Drizzle ORM 配置
├── &#128196; next.config.ts                  # Next.js 框架配置
├── &#128196; middleware.ts                   # Next.js 中间件（路由守卫）
├── &#128196; README.md                       # 项目说明文档
├── &#128196; PROJECT.md                      # 项目详细说明
├── &#128196; CHANGELOG.md                    # 根目录变更日志（软链接）
├── &#128196; COMPRESSED_SUMMARY.md           # 压缩摘要软链接
├── &#128196; jest.config.js                  # Jest 测试配置
├── &#128196; playwright.config.ts            # Playwright E2E 测试配置
├── &#128196; jest.setup.js                   # Jest 测试环境设置
└── &#128196; .knowledge-import-state.json    # 知识库导入状态记录
```

---

## &#128193; .bug-tracker/ - Bug 跟踪系统

```
/workspace/projects/.bug-tracker/
├── &#128196; bugs.json                       # Bug 记录数据库
└── &#128196; fixes.json                      # Bug 修复记录
```

**用途**: 存储项目运行时产生的 Bug 记录和修复历史，支持错误自动学习和规范升级。

---

## &#128193; .husky/ - Git Hooks

```
/workspace/projects/.husky/
├── &#128196; pre-commit                      # 提交前检查钩子
├── &#128196; post-commit                     # 提交后处理钩子
├── &#128196; commit-msg                      # 提交信息验证钩子
└── &#128196; _/                              # Husky 内部文件
    └── &#128196; husky.sh                    # Husky 脚本
```

**用途**: Git 钩子管理，实现代码质量检查、红线检测、错误学习等自动化流程。

---

## &#128193; assets/ - 静态资源

```
/workspace/projects/assets/
└── &#128193; (各类静态资源文件)               # 图片、图标等静态资源
```

**用途**: 存放项目所需的静态资源文件。

---

## &#128193; data/ - 数据存储

```
/workspace/projects/data/
└── &#128193; backups/                        # 数据备份目录
    └── &#128196; *.json                      # 各类数据备份文件
```

**用途**: 本地数据存储和备份。

---

## &#128193; data-export/ - 数据导出

```
/workspace/projects/data-export/
├── &#128196; export-summary.json             # 导出汇总信息
├── &#128196; saas_companies.json             # 企业数据导出
├── &#128196; saas_users.json                 # 用户数据导出
├── &#128196; saas_tenants.json               # 租户数据导出
├── &#128196; salary_slips.json               # 工资条数据导出
├── &#128196; salary_slip_details.json        # 工资条明细导出
├── &#128196; salary_slip_sends.json          # 工资条发送记录导出
├── &#128196; role_permissions.json           # 角色权限数据导出
├── &#128196; email_templates.json            # 邮件模板导出
├── &#128196; email_send_records.json         # 邮件发送记录导出
├── &#128196; email_global_variables.json     # 邮件全局变量导出
├── &#128196; email_trigger_configs.json      # 邮件触发配置导出
├── &#128196; smtp_configs.json               # SMTP 配置导出
├── &#128196; sms_templates.json              # 短信模板导出
├── &#128196; sms_send_records.json           # 短信发送记录导出
├── &#128196; sms_service_config.json         # 短信服务配置导出
├── &#128196; sms_verification_codes.json     # 短信验证码记录导出
├── &#128196; notification_settings.json      # 通知设置导出
├── &#128196; login_page_configs.json         # 登录页配置导出
├── &#128196; global_payment_configs.json     # 全局支付配置导出
├── &#128196; platform_config.json            # 平台配置导出
├── &#128196; system_settings.json            # 系统设置导出
├── &#128196; market_categories.json          # 应用市场分类导出
├── &#128196; market_products.json            # 应用市场产品导出
├── &#128196; media_categories.json           # 媒体分类导出
├── &#128196; media_resources.json            # 媒体资源导出
├── &#128196; partners.json                   # 合作伙伴数据导出
├── &#128196; company_apps.json               # 企业应用数据导出
└── &#128196; backups.json                    # 备份记录导出
```

**用途**: 数据库数据的 JSON 导出文件，用于数据迁移、备份和恢复。

---

## &#128193; drizzle/ - 数据库迁移

```
/workspace/projects/drizzle/
├── &#128193; meta/                           # 迁移元数据
│   └── &#128196; *_journal.json              # 迁移日志记录
├── &#128193; migrations/                     # SQL 迁移文件
│   ├── &#128196; *.sql                       # 数据库迁移脚本
│   └── &#128193; archive/                    # 历史迁移归档
│       └── &#128196; *.sql                   # 归档的迁移文件
└── &#128196; migrations.sql                  # 完整迁移 SQL
```

**用途**: Drizzle ORM 数据库版本管理，存储数据库结构变更的迁移文件。

---

## &#128193; logs/ - 日志目录

```
/workspace/projects/logs/
└── &#128196; *.log                           # 各类运行日志文件
```

**用途**: 存放项目运行时产生的日志文件。

---

## &#128193; public/ - 公共静态资源

```
/workspace/projects/public/
├── &#128193; downloads/                      # 下载文件目录
│   └── &#128196; *                           # 用户可下载的文件
├── &#128193; sdk/                            # SDK 文件
│   └── &#128196; *                           # SDK 相关文件
└── &#128193; uploads/                        # 用户上传文件
    └── &#128193; media/                      # 媒体文件
        └── &#128193; general/                # 通用媒体文件
            └── &#128196; *                   # 图片、视频等媒体资源
```

**用途**: 存放公共静态资源，可直接通过 URL 访问。

---

## &#128193; scripts/ - 脚本工具

```
/workspace/projects/scripts/
├── &#128196; README.md                       # 脚本工具完整索引 &#128221;
├── &#128196; build.sh                        # 开发环境构建脚本
├── &#128196; build-prod.sh                   # 生产环境构建脚本
├── &#128196; build-verify.sh                 # 构建验证脚本
├── &#128196; dev.sh                          # 开发服务器启动脚本
├── &#128196; start.sh                        # 生产服务器启动脚本
├── &#128196; precheck.ts                     # 开发前预检脚本（核心）
├── &#128196; release.ts                      # 版本发布脚本
├── &#128196; daily-release-new.ts            # 每日自动发布脚本
├── &#128196; generate-changelog.ts           # 变更日志生成脚本
├── &#128196; organize-changelog.ts           # 变更日志整理脚本
├── &#128196; fix-doc-dates.ts                # 文档日期修复脚本
├── &#128196; generate.js                     # 代码生成器（页面/API）
├── &#128196; git-hooks.js                    # Git 钩子安装管理
├── &#128196; bug-db.js                       # Bug 数据库管理
├── &#128196; bug-record.js                   # Bug 记录脚本
├── &#128196; bug-auto.js                     # Bug 自动处理脚本
├── &#128196; bug-update-specs.js             # Bug 规范升级脚本
├── &#128196; error-upgrade.js                # 错误升级脚本
├── &#128196; learn-error.ts                  # 错误学习脚本
├── &#128196; redline-check.ts                # 红线检测脚本
├── &#128196; decision-record.ts              # 决策记录脚本
├── &#128196; record-best-practice.ts         # 最佳实践记录脚本
├── &#128196; memory-manager.ts               # 记忆管理脚本
├── &#128196; sync-memory.ts                  # 记忆同步脚本
├── &#128196; auto-memory.ts                  # 自动记忆脚本
├── &#128196; backup-memory.ts                # 记忆备份脚本
├── &#128196; import-documents.ts             # 文档导入知识库脚本
├── &#128196; export-data.ts                  # 数据导出脚本
├── &#128196; import-data.ts                  # 数据导入脚本
├── &#128196; backup-data.ts                  # 数据备份脚本
├── &#128196; seed-data.ts                    # 种子数据脚本
├── &#128196; auto-sync.ts                    # 自动同步脚本
├── &#128196; auto-release-install.sh         # 自动发布安装脚本
├── &#128196; setup-git-credentials.sh        # Git 凭据配置脚本
├── &#128196; session-start-check.sh          # 会话启动检查脚本
├── &#128196; full-check-test-fix-publish.sh  # 完整检查发布脚本
├── &#128196; auto-fix-all.sh                 # 自动修复脚本
├── &#128196; install-quality-tools.sh        # 质量工具安装脚本
├── &#128196; rollback-prod.sh                # 生产回滚脚本
├── &#128196; test-api.sh                     # API 测试脚本
├── &#128196; pre-dev-check.sh                # 开发前检查脚本
├── &#128196; post-dev-check.sh               # 开发后检查脚本
├── &#128196; check-and-test.sh               # 检查测试脚本
├── &#128196; push-quick.sh                   # 快速推送脚本
├── &#128196; publish-all.sh                  # 全量发布脚本
├── &#128196; read-ai-memory.sh               # 读取 AI 记忆脚本
├── &#128196; dev-workflow.js                 # 开发工作流脚本
├── &#128196; check-common-bugs.js            # 常见 Bug 检查脚本
├── &#128193; cron/                           # 定时任务脚本
│   ├── &#128196; monitor-partitions.ts       # 分区监控脚本
│   ├── &#128196; migrate-default-partitions.ts # 默认分区迁移脚本
│   ├── &#128196; check-alerts.ts             # 告警检查脚本
│   └── &#128196; memory-maintenance.ts       # 记忆维护脚本
├── &#128193; dev-tests/                      # 开发测试脚本
│   └── &#128196; *                           # 各种测试脚本
└── &#128193; git-hooks/                      # Git 钩子脚本
    ├── &#128196; pre-commit                  # 提交前钩子
    ├── &#128196; post-commit                 # 提交后钩子
    └── &#128196; commit-msg                  # 提交信息钩子
```

**用途**: 存放各类自动化脚本，包括构建、部署、数据管理、记忆同步、错误学习等。

---

## &#128193; templates/ - 模板目录

```
/workspace/projects/templates/
└── &#128196; *                               # 各类模板文件
```

**用途**: 存放代码生成模板和文档模板。

---

## &#128193; tmp/ - 临时文件

```
/workspace/projects/tmp/
└── &#128196; *                               # 临时文件
```

**用途**: 存放临时文件，可安全删除。

---

## &#128193; src/ - 源代码目录（核心）

**索引文档**: [`src/README.md`](../src/README.md) - 源码完整索引，包含分层架构说明 &#128221;

### &#128193; src/app/ - Next.js App Router 页面

```
/workspace/projects/src/app/
├── &#128196; layout.tsx                      # 根布局组件
├── &#128196; page.tsx                        # 首页
├── &#128196; globals.css                     # 全局样式
├── &#128196; not-found.tsx                   # 404 页面
├── &#128196; error.tsx                       # 全局错误页面
├── &#128196; loading.tsx                     # 全局加载页面
│
├── &#128193; (auth)/                         # 认证相关页面（路由组）
│   ├── &#128196; layout.tsx                  # 认证页布局
│   ├── &#128193; login/                      # 登录页
│   │   └── &#128196; page.tsx                # 登录页面
│   ├── &#128193; register/                   # 注册页
│   │   └── &#128196; page.tsx                # 注册页面
│   ├── &#128193; forgot-password/            # 忘记密码
│   │   └── &#128196; page.tsx                # 忘记密码页面
│   └── &#128193; reset-password/             # 重置密码
│       └── &#128196; page.tsx                # 重置密码页面
│
├── &#128193; academy/                        # 薪税学院模块
│   ├── &#128196; page.tsx                    # 学院首页
│   └── &#128193; [id]/                       # 课程详情页
│       └── &#128196; page.tsx                # 课程详情页面
│
├── &#128193; employee/                       # 员工端页面
│   ├── &#128196; page.tsx                    # 员工首页
│   ├── &#128193; complete-info/              # 完善信息
│   │   └── &#128196; page.tsx                # 完善信息页面
│   ├── &#128193; salary-slip/                # 工资条
│   │   └── &#128196; page.tsx                # 工资条列表
│   └── &#128193; profile/                    # 个人中心
│       └── &#128196; page.tsx                # 个人信息页面
│
├── &#128193; tenant/                         # 租户端页面（企业）
│   ├── &#128196; page.tsx                    # 租户首页（仪表盘）
│   ├── &#128193; employees/                  # 人事管理
│   │   ├── &#128196; page.tsx                # 员工列表
│   │   └── &#128193; [id]/                   # 员工详情
│   │       └── &#128196; page.tsx            # 员工详情页
│   ├── &#128193; salary-slips/               # 工资条管理
│   │   ├── &#128196; page.tsx                # 工资条列表
│   │   └── &#128193; [id]/                   # 工资条详情
│   │       └── &#128196; page.tsx            # 工资条详情页
│   ├── &#128193; salary-config/              # 工资配置
│   │   └── &#128196; page.tsx                # 工资配置页面
│   ├── &#128193; apps/                       # 企业应用
│   │   └── &#128196; page.tsx                # 应用管理页面
│   ├── &#128193; partners/                   # 合作伙伴
│   │   └── &#128196; page.tsx                # 合作伙伴管理
│   ├── &#128193; orders/                     # 订单管理
│   │   └── &#128196; page.tsx                # 订单列表
│   ├── &#128193; settings/                   # 企业设置
│   │   ├── &#128196; page.tsx                # 设置首页
│   │   ├── &#128193; basic/                  # 基础设置
│   │   │   └── &#128196; page.tsx            # 基础信息设置
│   │   ├── &#128193; brand/                  # 品牌设置
│   │   │   └── &#128196; page.tsx            # 品牌形象设置
│   │   ├── &#128193; security/               # 安全设置
│   │   │   └── &#128196; page.tsx            # 安全配置页面
│   │   ├── &#128193; notification/           # 通知设置
│   │   │   └── &#128196; page.tsx            # 通知配置页面
│   │   ├── &#128193; data/                   # 数据管理
│   │   │   └── &#128196; page.tsx            # 数据管理页面
│   │   ├── &#128193; data-management/        # 数据管理（新）
│   │   │   └── &#128196; page.tsx            # 数据管理页面
│   │   ├── &#128193; backup/                 # 数据备份
│   │   │   └── &#128196; page.tsx            # 备份管理页面
│   │   ├── &#128193; media/                  # 媒体管理
│   │   │   └── &#128196; page.tsx            # 媒体资源管理
│   │   ├── &#128193; seo/                    # SEO 设置
│   │   │   └── &#128196; page.tsx            # SEO 配置页面
│   │   ├── &#128193; login-config/           # 登录配置
│   │   │   └── &#128196; page.tsx            # 登录页配置
│   │   ├── &#128193; program-backup/         # 程序备份
│   │   │   └── &#128196; page.tsx            # 程序备份页面
│   │   └── &#128193; integrations/           # 集成设置
│   │       ├── &#128196; page.tsx            # 集成总览
│   │       ├── &#128193; email/              # 邮件集成
│   │       │   └── &#128196; page.tsx        # 邮件服务配置
│   │       ├── &#128193; sms/                # 短信集成
│   │       │   └── &#128196; page.tsx        # 短信服务配置
│   │       ├── &#128193; storage/            # 存储集成
│   │       │   └── &#128196; page.tsx        # 存储服务配置
│   │       └── &#128193; payment/            # 支付集成
│   │           └── &#128196; page.tsx        # 支付服务配置
│   └── &#128193; finance/                    # 财务管理
│       └── &#128196; page.tsx                # 财务概览页面
│
├── &#128193; agent/                          # 代理商端页面
│   ├── &#128196; page.tsx                    # 代理商首页
│   ├── &#128193; partners/                   # 合作伙伴管理
│   │   └── &#128196; page.tsx                # 合作伙伴列表
│   ├── &#128193; commission/                 # 佣金管理
│   │   └── &#128196; page.tsx                # 佣金列表
│   └── &#128193; orders/                     # 订单管理
│       └── &#128196; page.tsx                # 订单列表
│
├── &#128193; admin/                          # 平台管理端页面
│   ├── &#128196; page.tsx                    # 管理后台首页
│   ├── &#128193; dashboard/                  # 仪表盘
│   │   └── &#128196; page.tsx                # 数据概览仪表盘
│   ├── &#128193; companies/                  # 企业管理
│   │   └── &#128196; page.tsx                # 企业列表
│   ├── &#128193; users/                      # 用户管理
│   │   ├── &#128196; page.tsx                # 用户列表
│   │   ├── &#128193; [id]/                   # 用户详情
│   │   │   └── &#128196; page.tsx            # 用户详情页
│   │   ├── &#128193; potential/              # 潜在用户
│   │   │   └── &#128196; page.tsx            # 潜在用户列表
│   │   └── &#128193; tags/                   # 用户标签
│   │       └── &#128196; page.tsx            # 标签管理
│   ├── &#128193; permissions/                # 权限管理
│   │   └── &#128196; page.tsx                # 权限配置
│   ├── &#128193; orders/                     # 订单管理
│   │   └── &#128196; page.tsx                # 订单列表
│   ├── &#128193; payments/                   # 支付管理
│   │   └── &#128196; page.tsx                # 支付记录
│   ├── &#128193; finance/                    # 财务管理
│   │   └── &#128196; page.tsx                # 财务报表
│   ├── &#128193; packages/                   # 套餐管理
│   │   └── &#128196; page.tsx                # 套餐列表
│   ├── &#128193; partners/                   # 合作伙伴管理
│   │   └── &#128196; page.tsx                # 合作伙伴列表
│   ├── &#128193; market/                     # 应用市场
│   │   ├── &#128196; page.tsx                # 市场首页
│   │   ├── &#128193; products/               # 产品管理
│   │   │   └── &#128196; page.tsx            # 产品列表
│   │   └── &#128193; services/               # 服务管理
│   │       └── &#128196; page.tsx            # 服务列表
│   ├── &#128193; addons/                     # 插件管理
│   │   └── &#128196; page.tsx                # 插件列表
│   ├── &#128193; integrations/               # 集成管理
│   │   └── &#128196; page.tsx                # 集成配置
│   ├── &#128193; email/                      # 邮件管理
│   │   └── &#128196; page.tsx                # 邮件服务管理
│   ├── &#128193; sms/                        # 短信管理
│   │   └── &#128196; page.tsx                # 短信服务管理
│   ├── &#128193; wechat-mp/                  # 微信公众号管理
│   │   └── &#128196; page.tsx                # 公众号配置
│   ├── &#128193; wechat-work/                # 企业微信管理
│   │   └── &#128196; page.tsx                # 企业微信配置
│   ├── &#128193; wechat-work-provider/       # 企业微信服务商
│   │   └── &#128196; page.tsx                # 服务商配置
│   ├── &#128193; miniprogram/                # 小程序管理
│   │   └── &#128196; page.tsx                # 小程序配置
│   ├── &#128193; statistics/                 # 统计分析
│   │   └── &#128196; page.tsx                # 数据统计
│   ├── &#128193; crm/                        # CRM 管理
│   │   └── &#128196; page.tsx                # CRM 首页
│   ├── &#128193; changelog/                  # 变更日志
│   │   └── &#128196; page.tsx                # 变更日志管理
│   ├── &#128193; system/                     # 系统管理
│   │   └── &#128196; page.tsx                # 系统配置
│   ├── &#128193; settings/                   # 平台设置
│   │   ├── &#128196; page.tsx                # 设置首页
│   │   ├── &#128193; basic/                  # 基础设置
│   │   │   └── &#128196; page.tsx            # 基础配置
│   │   ├── &#128193; brand/                  # 品牌设置
│   │   │   └── &#128196; page.tsx            # 品牌配置
│   │   ├── &#128193; security/               # 安全设置
│   │   │   └── &#128196; page.tsx            # 安全配置
│   │   ├── &#128193; notification/           # 通知设置
│   │   │   └── &#128196; page.tsx            # 通知配置
│   │   ├── &#128193; data/                   # 数据管理
│   │   │   └── &#128196; page.tsx            # 数据配置
│   │   ├── &#128193; data-management/        # 数据管理（新）
│   │   │   └── &#128196; page.tsx            # 数据管理
│   │   ├── &#128193; backup/                 # 备份管理
│   │   │   └── &#128196; page.tsx            # 备份配置
│   │   ├── &#128193; media/                  # 媒体管理
│   │   │   └── &#128196; page.tsx            # 媒体配置
│   │   ├── &#128193; seo/                    # SEO 设置
│   │   │   └── &#128196; page.tsx            # SEO 配置
│   │   ├── &#128193; login-config/           # 登录配置
│   │   │   └── &#128196; page.tsx            # 登录页配置
│   │   ├── &#128193; program-backup/         # 程序备份
│   │   │   └── &#128196; page.tsx            # 程序备份
│   │   └── &#128193; integrations/           # 集成设置
│   │       ├── &#128196; page.tsx            # 集成总览
│   │       ├── &#128193; email/              # 邮件集成
│   │       │   └── &#128196; page.tsx        # 邮件配置
│   │       ├── &#128193; sms/                # 短信集成
│   │       │   └── &#128196; page.tsx        # 短信配置
│   │       ├── &#128193; storage/            # 存储集成
│   │       │   └── &#128196; page.tsx        # 存储配置
│   │       └── &#128193; payment/            # 支付集成
│   │           └── &#128196; page.tsx        # 支付配置
│   ├── &#128193; memory/                     # AI 记忆管理
│   │   ├── &#128196; page.tsx                # 记忆管理首页
│   │   ├── &#128193; list/                   # 记忆列表
│   │   │   └── &#128196; page.tsx            # 记忆条目列表
│   │   ├── &#128193; dashboard/              # 记忆仪表盘
│   │   │   └── &#128196; page.tsx            # 记忆统计
│   │   ├── &#128193; backups/                # 记忆备份
│   │   │   └── &#128196; page.tsx            # 备份管理
│   │   ├── &#128193; cloud-knowledge/        # 云知识库
│   │   │   └── &#128196; page.tsx            # 云知识管理
│   │   ├── &#128193; project-knowledge/      # 项目知识库
│   │   │   └── &#128196; page.tsx            # 项目知识管理
│   │   └── &#128193; vector-knowledge/       # 向量知识库
│   │       └── &#128196; page.tsx            # 向量检索管理
│   ├── &#128193; open-platform/              # 开放平台管理
│   │   ├── &#128196; page.tsx                # 开放平台首页
│   │   ├── &#128193; overview/               # 平台概览
│   │   │   └── &#128196; page.tsx            # 概览页面
│   │   ├── &#128193; applications/           # 应用管理
│   │   ├── &#128193; api-keys/               # API 密钥管理
│   │   ├── &#128193; permissions/            # 权限管理
│   │   ├── &#128193; webhooks/               # Webhook 管理
│   │   ├── &#128193; logs/                   # 日志管理
│   │   ├── &#128193; analytics/              # 统计分析
│   │   └── &#128193; docs/                   # API 文档
│   │       └── &#128196; page.tsx            # 文档页面
│   └── &#128193; openplatform/               # 开放平台（旧）
│       ├── &#128196; page.tsx                # 开放平台首页
│       └── &#128193; docs/                   # API 文档
│           └── &#128196; page.tsx            # 文档页面
```

### &#128193; src/app/api/ - API 路由（后端接口）

```
/workspace/projects/src/app/api/
├── &#128193; auth/                           # 认证相关 API
│   └── &#128193; login/                      # 登录接口
│       └── &#128196; route.ts                # POST /api/auth/login
│
├── &#128193; admin/                          # 平台管理 API
│   ├── &#128193; database/                   # 数据库管理
│   │   └── &#128193; optimize/               # 数据库优化
│   │       └── &#128196; route.ts            # POST /api/admin/database/optimize
│   ├── &#128193; users/                      # 用户管理 API
│   │   ├── &#128196; route.ts                # GET/POST /api/admin/users
│   │   ├── &#128193; [id]/                   # 单个用户操作
│   │   │   └── &#128196; route.ts            # GET/PUT/DELETE /api/admin/users/[id]
│   │   ├── &#128193; tags/                   # 用户标签
│   │   │   └── &#128196; route.ts            # GET/POST /api/admin/users/tags
│   │   ├── &#128193; potential/              # 潜在用户
│   │   │   └── &#128196; route.ts            # GET /api/admin/users/potential
│   │   └── &#128193; batch/                  # 批量操作
│   │       └── &#128196; route.ts            # POST /api/admin/users/batch
│   └── &#128193; open-platform/              # 开放平台 API
│       ├── &#128193; api-keys/               # API 密钥管理
│       │   ├── &#128196; route.ts            # GET/POST /api/admin/open-platform/api-keys
│       │   └── &#128193; [id]/               # 单个密钥操作
│       │       ├── &#128196; route.ts        # GET/DELETE
│       │       ├── &#128193; disable/        # 禁用密钥
│       │       │   └── &#128196; route.ts    # POST /api/admin/open-platform/api-keys/[id]/disable
│       │       ├── &#128193; enable/         # 启用密钥
│       │       │   └── &#128196; route.ts    # POST
│       │       └── &#128193; rotate/         # 轮换密钥
│       │           └── &#128196; route.ts    # POST
│       ├── &#128193; apps/                   # 应用管理
│       │   ├── &#128196; route.ts            # GET/POST
│       │   └── &#128193; [id]/               # 单个应用操作
│       │       ├── &#128196; route.ts        # GET/PUT/DELETE
│       │       ├── &#128193; approve/        # 审批通过
│       │       │   └── &#128196; route.ts    # POST
│       │       └── &#128193; reject/         # 审批拒绝
│       │           └── &#128196; route.ts    # POST
│       ├── &#128193; permissions/            # 权限管理
│       │   ├── &#128196; route.ts            # GET/POST
│       │   └── &#128193; [id]/               # 单个权限
│       │       └── &#128196; route.ts        # GET/PUT/DELETE
│       └── &#128193; logs/                   # 日志管理
│           ├── &#128196; route.ts            # GET
│           └── &#128193; [id]/               # 单条日志
│               └── &#128196; route.ts        # GET
│
├── &#128193; apps/                           # 企业应用 API
│   └── &#128196; route.ts                    # GET/POST /api/apps
│
├── &#128193; ai-memory/                      # AI 记忆 API
│   └── &#128193; search/                     # 记忆搜索
│       └── &#128196; route.ts                # POST /api/ai-memory/search
│
├── &#128193; commission/                     # 佣金 API
│   ├── &#128193; records/                    # 佣金记录
│   │   └── &#128196; route.ts                # GET/POST /api/commission/records
│   └── &#128193; rules/                      # 佣金规则
│       └── &#128196; route.ts                # GET/POST /api/commission/rules
│
├── &#128193; companies/                      # 企业 API
│   └── &#128196; route.ts                    # GET/POST /api/companies
│
├── &#128193; email/                          # 邮件服务 API
│   ├── &#128193; send/                       # 发送邮件
│   │   └── &#128196; route.ts                # POST /api/email/send
│   ├── &#128193; templates/                  # 邮件模板
│   │   └── &#128196; route.ts                # GET/POST /api/email/templates
│   └── &#128193; config/                     # 邮件配置
│       └── &#128196; route.ts                # GET/PUT /api/email/config
│
├── &#128193; employees/                      # 员工 API
│   ├── &#128196; route.ts                    # GET/POST /api/employees
│   └── &#128193; [id]/                       # 单个员工操作
│       └── &#128196; route.ts                # GET/PUT/DELETE /api/employees/[id]
│
├── &#128193; finance/                        # 财务 API
│   └── &#128196; route.ts                    # GET /api/finance
│
├── &#128193; license/                        # 授权 API
│   └── &#128196; route.ts                    # GET/POST /api/license
│
├── &#128193; media/                          # 媒体资源 API
│   ├── &#128196; route.ts                    # GET/POST /api/media
│   └── &#128193; upload/                     # 文件上传
│       └── &#128196; route.ts                # POST /api/media/upload
│
├── &#128193; memory/                         # 记忆管理 API
│   ├── &#128196; route.ts                    # GET/POST /api/memory
│   ├── &#128193; backup/                     # 备份管理
│   │   └── &#128196; route.ts                # GET/POST /api/memory/backup
│   ├── &#128193; sync/                       # 同步管理
│   │   └── &#128196; route.ts                # POST /api/memory/sync
│   └── &#128193; export/                     # 导出管理
│       └── &#128196; route.ts                # GET/POST /api/memory/export
│
├── &#128193; notifications/                  # 通知 API
│   └── &#128196; route.ts                    # GET/POST /api/notifications
│
├── &#128193; open-platform/                  # 开放平台 API（对外）
│   ├── &#128196; route.ts                    # GET /api/open-platform
│   ├── &#128193; apps/                       # 应用接口
│   │   └── &#128196; route.ts                # GET/POST
│   ├── &#128193; auth/                       # 授权接口
│   │   └── &#128196; route.ts                # POST
│   └── &#128193; webhooks/                   # Webhook 接口
│       └── &#128196; route.ts                # POST
│
├── &#128193; orders/                         # 订单 API
│   ├── &#128196; route.ts                    # GET/POST /api/orders
│   └── &#128193; [id]/                       # 单个订单
│       └── &#128196; route.ts                # GET/PUT /api/orders/[id]
│
├── &#128193; partners/                       # 合作伙伴 API
│   ├── &#128196; route.ts                    # GET/POST /api/partners
│   └── &#128193; [id]/                       # 单个合作伙伴
│       └── &#128196; route.ts                # GET/PUT/DELETE
│
├── &#128193; payment/                        # 支付 API
│   ├── &#128196; route.ts                    # POST /api/payment
│   ├── &#128193; callback/                   # 支付回调
│   │   └── &#128196; route.ts                # POST /api/payment/callback
│   └── &#128193; refund/                     # 退款
│       └── &#128196; route.ts                # POST /api/payment/refund
│
├── &#128193; permissions/                    # 权限 API
│   └── &#128196; route.ts                    # GET/POST /api/permissions
│
├── &#128193; project-memory/                 # 项目记忆 API
│   ├── &#128196; route.ts                    # GET/POST /api/project-memory
│   ├── &#128193; context/                    # 上下文获取
│   │   └── &#128196; route.ts                # GET
│   ├── &#128193; maintenance/                # 维护操作
│   │   └── &#128196; route.ts                # POST
│   ├── &#128193; export/                     # 导出记忆
│   │   └── &#128196; route.ts                # GET/POST
│   └── &#128193; stats/                      # 统计信息
│       └── &#128196; route.ts                # GET
│
├── &#128193; salary-config/                  # 工资配置 API
│   └── &#128196; route.ts                    # GET/POST /api/salary-config
│
├── &#128193; salary-slips/                   # 工资条 API
│   ├── &#128196; route.ts                    # GET/POST /api/salary-slips
│   ├── &#128193; [id]/                       # 单个工资条
│   │   └── &#128196; route.ts                # GET/PUT/DELETE
│   ├── &#128193; batch/                      # 批量操作
│   │   └── &#128196; route.ts                # POST
│   ├── &#128193; import/                     # 导入
│   │   └── &#128196; route.ts                # POST
│   ├── &#128193; export/                     # 导出
│   │   └── &#128196; route.ts                # GET
│   └── &#128193; send/                       # 发送
│       └── &#128196; route.ts                # POST
│
├── &#128193; sms/                            # 短信服务 API
│   ├── &#128193; send/                       # 发送短信
│   │   └── &#128196; route.ts                # POST /api/sms/send
│   ├── &#128193; templates/                  # 短信模板
│   │   └── &#128196; route.ts                # GET/POST
│   └── &#128193; config/                     # 短信配置
│       └── &#128196; route.ts                # GET/PUT
│
├── &#128193; storage/                        # 存储服务 API
│   ├── &#128196; route.ts                    # GET/POST /api/storage
│   ├── &#128193; upload/                     # 上传文件
│   │   └── &#128196; route.ts                # POST
│   ├── &#128193; presign/                    # 预签名 URL
│   │   └── &#128196; route.ts                # POST
│   └── &#128193; delete/                     # 删除文件
│       └── &#128196; route.ts                # POST
│
├── &#128193; survey/                         # 问卷调查 API
│   └── &#128196; route.ts                    # GET/POST /api/survey
│
├── &#128193; system/                         # 系统管理 API
│   └── &#128196; route.ts                    # GET/POST /api/system
│
├── &#128193; tenants/                        # 租户 API
│   ├── &#128196; route.ts                    # GET/POST /api/tenants
│   └── &#128193; [id]/                       # 单个租户
│       └── &#128196; route.ts                # GET/PUT/DELETE
│
├── &#128193; unified-config/                 # 统一配置 API
│   ├── &#128196; route.ts                    # GET/POST /api/unified-config
│   ├── &#128193; batch/                      # 批量操作
│   │   └── &#128196; route.ts                # POST
│   └── &#128193; inherit/                    # 继承查询
│       └── &#128196; route.ts                # GET
│
├── &#128193; upload/                         # 文件上传 API
│   └── &#128196; route.ts                    # POST /api/upload
│
├── &#128193; users/                          # 用户 API
│   ├── &#128196; route.ts                    # GET/POST /api/users
│   └── &#128193; [id]/                       # 单个用户
│       └── &#128196; route.ts                # GET/PUT/DELETE
│
├── &#128193; webhook/                        # Webhook API
│   └── &#128196; route.ts                    # POST /api/webhook
│
└── &#128193; wechat/                         # 微信相关 API
    ├── &#128193; mp/                         # 公众号
    │   ├── &#128196; route.ts                # GET/POST
    │   └── &#128193; callback/               # 回调接口
    │       └── &#128196; route.ts            # GET/POST
    ├── &#128193; mini/                       # 小程序
    │   ├── &#128196; route.ts                # GET/POST
    │   └── &#128193; login/                  # 小程序登录
    │       └── &#128196; route.ts            # POST
    └── &#128193; work/                       # 企业微信
        ├── &#128196; route.ts                # GET/POST
        └── &#128193; callback/               # 回调接口
            └── &#128196; route.ts            # GET/POST
```

### &#128193; src/components/ - React 组件库

```
/workspace/projects/src/components/
├── &#128193; ui/                             # shadcn/ui 基础组件库
│   ├── &#128196; accordion.tsx               # 手风琴组件
│   ├── &#128196; alert-dialog.tsx            # 警告对话框
│   ├── &#128196; alert.tsx                   # 警告提示
│   ├── &#128196; aspect-ratio.tsx            # 宽高比容器
│   ├── &#128196; avatar.tsx                  # 头像组件
│   ├── &#128196; badge.tsx                   # 徽章组件
│   ├── &#128196; breadcrumb.tsx              # 面包屑导航
│   ├── &#128196; button.tsx                  # 按钮组件
│   ├── &#128196; calendar.tsx                # 日历组件
│   ├── &#128196; card.tsx                    # 卡片组件
│   ├── &#128196; carousel.tsx                # 轮播组件
│   ├── &#128196; chart.tsx                   # 图表组件
│   ├── &#128196; checkbox.tsx                # 复选框
│   ├── &#128196; collapsible.tsx             # 可折叠容器
│   ├── &#128196; command.tsx                 # 命令面板
│   ├── &#128196; context-menu.tsx            # 右键菜单
│   ├── &#128196; dialog.tsx                  # 对话框
│   ├── &#128196; drawer.tsx                  # 抽屉组件
│   ├── &#128196; dropdown-menu.tsx           # 下拉菜单
│   ├── &#128196; form.tsx                    # 表单组件
│   ├── &#128196; hover-card.tsx              # 悬停卡片
│   ├── &#128196; input-otp.tsx               # OTP 输入框
│   ├── &#128196; input.tsx                   # 输入框
│   ├── &#128196; label.tsx                   # 标签组件
│   ├── &#128196; menubar.tsx                 # 菜单栏
│   ├── &#128196; navigation-menu.tsx         # 导航菜单
│   ├── &#128196; pagination.tsx              # 分页组件
│   ├── &#128196; popover.tsx                 # 弹出框
│   ├── &#128196; progress.tsx                # 进度条
│   ├── &#128196; radio-group.tsx             # 单选组
│   ├── &#128196; scroll-area.tsx             # 滚动区域
│   ├── &#128196; select.tsx                  # 选择器
│   ├── &#128196; separator.tsx               # 分隔线
│   ├── &#128196; sheet.tsx                   # 侧边抽屉
│   ├── &#128196; sidebar.tsx                 # 侧边栏
│   ├── &#128196; skeleton.tsx                # 骨架屏
│   ├── &#128196; slider.tsx                  # 滑块
│   ├── &#128196; sonner.tsx                  # Toast 通知
│   ├── &#128196; switch.tsx                  # 开关
│   ├── &#128196; table.tsx                   # 表格组件
│   ├── &#128196; tabs.tsx                    # 标签页
│   ├── &#128196; textarea.tsx                # 文本域
│   ├── &#128196; toast.tsx                   # Toast 组件
│   ├── &#128196; toaster.tsx                 # Toast 容器
│   ├── &#128196; toggle-group.tsx            # 切换组
│   ├── &#128196; toggle.tsx                  # 切换按钮
│   └── &#128196; tooltip.tsx                 # 工具提示
│
├── &#128193; layouts/                        # 布局组件
│   ├── &#128196; AdminLayout.tsx             # 管理端布局（核心）
│   ├── &#128196; EmployeeLayout.tsx          # 员工端布局
│   ├── &#128196; TenantLayout.tsx            # 租户端布局
│   ├── &#128196; AgentLayout.tsx             # 代理商端布局
│   ├── &#128196; AuthLayout.tsx              # 认证页布局
│   └── &#128196; DashboardLayout.tsx         # 仪表盘布局
│
├── &#128193; templates/                      # 页面模板组件
│   └── &#128196; PageTemplate.tsx            # 新页面开发模板（必用）
│
├── &#128193; common/                         # 通用组件
│   ├── &#128196; Header.tsx                  # 页头组件
│   ├── &#128196; Footer.tsx                  # 页脚组件
│   ├── &#128196; Sidebar.tsx                 # 侧边栏组件
│   ├── &#128196; Navbar.tsx                  # 导航栏组件
│   ├── &#128196; Breadcrumb.tsx              # 面包屑组件
│   ├── &#128196; Loading.tsx                 # 加载组件
│   ├── &#128196; ErrorBoundary.tsx           # 错误边界组件
│   ├── &#128196; EmptyState.tsx              # 空状态组件
│   ├── &#128196; ConfirmDialog.tsx           # 确认对话框
│   ├── &#128196; DataTable.tsx               # 数据表格组件
│   ├── &#128196; SearchBar.tsx               # 搜索栏组件
│   ├── &#128196; FilterPanel.tsx             # 筛选面板组件
│   ├── &#128196; Pagination.tsx              # 分页组件
│   └── &#128196; StatusBadge.tsx             # 状态徽章组件
│
├── &#128193; forms/                          # 表单组件
│   ├── &#128196; LoginForm.tsx               # 登录表单
│   ├── &#128196; RegisterForm.tsx            # 注册表单
│   ├── &#128196; EmployeeForm.tsx            # 员工表单
│   ├── &#128196; SalarySlipForm.tsx          # 工资条表单
│   ├── &#128196; PartnerForm.tsx             # 合作伙伴表单
│   ├── &#128196; CompanyForm.tsx             # 企业表单
│   ├── &#128196; SettingsForm.tsx            # 设置表单
│   └── &#128196; UploadForm.tsx              # 上传表单
│
├── &#128193; cards/                          # 卡片组件
│   ├── &#128196; StatsCard.tsx               # 统计卡片
│   ├── &#128196; InfoCard.tsx                # 信息卡片
│   ├── &#128196; ChartCard.tsx               # 图表卡片
│   └── &#128196; ActionCard.tsx              # 操作卡片
│
├── &#128193; modals/                         # 模态框组件
│   ├── &#128196; BaseModal.tsx               # 基础模态框
│   ├── &#128196; ConfirmModal.tsx            # 确认模态框
│   ├── &#128196; FormModal.tsx               # 表单模态框
│   └── &#128196; DetailModal.tsx             # 详情模态框
│
├── &#128193; charts/                         # 图表组件
│   ├── &#128196; LineChart.tsx               # 折线图
│   ├── &#128196; BarChart.tsx                # 柱状图
│   ├── &#128196; PieChart.tsx                # 饼图
│   ├── &#128196; AreaChart.tsx               # 面积图
│   └── &#128196; StatsChart.tsx              # 统计图表
│
├── &#128193; features/                       # 功能组件（业务相关）
│   ├── &#128193; salary-slip/                # 工资条相关组件
│   │   ├── &#128196; SalarySlipCard.tsx      # 工资条卡片
│   │   ├── &#128196; SalarySlipList.tsx      # 工资条列表
│   │   ├── &#128196; SalarySlipDetail.tsx    # 工资条详情
│   │   └── &#128196; SalarySlipImport.tsx    # 工资条导入
│   ├── &#128193; employee/                   # 员工相关组件
│   │   ├── &#128196; EmployeeCard.tsx        # 员工卡片
│   │   ├── &#128196; EmployeeList.tsx        # 员工列表
│   │   ├── &#128196; EmployeeDetail.tsx      # 员工详情
│   │   └── &#128196; EmployeeImport.tsx      # 员工导入
│   ├── &#128193; partner/                    # 合作伙伴相关组件
│   │   ├── &#128196; PartnerCard.tsx         # 合作伙伴卡片
│   │   ├── &#128196; PartnerList.tsx         # 合作伙伴列表
│   │   └── &#128196; PartnerDetail.tsx       # 合作伙伴详情
│   └── &#128193; open-platform/              # 开放平台组件
│       ├── &#128196; ApiKeyCard.tsx          # API 密钥卡片
│       ├── &#128196; AppCard.tsx             # 应用卡片
│       └── &#128196; WebhookCard.tsx         # Webhook 卡片
│
├── &#128193; providers/                      # Provider 组件
│   ├── &#128196; ThemeProvider.tsx           # 主题提供者
│   ├── &#128196; AuthProvider.tsx            # 认证提供者
│   └── &#128196; QueryProvider.tsx           # React Query 提供者
│
└── &#128196; AntdAppProvider.tsx             # Ant Design 全局配置（含 dayjs locale）
```

**用途**: 
- `ui/`: shadcn/ui 基础组件，禁止修改
- `layouts/`: 布局组件，所有页面必须使用
- `templates/`: 页面模板，新页面开发必用
- `common/`: 通用业务组件
- `forms/`: 表单组件
- `cards/`: 卡片展示组件
- `modals/`: 模态框组件
- `charts/`: 图表可视化组件
- `features/`: 业务功能组件
- `providers/`: React Context 提供者

### &#128193; src/lib/ - 工具函数库

```
/workspace/projects/src/lib/
├── &#128196; utils.ts                        # 通用工具函数（cn, formatDate 等）
├── &#128196; dayjs-locale.ts                 # dayjs 中文配置（全局导入）
│
├── &#128193; api/                            # API 工具
│   ├── &#128196; client.ts                   # API 客户端封装
│   ├── &#128196; response.ts                 # 响应格式化工具
│   └── &#128193; salary-slip/                # 工资条 API 工具
│       └── &#128196; index.ts                # 工资条相关 API 调用
│
├── &#128193; cache/                          # 缓存工具
│   ├── &#128196; index.ts                    # 缓存管理入口
│   └── &#128196; memory-cache.ts             # 内存缓存实现
│
├── &#128193; constants/                      # 常量定义
│   ├── &#128196; index.ts                    # 常量导出入口
│   ├── &#128196; roles.ts                    # 角色常量
│   ├── &#128196; status.ts                   # 状态常量
│   └── &#128196; config.ts                   # 配置常量
│
├── &#128193; database/                       # 数据库工具
│   ├── &#128196; index.ts                    # 数据库工具入口
│   ├── &#128196; connection.ts               # 数据库连接管理
│   └── &#128196; helpers.ts                  # 数据库操作辅助函数
│
├── &#128193; email/                          # 邮件工具
│   ├── &#128196; index.ts                    # 邮件工具入口
│   ├── &#128196; sender.ts                   # 邮件发送器
│   ├── &#128196; templates.ts                # 邮件模板处理
│   └── &#128196; validator.ts                # 邮箱验证
│
├── &#128193; employee-management/            # 人事管理工具
│   ├── &#128196; index.ts                    # 人事管理工具入口
│   ├── &#128196; import.ts                   # 员工导入处理
│   └── &#128196; export.ts                   # 员工导出处理
│
├── &#128193; excel/                          # Excel 工具
│   ├── &#128196; index.ts                    # Excel 工具入口
│   ├── &#128196; parser.ts                   # Excel 解析器
│   ├── &#128196; generator.ts                # Excel 生成器
│   └── &#128196; validator.ts                # Excel 验证器
│
├── &#128193; export/                         # 导出工具
│   ├── &#128196; index.ts                    # 导出工具入口
│   ├── &#128196; pdf.ts                      # PDF 导出
│   ├── &#128196; csv.ts                      # CSV 导出
│   └── &#128196; json.ts                     # JSON 导出
│
├── &#128193; field-config/                   # 字段配置工具
│   ├── &#128196; index.ts                    # 字段配置入口
│   └── &#128196; manager.ts                  # 字段配置管理
│
├── &#128193; knowledge/                      # 知识库工具
│   ├── &#128196; index.ts                    # 知识库工具入口
│   ├── &#128196; search.ts                   # 知识检索
│   └── &#128196; sync.ts                     # 知识同步
│
├── &#128193; license-system/                 # 授权系统工具
│   ├── &#128196; index.ts                    # 授权工具入口
│   ├── &#128196; validator.ts                # 授权验证
│   └── &#128196; generator.ts                # 授权码生成
│
├── &#128193; memory/                         # 记忆系统工具
│   ├── &#128196; index.ts                    # 记忆工具入口
│   ├── &#128196; manager.ts                  # 记忆管理
│   ├── &#128196; sync.ts                     # 记忆同步
│   └── &#128196; backup.ts                   # 记忆备份
│
├── &#128193; middleware/                     # 中间件工具
│   ├── &#128196; index.ts                    # 中间件入口
│   ├── &#128196; auth.ts                     # 认证中间件
│   └── &#128196; logging.ts                  # 日志中间件
│
├── &#128193; services/                       # 服务工具
│   ├── &#128196; index.ts                    # 服务工具入口
│   └── &#128196; helpers.ts                  # 服务辅助函数
│
├── &#128193; sms/                            # 短信工具
│   ├── &#128196; index.ts                    # 短信工具入口
│   ├── &#128196; sender.ts                   # 短信发送器
│   ├── &#128196; templates.ts                # 短信模板处理
│   └── &#128196; validator.ts                # 手机号验证
│
├── &#128193; storage/                        # 存储工具
│   ├── &#128196; index.ts                    # 存储工具入口
│   ├── &#128196; s3-client.ts                # S3 客户端封装
│   ├── &#128196; uploader.ts                 # 文件上传器
│   └── &#128196; presign.ts                  # 预签名 URL 生成
│
├── &#128193; testing/                        # 测试工具
│   ├── &#128196; index.ts                    # 测试工具入口
│   ├── &#128196; mock.ts                     # Mock 数据生成
│   └── &#128196; fixtures.ts                 # 测试固件
│
├── &#128193; utils/                          # 通用工具子目录
│   ├── &#128196; date.ts                     # 日期处理工具
│   ├── &#128196; string.ts                   # 字符串处理工具
│   ├── &#128196; number.ts                   # 数字处理工具
│   ├── &#128196; array.ts                    # 数组处理工具
│   ├── &#128196; object.ts                   # 对象处理工具
│   └── &#128196; validation.ts               # 验证工具
│
└── &#128193; validation/                     # 验证工具
    ├── &#128196; index.ts                    # 验证工具入口
    ├── &#128196; schemas.ts                  # Zod Schema 定义
    └── &#128196; rules.ts                    # 验证规则
```

**用途**: 
- 存放纯函数工具类，无副作用
- 按功能模块组织
- 提供统一的入口文件 (`index.ts`)

---

### &#128193; src/services/ - 业务服务层

```
/workspace/projects/src/services/
├── &#128196; README.md                       # 业务服务层索引文档
├── &#128193; auth/                           # 认证服务
│   ├── &#128196; index.ts                    # 认证服务入口
│   ├── &#128196; login.ts                    # 登录服务
│   ├── &#128196; register.ts                 # 注册服务
│   ├── &#128196; session.ts                  # 会话管理
│   └── &#128196; permission.ts               # 权限验证
│
├── &#128193; cache/                          # 缓存服务
│   ├── &#128196; index.ts                    # 缓存服务入口
│   └── &#128196; manager.ts                  # 缓存管理器
│
├── &#128193; channels/                       # 渠道服务
│   ├── &#128196; index.ts                    # 渠道服务入口
│   ├── &#128193; wechat/                     # 微信渠道
│   │   ├── &#128196; mp.ts                   # 公众号服务
│   │   ├── &#128196; mini.ts                 # 小程序服务
│   │   └── &#128196; oauth.ts                # OAuth 授权
│   └── &#128193; wework/                     # 企业微信渠道
│       ├── &#128196; index.ts                # 企业微信服务
│       └── &#128196; contact.ts              # 通讯录服务
│
├── &#128193; config/                         # 配置服务
│   ├── &#128196; index.ts                    # 配置服务入口
│   ├── &#128196; unified-config.ts           # 统一配置服务
│   └── &#128196; inheritance.ts              # 配置继承逻辑
│
├── &#128193; memory/                         # 记忆服务
│   ├── &#128196; index.ts                    # 记忆服务入口
│   ├── &#128196; manager.ts                  # 记忆管理器
│   ├── &#128196; sync.ts                     # 同步服务
│   └── &#128196; backup.ts                   # 备份服务
│
├── &#128193; miniprogram/                    # 小程序服务
│   ├── &#128196; index.ts                    # 小程序服务入口
│   ├── &#128196; login.ts                    # 小程序登录
│   └── &#128196; message.ts                  # 消息推送
│
├── &#128193; monitor/                        # 监控服务
│   ├── &#128196; index.ts                    # 监控服务入口
│   ├── &#128196; health.ts                   # 健康检查
│   └── &#128196; metrics.ts                  # 指标收集
│
├── &#128193; open-platform/                  # 开放平台服务
│   ├── &#128196; index.ts                    # 开放平台服务入口
│   ├── &#128196; api-key.ts                  # API 密钥服务
│   ├── &#128196; application.ts              # 应用服务
│   ├── &#128196; permission.ts               # 权限服务
│   └── &#128196; webhook.ts                  # Webhook 服务
│
├── &#128193; utils/                          # 服务工具
│   ├── &#128196; index.ts                    # 服务工具入口
│   └── &#128196; helpers.ts                  # 通用辅助函数
│
└── &#128193; wechat/                         # 微信服务总入口
    ├── &#128196; index.ts                    # 微信服务入口
    ├── &#128196; mp.ts                       # 公众号服务
    ├── &#128196; mini.ts                     # 小程序服务
    └── &#128196; work.ts                     # 企业微信服务
```

**用途**: 
- 业务逻辑封装层
- 调用 storage 层进行数据操作
- 提供可复用的业务方法

---

### &#128193; src/storage/ - 数据存储层

```
/workspace/projects/src/storage/
├── &#128193; database/                       # 数据库存储（PostgreSQL + Drizzle）
│   ├── &#128196; README.md                   # 数据访问层索引文档
│   ├── &#128196; index.ts                    # 数据库存储入口
│   ├── &#128196; schema.ts                   # Drizzle Schema 定义（废弃，用 shared/schema.ts）
│   │
│   ├── &#128193; shared/                     # 共享 Schema 定义
│   │   ├── &#128196; schema.ts               # 核心 Schema 定义（必用）
│   │   ├── &#128196; schemas.ts              # 扩展 Schema
│   │   ├── &#128196; schema-legacy.ts        # 废弃 Schema（参考）
│   │   └── &#128196; relations.ts            # 表关系定义
│   │
│   ├── &#128196; saasCompanyManager.ts        # 企业数据管理器
│   ├── &#128196; saasUserManager.ts          # 用户数据管理器
│   ├── &#128196; saasTenantManager.ts         # 租户数据管理器
│   ├── &#128196; saasOrderManager.ts          # 订单数据管理器
│   ├── &#128196; salarySlipManager.ts         # 工资条数据管理器
│   ├── &#128196; salarySlipDetailManager.ts   # 工资条明细管理器
│   ├── &#128196; salarySlipSendManager.ts     # 工资条发送管理器
│   ├── &#128196; salaryConfigManager.ts       # 工资配置管理器
│   ├── &#128196; partnerManager.ts            # 合作伙伴管理器
│   ├── &#128196; employeeManager.ts           # 员工数据管理器
│   ├── &#128196; emailTemplateManager.ts      # 邮件模板管理器
│   ├── &#128196; emailSendRecordManager.ts    # 邮件发送记录管理器
│   ├── &#128196; smtpConfigManager.ts         # SMTP 配置管理器
│   ├── &#128196; smsTemplateManager.ts        # 短信模板管理器
│   ├── &#128196; notificationSettingManager.ts # 通知设置管理器
│   ├── &#128196; mediaResourceManager.ts      # 媒体资源管理器
│   ├── &#128196; marketProductManager.ts      # 市场产品管理器
│   ├── &#128196; licenseManager.ts            # 授权管理器
│   ├── &#128196; invitationRecordManager.ts   # 邀请记录管理器
│   ├── &#128196; notificationManager.ts       # 通知管理器
│   ├── &#128196; unifiedConfigManager.ts      # 统一配置管理器
│   ├── &#128196; tenantManager.ts             # 租户管理器
│   ├── &#128196; userManager.ts               # 用户管理器
│   ├── &#128196; payrolSheetManager.ts        # 工资表管理器
│   ├── &#128196; releaseRecordManager.ts      # 发布记录管理器
│   ├── &#128196; surveyVoteManager.ts         # 问卷调查管理器
│   ├── &#128196; userIdentityManager.ts       # 用户身份管理器
│   ├── &#128196; partitionManager.ts          # 分区管理器
│   ├── &#128196; partitionAlertManager.ts     # 分区告警管理器
│   ├── &#128196; partitionMonitorService.ts   # 分区监控服务
│   ├── &#128196; fieldConfigManager.ts        # 字段配置管理器
│   ├── &#128196; financeManager.ts            # 财务数据管理器
│   ├── &#128196; auditLogManager.ts           # 审计日志管理器
│   ├── &#128196; cacheManager.ts              # 缓存管理器
│   │
│   ├── &#128196; license.schema.ts            # 授权相关 Schema
│   ├── &#128196; license-system.schema.ts     # 授权系统 Schema
│   ├── &#128196; service-config.schema.ts     # 服务配置 Schema
│   └── &#128196; user-identity.schema.ts      # 用户身份 Schema
│
└── &#128193; sqlite/                         # SQLite 存储（内存数据库）
    ├── &#128196; index.ts                    # SQLite 存储入口
    ├── &#128196; memoryDb.ts                 # 内存数据库实现
    ├── &#128196; memoryManager.ts            # 内存数据管理器
    └── &#128196; memoryTypes.ts              # 内存数据类型定义
```

**用途**: 
- 数据访问层，封装所有数据库操作
- **Manager 模式**: 每个 Manager 对应一个数据实体
- **必须从 `@/storage/database/*Manager` 导入**
- **Schema 使用 `src/storage/database/shared/schema.ts`**

### &#128193; src/types/ - TypeScript 类型定义

```
/workspace/projects/src/types/
├── &#128196; index.ts                        # 类型导出入口
├── &#128196; api.ts                          # API 相关类型（ApiResponse<T>）
├── &#128196; common.ts                       # 通用类型定义
├── &#128196; database.ts                     # 数据库相关类型
├── &#128196; license-system.ts               # 授权系统类型
├── &#128196; safe.ts                         # 类型安全工具
├── &#128196; helpers.ts                      # 类型辅助工具
│
├── &#128196; global.d.ts                     # 全局类型声明
├── &#128196; globals.d.ts                    # 全局变量声明
├── &#128196; lunar-javascript.d.ts           # 农历库类型声明
├── &#128196; miniprogram-sm-crypto.d.ts      # 小程序加密库类型
├── &#128196; wechat-api.d.ts                 # 微信 API 类型声明
├── &#128196; unzipper.d.ts                   # 解压库类型声明
└── &#128196; yauzl.d.ts                      # ZIP 解压库类型声明
```

**用途**: 
- 集中管理所有 TypeScript 类型定义
- `api.ts` 中的 `ApiResponse<T>` 是 API 响应的标准类型
- `*.d.ts` 为第三方库补充类型声明

---

### &#128193; src/hooks/ - React Hooks

```
/workspace/projects/src/hooks/
├── &#128196; index.ts                        # Hooks 导出入口
├── &#128196; useAuth.ts                      # 认证 Hook
├── &#128196; useUser.ts                      # 用户信息 Hook
├── &#128196; useCompany.ts                   # 企业信息 Hook
├── &#128196; useTenant.ts                    # 租户信息 Hook
├── &#128196; usePermissions.ts               # 权限 Hook
├── &#128196; useLocalStorage.ts              # 本地存储 Hook
├── &#128196; useDebounce.ts                  # 防抖 Hook
├── &#128196; useThrottle.ts                  # 节流 Hook
├── &#128196; useMediaQuery.ts                # 媒体查询 Hook
├── &#128196; useToggle.ts                    # 切换状态 Hook
├── &#128196; useFetch.ts                     # 数据获取 Hook
├── &#128196; usePagination.ts                # 分页 Hook
└── &#128196; useForm.ts                      # 表单 Hook
```

**用途**: 
- 封装可复用的 React Hooks
- 状态管理和副作用处理

---

### &#128193; src/providers/ - React Context Providers

```
/workspace/projects/src/providers/
├── &#128196; index.ts                        # Providers 导出入口
├── &#128196; AntdProviders.tsx               # Ant Design 全局配置
├── &#128196; ThemeProvider.tsx               # 主题 Provider
├── &#128196; AuthProvider.tsx                # 认证 Provider
├── &#128196; QueryProvider.tsx               # React Query Provider
└── &#128196; ToastProvider.tsx               # Toast 通知 Provider
```

**用途**: 
- React Context 提供者
- 在 `src/app/layout.tsx` 中统一挂载

---

### &#128193; src/stores/ - 状态管理（Zustand）

```
/workspace/projects/src/stores/
├── &#128196; index.ts                        # Stores 导出入口
├── &#128196; auth.store.ts                   # 认证状态管理
└── &#128196; ui.store.ts                     # UI 状态管理（侧边栏、主题等）
```

**用途**: 
- 使用 Zustand 进行全局状态管理
- 替代 Redux，更轻量

---

### &#128193; src/domains/ - 领域模型层

```
/workspace/projects/src/domains/
├── &#128193; auth/                           # 认证领域
│   ├── &#128193; entities/                   # 实体定义
│   ├── &#128193; repositories/               # 仓储接口
│   ├── &#128193; services/                   # 领域服务
│   └── &#128193; value-objects/              # 值对象
│
├── &#128193; company/                        # 企业领域
│   ├── &#128193; entities/                   # 企业实体
│   ├── &#128193; repositories/               # 企业仓储
│   └── &#128193; services/                   # 企业服务
│
├── &#128193; employee/                       # 员工领域
│   ├── &#128193; entities/                   # 员工实体
│   ├── &#128193; repositories/               # 员工仓储
│   └── &#128193; services/                   # 员工服务
│
├── &#128193; partner/                        # 合作伙伴领域
│   ├── &#128193; entities/                   # 合作伙伴实体
│   ├── &#128193; repositories/               # 合作伙伴仓储
│   └── &#128193; services/                   # 合作伙伴服务
│
├── &#128193; salary-slip/                    # 工资条领域
│   ├── &#128193; entities/                   # 工资条实体
│   ├── &#128193; repositories/               # 工资条仓储
│   ├── &#128193; services/                   # 工资条服务
│   └── &#128193; value-objects/              # 工资条值对象
│
├── &#128193; service/                        # 服务领域
│   ├── &#128193; entities/                   # 服务实体
│   ├── &#128193; factories/                  # 工厂模式
│   ├── &#128193; interfaces/                 # 接口定义
│   ├── &#128193; repositories/               # 服务仓储
│   └── &#128193; services/                   # 服务逻辑
│
├── &#128193; shared/                         # 共享领域
│   ├── &#128193; auth/                       # 共享认证
│   └── &#128193; repositories/               # 共享仓储
│
└── &#128193; tenant/                         # 租户领域
    └── &#128193; repositories/               # 租户仓储
```

**用途**: 
- 领域驱动设计（DDD）分层
- 封装业务实体和领域服务
- 定义仓储接口

---

### &#128193; src/infrastructure/ - 基础设施层

```
/workspace/projects/src/infrastructure/
├── &#128193; api/                            # API 基础设施
│   └── &#128196; *.ts                        # API 客户端实现
│
├── &#128193; auth/                           # 认证基础设施
│   └── &#128196; *.ts                        # 认证实现（JWT、Session）
│
├── &#128193; cache/                          # 缓存基础设施
│   └── &#128196; *.ts                        # 缓存实现（Redis、内存）
│
├── &#128193; database/                       # 数据库基础设施
│   ├── &#128193; migrations/                 # 迁移文件
│   ├── &#128193; repositories/               # 仓储实现
│   └── &#128193; shared/                     # 共享数据库工具
│
├── &#128193; email/                          # 邮件基础设施
│   └── &#128196; *.ts                        # 邮件发送实现（SMTP）
│
├── &#128193; repositories/                   # 仓储实现总目录
│   └── &#128196; *.ts                        # 各领域仓储实现
│
├── &#128193; scheduler/                      # 调度器基础设施
│   └── &#128196; *.ts                        # 定时任务实现
│
├── &#128193; services/                       # 服务基础设施
│   └── &#128196; *.ts                        # 基础服务实现
│
├── &#128193; sms/                            # 短信基础设施
│   └── &#128196; *.ts                        # 短信发送实现（阿里云）
│
└── &#128193; storage/                        # 存储基础设施
    └── &#128196; *.ts                        # 文件存储实现（S3）
```

**用途**: 
- 实现技术细节
- 数据库连接、缓存、消息队列等
- 实现领域层定义的仓储接口

---

### &#128193; src/shared/ - 共享模块

```
/workspace/projects/src/shared/
├── &#128193; auth/                           # 共享认证模块
│   └── &#128196; *.ts                        # 认证共享工具
│
├── &#128193; types/                          # 共享类型定义
│   └── &#128196; *.ts                        # 共享类型
│
├── &#128193; utils/                          # 共享工具函数
│   └── &#128196; *.ts                        # 共享工具
│
└── &#128193; validation/                     # 共享验证规则
    └── &#128196; *.ts                        # 共享验证器
```

**用途**: 
- 跨层共享的代码
- 可在 domains、services、infrastructure 中复用

---

### &#128193; src/interfaces/ - 接口定义

```
/workspace/projects/src/interfaces/
└── &#128196; *.ts                            # 各模块接口定义
```

**用途**: 
- 定义模块间的接口契约
- 依赖倒置原则的实现

---

### &#128193; src/utils/ - 工具函数

```
/workspace/projects/src/utils/
└── &#128196; no-generator.ts                 # 雪花 ID 生成器
```

**用途**: 
- 通用工具函数
- 无副作用的纯函数

---

## &#128193; docs/ - 文档目录

### &#128193; docs/00-开发规范/ - 开发规范文档

```
/workspace/projects/docs/00-开发规范/
├── &#128196; README.md                       # 规范索引页
├── &#128196; 规范更新指南.md                  # 规范文件更新流程（核心）
├── &#128196; 开发前检查清单.md                # 开发前必查项
├── &#128196; 开发安全规范.md                  # 安全开发规范
├── &#128196; 开发规范-完整版-含扣子部署.md     # 完整开发规范
├── &#128196; 类型安全规范体系.md              # TypeScript 类型安全规范
├── &#128196; 类型安全快速参考卡.md            # 类型安全速查
├── &#128196; TYPE_SAFETY_GUIDE.md            # 类型安全指南（英文）
├── &#128196; 错误预防指南.md                  # 错误预防策略（含常见错误模式库）
├── &#128196; 错误处理规范.md                  # 统一错误码和错误响应格式
├── &#128196; 数据模型字典.md                  # 数据库表字段含义、枚举值、关联关系
├── &#128196; BUG自动记录系统使用指南.md       # Bug 记录系统说明
├── &#128196; 常见BUG知识库.md                 # 常见 Bug 汇总
│
├── &#128193; 前端规范/                        # 前端开发规范
│   ├── &#128196; README.md                   # 前端规范索引
│   ├── &#128196; 核心规范.md                  # 前端核心规范（必读）
│   ├── &#128196; TypeScript最佳实践.md        # TS 最佳实践
│   ├── &#128196; 前端布局规范.md              # 布局规范
│   ├── &#128196; 前端页面模板.md              # 页面模板说明
│   ├── &#128196; 页面模板.md                  # 页面模板补充
│   ├── &#128196; 前端颜色与组件规范.md        # 颜色和组件使用规范
│   ├── &#128196; 组件配置手册.md              # 组件配置参考
│   └── &#128196; 问题排查指南.md              # 前端问题排查
│
├── &#128193; 后端规范/                        # 后端开发规范
│   ├── &#128196; README.md                   # 后端规范索引
│   └── &#128196; 后端开发手册.md              # 后端开发指南
│
└── &#128193; 最佳实践/                        # 最佳实践记录
    ├── &#128196; README.md                   # 最佳实践索引
    ├── &#128196; bp-20260223-m7ps.md         # 最佳实践记录示例
    └── &#128196; 图片上传优化总结.md          # 图片上传优化实践
```

**用途**: 
- 开发规范集中管理
- 新功能开发前必读
- `规范更新指南.md` 定义规范文件的更新流程

---

### &#128193; docs/01-快速开始/ - 快速开始指南

```
/workspace/projects/docs/01-快速开始/
├── &#128196; README.md                       # 快速开始索引
├── &#128196; 快速开始.md                      # 项目快速启动指南
├── &#128196; Gitee快速开始.md                 # Gitee 协作指南
├── &#128196; 协作快速开始.md                  # 团队协作指南
└── &#128196; 质量保证快速开始.md              # 质量保证指南
```

---

### &#128193; docs/02-部署指南/ - 部署相关文档

```
/workspace/projects/docs/02-部署指南/
├── &#128196; README.md                       # 部署指南索引
├── &#128196; 部署指南.md                      # 部署总览
├── &#128196; 部署快速开始.md                  # 快速部署
├── &#128196; Coze部署指南.md                  # Coze 平台部署
├── &#128196; Coze部署问题分析.md              # 部署问题排查
├── &#128196; Docker部署.md                    # Docker 部署方案
├── &#128196; 发布指南.md                      # 发布流程
├── &#128196; 快速发布指南.md                  # 快速发布步骤
├── &#128196; 构建和发布.md                    # 构建发布流程
├── &#128196; 构建标准.md                      # 构建标准规范
├── &#128196; 构建检查清单.md                  # 构建前检查
├── &#128196; 生产部署快速开始.md              # 生产环境快速部署
├── &#128196; 生产部署方案.md                  # 生产部署方案
├── &#128196; 生产部署标准.md                  # 生产部署标准
├── &#128196; 生产部署检查清单.md              # 生产部署检查
├── &#128196; 程序备份性能.md                  # 备份性能优化
├── &#128196; 自动修复和发布指南.md            # 自动修复发布
└── &#128196; 自动化发布命令使用指南.md        # 自动化发布命令
```

---

### &#128193; docs/03-开发指南/ - 开发指南文档

```
/workspace/projects/docs/03-开发指南/
├── &#128196; README.md                       # 开发指南索引
├── &#128196; 开发指南.md                      # 开发总览
├── &#128196; 开发流程.md                      # 开发流程规范
├── &#128196; 开发环境标准.md                  # 环境配置标准
├── &#128196; 全局样式.md                      # 全局样式说明
├── &#128196; Git凭据配置.md                   # Git 凭据配置
├── &#128196; Git自动配置.md                   # Git 自动配置
├── &#128196; Git推送规则.md                   # Git 推送规范
├── &#128196; 协作设置.md                      # 团队协作配置
├── &#128196; 定时任务.md                      # 定时任务配置
├── &#128196; 技术改进.md                      # 技术改进记录
├── &#128196; 贡献指南.md                      # 贡献者指南
└── &#128196; 项目目录结构.md                  # 项目目录说明
```

---

### &#128193; docs/04-API文档/ - API 接口文档

```
/workspace/projects/docs/04-API文档/
├── &#128196; README.md                       # API 文档索引
├── &#128196; API接口文档.md                   # API 接口总览
└── &#128196; 企业API.md                       # 企业相关 API 文档
```

---

### &#128193; docs/05-数据库/ - 数据库文档

```
/workspace/projects/docs/05-数据库/
├── &#128196; README.md                       # 数据库文档索引
├── &#128196; DATABASE_SCHEMA.md              # 数据库 Schema 说明
├── &#128196; 数据库字典.md                    # 数据字典
├── &#128196; 数据持久化.md                    # 数据持久化说明
├── &#128196; 数据模型统一.md                  # 数据模型统一规范
├── &#128196; 数据迁移.md                      # 数据迁移指南
└── &#128196; 分区指南.md                      # PostgreSQL 分区表指南（核心）
```

---

### &#128193; docs/06-架构设计/ - 架构设计文档

```
/workspace/projects/docs/06-架构设计/
├── &#128196; README.md                       # 架构设计索引
├── &#128196; 架构结构.md                      # 系统架构概览
├── &#128196; 架构使用指南.md                  # 架构使用说明
├── &#128196; 架构优化计划.md                  # 架构优化计划
├── &#128196; 前端架构.md                      # 前端架构设计
├── &#128196; 前端重构总结.md                  # 前端重构记录
├── &#128196; 仓库模式.md                      # Repository 模式说明
└── &#128196; 仓库实现总结.md                  # 仓库实现总结
```

---

### &#128193; docs/07-测试质量/ - 测试与质量文档

```
/workspace/projects/docs/07-测试质量/
├── &#128196; README.md                       # 测试质量索引
├── &#128196; 测试策略.md                      # 测试策略说明
├── &#128196; 单元测试.md                      # 单元测试指南
├── &#128196; 集成测试.md                      # 集成测试指南
├── &#128196; E2E测试.md                       # E2E 测试指南
├── &#128196; 测试覆盖率.md                    # 测试覆盖率要求
└── &#128196; 代码质量检查.md                  # 代码质量规范
```

---

### &#128193; docs/08-版本管理/ - 版本管理文档

```
/workspace/projects/docs/08-版本管理/
├── &#128196; README.md                       # 版本管理索引
├── &#128196; CHANGELOG.md                    # 变更日志（核心）
├── &#128196; 版本发布流程.md                  # 版本发布流程
└── &#128196; 版本号规范.md                    # 语义化版本规范
```

---

### &#128193; docs/09-配置指南/ - 配置相关文档

```
/workspace/projects/docs/09-配置指南/
├── &#128196; README.md                       # 配置指南索引
├── &#128196; 环境变量配置.md                  # 环境变量说明
├── &#128196; 数据库配置.md                    # 数据库配置
├── &#128196; 缓存配置.md                      # 缓存配置
└── &#128196; 第三方服务配置.md                # 第三方服务配置
```

---

### &#128193; docs/10-平台规划/ - 平台规划文档

```
/workspace/projects/docs/10-平台规划/
├── &#128196; README.md                       # 平台规划索引
├── &#128196; 产品路线图.md                    # 产品发展路线
├── &#128196; 功能规划.md                      # 功能规划
└── &#128196; 技术规划.md                      # 技术演进规划
```

---

### &#128193; docs/11-开发计划/ - 开发计划文档

```
/workspace/projects/docs/11-开发计划/
├── &#128196; README.md                       # 开发计划索引
├── &#128196; 当前迭代计划.md                  # 当前迭代内容
├── &#128196; 待办事项.md                      # 待办任务列表
└── &#128193; 技术实现方案/                    # 技术方案文档
    └── &#128196; *.md                        # 各功能技术方案
```

---

### &#128193; docs/12-项目记忆/ - AI 记忆系统文档

```
/workspace/projects/docs/12-项目记忆/
├── &#128196; README.md                       # 记忆系统索引
├── &#128196; 记忆系统架构.md                  # 记忆系统设计
├── &#128196; 记忆同步机制.md                  # 同步机制说明
├── &#128196; 向量知识库.md                    # 向量检索说明
└── &#128196; 最佳实践记录.md                  # 最佳实践汇总
```

---

### &#128193; docs/13-迁移指南/ - 迁移指南文档

```
/workspace/projects/docs/13-迁移指南/
├── &#128196; README.md                       # 迁移指南索引
├── &#128196; 数据迁移指南.md                  # 数据迁移步骤
└── &#128196; 系统迁移指南.md                  # 系统迁移说明
```

---

### &#128193; docs/14-需求文档/ - 需求文档

```
/workspace/projects/docs/14-需求文档/
├── &#128196; README.md                       # 需求文档索引
├── &#128196; 需求分析.md                      # 需求分析方法
└── &#128196; *.md                            # 各功能需求文档
```

---

### &#128193; docs/15-授权系统/ - 授权系统文档

```
/workspace/projects/docs/15-授权系统/
├── &#128196; README.md                       # 授权系统索引
├── &#128196; 授权系统设计.md                  # 授权系统架构
├── &#128196; 授权码管理.md                    # 授权码管理
└── &#128196; 权限控制.md                      # 权限控制实现
```

---

### &#128193; docs/16-问题修复/ - 问题修复记录

```
/workspace/projects/docs/16-问题修复/
├── &#128196; README.md                       # 问题修复索引
└── &#128196; *.md                            # 各问题修复记录
```

---

### &#128193; docs/17-其他/ - 其他文档

```
/workspace/projects/docs/17-其他/
├── &#128196; README.md                       # 其他文档索引
└── &#128196; *.md                            # 其他杂项文档
```

---

### &#128193; docs/18-开放平台/ - 开放平台文档

```
/workspace/projects/docs/18-开放平台/
├── &#128196; README.md                       # 开放平台索引
├── &#128196; API文档.md                       # 开放 API 文档
├── &#128196; 接入指南.md                      # 第三方接入指南
├── &#128196; Webhook配置.md                   # Webhook 配置说明
└── &#128196; 权限申请.md                      # 权限申请流程
```

---

### &#128193; docs/19-智能进化/ - AI 进化机制文档

```
/workspace/projects/docs/19-智能进化/
├── &#128196; README.md                       # 智能进化索引
├── &#128196; AI进化机制.md                    # AI 进化机制设计
├── &#128196; 错误学习.md                      # 错误自动学习
├── &#128196; 红线检测.md                      # 红线规则检测
└── &#128196; 决策追溯.md                      # 决策记录追溯
```

---

### &#128193; docs/40-操作教程/ - 操作教程文档

```
/workspace/projects/docs/40-操作教程/
├── &#128196; README.md                       # 操作教程索引
├── &#128196; 用户操作手册.md                  # 用户操作手册
├── &#128196; 管理员操作手册.md                # 管理员操作手册
└── &#128196; 常见问题.md                      # FAQ
```

---

### &#128193; docs/skills/ - AI 技能配置

```
/workspace/projects/docs/skills/
└── &#128193; project-memory-loader/          # 项目记忆加载技能
    ├── &#128196; SKILL.md                    # 技能定义文件（核心）
    ├── &#128196; schema.json                 # 技能配置 Schema
    └── &#128196; *.md                        # 其他技能相关文件
```

---

### &#128193; docs 根目录文件

```
/workspace/projects/docs/
├── &#128196; .docs-version-control.yml       # 文档版本控制配置
├── &#128196; .search-keywords.yml            # 搜索关键词索引
└── &#128196; 压缩摘要.md                      # 项目压缩摘要（核心）
```

---

## &#128193; .cozeproj/ - Coze 项目配置（隐藏目录）

```
/workspace/projects/.cozeproj/
├── &#128196; scripts/                        # 构建和运行脚本
│   ├── &#128196; build.sh                    # 构建脚本
│   └── &#128196; run.sh                      # 运行脚本
└── &#128196; config.json                     # Coze 项目配置
```

**用途**: Coze 平台部署相关配置，由 `coze init` 自动生成，一般不需要手动修改。

---

## &#128273; 核心文件快速索引

### 必读文件（新会话启动时）

| 优先级 | 文件 | 用途 |
|--------|------|------|
| 1 | `.clinerules` | AI 开发铁律，所有规则的顶层 |
| 2 | `docs/压缩摘要.md` | 项目全局视角，AI 启动必读 |
| 3 | `docs/skills/project-memory-loader/SKILL.md` | 记忆系统配置 |
| 4 | `docs/00-开发规范/前端规范/核心规范.md` | 前端开发详细规范 |
| 5 | `src/components/templates/PageTemplate.tsx` | 新页面开发模板 |

### 核心配置文件

| 文件 | 用途 |
|------|------|
| `package.json` | 项目依赖和脚本定义 |
| `tsconfig.json` | TypeScript 编译配置 |
| `tailwind.config.ts` | Tailwind CSS 配置 |
| `next.config.ts` | Next.js 框架配置 |
| `drizzle.config.ts` | Drizzle ORM 配置 |
| `.coze` | Coze 部署配置 |
| `ecosystem.config.cjs` | PM2 进程管理配置 |

### 核心源码入口

| 文件/目录 | 用途 |
|-----------|------|
| `src/app/layout.tsx` | 根布局组件 |
| `src/app/page.tsx` | 首页 |
| `src/middleware.ts` | 路由守卫中间件 |
| `src/components/layouts/AdminLayout.tsx` | 管理端布局（必用） |
| `src/storage/database/shared/schema.ts` | 数据模型定义（必用） |
| `src/storage/database/*Manager.ts` | 数据操作管理器 |
| `src/types/api.ts` | API 类型定义 |

---

## &#128202; 统计信息

| 分类 | 数量 | 说明 |
|------|------|------|
| 页面路由 | ~150+ | `src/app/` 下的 page.tsx |
| API 路由 | ~100+ | `src/app/api/` 下的 route.ts |
| UI 组件 | ~50+ | `src/components/ui/` |
| 业务组件 | ~100+ | `src/components/` 其他目录 |
| 数据管理器 | ~30+ | `src/storage/database/*Manager.ts` |
| 文档文件 | ~200+ | `docs/` 目录 |
| 脚本工具 | ~50+ | `scripts/` 目录 |

---

## &#128260; 目录结构设计原则

### 1. 分层架构

```
表示层 (app/) → 业务层 (services/) → 数据层 (storage/) → 基础设施层 (infrastructure/)
```

### 2. 领域驱动设计（DDD）

```
src/domains/           # 领域模型
  ├── entities/        # 实体
  ├── repositories/    # 仓储接口
  ├── services/        # 领域服务
  └── value-objects/   # 值对象
```

### 3. 组件分层

```
src/components/
  ├── ui/              # 基础 UI（shadcn/ui，禁止修改）
  ├── layouts/         # 布局组件
  ├── templates/       # 页面模板
  ├── common/          # 通用业务组件
  ├── forms/           # 表单组件
  └── features/        # 功能组件
```

### 4. 文档分层

```
docs/
  ├── 00-开发规范/     # 开发规范（必读）
  ├── 01-快速开始/     # 快速入门
  ├── 02-部署指南/     # 部署相关
  ├── ...
  └── skills/          # AI 技能配置
```

---

## ⚠️ 重要提醒

### 禁止修改的文件

| 文件/目录 | 原因 |
|-----------|------|
| `src/components/ui/*` | shadcn/ui 组件，升级会被覆盖 |
| `src/db/schema.ts` | 已废弃，使用 `src/storage/database/shared/schema.ts` |
| `.husky/_/*` | Husky 内部文件 |

### 必须遵守的规则

1. **新页面开发**：必须使用 `src/components/templates/PageTemplate.tsx`
2. **数据操作**：必须使用 `src/storage/database/*Manager.ts`
3. **布局组件**：必须使用 `AdminLayout`，禁止创建独立 layout.tsx
4. **颜色样式**：必须使用语义化类名（`bg-background`, `text-foreground`）

---

## &#128221; 更新记录

| 日期 | 版本 | 更新内容 |
|------|------|----------|
| 2026-03-10 | v1.0.0 | 初始版本，完整目录树 |

---

> **最后更新**: 2026-03-10
> **维护者**: AI 自动生成
> **用途**: 帮助 AI 快速理解项目结构，提高开发效率