Pre_Seg_Server/工程分析/需求分析-2026-04-29-22-29-26.md

需求分析 - 2026-04-29-22-29-26

需求来源

• 提出时间: 2026-04-29-22-29-26
• 需求类型: 文档完善

原始需求描述

完善 README.md，在其中加入程序部署流程。

需求拆解

需求 1: 重写 README.md 项目概述

• 详细描述: 当前 README 仍为 AI Studio 旧模板，需更新为反映全栈语义分割系统的真实定位
• 优先级: P0-阻塞
• 影响范围: README.md
• 验收标准: README 开篇准确描述项目定位、核心功能、技术栈

需求 2: 加入系统架构图/说明

• 详细描述: 用文本或 Markdown 表格描述前后端架构拓扑
• 优先级: P0-阻塞
• 影响范围: README.md
• 验收标准: 读者可从 README 理解系统各层级关系

需求 3: 加入完整部署流程

• 详细描述: 包含基础设施安装（PostgreSQL/Redis/MinIO/FFmpeg）、Conda 环境配置、Python 依赖安装、模型权重下载、前后端启动
• 优先级: P0-阻塞
• 影响范围: README.md
• 验收标准: 新用户按 README 可独立完成从零到运行的全部部署

需求 4: 加入目录结构说明

• 详细描述: 列出 backend/、src/、models/ 等关键目录的用途
• 优先级: P1-高
• 影响范围: README.md
• 验收标准: 目录结构清晰，便于开发者快速定位代码

需求 5: 加入环境变量和配置说明

• 详细描述: 说明 .env、backend/.env 等配置文件的作用和必填项
• 优先级: P1-高
• 影响范围: README.md
• 验收标准: 配置项完整，默认值合理

约束条件

• 使用中文撰写 README（界面已中文，文档保持一致）
• 不修改任何业务代码
• 保留现有 banner 图片（如有）

风险评估

风险点	影响	缓解措施
文档与实际代码不同步	中	基于实际已部署的代码和配置编写