面向 C 端用户与上门服务者的家政 / 本地生活预约应用,目标是把服务浏览、时段预约、订单跟踪与服务者接单集中到同一移动端,解决服务信息分散、预约时段不透明、订单状态难追踪的问题。
核心功能模块包括:服务目录(清洁、维修、装修、搬家四类,支持关键词搜索与分类标签筛选)、服务详情(服务内容、评分、服务者信息与到付说明)、预约下单(日历选择日期、可选时段、上门地址与备注,到付结算)、订单中心(订单列表、详情与 pending→accepted→in_progress→completed/cancelled 状态时间线)、服务者工作台(查看新订单并接单、开始、完成)、完成后评价,以及账号登录 / 注册与客户–服务者角色切换;界面支持中英文双语。
业务流程:用户浏览分类或搜索服务 → 进入详情确认内容与价格 → 选择日期、时段、地址并提交订单 → 服务者在工作台接单 → 进行中 → 服务完成后用户评分评价;同一应用内可切换客户与服务者视角。
整体采用 Flutter + Dart 跨端框架,按功能优先(feature-first)分层组织:UI 层(features/*/presentation)通过 Riverpod Notifier 管理状态,调用仓储接口;仓储提供 Mock/Fake 与 Supabase 两套实现,可在无云凭据的离线 Mock 模式下直接演示,接入 Supabase 后启用邮箱认证与订单、评价的云端同步。路由使用 go_router,日历选择基于 table_calendar,本地化通过 intl + ARB 文件实现中英双语,本地偏好用 shared_preferences 持久化;后端通过一份 SQL 迁移脚本初始化服务、服务者、订单、评价等表结构。
由本人独立完成前端全部模块与后端 schema 设计:工程划分 8 个功能模块(认证、服务、订单、评价、服务者、资料、会话、设置),共 64 个 Dart 源文件、10 个主要页面、9 个测试文件,覆盖服务仓储、订单时段、服务者接单流程、评价与云端同步等场景。
主要难点与处理:一是后端可切换,通过仓储接口与依赖注入隔离离线 Mock 与云端实现,避免演示绑定云环境;二是多语言,把时长、分类、订单状态等文案抽离到 ARB 映射,避免界面硬编码;三是双角色共存,客户与服务者视图在同一工程内按角色路由与数据视图切换;四是订单状态机用枚举统一描述流转,并以单元测试锁定关键流程。当前版本为到付结算,未接入在线支付;演示账号为内存态,不含推送与应用内聊天