AutoRepair Quote v1.0 — 交付说明（2026-10-28）

需求来源：~/workspace/app-demand-shortlist-v1.md 第 1 名「汽修报价单（创意库 i004）」

产物

• APK：~/workspace/your_files/AutoRepairQuote-v1.0.apk（15.6 MB，debug 签名，可直接安装）
• 源码：~/workspace/autorepair-quote-android/
• 包名：com.autorepairquote.app
• 版本：versionCode 1 / versionName 1.0
• 系统要求：Android 7.0（minSdk 24）及以上，targetSdk 34
• 技术栈：Kotlin + Jetpack Compose 纯原生（无 WebView）；本地 SQLite 存储（SQLiteOpenHelper）；零联网、无账号（APK 未申请 INTERNET 权限）

已实现功能（第一版只做的 2 个功能，已全部落地）

1. 报价单生成（配件 + 工时分项） - 新建/编辑报价单：客户（下拉选择或快速新建，输入新名字保存时自动建档）、车辆（可点选客户名下车辆自动填充）、状态（Draft / Sent / Approved） - 配件行：名称、数量、单价，自动算行金额；工时行：工作描述、小时数、时费（默认带出设置里的时费），自动算行金额 - 税率（%）、备注；实时汇总：配件小计、工时小计、税额、总计 - 报价单自动编号（Q-1001 起递增，删除不重号） - 详情页一键导出 PDF（A4 版式）或 PNG 图片，经系统分享面板发送给客户（WhatsApp/邮件等） - 详情页可「Duplicate as new quote」整单复制复用

2. 客户与车辆档案 - 客户：增删改查（姓名、电话、邮箱、备注）；报价里输新客户名会自动建档 - 车辆：每个客户可挂多辆车（年份、品牌、型号、车牌、VIN），报价时一键选用 - 客户详情页显示该客户的全部历史报价，点任意一张直接打开/导出 - 删除客户时历史报价保留姓名快照，仍可读（不会变空白）

设置页（支撑功能） - 店名、电话、邮箱、地址（印在每张报价单上） - 货币：20 种币种可选（USD / EUR / GBP / CNY / JPY / INR / BRL / MXN 等），全局生效 - 默认工时费、默认税率（新建报价单时带出）

未做事项（按第一版范围主动砍掉）

• 订阅/付费墙（需求文档的变现是后续版本的事）
• 云同步、账号、多员工、在线发送（短信/邮件直发）
• 报价单模板库、行业模板（搬家/开锁等）——需求文档明确警告不可换皮克隆，未来若做须做成同 App 内模板
• 多语言 UI（目前英文优先，符合全球 Play 定位）
• release 正式签名包（上架前需生成签名并出 AAB）

已知问题

• PDF 固定单页 A4：行数特别多（约 35 行以上）的报价单，后半部分可能被截断；PNG 导出无此问题（长图）
• 构建有一条图标弃用警告（ReceiptLong 图标），不影响功能
• 未做真机/模拟器实测（构建环境无模拟器），已通过完整编译打包与 APK 结构校验；首次真机打开建议验一遍：新建报价 → 导出 PDF → 分享

重新构建

cd ~/workspace/autorepair-quote-android
# 需先确保代理 shim 在跑：python3 ~/workspace/android-sdk/proxy-shim.py（监听 127.0.0.1:18888）
JAVA_HOME=~/workspace/jdk-17 GRADLE_USER_HOME=/home/hatch/.gradle \
_JAVA_OPTIONS=-Djava.net.preferIPv4Stack=true ./gradlew assembleDebug