# 拉迷企微客户服务系统（PC 社群运营端）

## 项目结构

| 目录 | 说明 |
|------|------|
| `src/` | **PC 前端**（Angular 20，本仓库主应用） |
| `backend/` | **后端 API**（Express，默认端口 `:3101`） |
| `doc/` | 产品与设计文档 |
| `backend/docs/` | 后端设计、部署与数据库文档 |

> 完整目录说明、功能清单与后续计划见 **[doc/项目目录与功能说明.md](doc/项目目录与功能说明.md)**

## 本地开发

### 1. 启动后端

```bash
cd backend
npm install   # 或 pnpm install
npm run dev
```

PC API：`http://localhost:3101/api`  
健康检查：`http://localhost:3101/api/health`

### 2. 启动 PC 前端

```bash
# 仓库根目录
npm install   # 或 pnpm install
npm start
```

前端：`http://localhost:4200`（通过 `proxy.conf.json` 代理 `/api` → 3101）

### 演示账号

默认密码均为 `123456`，**登录使用手机号**：

| 角色 | 手机号 | 邮箱 |
|------|--------|------|
| 总监 | 13800000001 | admin@lami.com |
| 区域督导 | 13800000002 | dudao@lami.com |
| 店长 | 13800000003 | lidian@lami.com |

## 环境变量（后端）

见 `backend/.env.example`。关键配置：

- `PARSE_SERVER_URL` / `PARSE_APP_ID` / `PARSE_MASTER_KEY` — Parse 数据库
- `QIWE_TOKEN` / `QIWE_GUID` — 企微 QiWe 平台（群同步、消息同步）

## 常见问题

### 后端报 `EADDRINUSE :::3101`

端口已被占用。先结束旧进程再启动：

```powershell
netstat -ano | findstr ":3101"
taskkill /PID <PID> /F
```

### 登录报 Parse 502 / invalid JSON

远程 Parse 数据库（`PARSE_SERVER_URL`）不可用。访问 `/api/health` 查看 `database.connected`。Parse 恢复前登录无法使用；可临时将 `src/environments/environment.development.ts` 中 `useBackendApi` 改为 `false` 使用 Mock 数据。

### 前端提示「网络错误，请确认后端服务已启动」

1. 确认 `backend/` 已启动（不是旧路径 `backend/backend/`）
2. 访问 `http://localhost:3101/api/health` 验证

## 构建

```bash
npm run build       # 前端生产构建
npm test            # 前端单元测试
```

## 文档索引

| 文档 | 内容 |
|------|------|
| [doc/项目目录与功能说明.md](doc/项目目录与功能说明.md) | **目录结构、当前功能、后续计划** |
| [doc/风控工单-后端开发说明.md](doc/风控工单-后端开发说明.md) | 风控模块后端设计与分阶段计划 |
| [backend/docs/backend-design.md](backend/docs/backend-design.md) | Webhook 架构 |
| [backend/docs/database-design.md](backend/docs/database-design.md) | Parse 表结构 |