文档目录结构简洁化

2026-09-01 18:05:18 +08:00
parent bee439cf34
commit 5e531ffe1e
47 changed files with 1334 additions and 3380 deletions
@@ -1,5 +1,7 @@
 # 模块化部署端口说明

+> 文档定位：**当前部署下的端口规划补充说明**。
+> 部署入口与当前推荐方案见 [../DEPLOYMENT.md](../DEPLOYMENT.md)，Linux 部署步骤见 [LINUX_SETUP.md](LINUX_SETUP.md)。
 > 本文档描述的是 **当前模块化部署模式** 下的端口规划，不再以历史单体 `src.main:app` 作为默认前提。

 当前推荐部署对象：
@@ -128,7 +130,7 @@ VITE_INVENTORY_API_BASE_URL=https://inventory.example.com
 ```

 当前详细策略见：
- [BACKEND_MODULARIZATION_BLUEPRINT.md](../BACKEND_MODULARIZATION_BLUEPRINT.md)
+- [archive/BACKEND_MODULARIZATION_BLUEPRINT.md](../archive/BACKEND_MODULARIZATION_BLUEPRINT.md)

 ---

@@ -1,6 +1,8 @@
 # geMoldInsight Linux 部署指南

-> 本文档描述的是 **当前模块化架构** 下的 Linux 部署方式，而不是历史单体 `src.main:app` 方案。
+> 文档定位：**Linux 环境下的详细部署操作文档**。
+> 当前部署主题入口见 [../DEPLOYMENT.md](../DEPLOYMENT.md)，当前项目状态见 [../STATUS.md](../STATUS.md)，当前架构边界见 [../ARCHITECTURE.md](../ARCHITECTURE.md)。
+> 本文档描述的是 **当前模块化架构** 下的 Linux 部署方式，而不是历史单体入口方案。

 当前项目支持三种部署模式：

@@ -17,7 +19,7 @@
 - **复用服务器上已存在的 PostgreSQL / Redis / RustFS(或 MinIO 兼容存储)**

 详细架构蓝图见：
- [BACKEND_MODULARIZATION_BLUEPRINT.md](../BACKEND_MODULARIZATION_BLUEPRINT.md)
+- [archive/BACKEND_MODULARIZATION_BLUEPRINT.md](../archive/BACKEND_MODULARIZATION_BLUEPRINT.md)

 ---

@@ -192,12 +194,12 @@ celery -A src.celery_app.celery_app worker --loglevel=info

 ## 6.3 unified

-当前仓库仍保留历史统一入口 [main.py](../../src/main.py)，但它更适合作为**过渡参考**，不建议作为长期标准入口。
+当前仓库历史上存在过统一入口，但它更适合作为**过渡参考**，不建议再作为长期标准入口。

 在正式完成组合层重构前，如需统一部署，可优先使用反向代理或部署编排层统一暴露 gemold 与 inventory；后续会演进为显式 `unified_app.py`。

 蓝图参考：
- [BACKEND_MODULARIZATION_BLUEPRINT.md](../BACKEND_MODULARIZATION_BLUEPRINT.md)
+- [archive/BACKEND_MODULARIZATION_BLUEPRINT.md](../archive/BACKEND_MODULARIZATION_BLUEPRINT.md)

 ---

@@ -421,6 +423,6 @@ docker compose --profile full up -d
 ## 12. 推荐阅读

 - [README.md](../../README.md)
- [BACKEND_MODULARIZATION_BLUEPRINT.md](../BACKEND_MODULARIZATION_BLUEPRINT.md)
+- [archive/BACKEND_MODULARIZATION_BLUEPRINT.md](../archive/BACKEND_MODULARIZATION_BLUEPRINT.md)
 - [DEPLOY_PORT.md](./DEPLOY_PORT.md)
 - [PORT_CONFIG.md](./PORT_CONFIG.md)
@@ -1,5 +1,7 @@
 # 端口配置说明（模块化架构）

+> 文档定位：**模块化部署下的端口与环境变量配置补充说明**。
+> 当前部署主题入口见 [../DEPLOYMENT.md](../DEPLOYMENT.md)，详细 Linux 部署步骤见 [LINUX_SETUP.md](LINUX_SETUP.md)。
 > 本文档说明当前 geMoldInsight 在**模块化部署**下的端口配置方式。

 当前架构中应区分：
@@ -174,5 +176,5 @@ Compose 通过端口映射暴露服务：

 - [LINUX_SETUP.md](./LINUX_SETUP.md)
 - [DEPLOY_PORT.md](./DEPLOY_PORT.md)
- [BACKEND_MODULARIZATION_BLUEPRINT.md](../BACKEND_MODULARIZATION_BLUEPRINT.md)
+- [archive/BACKEND_MODULARIZATION_BLUEPRINT.md](../archive/BACKEND_MODULARIZATION_BLUEPRINT.md)
 - [README.md](../../README.md)
@@ -1,39 +0,0 @@
-# 端口配置历史说明（已被模块化部署文档取代）
-
-本文件保留为历史说明。
-
-它所描述的“单体应用单一端口配置”思路，已经不再能完整代表当前 geMoldInsight 的模块化架构。
-
-当前项目已演进为：
-
- gemold 模块可独立部署
- inventory 模块可独立部署
- unified 作为组合模式存在
- gemold 与 inventory 应分别考虑端口与网关暴露方式
-
-因此，端口配置的权威说明已转移到以下文档：
-
- [LINUX_SETUP.md](./LINUX_SETUP.md)
- [DEPLOY_PORT.md](./DEPLOY_PORT.md)
- [PORT_CONFIG.md](./PORT_CONFIG.md)
- [BACKEND_MODULARIZATION_BLUEPRINT.md](../BACKEND_MODULARIZATION_BLUEPRINT.md)
-
---
-
-## 当前结论
-
-1. 不再默认以历史单体 `src.main:app` 作为部署中心。
-2. 不再假设整个系统只有一个后端端口。
-3. gemold 与 inventory 应按模块分别规划端口。
-4. unified 更适合通过组合层或网关统一暴露，而不是继续沿用旧单体部署语义。
-
---
-
-## 建议
-
-如果你正在查找当前有效的端口/部署方式，请不要继续参考旧的单体端口说明，而应直接查看：
-
- [README.md](../../README.md)
- [LINUX_SETUP.md](./LINUX_SETUP.md)
- [DEPLOY_PORT.md](./DEPLOY_PORT.md)
- [PORT_CONFIG.md](./PORT_CONFIG.md)