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

## 项目结构

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

> `lami-base-v1/` 是早期演示/参考项目，接口路径为 `/api/qiwei/*`，**不是**本前端对接的后端。请勿与 `backend/` 同时占用 `3101` 端口。

## 本地开发

### 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
# 仓库根目录
pnpm install
pnpm start
```

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

### 演示账号

默认密码均为 `123456`（可在个人设置中修改）：

| 角色 | 邮箱 |
|------|------|
| 系统管理员 | admin@lami.com |
| 店长 | lidian@lami.com |
| 社群运营 | wangying@lami.com |

## 环境变量（后端）

见 `backend/.env.example`。生产环境务必配置：

- `PARSE_SERVER_URL` / `PARSE_APP_ID` / `PARSE_MASTER_KEY` — Parse 数据库
- `QIWE_TOKEN` / `QIWE_GUID` — 企微 QiWe 平台（群同步、消息同步）
- `PARSE_TIMEOUT_MS` — Parse 请求超时（默认 `8000`，避免数据库不可达时接口卡死）

## 常见问题

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

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

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

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

1. 确认启动的是 `backend/`，不是 `lami-base-v1/backend/`
2. 访问 `http://localhost:3101/api/health`，若 `database.connected` 为 `false`，说明 Parse 数据库不可达，需检查 `PARSE_SERVER_URL` 对应服务是否正常运行

## 构建

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