asset-light 项目技术文档
适用场景
- 你要维护/扩展
asset-light（新增页面、功能、数据结构、优化性能等）。 - 你要理解当前实现（模块划分、数据流、数据库 schema、UI 状态管理）。
- 你要把项目当作 Rust 学习素材，但希望先有“工程地图”。
文档目录
- 项目总览（从代码看架构）：
project-overview.md - 数据库与迁移（SQLite / schema_version / Repository）：
database.md - 状态与数据流（页面加载策略、全局状态、刷新边界）：
state-and-data-flow.md - UI 与路由（Dioxus 组件组织、路由结构、页面职责）：
ui-and-routing.md - 编码约定（模块边界、命名、错误处理、可测试性）：
coding-conventions.md - 常见问题排查（构建、数据库、数据重置、调试）：
troubleshooting.md
与规划/设计文档的关系
docs/ 下已有 PRD、UI 设计、架构设计等文档（主要回答“为什么做 / 做什么”）。
本目录的技术文档更偏向“怎么做 / 现在怎么做 / 怎么改更稳”。