Noheir 是一款个人财务管理 Web 应用，帮助用户从收支到资产形成完整的财务视图，并通过可视化与指标体系辅助决策。
- 01-overview.md
- 02-core-features.md
- 03-structure.md
- 04-run.md
- 05-testing.md
- 06-docs-guidelines.md
- 07-dev-guidelines.md
- 08-data-and-security.md
- 09-pages-and-data-flow.md
- 10-mvvm-guidelines.md
- 11-e2e-testing.md
- 12-mcp-server.md
bun install
cp .env.example .env.local
bun run dev访问 http://localhost:7012。
- 收支分析与分类洞察
- 储蓄率与财务健康度评估
- 资产与资金单元管理
- 数据导入与质量校验
- 可选 AI 助手分析
noheir/
├── public/ # 静态资源
├── src/
│ ├── components/ # 业务与通用组件
│ ├── contexts/ # 全局上下文
│ ├── domain/ # 纯业务规则与计算
│ ├── hooks/ # 自定义 Hooks
│ ├── lib/ # 工具与核心逻辑
│ ├── pages/ # 页面级组件
│ ├── services/ # 数据服务
│ ├── types/ # 类型定义
│ ├── viewmodels/ # 视图模型与派生逻辑
│ └── main.tsx # 应用入口
├── tests/ # 单元测试
├── scripts/ # 开发辅助脚本
└── docs/ # 项目文档
bun run dev- 代码规范检查：
bunx eslint . --max-warnings=0 - UT：
bun test - 覆盖率：
bun test --coverage - UT 覆盖率目标：90%
- 更新代码必须同步更新相应文档
- README 只保留概览与入口，细节下沉到
docs/
- 一个 commit 只包含一个逻辑变更
- 保持每个 commit 可回滚、可构建
- 修改行为或流程必须附带文档更新
- 任何新功能、目录调整或运行方式变更，必须同步更新
docs/与README.md