痛点：中小型汽修门店的日常经营，长期依赖纸质工单、手工记账或通用记账软件，普遍面临几个问题：
1、记录零散、难追溯：维修工单、收支流水分散在纸单和微信里，车主再次来店时翻不到历史维修记录。
2、对不上账：收入、支出、利润靠月底手工汇总，容易漏记错记，看不清门店真实经营状况。
3、车辆信息录入慢：车牌号、车架号（VIN）靠手动敲，17 位 VIN 极易输错。
4、多人协作与责任不清：店里多个师傅/前台共用一套数据，谁改了什么无从查证。
5、网络不稳定：修理车间网络信号差，纯在线的系统一断网就没法用。
本项目的定位：把"接车 → 建档 → 维修记录 → 收支登记 → 经营统计"搬到一台手机/平板上，做成离线可用、扫码录入、多用户留痕、数据可同步的门店管理工具，让店主用一部设备就能管好账和车。
目标用户：汽修门店店主、前台、维修师傅。
1. 登录 / 注册
多用户账号体系,密码加密存储(SHA-256 + 随机盐),支持"记住密码"与自动登录。
2. 主页
功能卡片式入口,一屏直达各模块;手机用底部导航、平板自动切换为侧边导航,大小屏都好用。
3. 维修记录
门店核心账本。登记车主、电话、车牌、车架号、维修内容与金额;支持卡片列表浏览、编辑、删除(二次确认),并可按车主/车牌/车架号模糊搜索,一键导出 CSV。
4. 费用记录
登记门店各类支出(用途、金额、日期),内置日期选择器,支持按用途或日期检索、CSV 导出。
5. 经营统计
按月汇总收入、支出、利润,提供每日收支明细,支持月份切换,门店经营状况一目了然。
6. 扫描识别（车牌 / VIN）
调用相机实时识别或从相册选图,自动提取车牌号,免去手工输入;识别后可直接查询该车历史维修记录或快速建档。
7. 故障码（DTC）查询
内置汽车故障码库,输入故障码即可查询含义与说明,辅助师傅快速判断故障。
8. 用户管理
管理门店多个操作账号(新增/编辑/删除),密码加密存储,关键操作留痕。
9. 数据同步
支持上传、下载、增量三种同步模式,采用离线优先设计:没网时照常记录、来网时再同步;每次同步留有日志(条数、结果、耗时),可追溯。
10. 系统设置
修改密码、清理数据、数据库备份与恢复、服务器地址配置、用户协议与隐私政策等。
个人独立项目（非团队 / 非商业委托，独立选题与开发）。
整体架构：
采用 MVVM + Clean Architecture 分层,单 Activity + 全 Jetpack Compose 声明式 UI:
1、表现层(presentation):Compose 页面 + ViewModel,通过 StateFlow 驱动单向数据流。
2、领域层(domain):定义业务模型与 Repository 接口,实现依赖倒置。
3、数据层(data):Room 本地库 + Retrofit 网络 + Repository 实现 + Mapper 转换,隔离数据库结构与网络协议。
4、依赖注入(di):Hilt 统一装配各层依赖。
关键实现：
1、本地存储:Room 持久化(6 张表:维修/费用/用户/操作日志/同步日志/故障码),配套规范的版本迁移脚本,升级不丢数据;DataStore 存登录态与偏好。
2、端云同步:Retrofit + OkHttp(带鉴权与日志拦截器)实现上传/下载/增量同步;数据带同步状态、软删除、版本号字段,支持离线优先与基于版本号的冲突处理。
3、车牌识别:集成开源 NCNN 车牌识别方案(LFFD 检测 + LPR 识别),通过 NDK/JNI 封装,接入 CameraX 扫描流程,本地推理、无需联网。
4、响应式适配:基于 Material3 Window Size Class,手机与平板自动切换导航形态。
5、工程化:Kotlin + Gradle Kotlin DSL + Version Catalog 统一依赖管理 + KSP 注解处理。
评论