# Main 模块业务逻辑 ## 模块职责 Main 模块负责登录后的主界面 Tab 容器,以及当前尚未迁移页面的占位入口。 主界面由 `MainTabsView` 承载: - 使用 `TabView` 展示首页、订单、数据、我的四个 Tab。 - 每个 Tab 内部都包裹独立的 `NavigationStack`。 - 每个 Tab 的导航路径由 `AppRouter` 单独保存。 ## Tab 结构 当前 Tab 来自 `AppTab`: - `home`:首页 - `orders`:订单 - `statistics`:数据 - `profile`:我的 `HomeRootView` 已接入真实的 `HomeView`,`OrdersRootView` 已接入真实的 `OrdersView`,`StatisticsRootView` 已接入真实的 `StatisticsView`,`ProfileRootView` 已接入真实的 `ProfileView`。 ## 导航流程 1. `MainTabsView` 从 Environment 读取 `AppRouter`。 2. `TabView` 使用 `appRouter.selectedTab` 作为选中状态。 3. 每个 Tab 创建自己的 `NavigationStack(path:)`。 4. 路径绑定来自 `appRouter.binding(for:)`。 5. Tab 内页面需要进入尚未迁移的子页面时,通过当前 Tab 注入的 `RouterPath` push 一个 `AppRoute.placeholder`。 6. `navigationDestination` 根据 `AppRoute` 展示详情页。 7. 子页面展示时读取 `AppRoute.hidesTabBarWhenPushed`,默认隐藏底部 TabBar。 ## 后续迁移规则 迁移新页面时: - 优先替换对应 Tab 的 RootView。 - 保持每个 Tab 自己的 `NavigationStack`。 - 跨 Tab 跳转通过 `AppRouter.select` 切换 Tab。 - Tab 内跳转通过当前 Tab 的 `RouterPath.navigate` 或扩展后的 `AppRoute` 处理。 - 普通业务子页面默认隐藏 TabBar;只有确有产品需求时,才在 `AppRoute` 策略中单独放开。 - 真实业务页面接入后,应同步补充该模块文档和单元测试。