FinUnity Web + Server

为什么做

管理账户、持仓和资金流时，如果每个页面各算一遍余额，就容易出现总览与明细不一致。我做 FinUnity Web + Server，是想让这些数据由服务端统一计算，再用 Web 客户端展示和操作。

方案

• 一份账本快照：FastAPI 服务在同一个数据库读事务内取账户、持仓、流水和目标；React Web 的总览、账户、持仓和配置页面使用同一份汇总结果。
• 明确金额口径：现金余额由期初余额和流水计算，再与持仓市值合并；不同币种分别展示，缺少汇率时不直接相加。金额在服务端按 Decimal 处理。
• 截图识别后确认：持仓截图可以提取结构化记录，用户确认后才写入持仓；原图仅在识别请求期间使用。
• 失败边界可见：缺少价格、成本或真实行情接入时，界面显示估算或未配置状态，不把参考数据说成实时行情。

我负责的工作

实现 Web 交互与服务端业务接口，梳理账户、持仓、现金流和配置的计算口径；修复多页面重复计算带来的不一致，并补充输入校验、版本冲突和行情刷新失败的处理。

怎么验证的

• 2026 年 9 月的一次一致性修复记录中，前端生产构建、Oxlint 和后端 Ruff 通过，后端 pytest 35 项通过；覆盖逐笔舍入、分币种隔离、非法输入、版本冲突与行情刷新失败等场景。
• 这次记录没有包含浏览器交互、移动端视觉检查或真实行情联调；近期部署状态和完整端到端验收仍待核实。

现在做到哪

Web 和服务端代码已有账户、持仓、资金流、三桶配置及持仓截图识别能力。真实行情供应商尚未接入，现有参考数据是联调样本。Web + Server 暂无核实过的公开访问入口，因此这里只展示方案与验证边界。