用户与问题
家庭中的点餐和做饭协作通常依赖临时聊天：想吃什么说不清、点过的菜容易遗漏、主厨不知道哪些菜已经确认、采购时还要重新整理食材。
传统菜谱产品主要解决“如何做菜”，却没有连接点餐人、主厨、菜单和采购清单。与此同时，如果家庭中只有一个人使用 iPhone，强制双人协作又会让产品无法真正落地。
小家饭需要同时解决三个问题：让点餐足够轻松，让主厨能够清楚执行，并让单人家庭也能跑通完整流程。
Project case study
小家饭（Mickey’s Kitchen）
面向小夫妻与小家庭的菜谱和点餐协作 App，把“今天吃什么”转化为点餐、审批、采购与备菜的完整家庭协作流程。
Overview
为什么要做这个产品？
目标与结果
项目目标是建立一条从“想吃什么”到“知道买什么、做什么”的完整家庭用餐闭环，同时保证流程可以逐步扩展为可商业化产品。
目前已经形成可运行的 iOS App、FastAPI 服务端和 React 管理后台，覆盖邮箱账户、家庭空间、点餐、逐道审批、菜谱管理、采购清单、历史与收藏、用户反馈等核心模块；同时建立数据库迁移、自动化测试和 GitHub Actions 持续集成流程。
项目仍处于持续开发和真实用户验证阶段，推送通知、部分对象存储及第三方菜谱提取能力还需要结合正式服务配置继续完善。
Product
核心体验与界面
截图按真实业务场景组织；选择任意界面，可在当前场景内逐张查看。
轻松完成家庭点餐
点餐人通过菜谱和常点内容选择菜品，快速建立下一餐菜单，并查看提交后的处理状态。
主厨审批与采购
主厨逐道处理家庭成员提交的菜品，并将确认后的菜单自动转化为采购清单。
沉淀家庭菜谱
主厨维护家庭长期使用的菜谱库，让每次点餐和采购都能复用已经积累的内容。
运营管理后台
独立管理后台用于维护平台菜谱、家庭空间、用户反馈和产品运营配置。
项目仓库
项目保存GitHub私人仓库
My contribution
我的贡献
- 01
产品定义与范围控制
从家庭点餐场景出发定义核心用户、产品定位、业务闭环和阶段边界，并将复杂需求拆分为可逐步验证的版本。
- 02
用户旅程与交互设计
设计首次使用、点餐、审批、采购、菜谱维护和单人模式等关键旅程，明确不同角色的导航、状态反馈和异常路径。
- 03
领域模型与系统架构
建立家庭空间、成员角色、菜谱、点餐批次、订单快照和空间权益等领域模型，并设计 iOS、服务端和管理后台的协作边界。
- 04
独立全栈实现
完成 SwiftUI iOS 客户端、FastAPI 服务端、PostgreSQL 数据模型、Redis 异步能力以及 React 管理后台的开发与联调。
- 05
测试与交付治理
为关键业务规则建立单元测试和集成测试，配置数据库迁移、Docker 开发环境与 GitHub Actions 持续集成，降低持续迭代风险。
- 06
部署与运维
设计并维护开发、测试与生产环境的部署方案，使用 Docker 编排服务，配置数据库迁移、健康检查、日志排查、数据备份与发布回滚流程，保障系统稳定运行和持续迭代。
Key decisions
关键产品决策
- 01
以家庭空间作为协作边界
成员、角色、菜谱、订单和权益都归属于同一个家庭空间，避免将家庭协作错误地建模为个人数据的简单共享。
- 02
同时支持协作模式与单人模式
双人使用时保留点餐与审批闭环；只有一台 iPhone 时跳过审批，将点餐、采购和菜谱能力合并，保证产品在真实家庭条件下仍然可用。
- 03
允许从不完整菜卡开始
点餐人找不到菜品时可以先输入菜名生成占位卡，由主厨后续补充食材和步骤，避免完整录入成本阻断点餐。
How I built it
构建过程
- 01
01 产品定义
从家庭日常点餐与做饭沟通中提炼问题，确定“点餐—审批—采购—备菜”主流程，并控制首个版本的功能边界。
- 02
02 体验与领域设计
梳理角色、家庭空间、单人模式、订单状态和菜谱生命周期，形成 PRD、用户旅程、领域语言与接口契约。
- 03
03 三端开发实现
分别构建 SwiftUI iOS App、FastAPI 服务端和 React 管理后台，逐步打通账户、空间、菜谱、点餐、审批和采购流程。
- 04
04 测试与质量门禁
围绕领域规则、API、数据库迁移和核心界面编写自动化测试，并使用 CI 持续验证后端、后台和 iOS 工程。
- 05
05 小规模产品验证
以真实家庭使用为下一阶段重点，验证首次使用理解成本、点餐效率、主厨审批体验和采购清单的实际帮助。
- 06
部署运维
设计并维护开发、测试与生产环境的部署方案，使用 Docker 编排服务，配置数据库迁移、健康检查、日志排查、数据备份与发布回滚流程，保障系统稳定运行和持续迭代。
Outcome
项目成果
完成一套由 iOS App、FastAPI 服务端和 React 管理后台组成的家庭点餐协作产品。
产品已覆盖家庭空间、邮箱账户、点餐、逐道审批、菜谱管理、采购清单、历史收藏、单人模式、意见反馈和运营管理等核心能力，并建立数据库迁移、Docker 环境、自动化测试与持续集成体系。
项目证明了我能够从真实生活问题出发，独立完成产品定义、复杂业务建模、交互设计、全栈开发和持续交付。目前产品下一步计划加入健康餐饮推荐AI系统
Retrospective
项目复盘
项目目标是建立一条从“想吃什么”到“知道买什么、做什么”的完整家庭用餐闭环，同时保证流程可以逐步扩展为可商业化产品。
目前已经形成可运行的 iOS App、FastAPI 服务端和 React 管理后台，覆盖邮箱账户、家庭空间、点餐、逐道审批、菜谱管理、采购清单、历史与收藏、用户反馈等核心模块；同时建立数据库迁移、自动化测试和 GitHub Actions 持续集成流程。
项目仍处于持续开发和真实用户验证阶段，推送通知、部分对象存储及第三方菜谱提取能力还需要结合正式服务配置继续完善。