CNWei
039ea70edf
- 添加导航条目和分类数据模型 - 实现导航卡片网格展示 - 支持点击卡片打开链接 - 添加主题样式（渐变色、卡片阴影） - 区分系统默认和自定义条目 - 添加分类统计信息"
3.1 KiB
Navius 前端（Flutter Web）
导航站前端，使用 Flutter 构建。当前目标平台只有 Web，数据来自 Rust 后端
（GET /api/nav）。
界面基准是仓库根目录的 index3.html：可折叠的层级侧栏 + 居中的顶部控制栏
（折叠按钮 + 搜索框）+ 分组卡片网格 + 右下角圆形回到顶部。
和后端一起跑
前端启动时会请求后端，所以两个都要起：
cd backend && cargo run # 默认 http://127.0.0.1:8080
cd frontend && flutter run -d chrome
后端地址默认是 http://127.0.0.1:8080，打包或换环境时用编译期变量覆盖：
flutter build web --dart-define=NAVIUS_API_BASE=https://api.example.com
后端没起来时页面会显示「加载失败」和具体原因，并给一个「重试」按钮。
侧栏底部的「提交网站」直接跳到后端配好的收集入口（nav.json 的 site.submitUrl，
填 Mattermost 地址即可）。页面上不再有提交表单——收集和讨论都在 Mattermost 里做，
网站数据由后端接口写入。
页面上没有编辑和删除入口：卡片只管展示和跳转，用户提交的站点照样由后端接口
（PATCH / DELETE）维护，只是不从这里操作。
站点名、搜索框提示、提交入口地址都来自后端（nav.json 的 site），前端不再写死。
常用命令
flutter pub get # 拉取依赖
flutter run -d chrome # 本地运行
flutter analyze # 静态分析
flutter test # 单元测试与组件测试
flutter build web # 构建产物输出到 build/web
目录约定
lib/core/：与业务无关的基础设施——主题、尺寸常量、断点计算、打开链接的能力。lib/features/<功能>/：按功能划分，内部再分data（数据来源与仓库）、domain（模型与规则）、presentation（页面与组件）。test/：目录结构与lib/保持一致。
依赖方向固定为 features/ → core/：core 不引用任何功能代码，
功能之间也不互相引用。
接后端的位置
页面只依赖仓库接口，不关心数据来自后端还是本地 mock：
- 契约：
lib/features/home/data/home_repository.dart - 后端实现：
lib/features/home/data/http_home_repository.dart - mock 实现：
lib/features/home/data/mock_home_repository.dart（测试用）
接口对应关系：读 GET /api/nav、提交 POST /api/sites、编辑 PATCH /api/sites/{id}、
删除 DELETE /api/sites/{id}。仓库契约里四个方法都在，界面目前只用到「读」和
「跳转到提交入口」，另外三个留给后台工具或以后再做界面时用。
接口返回的分组树在 http_home_repository.dart 里映射成前端模型：分组变成侧栏导航，
只有挂着网站的分组才进内容区（空分组留在侧栏，点了没有对应内容——和原型一致），
子分组的内容标题会带上父级（「素材资源 - UI 设计」）。
完整的目录树、设计令牌映射、响应式规则与实现取舍见 docs/frontend-architecture.md。