rlz/docs/项目文档0511.md

瑞来兹医助 (RLZ) 项目文档

最后更新：2026-05-11 项目路径：/home/renjianbo/saars/rlz/ Git 仓库：http://101.43.95.130:3001/admin/rlz

---

项目概述

瑞来兹医助是一个陪诊服务综合平台，包含以下子系统：

子系统	技术栈	说明
rlz (后端)	Java 1.8 + Spring Boot + MyBatis + Maven	基于若依(RuoYi) 3.8.3 的后端管理系统
rlz-ui (管理前端)	Vue 2.6 + Element UI + Vuex + Vue Router	基于若依-Vue 的管理后台界面
peizhen (Android)	Android (Gradle 8.7.3) + Java	陪诊师端 Android App
coupon (微信小程序)	微信原生 + Vant Weapp	用户端微信小程序

---

一、rlz — 后端服务

技术栈

• 框架: Spring Boot (若依 RuoYi 3.8.3)
• 语言: Java 1.8
• 构建: Maven
• 数据库: MySQL 8 (腾讯云 CynosDB)
• 缓存: Redis 7
• ORM: MyBatis
• 连接池: Druid 1.2.11
• 其他: JWT, Swagger, Fastjson, PageHelper

模块结构

rlz/
├── ruoyi-admin/      # 主应用模块 (Controller + 配置)
├── ruoyi-common/     # 公共工具模块
├── ruoyi-framework/  # 框架核心模块
├── ruoyi-system/     # 系统管理模块
├── ruoyi-quartz/     # 定时任务模块
├── ruoyi-generator/  # 代码生成模块
├── sql/              # 数据库脚本
│   ├── ry_20220625.sql   # 基础数据
│   └── quartz.sql        # 定时任务表
├── Dockerfile        # 多阶段构建
└── pom.xml           # 根 POM

核心功能

• 系统管理: 用户/角色/菜单/部门/岗位/字典管理
• 业务功能: 医院管理、订单管理、认证管理
• 监控管理: 在线用户、操作日志、登录日志、服务监控、缓存监控
• 开发工具: 代码生成器、Swagger 文档

配置文件

文件	说明
application.yml	主配置
application-docker.yml	Docker 环境配置
application-dev.yml	开发环境配置
application-druid.yml	Druid 数据源配置
logback.xml	日志配置

Docker 部署

• 端口: 8039
• 构建: docker build -t rlz-backend:latest .
• 编排: docker compose up -d --build（项目根目录）
• 依赖: Redis (容器内) + MySQL (腾讯云 CynosDB 外部)
• JVM: -Xms512m -Xmx1024m

数据库连接

参数	值
Host	gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com
Port	24936
Database	rlz
User	root

---

二、rlz-ui — 管理后台前端

技术栈

• 框架: Vue 2.6.12
• UI 库: Element UI 2.15.8
• 状态管理: Vuex 3.6
• 路由: Vue Router 3.4
• 图表: ECharts 4.9
• HTTP: Axios 0.24
• 构建: Vue CLI 4.4.6
• 富文本: Quill 1.3
• 代码高亮: Highlight.js

目录结构

rlz-ui/
├── src/
│   ├── views/
│   │   ├── system/     # 系统管理页面
│   │   │   ├── user/     # 用户管理
│   │   │   ├── role/     # 角色管理
│   │   │   ├── menu/     # 菜单管理
│   │   │   ├── dept/     # 部门管理
│   │   │   ├── post/     # 岗位管理
│   │   │   ├── dict/     # 字典管理
│   │   │   ├── config/   # 参数配置
│   │   │   ├── notice/   # 公告管理
│   │   │   ├── hospital/ # 医院管理
│   │   │   ├── order/    # 订单管理
│   │   │   └── renzheng/ # 认证管理
│   │   ├── monitor/    # 监控管理
│   │   ├── tool/       # 开发工具
│   │   └── dashboard/  # 仪表盘
│   ├── layout/         # 布局组件
│   ├── router/         # 路由配置
│   ├── plugins/        # 插件
│   └── App.vue         # 根组件
├── public/             # 静态资源
├── dist/               # 构建产物
└── package.json

启动命令

npm run dev           # 开发模式
npm run build:prod    # 生产构建
npm run build:stage   # 预发布构建

---

三、peizhen — 陪诊 Android App

技术栈

• 语言: Java
• 构建: Gradle 8.7.3 + Android Gradle Plugin 8.7.3
• 编译 SDK: 34
• 最低 SDK: 26 (Android 8.0)
• 目标 SDK: 34
• 包名: com.ruilaizi.service
• 版本: 1.0.1 (versionCode 101)

项目结构

peizhen/
├── app/
│   ├── src/main/
│   │   ├── java/com/ruilaizi/service/
│   │   │   ├── main/
│   │   │   │   ├── activity/       # 主 Activity（登录、主页等）
│   │   │   │   ├── find/           # 发现模块
│   │   │   │   ├── kehu/           # 客户管理模块
│   │   │   │   ├── my/             # 我的模块（订单、红包、认证等）
│   │   │   │   └── task/           # 任务模块
│   │   │   ├── base/               # 基础类（BaseActivity, BaseFragment 等）
│   │   │   ├── network/            # 网络层（Retrofit + HTTP）
│   │   │   ├── okgonet/            # 自定义网络框架
│   │   │   ├── db/                 # 本地数据库
│   │   │   ├── dialog/             # 对话框组件
│   │   │   ├── utils/              # 工具类
│   │   │   ├── view/               # 自定义 View（含 WebView）
│   │   │   ├── widget/             # 小组件
│   │   │   ├── common/             # 公共常量
│   │   │   └── wxapi/              # 微信 SDK 回调
│   │   ├── res/                    # 资源文件
│   │   └── AndroidManifest.xml
│   ├── libs/                       # JAR 依赖
│   │   ├── wechat-sdk-android-without-mta-1.0.2.jar
│   │   ├── ShareSDK-Wechat-Core-2.8.3.jar
│   │   ├── fastjson-1.1.43.android.jar
│   │   ├── eventbus-2.4.0.jar
│   │   └── tbs_sdk_thirdapp_v3.2.0...jar (腾讯浏览服务)
│   ├── release/output-metadata.json
│   └── build.gradle
├── baselibs/                       # 基础库模块
├── citypicker/                     # 城市选择器模块
├── gradle/
├── build.gradle                    # 根构建脚本
├── settings.gradle
└── gradle.properties

核心功能

• 用户登录: 密码登录、验证码登录、短信登录、微信登录
• 陪诊订单: 订单管理、接单、完成、评价
• 客户管理: 客户信息、客户分配、客户跟进
• 红包/钱包: 红包收发、钱包管理
• 认证: 实名认证
• IM 即时通讯: 会话、评论
• 消息通知: 系统消息推送

签名配置

• 签名文件: ruilaizi.jks
• 别名: 123456

---

四、coupon — 微信小程序

技术栈

• 框架: 微信原生小程序
• UI: Vant Weapp 组件库
• AppID: wx2d5ca40a16ebd1b3
• 基础库: 2.21.0
• 分包: 支持 (shopping 子包)

目录结构

coupon/
├── pages/                    # 主包页面
│   ├── index/                # 首页
│   ├── order/                # 订单列表
│   ├── orderdetail/          # 订单详情
│   ├── reforderdetail/       # 退款订单详情
│   ├── peizhen/              # 陪诊服务
│   ├── peihu/                # 陪护服务
│   ├── my/                   # 我的
│   ├── mechanism/            # 机构
│   ├── myshoucang/           # 我的收藏
│   ├── wodeqianbao/          # 钱包
│   ├── tuiguang/             # 推广
│   ├── guanyu/               # 关于
│   └── webpage/              # Web页面
├── shopping/                 # 分包 (购物)
│   └── pages/
│       ├── goddess/          # 女神
│       ├── payment/          # 支付
│       ├── paysuccess/       # 支付成功
│       └── withdrawal/       # 提现
├── component/                # 组件
│   └── picker/               # 日期选择器
├── miniprogram/@vant/weapp/  # Vant 组件库
├── utils/                    # 工具函数
├── app.js                    # 小程序入口
├── app.json                  # 小程序配置
├── app.wxss                  # 全局样式
└── project.config.json       # 项目配置

TabBar

页面	路径
首页	pages/index/index
订单	pages/order/order
我的	pages/my/my

核心功能

• 陪诊/陪护服务展示与预约
• 订单管理（下单、支付、退款）
• 钱包/余额管理
• 推广分销
• 机构展示

---

五、Docker 环境

Docker Compose 服务

服务	镜像	端口	说明
rlz-redis	redis:7-alpine	6379 (内部)	Redis 缓存
rlz-backend	rlz-backend:latest	8039	Java 后端

相关卷

卷名	用途
rlz-redis-data	Redis 持久化数据
rlz-upload	文件上传目录
rlz-logs	应用日志

---

六、部署架构

┌─────────────────────────────────────────┐
│           腾讯云服务器 101.43.95.130       │
│                                          │
│  ┌──────────────┐  ┌──────────────────┐ │
│  │  rlz-backend  │  │    rlz-redis     │ │
│  │  (Java 1.8)  │  │   (Redis 7)     │ │
│  │  Port: 8039   │  │   Port: 6379     │ │
│  └──────┬───────┘  └──────────────────┘ │
│         │                                │
└─────────┼────────────────────────────────┘
          │
          ▼
┌─────────────────────┐
│   腾讯云 CynosDB     │
│   (MySQL 8)         │
│   Port: 24936       │
└─────────────────────┘

---

七、关键脚本与测试文件

文件	说明
docker-compose.yml	Docker 编排，一键启动 Redis + 后端
.env	Docker Compose 环境变量（含数据库密码，需保密）
Docker部署说明.md	Docker 部署文档
fix_firewall.sh	防火墙修复脚本
test_api.py / test_api.sh	API 测试脚本
test_weixin_login.sh	微信登录测试
test_sms_login.py	短信登录测试
test_password_login.py	密码登录测试
test_postman_api.sh	Postman API 测试
postman_test_token.sh	Postman Token 测试
quick_test.sh	快速测试
测试公网连接.sh	公网连接测试

八、相关文档

文档	说明
陪诊项目需求文档.txt	项目需求说明
项目文档.txt	项目总览文档
API文档.txt	API 接口文档
Android接口配置说明.txt	Android 接口配置
Android配置说明.txt	Android 配置说明
后台管理系统访问说明.md	后台访问说明
对外访问地址说明.md	外部访问地址说明
完整配置检查清单.txt	配置检查清单
前端服务启动说明.md	前端启动文档
Docker部署说明.md	Docker 部署文档

---

九、Git 仓库信息

• Gitea: http://101.43.95.130:3001/admin/rlz
• 当前分支: main
• 最新提交: 包含 peizhen (Android) 和 coupon (小程序) 代码，已作为普通目录纳入仓库