add project docs and research materials; update arch doc with WSL2 dev setup
- docs/: 6 development documents (PRD, tech selection, architecture, risks, roadmap, design workflow) - research/: FIRE background materials, personal plan, Excel calculator - 03-架构设计.md: add Section 8 documenting WSL2 → Windows browser dev environment (Vite host config, access URLs, mobile debugging tip) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
# 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 测算表一致。
|
||||
Reference in New Issue
Block a user