asset-tracker/PRD.md

PRD - Asset Tracker (MVP)

1. 项目目标

构建单用户个人资产管理系统，统一记录现实资产和网络资产，提供资产统计与到期提醒能力。

2. MVP 功能边界

2.1 In Scope

1. 资产分类管理
2. 资产新增、查询
3. 仪表盘汇总：
   • 总资产（按记录金额直接累加）
   • 分类占比
   • 未来30天到期资产清单
4. 定时提醒扫描：
   • 每小时扫描一次未来 30/7/1 天到期资产
   • 首版先日志输出提醒事件

2.2 Out of Scope

• 多用户协作
• 自动估值源接入（股票/币价 API）
• 复杂权限系统
• 导入导出与财务报表

3. 用户故事

1. 作为用户，我希望快速记录资产，了解当前资产分布。
2. 作为用户，我希望在关键资产到期前得到提醒，减少忘记续费风险。
3. 作为用户，我希望看到未来30天到期资产列表，做提前规划。

4. 核心流程

4.1 新增资产

• 选择/创建分类
• 输入资产基础信息（名称、数量、单价、币种、到期时间）
• 系统保存并可在列表中查看

4.2 资产列表

• 查看所有有效资产
• 支持按分类过滤（MVP 可选，先预留参数）

4.3 到期提醒扫描

• cron 每小时触发
• 扫描未来30天内到期资产
• 输出提醒日志（含资产名、到期日期、剩余天数）

5. 数据模型（MVP）

categories

• id
• name
• type (real / digital)
• color
• created_at
• updated_at

assets

• id
• name
• category_id
• quantity
• unit_price
• total_value
• currency
• expiry_date（可空）
• note
• status (active / inactive)
• created_at
• updated_at

6. 非功能需求

1. 可部署性：单二进制 + SQLite
2. 可维护性：分层结构（api/service简化为handler+repo）
3. 可扩展性：预留 reminders 表与通知通道模块

7. 验收标准

• 能通过 API 创建分类和资产
• 能通过 API 获取资产列表和仪表盘汇总
• 服务启动后 cron 每小时运行提醒扫描并输出日志
• OpenAPI 文档与实现字段一致