面向跨文化饮食的智能点餐助手系统——个人工作复盘（组长）

一、项目总览与个人定位

本项目为课程实训重点项目，致力于打造服务海外出行、跨文化饮食场景的智能点餐助手，核心解决用户在国外餐厅菜单看不懂、菜品不了解、点餐无参考的痛点，实现菜单拍照识别→AI翻译解析→菜品深度分析→智能推荐→收藏/购物车的全流程智能服务。
我在团队中担任项目组长，同时是全栈核心开发者，全程主导项目架构设计、技术选型、0-1搭建、核心功能研发、团队分工、问题攻坚、联调落地，是项目从无到有、从Demo到完整可用应用的核心推动者。

二、核心工作总述

• 顶层设计：独立完成项目技术选型、前后端数据库架构规划、接口规范制定；
• 基建搭建：从零搭建Flutter前端 + FastAPI后端 + MySQL数据库全栈底座，实现前后端联通；
• 核心功能研发：主导开发菜单多模态识别、AI翻译解析、菜品深度分析、文生图生成、用户系统、JWT认证、历史记录、收藏系统、购物车全核心业务；
• 团队管理：制定开发计划、拆分模块分工、统一开发标准、保障团队高效协作；
• 技术攻坚：解决全流程环境、兼容性、接口、数据解析、模型调用等各类疑难问题；
• 质量保障：统一前后端数据契约、优化交互体验、完成全链路联调落地。

---

三、分阶段详细工作内容

第一阶段：项目启动与全栈基建0→1搭建（核心奠基工作）

作为组长，我首先完成了项目从0到1的所有底层基建，为整个团队提供统一、可运行、可扩展的开发基础，避免重复开发与架构混乱。

1. 技术选型与架构规划

结合项目需求（跨端、AI集成、高并发、快速开发），我确定全套技术栈：

• 前端：Flutter（跨平台、高性能渲染）
• 后端：FastAPI（异步高并发、自动接口文档）
• 数据库：MySQL（稳定易用）
• ORM：SQLAlchemy 2.0（生产级数据操作）
• AI能力：Qwen多模态大模型、文生图模型
• 认证：JWT身份鉴权
  并规划清晰的三层架构：前端交互层 → 后端服务层 → 数据持久层。

2. 独立完成前端Flutter全框架搭建

• 初始化Flutter项目，完成环境配置、依赖管理；
• 设计项目首页，实现菜单上传、我的收藏、偏好设置核心入口；
• 搭建页面路由、公共组件、数据模型基础规范；
• 完成跨端适配，确保Android模拟器稳定运行。

3. 独立完成后端FastAPI框架搭建

• 初始化异步后端服务，配置uvicorn启动；
• 开发基础健康检查接口、文件上传接口（菜单识别入口）；
• 集成Swagger自动接口文档，方便团队调试与对接；
• 制定统一的接口返回格式（success/message/data），保障前端稳定解析。

4. 独立完成数据库设计与接入

• 创建menu_app数据库，设计用户表、历史记录表、购物车表、收藏表；
• 完成SQLAlchemy配置，解决数据库密码特殊字符转义、连接池、闲置断开问题；
• 实现ORM自动建表、数据读写CRUD基础能力；
• 为团队提供统一数据库规范，无需组员重复配置。

5. 前后端联通与基础联调

• 解决Android模拟器访问本地后端的网络问题（10.0.2.2宿主机映射）；
• 完成图片上传、接口请求、数据解析全链路打通；
• 输出可直接运行的Demo，作为团队统一开发基座。

🔴 核心贡献

本阶段100%基础架构均由我独立完成，是项目能够顺利推进的前提，为团队4个功能模块提供了统一开发环境、接口标准与运行底座。

---

第二阶段：核心AI功能开发（项目核心竞争力）

作为组长，我牵头攻克项目最核心、技术难度最高的AI能力模块，实现从“工具”到“智能应用”的升级。

1. 多模态菜单识别与翻译

• 抛弃传统OCR，接入Qwen-VL多模态大模型，直接对菜单图片进行语义理解；
• 设计高精度Prompt，强制模型输出结构化JSON（原文菜名、中文译名、描述、价格、标签）；
• 开发后端/upload核心接口，完成图片接收→模型调用→数据解析→结果返回全流程；
• 解决模型调用异常、格式不统一、解析失败等问题。

2. 菜品深度分析功能

• 开发/dish-details接口，实现点击菜品二次AI分析；
• 解析输出：原材料、过敏原、口味评分、菜系、烹饪方式、营养信息、饮食限制；
• 前端实现口味可视化进度条，提升用户体验。

3. 菜品文生图功能

• 集成Qwen-Image-2.0文生图模型，自动生成菜品示意图；
• 解决模型接口403、异步不支持、图片URL解析失败等疑难Bug；
• 实现图片URL下载→Base64编码→前端渲染全流程；
• 大幅提升详情页视觉效果与应用完整度。

🔴 核心贡献

AI能力是项目核心亮点，全部AI相关接口、模型对接、提示工程、数据结构化均由我独立开发，让项目具备了其他小组不具备的智能理解能力。

---

第三阶段：用户体系与业务闭环开发（应用化关键）

我主导完成项目商业化必备的用户系统与业务闭环，让项目从Demo升级为完整可用的全栈应用。

1. 用户注册/登录 + JWT身份认证

• 设计用户表，实现密码加密（bcrypt）；
• 解决passlib/bcrypt版本兼容、登录422格式错误等问题；
• 前端实现Token本地存储、全局请求头携带；
• 所有接口实现鉴权保护，确保数据安全。

2. 识别历史持久化

• 开发recognition_history表，自动保存用户每一次识别记录；
• 实现历史记录查询、展示、按用户隔离功能；
• 让应用具备“记忆能力”。

3. 收藏系统开发

• 设计favorite_dishes收藏表，支持按用户、按识别批次收藏菜品；
• 开发收藏/取消收藏/查询接口；
• 前端实现独立收藏页面，支持菜品收藏+表达收藏双分类展示。

4. 购物车系统升级

• 重构购物车，绑定用户ID、识别批次、来源图片；
• 实现购物车按菜单图片分组展示，大幅优化体验；
• 完成增删查全功能，实现数据持久化，重启不丢失。

🔴核心贡献

我独立完成了用户、认证、历史、收藏、购物车五大业务系统，构建了完整的用户行为闭环，让项目具备了真实使用价值。

---

第四阶段：团队管理与分工协作

在完成个人核心开发的同时，我履行组长职责，保障团队高效协作：

1. 模块拆分与分工
   将项目拆分为4大模块，结合组员特长分配任务：

• 菜单翻译与展示
• AI咨询对话
• 特色美食知识库
• 收藏与偏好系统
  我负责全栈基建 + 全部核心AI功能 + 业务系统 + 技术支持。

2. 统一开发规范

• 统一前后端字段命名、接口格式、数据模型；
• 统一数据库表结构、API请求方式；
• 避免字段不匹配、解析失败、联调不通等问题。

3. 技术支持与问题解决
   全程为组员解决疑难问题：

• Flutter环境配置、UI报错、空安全问题；
• 后端接口编写、数据库操作、联调401/404/422错误；
• 前后端数据对接、图片上传、Token携带等问题。

4. 进度管控
   制定开发计划，定期同步进度，把控项目里程碑，确保按时完成。

🔴 核心贡献

作为组长，我不仅完成了最核心的开发任务，还统筹整个项目进度、统一技术标准、解决团队所有技术障碍，保障项目高质量落地。

---

四、个人工作成果与贡献总结

1. 个人核心产出（硬核成果）

• ✅ 搭建Flutter + FastAPI + MySQL全栈架构（项目根基）
• ✅ 开发多模态菜单识别、AI翻译、菜品深度分析核心AI能力
• ✅ 实现文生图自动生成菜品图片，提升应用质感
• ✅ 构建用户登录/注册、JWT认证、历史记录、收藏、购物车完整业务系统
• ✅ 解决环境、网络、接口、模型、数据库全流程疑难Bug
• ✅ 完成前后端全链路联调，项目可完整演示运行

2. 组长管理贡献

• ✅ 制定项目技术路线与开发计划
• ✅ 拆分模块、合理分工，最大化团队效率
• ✅ 统一开发规范，避免重复造轮子
• ✅ 全程技术支持，保障所有组员顺利开发
• ✅ 把控项目质量与进度，按时完成目标

3. 项目价值提升

• 让项目从单纯的菜单识别工具升级为完整的智能点餐助手；
• 具备AI理解、用户体系、数据持久化、可视化展示等企业级能力；
• 功能完整、体验流畅、可直接演示，远超课程实训基础要求。

---

五、个人能力成长

• 全栈开发能力：熟练掌握Flutter前端、FastAPI后端、数据库设计、AI集成；
• 异步编程思维：精通Dart/Python异步、事件循环、高并发处理；
• AI工程化能力：掌握大模型对接、Prompt工程、结构化输出、文生图落地；
• 项目管理能力：具备架构设计、分工协作、进度管控、问题统筹能力；
• 实战攻坚能力：能独立解决全流程疑难问题，具备独立负责项目的能力。

---