# Stall Ledger（小摊收支记）v1.0 交付说明

需求来源：`~/workspace/app-demand-shortlist-v1.md` 第 9 名「小摊收支记」（创意库 i001 小吃摊记账本 + i237 小摊收支记）。

## 产物

- **APK**：`~/workspace/your_files/StallLedger-v1.0.apk`（15.6 MB，debug 签名，可直接安装）
- **源码**：`~/workspace/stall-ledger-android/`
- **包名**：`com.stalledger.app`，versionCode 1 / versionName 1.0，minSdk 24 / targetSdk 34
- **技术栈**：Kotlin + Jetpack Compose 纯原生（无 WebView），本地 SQLite 存储；aapt 校验确认**未申请 INTERNET 权限**（仅有系统自动生成的内部权限），零联网、无账号

## 需求复核结论（开工前已做）

**信号未反转，照计划开工，但要如实说明竞争格局的变化程度：**

- 大而全的 MSME 记账赛道确实已被占住：印尼 BukuWarung（800 万+用户，POS + 库存 + 赊账 + 云端账号 + 支付全套，学术调研显示其用户最看重的正是「自动算净利润」，80% 受访者认为利润汇总满足其核心需求）、印度 Khata 系列、各国 POS 应用都在。需求本身已被大规模验证为真。
- 但清单押注的「摊贩专用、极简到只有两件事」这一端仍有空位：现有产品要么是 BukuWarung 式全功能（要注册、要学、功能臃肿），要么是通用 Cash In/Out 流水账（不区分「进货成本 vs 营业额」、不把「今天赚没赚钱」做成第一屏的核心数字）。本 App 的差异化就押在：免注册、零设置、两个大按钮、三秒记一笔、打开即见今日净利润。
- 与清单原判断一致的风险提示：这是长线走量款不是回本款，单用户广告价值低；西语/印尼语本地化是 v2 的关键杠杆，本版按要求未硬塞机翻。

## 第一版 2 个功能（按需求文档原样落地）

1. **每日流水极速记账**：今日页两个 68dp 大按钮「+ SALE（营业额）」「+ STOCK COST（进货成本）」，点开是全屏大键盘（58dp 按键、支持小数点与双零键），金额输入只要点数字，备注可选填一句；日期默认今天、可点选改任意日期补记；已有条目点按即可改金额/类型/日期/备注或删除。条目按类型分色（绿 + / 橙 −），今日流水列表实时更新。
2. **净利润自动算 + 周/月汇总**：今日页顶部大卡片实时显示今日净利润（营业额 − 成本，正绿负红）及两项分项合计；History 页可切换周/月，前后翻期，每期有利润汇总卡、日均净利润，并逐日列出每天的营业额/成本/净利润，点任意一天进日详情（可补记、改单）。

**设置页**：摊位名（显示在今日页标题）、**币种设置项**（39 种，覆盖东南亚/南亚/拉美/非洲主要货币 + 主流货币，金额按所选币种符号显示，整数金额自动隐藏小数）、数据条数显示与一键清空全部记录、About（含「数据只存本机、无账号、不联网」说明）。

## 未做（按 v1 范围砍掉）

- 多语言 UI 本地化（西/印尼语等，留 v2；本版英文优先，未塞机翻）
- 广告与去广告会员（变现层，等有量再加）
- 赊账/欠款记录、库存数量管理、商品档案、POS 开单
- 导出/备份/云同步、release 签名包

## 已知问题

- 未做真机/模拟器实测（本环境无模拟器），仅完成编译打包 + APK 结构与权限校验；建议真机首验一遍「记一笔 Sale → 记一笔 Cost → 看今日利润 → History 切周/月」这条链。
- 周汇总以周一为一周起点（多数目标市场通行；个别地区习惯周日起始，后续可做设置项）。
- 金额内部以「分」为单位存储，整数显示自动去小数；超大金额（单笔 ≥ 10 亿单位）输入长度已限制，不影响摊贩场景。
- 删除操作含单条删除与设置页全部清空，均有二次确认；清空不可恢复。