You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
AdLike2048/docs/需求-模块保留.md

115 lines
5.0 KiB

3 weeks ago
# 需求:新产品模块保留清单
> 状态:**已确认**(基于策划原型 + 新配表 + [需求-新项目概述.md](./需求-新项目概述.md))
> 日期:2026-08-17
> 关联:[遗留代码收敛方案.md](./遗留代码收敛方案.md)、[方案-项目结构整理与遗留清理.md](./方案-项目结构整理与遗留清理.md)
## 1. 决策说明
本清单决定 **哪些目录投入规范收敛与改造**,哪些 **删除**。
未标「保留」的模块 **不做** 大规模重构。
**图例**:`保留` | `改造` | `删除(计划)`
---
## 2. MX 框架层(全部保留)
| 模块 | 路径 | 决定 | 说明 |
|------|------|------|------|
| UI 框架 | `assets/mx/module/ui/` | **保留** | UIManager、PopAnim、RuntimeLoadingGate |
| 资源管线 | `assets/mx/module/res/` | **保留** | 加载、预载、Bundle 生命周期 |
| 启动 | `assets/mx/module/boot/` | **保留** | BootPipeline、UpdatePipeline |
| 战斗内核 | `assets/mx/module/battle/` | **保留** | 含阵营区域、寻路、ECS |
| 合成内核 | `assets/mx/module/merge/` | **保留** | 背包合成(裁剪 type3 调用) |
| 音频 | `assets/mx/module/audio/` | **保留** | |
| 事件 | `assets/mx/module/event/` | **保留** | GEvent |
| ECS | `assets/mx/module/ecs/` | **保留** | |
| 多语言 | `assets/mx/module/lang/` | **保留** | |
| 红点/引导等 | `assets/mx/module/*` | **保留** | 按新产品 UI 裁剪引用 |
---
## 3. 业务层
| 模块 | 路径 | 决定 | 说明 |
|------|------|------|------|
| 游戏入口 | `GameLaunch.ts`、`GameController.ts` | **保留 + 改造** | 启动链试点已完成 |
| 全局数据 | `assets/script/game/` | **保留 + 改造** | 段位存档、新配表 |
| 战斗适配 | `assets/script/battle/` | **改造** | 阵营 PvAI + 固定路线 + Text 字池 |
| 战斗 UI | `assets/script/ui/BattleGame/` | **改造** | 大幅裁剪 |
| 首页 | `PanelHome/` | **改造** | 段位首页,去章节选关 |
| 神将武器 | `pageWeapon/` | **改造** | Weapon/Hero 新表 |
| 商店 | `pageShop/` 等 | **改造** | 改读 Battlebuff,非旧 Shop |
| 转盘 | `TurnTable/` | **改造** | Battlebuff + Const |
| 论功行赏 | — | **新建** | 替代 7 日签到主流程 |
| 排行榜 | — | **新建** | 段位榜 + 今日胜场榜 |
| 平台奖励 | `PanelSidebar/` 等 | **保留** | 侧边栏/添桌,与论功行赏并列 |
| 角色 Tab | `pageUserLevelup/`、`skin/` | **删除(计划)** | 无 Role/Skin 表 |
| 副本 Tab | `Replica/`、`pageDungeon/` | **删除(计划)** | 无 Replica 表 |
| 任务 | `taskView/` | **删除(计划)** | Task 表已删 |
| 7 日签到 | `sign7Day/` | **删除(计划)** | 论功行赏替代 |
| 商业化弹窗 | fund/monthCard/firstRecharge 等 | **删除(计划)** | MVP 不做 |
| SDK | `assets/script/sdk/` | **保留 + 改造** | 排行榜等;马甲收敛 |
| 引流小游戏 | `attractingTrafficGame/` | **删除(计划)** | |
| 活动/内购 | `activity/`、`purchase/` | **删除(计划)** | MVP 不做内购 |
| 皮肤/剧情 | `skin/`、`StoryLine` | **删除(计划)** | |
| 功能解锁 | `newFun/` | **删除(计划)** | NewFun 表已删 |
### 3.1 大厅导航(待美术定稿)
- **方案 A**:单页首页 + 功能入口(对齐原型)
- **方案 B**:精简 Tab(首页 / 商店 / 神将武器)
共同约束:删除 Role、Replica Tab。
---
## 4. 资源分包(bundles)
| Bundle | 决定 | 说明 |
|--------|------|------|
| first / comm / audio / lang | **保留** | 首包与公共 |
| home / shop / weapon | **改造** | 局外核心 |
| battleGame / battleMap / battleHero 等 | **改造** | 阵营战斗 |
| role | **删除(计划)** | 无角色 Tab |
| replica | **删除(计划)** | 无副本 |
| attractingTrafficGame | **删除(计划)** | |
| allBuyShops 子包 | **删除(计划)** | 商业化 MVP 不做 |
---
## 5. 编辑器扩展(全部保留)
| 扩展 | 决定 |
|------|------|
| excel-to-json-ts | **保留** |
| mx-res-manager | **保留** |
| tools(构建钩子) | **保留** |
| 引用查找器 | **保留** |
---
## 6. 已确认项(2026-08-17)
- [x] 保留 **塔防 + 汉字背包合成** 核心战斗(裁剪 type3 格子与 Gacha)
- [x] 战斗改为 **玩家 vs AI**,采用 **阵营区域方案**(半图镜像已删除)
- [x] 进度改为 **段位制**(Rank 表)
- [x] 删除 **引流小游戏** 与相关 bundle
- [x] 删除 **副本 / 角色 Tab / 任务 / 7 日签到主流程 / 商业化弹窗**
- [x] 保留 **论功行赏 + 平台奖励(侧边栏/添桌)**
- [x] 保留 **神将武器、商店、转盘、排行榜**
- [ ] 目标发行渠道与 SDK 马甲数量(待产品确定)
- [ ] 大厅导航方案 A/B(待美术确定)
---
## 7. 规范收敛优先级
1. ✅ 启动链(Phase 2 试点)
2. 配表与存档迁移(Phase 1)
3. 局外裁剪(Phase 2)
4. 战斗阵营改造(Phase 3)
5. 资源清扫(Phase 4)
6. 全库 Set/Map、全局函数(长期,见遗留收敛方案)