党员发展管理系统

基于微信服务号网页 App、Node.js 服务端和 PC 后台的党务管理项目，覆盖发展党员流程、角色权限、流程审核、统计分析、材料上传和消息提醒。当前主产品形态已收敛为服务号 H5 与 PC 后台，不再保留小程序主路径。

项目介绍

• 服务号网页 App：申请人、支部审核者、组织员和学院党委共用的微信内轻量工作台。
• 服务端：统一认证、权限、流程、统计、导出、附件上传。
• PC 后台：查看台账、审核审批、统计分析、流程配置、组织与角色管理。

GitHub 仓库地址：

• https://github.com/Lukas-VI/party-building-system

业务场景

• 发展党员 25 步流程留痕管理
• 申请人基础资料维护
• 支部/单位/组织部多级权限操作
• 注册审核、流程审核、统计下载

角色与权限

• 入党申请人：查看与提交本人流程和资料
• 党支部书记：查看本支部、处理支部审核节点、导出本支部数据
• 组织员：查看本单位、审核注册、推进流程、分配角色
• 二级单位党委书记/副书记：查看与审批本单位范围内事项
• 校党委组织部：全校查看、统计、审核、导出
• 超级管理员：组织配置、角色配置、流程配置、全量导出

项目结构

.
├─ admin-desktop/    PC 后台前端
├─ admin-mobile/     服务号网页 App（Vue3 + Vant）
├─ docs/             项目说明、部署文档、图表与进展记录
└─ server/           Node.js + MySQL 服务端

本地开发

1. 启动服务端

cd server
npm install
cp .env.example .env
npm run start

说明：

• 服务端默认连接 MySQL
• 启动时会执行 server/deploy/mysql-init.sql 并初始化演示数据
• 开发联调配置请参考独立调试文档

2. 启动后台

cd admin-desktop
npm install
npm run dev

可通过 admin-desktop/.env.example 配置 VITE_API_BASE。 如需按开发服务器联调口径启动桌面后台开发服务：

npm run dev:1919

如需通过统一入口 https://域名/web-admin/ 暴露后台：

• 对外前端入口只保留 /web-admin/
• 桌面后台真实挂载在 /admin-desktop/
• 服务号网页 App 真实挂载在 /wx-app/
• 统一网关会根据设备类型把 /web-admin/ 自动分流到桌面版或服务号网页端

3. 启动服务号网页 App

cd admin-mobile
npm install
npm run dev:1919

如需本地统一预览桌面版和手机版：

• 运行仓库根目录下的统一网关脚本，使用同一个 1919 端口承载 /admin-desktop/ 与 /wx-app/

服务号网页 App 使用说明

• 统一前端入口：https://你的域名/web-admin/
• 服务号网页 App 真实挂载路径：https://你的域名/wx-app/
• 微信内打开时优先作为服务号工作台使用，桌面设备访问会自动跳转到 PC 后台
• 登录页提供首次注册入口，注册表单提交至 /api/auth/register
• 登录支持账号密码，后续可补充微信网页授权绑定
• 工作台按角色显示待办、下一步节点、消息提醒和最近操作
• 不同角色的视图不同：
• 申请人重点使用：我的流程、我的资料、材料维护
• 审核者重点使用：待办处理、消息提醒、流程查询和关键节点确认
• 第一阶段验收边界为前 12 步 MVP；13 步以后作为后续阶段保留在流程定义中，不进入当前待办办理
• 材料按步骤和标签归集，不单独拆分总档案夹

后台使用说明

• 默认演示/开发管理员账号：admin / 123456
• 桌面后台用于完整台账、导出、流程配置和组织管理
• 服务号网页 App 用于微信手机端中的待办处理、消息提醒、资料维护、流程查看和材料上传
• 登录后按角色展示菜单
• 申请人台账支持单位、支部、阶段和关键字筛选
• 流程详情页查看单个申请人的 25 步记录
• 审核审批页处理待审节点
• 统计分析页查看单位/支部维度统计
• 数据导出页下载台账和统计报表
• 流程配置页维护每步起止时间
• 登录页与侧边栏靠后位置提供“更多选项”，可切换“样式1/样式2”

服务部署说明与要求

• 建议环境：Linux 云主机
• 反向代理：Nginx
• 进程管理：PM2
• 数据库：MySQL 8.x
• 证书要求：后端 API 和后台域名均为 HTTPS
• 上传目录：独立持久化目录，例如 /data/party-building/uploads
• 服务号网页授权：需配置 WECHAT_SERVICE_APP_ID、WECHAT_SERVICE_APP_SECRET、WECHAT_SERVICE_REDIRECT_URI
• frp 端口规划：
  • 1145 -> 3000：服务端 API
  • 1919 -> 1919：统一前端网关
• Navicat 数据库管理建议继续通过 VMware NAT 或受控内网访问，不通过 frp 暴露数据库

详细步骤见：

• 部署文档
• 微信服务号 API 代理部署
• 团队协作与测试服部署流程
• 项目总览
• 全程记实表整理与研发参考
• 4月20会议纪要
• 发展流程说明
• 25 步流程办理类型与责任角色
• 模块维护说明
• 开发调试记录

当前实现状态

• 已完成前后端分离代码结构
• 已将手机端正式方向切换为微信服务号网页 App
• 已将服务端切换到 MySQL + JWT + 环境变量配置
• 已提供后台静态构建与 Nginx 示例配置
• 已补充微信账号绑定的数据表和后端接口骨架
• 已补齐服务端 /api/mobile/* 第一阶段工作台接口
• 已保证后台系统和服务端联调链路可用
• 已修复开发环境下后台登录的 CORS/环境配置故障
• 已为服务号网页 App 重建登录、工作台、流程办理、消息中心、材料维护和资料页
• 已将演示姓名统一匿名化为 Name
• 已将前 12 步的部分细化规则并入任务化配置字段
• 已整理《发展党员全程记实表》结构，作为 25 步 每步填写/提交内容的研发参考
• 已新增 user_profiles，用于承接非申请人角色资料存储
• 已提供 npm run reset-admin 修复开发环境管理员口令漂移
• 已移除移动端暗黑模式分支，统一收口为高对比度正式亮色样式
• 已将服务号网页 App 固定到 /wx-app/
• 已将桌面后台保留在 /admin-desktop/，并按设备自动分流
• 已将对外前端入口收口为 /web-admin/，旧 /admin/、/m-admin/、/web-admin/mobile/ 不再保留
• 已从主仓库路径清理历史小程序入口、页面与依赖，移动端只保留服务号 H5 主线
• 已将前 12 步设为第一阶段 MVP 办理边界，并补强流程提交/审核权限校验
• 已按新增需求补齐前 12 步主链路结构化字段，H5 节点详情可动态填写/回显，审核结果会推进或阻断后续节点
• PC 后台已支持单位、支部基础维护，并可在流程详情查看每步业务记录

后续建议

• 接入正式统一身份认证
• 将密码哈希升级到更强算法
• 引入对象存储替代本地文件目录
• 增加流程节点的更细粒度校验与审计
• 继续细化 25 步步骤字段、材料标签、通知模板和时间规则
• 根据会议纪要和笔录补齐“25 步 -> 具体填写/提交内容”映射
• 完成服务号网页授权、模板消息和点击回跳的正式联调