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 个功能(按需求文档原样落地)
- 每日流水极速记账:今日页两个 68dp 大按钮「+ SALE(营业额)」「+ STOCK COST(进货成本)」,点开是全屏大键盘(58dp 按键、支持小数点与双零键),金额输入只要点数字,备注可选填一句;日期默认今天、可点选改任意日期补记;已有条目点按即可改金额/类型/日期/备注或删除。条目按类型分色(绿 + / 橙 −),今日流水列表实时更新。
- 净利润自动算 + 周/月汇总:今日页顶部大卡片实时显示今日净利润(营业额 − 成本,正绿负红)及两项分项合计;History 页可切换周/月,前后翻期,每期有利润汇总卡、日均净利润,并逐日列出每天的营业额/成本/净利润,点任意一天进日详情(可补记、改单)。
设置页:摊位名(显示在今日页标题)、币种设置项(39 种,覆盖东南亚/南亚/拉美/非洲主要货币 + 主流货币,金额按所选币种符号显示,整数金额自动隐藏小数)、数据条数显示与一键清空全部记录、About(含「数据只存本机、无账号、不联网」说明)。
未做(按 v1 范围砍掉)
- 多语言 UI 本地化(西/印尼语等,留 v2;本版英文优先,未塞机翻)
- 广告与去广告会员(变现层,等有量再加)
- 赊账/欠款记录、库存数量管理、商品档案、POS 开单
- 导出/备份/云同步、release 签名包
已知问题
- 未做真机/模拟器实测(本环境无模拟器),仅完成编译打包 + APK 结构与权限校验;建议真机首验一遍「记一笔 Sale → 记一笔 Cost → 看今日利润 → History 切周/月」这条链。
- 周汇总以周一为一周起点(多数目标市场通行;个别地区习惯周日起始,后续可做设置项)。
- 金额内部以「分」为单位存储,整数显示自动去小数;超大金额(单笔 ≥ 10 亿单位)输入长度已限制,不影响摊贩场景。
- 删除操作含单条删除与设置页全部清空,均有二次确认;清空不可恢复。