HELPPLAY 　

HelpPlay 地陪平台 · 十项细分服务的地陪平台骨架

89 COMMITS

10 SERVICE TYPES

681 TS FILES

1w+ TARGET DAU

OVERVIEW ── 这是什么01

面向 C 端游客的标准化地陪服务平台，覆盖全景路线、夜间护送、银发陪伴等十项细分服务。这一版做的是地基：pnpm monorepo、微服务拆分、共享库、双小程序与容器化编排全部就位，业务逻辑在骨架之上填。

ARCHITECTURE ── 架构分层02

01骨架

pnpm workspaces monorepo · libs 共享库（config / logger / mongo / swagger / exceptions）· commitlint + husky 强约束

02后端

Node.js 微服务 · MongoDB 主库 · Redis 缓存 · 消息队列跨服务通信

03端

miniprogram-user 用户端小程序 · miniprogram-shared 共享层 · PC 端网页

04运维

Docker Compose 本地基建 · nginx 反代 · PM2 ecosystem 进程编排

05质量

Jest + 覆盖率门槛 · ESLint + Prettier · 全量 typecheck

FEATURES ── 功能与取舍03

config / logger / mongo / swagger / exceptions 五个包先落地，微服务不各写一套。

swagger 包统一挂载，新增接口同步出 OpenAPI。

用户端与后续服务端小程序共用类型与请求层，避免两端漂移。

commitlint + husky + lint-staged，规范在钩子里而不在文档里。

MILESTONES ── 里程碑04

2026-04-22

立项：monorepo 骨架与共享库

2026-05-04

微服务拆分、双小程序与容器化编排就位

RELATED LOGS ── 相关复盘05