lami

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

项目结构

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

完整目录说明、功能清单与后续计划见 doc/项目目录与功能说明.md

本地开发

1. 启动后端

cd backend
npm install   # 或 pnpm install
npm run dev

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

2. 启动 PC 前端

# 仓库根目录
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

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

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 验证

构建

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

文档索引

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