fire_goal/docs/01-需求文档-PRD.md

# 01 · 需求文档（PRD）

> 个人 FIRE 自律 App ｜ 版本 v0.1（MVP 定义）

## 一、背景与目标

用户已制定个人 FIRE 计划（详见 `../我的FIRE计划与建议.md`），核心诉求是：
**"开发一个适合自己情况的、通用的 FIRE App，每天监督自己把行为对齐 FIRE 要求。"**

现有开源工具（Firefly III 等）偏专业记账、需自托管运维，且不做"每日行为自律"。因此决定自研一个**轻量、跨端、可自托管**的工具。

## 二、用户画像

| 维度 | 信息 |
|---|---|
| 年龄 | 40 岁以上 |
| FIRE 路线 | **Barista FIRE（半退休）** |
| 目标本金 | 约 43–71 万（中性取 71 万） |
| 现状 | 起始本金 7 万，每月定投 1500，持有工商银行等 |
| 技术条件 | 有腾讯云 VPS + 域名（certbot/HTTPS）、Synology NAS、可用 Docker；偏好数据自己掌握 |
| 平台诉求 | 希望能打包成 **iOS + Android** App，最好不依赖 Mac |

## 三、产品定位

> 自托管、跨端的**个人 FIRE 自律工具** = 「自律闹钟」+「目标进度仪表盘」，**不是专业会计软件**。

设计原则：
1. **每天 30 秒能用完** —— 自律优先，低摩擦。
2. **绑定个人真实目标** —— 内置用户的 71 万目标、3.5% 提取率等参数。
3. **数据自己掌握** —— 本地优先，可同步到自己的服务器（腾讯云 VPS）。
4. **够用即可** —— 不追求复式记账级别的专业度。

## 四、功能需求（MVP 四大模块）

### 1. 每日行为打卡 🟥 核心
- 每日勾选清单：✅记账了 ✅无冲动消费 ✅定投到账 ✅复盘。
- 连续打卡天数、本月/本周完成率统计。
- 目的：把"对齐 FIRE 行为"变成可坚持的日常习惯。

### 2. 目标进度 & 净资产
- 录入当前资产，自动显示**距离 71 万目标的进度条**。
- 储蓄率、净资产曲线。

### 3. FIRE 测算器
- 搬入 `../FIRE可调测算表.xlsx` 的逻辑。
- 可调参数：起始本金 / 每月定投 / 兼职收入 / 安全提取率 / 收益率。
- 自动计算：目标本金、达成年限（保守/中性/乐观三档）。

### 4. 持仓 & 分红跟踪
- 记录工行等持仓的成本/市值/股息率/分红。
- 提醒：按估值加仓、分红复投。
- ⚠️ 第一版**手动录入**，不接实时行情（见风险文档）。

## 五、非功能需求

- **跨端**：H5(网页/PWA)、App(iOS/Android)，小程序可选（后置）。
- **用户端骨架**：基于开源脚手架 **unibest**（uni-app + Vue3）。
- **后端**：Go + Gin + GORM + SQLite，部署在用户腾讯云 VPS（Docker + Nginx + certbot HTTPS）；NAS 可作备份/备选。
- **管理端**：**Web 管理后台（无构建）**，Gin html/template + HTMX + Alpine + **Tabler**(Bootstrap5 后台皮肤)，由 Go 进程直接托管（并入 `server/`），电脑端登录，用于数据增删改查、报表、参数调整；与用户端共用同一后端与数据库。单人自管，不做多用户权限。
- **离线可用**：本地优先，联网时同步。
- **隐私**：财务数据不经第三方云。

## 六、范围边界（本期不做）

- ❌ 复式记账 / 多账户专业账本（用 Firefly III 那类）。
- ❌ 实时股票行情接入（数据源不稳定，先手动录入）。
- ❌ 微信小程序首发（HTTPS 已就绪，但仍需域名 ICP 备案，故本期后置，见风险文档）。
- ❌ 多用户 / 社交功能（个人自用）。

## 七、验收标准（MVP）

1. 浏览器(H5)中四大模块可用，数据本地持久化。
2. 能打出可安装的 Android 包并在手机使用。
3. 「打卡 + 目标进度」形成每日可用闭环。
4. 测算器结果与 Excel 测算表一致。