2026-04-29-22-29-26 - 完善README.md：系统架构+技术栈+完整部署流程+常见问题

2026-04-29 22:32:06 +08:00
parent fd4b5e5b3d
commit f41d9c20f5
5 changed files with 536 additions and 10 deletions
--- a/工程分析/经验记录.md
+++ b/工程分析/经验记录.md
@@ -99,4 +99,22 @@ AI 助手运行的容器/环境与项目实际开发环境分离，后者才装

 ---

+## 2026-04-29-22-29-26 — README.md 完善
+
+### A. 具体问题
+项目全栈改造完成后，README.md 仍为旧版 AI Studio 模板，未反映真实系统架构和部署流程，新用户无法按文档独立完成部署。
+
+### B. 产生原因
+前期聚焦功能开发，文档滞后；改造涉及后端/前端/基础设施/AI 模型多个层级，文档编写工作量大。
+
+### C. 解决方案
+按代码编纂工作流，编写需求分析→实现方案→测试方案，然后一次性重写 README.md，涵盖系统架构、技术栈、目录结构、分步部署命令、环境变量、访问凭证、常见问题。
+
+### D. 后续如何避免问题
+- 任何架构级变更后，同步更新 README.md
+- 将 README 纳入代码审查清单
+- 新成员入职时按 README 走通部署流程作为验收标准
+
+---
+
 > 新增经验请追加到文件末尾，保持时间倒序或正序均可，但需确保每条经验包含完整的 A/B/C/D 四段。