lami-shequn

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

项目结构

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

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

本地开发

1. 启动后端

cd backend
npm install   # 或 pnpm install
npm run dev

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

2. 启动 PC 前端

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

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

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 对应服务是否正常运行

构建

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