在装闭 RenoPit 中用户不是直接上传一批文件并调用 AI而是先创建“装修项目”再围绕项目管理素材和分析结果。本篇对照开源仓库 fthux/RenoPit从 React 页面一路追踪到 FastAPI 和 SQLAlchemy。一、项目列表是业务入口ProjectsPage.tsx请求GET /api/projects?page1page_size8把返回的projects、total和total_pages分别写入页面状态。后端list_projects()先统计总数再计算偏移量offset(page-1)*page_size projects_orm(db.query(Project).order_by(Project.created_at.desc()).offset(offset).limit(page_size).all())每条 ORM 记录经过_project_to_response()转换同时计算图片和文件数量。前端根据status显示待分析、分析中、已完成或失败等状态。如果当前页存在analyzing项目页面会启动定时刷新等待后台任务改变项目状态。二、创建项目分成两次请求CreateProjectPage同时收集项目名称、描述、补充说明和待上传文件但提交时并没有把所有数据塞进一个请求。第一步向POST /api/projects发送 JSONconst createRes await fetch(${API}/projects, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ name, description, input_text: inputText }), })后端创建 UUID、访问令牌和pending状态提交后返回项目 ID。第二步前端把选中的文件放进FormData请求/api/projects/{id}/upload。上传完成后才跳转到项目详情页。这种调用顺序决定了项目是文件的归属入口即使没有图片用户只填写补充说明也能得到一个可以启动纯文本分析的项目。三、项目详情页如何加载数据ProjectPage.tsx从路由参数取得projectId并行请求三组数据/projects/{id}获取项目元数据/projects/{id}/files获取文档/projects/{id}/images获取图片。项目名称、描述和补充说明支持行内编辑。保存时页面根据当前字段构造局部 JSON再调用PUT /api/projects/{id}。后端只修改请求体中不为None的字段更新updated_at后返回新的ProjectResponse。四、复制项目同时复制数据库和磁盘项目列表中的复制操作会先显示确认对话框确认后前端调用POST /api/projects/{id}/duplicate。后端创建新的项目 UUID并把名称默认改成“原名称副本”。新项目会继承描述和补充说明但状态重新设为pending分析结果和报告不会复制。当copy_filestrue时复制过程有两层为每个ProjectImage和ProjectFile创建新的数据库记录把存储路径中的旧项目 ID 替换为新 ID再通过shutil.copy2()复制物理文件。extracted_text也会跟随ProjectFile复制因此新项目不必重新解析原文档。所有记录添加完成后统一commit再把新项目返回给前端。五、删除项目依赖关联关系删除操作同样先经过确认前端请求DELETE /api/projects/{id}后端检查项目存在后只执行两步db.delete(project)db.commit()图片、文件、分析和报告的数据行由 SQLAlchemy 的delete-orphan和数据库外键级联处理。这个接口本身没有逐个删除关联记录也没有在函数中遍历磁盘目录。请求成功后前端清空确认状态并重新请求当前页让列表数量和分页数据回到后端的最新结果。六、项目状态贯穿整个生命周期项目创建和复制时状态都是pending触发分析后变成analyzingCelery 任务结束后写为completed或failed。项目列表、详情页、按钮可用性和报告入口都读取同一个字段。因此项目生命周期不仅是 CRUD还承担了前端和异步任务之间的状态协议。React 不需要理解 Celery 的内部细节只要持续读取项目状态就能决定显示“开始分析”“停止分析”还是“查看报告”。七、项目调用链小结RenoPit 的项目操作形成了一条稳定主线先创建项目再关联文件编辑只更新元数据复制创建新的项目边界并复制素材删除通过 ORM 关系清理数据AI 状态则持续写回同一条项目记录。上述页面和接口均来自 fthux/RenoPit。下一篇将进入/upload接口内部继续分析装修图片、合同和报价单上传后如何落盘、压缩并提取文本。