# RentKeeper v1.0 交付说明（2026-10-28）

第 4 名「房东收租管家（创意库 i330 + i212）」第一版已开发完成，构建一次通过（仅修过一处多余导入）。

## 产物

- **APK**：`~/workspace/your_files/RentKeeper-v1.0.apk`（15.7 MB，debug 签名，可直接装）
- **源码**：`~/workspace/landlord-rent-android/`
- **包名**：`com.landlordrent.app`，versionCode 1 / versionName 1.0，minSdk 24 / targetSdk 34
- Kotlin + Jetpack Compose 纯原生（无 WebView），SQLite 本地存储；aapt 校验仅 POST_NOTIFICATIONS + RECEIVE_BOOT_COMPLETED，**未申请 INTERNET 权限**，零联网、无账号。UI 英文优先。

## 需求复核结论（开工前已做）：信号未反转，照计划开工，但口径有漂移，已如实标注

- 2026-10 搜索可见：小房东赛道确实在升温——Landlord Lite（未上线、先做候补名单）直接主打「给 1–10 套房的独立房东、简单收租提醒」，LandlordHub、RentPager 等也在抢同一人群，说明需求与付费意愿被多方验证。
- 但现有玩家几乎全是**云端平台型**：账号注册、租客门户、在线收款、银行卡/银行账户连接、按套收费的订阅 SaaS。本 App 押的「**完全离线、无账号、不碰支付、数据只存本机**的极简收租记账本」这个子角度，搜索结果里没有玩家在占。
- 漂移提示：清单原判「低偏中」同质化成立且在往「中」漂移——将来上架时，商店文案必须把 "no account / fully offline / private" 打在最前面，不能只写 "simple app for small landlords"（那句已经被 Landlord Lite 占了）。

## 第一版 2 个功能（按需求文档原样落地，范围砍住）

1. **房源 / 租客 / 租约登记 + 自动提醒**
   - 房源增删改查（名称/地址/备注）；租约登记含租客姓名/电话/邮箱、月租、每月收租日（1–28 号）、押金、起止日期（可设无结束日期 = 按月续租）。
   - 本地提醒（每日 9:00 统一检查、按实时账本判断，不留过期闹钟）：收租日前 3 天提醒、到期当天未收足提醒、租约到期前 30 天 / 7 天提醒、逾期汇总提醒；开机自动恢复布防，开 App 自愈。Android 13+ 未授权通知时，首页有横幅、设置页有双入口引导。
2. **收租流水记账 + 逾期标红汇总**
   - 按「租约 × 月份」记账：金额、到账日期、方式（银行转账/现金/支票/卡/其他）、备注，支持部分收款（自动算剩余欠额）、改删。
   - 每个租约自起始月起逐月生成应收账单；已过收租日未收足的自动判逾期，首页红色汇总卡（逾期总金额 + 笔数）+ 逐条红色明细（几天 late、已付多少），点按钮直达补记收款；租约详情页有 Outstanding 区 + 全部账单月状态（Paid / Partly paid / Overdue / Unpaid）。
   - 仪表盘另有本月 Expected / Collected、未来 30 天到期清单、60 天内到期租约清单。

**设置页**：货币 12 种可选（USD/EUR/GBP/AUD/CAD/NZD/CNY/JPY/INR/SGD/AED/CHF，默认 USD）、通知状态与系统设置入口、About（含免责声明：仅个人记账工具，不收款、不连银行、不提供租约文书或法律建议）、一键删除全部数据。

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

订阅付费墙、在线收款/支付、合同与租约文书生成（法律风险，明确不做）、租客门户/租客端、筛选背景调查、维修工单、费用支出记账、报表导出、多语言 UI、release 签名包。

## 已知问题

- 无真机/模拟器实测（仅完整编译 + aapt 结构与权限校验）。建议真机首验一条链：「加房源 → 建租约（收租日设为 3 天后）→ 等/改系统日期验证提醒 → 记一笔部分收款 → 看逾期标红与汇总变化」。
- 提醒采用非精确闹钟（每日 9:00 检查制），可能有分钟级漂移；强省电 ROM 可能延迟，开 App 可自愈重排。
- 逾期判定不设宽限期：收租日次日 0 点起未收足即算逾期（late 天数从收租日算）；部分收款按已付金额抵扣，剩余部分继续计逾期。
- 首月账单按整月租金计：租约若月中起始，第一个月仍按整月应收显示，需要房东自行用部分收款或备注处理按天折算的情况。
- 删除房源会级联删除其租约与全部收款记录（删除前有明确确认框）；删除租约同样会删掉其收款记录。