# 188-179 招聘系统项目文档

## 项目概述

本项目是一个大型企业级招聘管理系统，采用 Monorepo 架构，包含管理后台、员工小程序、人才小程序等多个应用。

### 技术栈

- **前端框架**: React 19, Taro 3.x
- **后端框架**: Hono 4.x, NestJS (部分模块)
- **数据库**: PostgreSQL 17
- **缓存**: Redis 7
- **对象存储**: MinIO
- **构建工具**: Vite, Turbo
- **包管理**: pnpm workspaces
- **测试**: Vitest, Playwright, Testing Library

## 项目结构

```
188-179-template-6/
├── packages/              # 核心共享包和模块 (61个)
├── allin-packages/        # 业务模块包 (15个)
├── mini-ui-packages/      # 小程序UI组件库 (18个)
├── mini/                  # 员工小程序 (Taro)
├── mini-talent/           # 人才小程序 (Taro)
├── web/                   # 管理后台 (React + Vite)
├── docs/                  # 项目文档
└── _bmad/                 # BMAD工作流配置
```

## 文档导航

### 快速开始
- [开发环境设置](./guides/setup.md)
- [本地开发指南](./guides/local-development.md)
- [部署指南](./guides/deployment.md)

### 架构文档
- [Monorepo架构](./architecture/monorepo.md)
- [模块组织结构](./architecture/module-structure.md)
- [数据模型](./architecture/data-models.md)
- [API设计](./architecture/api-design.md)

### 开发规范
- [编码标准](./standards/coding-standards.md)
- [后端模块开发规范](./standards/backend-module-standards.md)
- [UI包开发规范](./standards/ui-package-standards.md)
- [小程序UI包开发规范](./standards/mini-ui-package-standards.md)
- [测试规范](./standards/testing-standards.md)

## 包分类

### 核心共享包
- `core-module`: 核心业务逻辑
- `shared-types`: 共享类型定义
- `shared-utils`: 共享工具函数
- `shared-crud`: 通用CRUD服务
- `shared-ui-components`: 共享UI组件

### 业务模块包
#### 基础模块
- `auth-module`: 认证授权
- `user-module`: 用户管理
- `file-module`: 文件管理
- `tenant-module`: 租户管理

#### 业务模块
- `orders-module`: 订单管理
- `goods-module`: 商品管理
- `merchant-module`: 商家管理
- `supplier-module`: 供应商管理
- `delivery-address-module`: 收货地址
- `geo-areas`: 地理区域
- `advertisements-module`: 广告管理
- `bank-names-module`: 银行名称
- `mini-payment`: 小程序支付

### 小程序UI包
#### 通用组件
- `mini-charts`: 图表组件
- `mini-enterprise-auth-ui`: 企业认证UI
- `mini-shared-ui-components`: 共享UI组件
- `allin-enums`: 枚举定义

#### 员工端 (yongren)
- `yongren-dashboard-ui`: 仪表板
- `yongren-order-management-ui`: 订单管理
- `yongren-statistics-ui`: 统计分析
- `yongren-talent-management-ui`: 人才管理

#### 人才端 (rencai)
- `rencai-auth-ui`: 认证UI
- `rencai-dashboard-ui`: 仪表板
- `rencai-attendance-ui`: 考勤管理
- `rencai-employment-ui`: 入职管理
- `rencai-personal-info-ui`: 个人信息

## 开发命令

### 安装依赖
```bash
pnpm install
```

### 启动开发环境
```bash
# 启动全部应用
pnpm dev

# 仅启动管理后台
pnpm run dev:web

# 仅启动员工小程序 H5
pnpm run dev:mini

# 仅启动人才小程序 H5
pnpm run dev:mini-talent
```

### 构建
```bash
# 构建所有包
pnpm build

# 构建小程序UI包
pnpm run build:mini-ui-packages
```

### 测试
```bash
# 运行所有测试
pnpm test

# 类型检查
pnpm typecheck

# 代码检查
pnpm lint
```

## 多租户架构

项目支持多租户架构，部分模块具有多租户变体（带 `-mt` 后缀）：
- `auth-module-mt`
- `goods-module-mt`
- `orders-module-mt`
- 等等...

## 联系方式

- 项目名称: 188-179 招聘系统
- 最后更新: 2026-01-07
