大森林
|
1e58fd5490
|
docs: 再次精简 README 与部署文档,按主题拆分
目标:门面文档只放"最常用",把"深水区"分到独立文件,按需查阅。
README(299 → 205 行):
- 合并 "为什么选择 Jeepay" + "适用场景" 为 "Jeepay 适合谁" 一节。
- 删除 "系统能力概览"(信息已在项目简介 + Jeepay 适合谁里)。
- 删除 "快速开始"(环境要求 / 代码获取 / 首次启动流程都在 docs/deploy/*
里更详细)。
- 删除 "在线体验" + "版本与兼容性说明"(前者并入"贡献与协作"尾行,
后者内容已散在 CONTRIBUTING.md / upgrade.md 里)。
- "贡献与协作"段一句话指向 CONTRIBUTING.md,不再重复列清单。
docs/deploy/shell.md(248 → 79 行):只保留"5 分钟上手 + 常用命令 +
卸载 + 高级覆盖项表"。移除宿主端口冲突详解、HTTPS 反代、RocketMQ 排查、
ARM64 说明等细节段,全部外迁。
docs/deploy/compose.md(218 → 63 行):目录约定 + 启动命令 + 端口 /
账号 + 常用命令;移除镜像发布章节(对终端用户无用)外迁。
docs/deploy/troubleshooting.md(31 → 132 行):从 shell.md 吸收 RocketMQ
启动失败、brokerIP 缓存问题、WebSocket 101 卡住、application.yml 变目录、
镜像 403、打包排障现场等排障条目,成为统一的故障诊断入口。
新增 docs/deploy/https.md(88 行):域名 + HTTPS 反代模板(从 shell.md
搬出),含 nginx 配置示例、certbot 申请命令、第三方支付回调 URL 注意
事项、防火墙建议。
新增 docs/deploy/publish.md(62 行):Docker Hub / 华为云 SWR 镜像发布
脚本说明(从 compose.md 搬出),只给维护者看。
净删除 528 行,新增 211 行;整体更紧凑,每篇文档聚焦单一主题。
|
2026-04-22 13:08:43 +08:00 |
|