Initial commit

suixinkan/Features/Main/Main.md

@@ -0,0 +1,40 @@
+# Main 模块业务逻辑
+
+## 模块职责
+
+Main 模块负责登录后的主界面 Tab 容器，以及当前尚未迁移页面的占位入口。
+
+主界面由 `MainTabsView` 承载：
+- 使用 `TabView` 展示首页、订单、数据、我的四个 Tab。
+- 每个 Tab 内部都包裹独立的 `NavigationStack`。
+- 每个 Tab 的导航路径由 `AppRouter` 单独保存。
+
+## Tab 结构
+
+当前 Tab 来自 `AppTab`：
+- `home`：首页
+- `orders`：订单
+- `statistics`：数据
+- `profile`：我的
+
+`HomeRootView` 已接入真实的 `HomeView`，`ProfileRootView` 已接入真实的 `ProfileView`。订单和数据 Tab 当前仍使用 `PlaceholderTabRootView`，用于保留入口和验证 Tab 内导航。
+
+## 导航流程
+
+1. `MainTabsView` 从 Environment 读取 `AppRouter`。
+2. `TabView` 使用 `appRouter.selectedTab` 作为选中状态。
+3. 每个 Tab 创建自己的 `NavigationStack(path:)`。
+4. 路径绑定来自 `appRouter.binding(for:)`。
+5. 占位页点击“打开详情”时，通过当前 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` 策略中单独放开。
+- 真实业务页面接入后，应同步补充该模块文档和单元测试。