已结束已结束养鱼项目小游戏客户端外包，预算2万以内
# 养鱼项目小游戏客户端外包需求文档
## 1. 项目背景与目标
### 1.1 项目背景
本项目为休闲养鱼小游戏，核心玩法为 图鉴合成 -> 鱼塘养殖 -> 收获出售 -> 轻社交对抗 的循环。
当前甲方需要引入客户端外包团队，完成微信小游戏与抖音小游戏双平台客户端研发与交付，确保：
1. 首发版本可稳定上线。
2. 包体、审核、性能满足渠道要求。
3. 后续版本具备持续迭代能力。
### 1.2 外包目标
1. 在约定周期内交付可上线客户端版本。
2. 实现主包 + 业务包双层分包架构，控制启动耗时与包体风险。
3. 按平台审核规范隔离平台代码，降低审核驳回风险。
4. 建立规范化代码、构建、测试、文档交付体系。
### 1.3 合作定位
1. 甲方负责：产品需求、系统规则、数值策略、资源素材、验收决策。
2. 乙方负责：客户端架构设计、功能开发、联调支持、性能优化、提审支持。
---
## 2. 外包范围
### 2.1 必须交付范围（V1.0）
平台支持：
1. 微信小游戏版本。
2. 抖音小游戏版本。
3. Web 预览版本（开发调试用）。
功能系统：
1. 登录加载与开始游戏流程。
2. 公告入口与页签公告弹窗。
3. 主界面基础框架与功能面板入口。
4. 鱼类图鉴与合成功能前端表现。
5. 鱼塘养殖（投苗、阶段成长、喂食加速、收获）。
6. 贸易站出售流程与结果反馈。
7. 好友、聊天、黑名单、邻居互访入口。
8. 邮件入口与邮件列表基础交互。
9. 任务与新手引导客户端交互流程。
10. 猫屋与犬舍入口及基础交互页面。
上线支撑事项：
1. 软著申报材料整理与提交流程配合。
2. 微信与抖音平台提审资料整理、提审执行与驳回整改。
3. 上线窗口期陪跑支持（发布、回滚、监控与应急响应）。
客户端基础能力：
1. 主包 + 单业务包分包能力。
2. 资源 manifest 解析与 CDN 加载。
3. 本地缓存（索引、容量、淘汰、版本清理）。
4. 统一事件系统、状态管理、服务调用门面。
5. 错误弹窗、重试、降级与日志上报。
工程化能力：
1. 多平台构建脚本（微信/抖音/Web）。
2. 平台代码隔离与构建剔除。
3. 环境配置（开发、测试、预发、正式）切换。
4. 可执行打包与提审流程说明文档。
### 2.2 不在本次外包范围
1. 服务端功能开发。
2. 协议设计与数据库设计。
3. 运营后台系统。
4. 非小游戏平台原生客户端。
5. 软著官方申请费用与第三方法务费用。
6. 平台投放与买量运营执行。
---
## 3. 技术与架构要求
### 3.1 分包架构要求
1. 架构形式：主包 + 业务包（gameplay）。
2. 主包承载：启动流程、登录流程、基础导航、公共能力。
3. 业务包承载：重玩法逻辑与重资源。
4. 禁止：业务层直接调用分包底层加载接口，必须统一由分包管理器调度。
### 3.2 平台隔离要求
1. 平台代码仅可存在于 platform 目录。
2. 业务代码禁止直接引用平台具体实现。
3. 平台实例只能由统一入口创建。
4. 微信目标包不得包含抖音 API 可执行路径，抖音目标包同理。
### 3.3 资源管理要求
1. 资源键必须统一管理，禁止业务代码硬编码路径。
2. 资源寻址流程：manifest -> 本地缓存 -> CDN。
3. 缓存阈值：150MB；淘汰策略：LRU。
4. 启动时必须执行过期资源清理。
5. 下载失败需支持重试与降级，不得直接阻断主流程。
### 3.4 代码与质量要求
1. 核心模块需有清晰目录边界与注释说明。
2. 关键流程必须具备异常处理与回退路径。
3. 不允许出现阻塞主线程的长耗时同步逻辑。
4. 乙方需提供 Code Review 规则与执行记录。
---
## 4. 交付物要求
### 4.1 代码交付
1. 完整客户端工程源码（含构建脚本）。
2. 分支管理规范与版本标签。
3. 提测包、提审包、发布包产物。
### 4.2 文档交付
1. 客户端技术架构说明。
2. 分包与资源管理说明。
3. 平台隔离与审核规避说明。
4. 构建发布手册（环境、命令、产物路径）。
5. 联调说明（接口依赖、时序、异常码处理）。
6. 测试报告（功能、兼容性、性能、回归）。
7. 已知问题清单与风险清单。
8. 软著材料包（代码说明、功能说明、操作说明、申请信息清单）。
9. 提审材料包（平台资质清单、测试账号清单、审核说明、常见驳回对照表）。
10. 上线陪跑手册（上线流程、回滚预案、值班通讯录、事故分级与响应SOP）。
### 4.3 过程交付
1. 周报：本周完成、风险、下周计划。
2. 版本演示：每个里程碑需提供可运行版本。
3. 缺陷处理台账：问题级别、负责人、修复时间。
4. 提审跟踪台账：平台、版本、提交时间、审核结果、驳回原因、整改状态。
5. 陪跑日报：上线窗口期间每日报告稳定性、问题处理与次日计划。
---
## 5. 进度与里程碑要求
### 5.1 建议里程碑（可在商务阶段细化）
1. M1 需求澄清与技术方案确认（第 1 周）：输出详细排期、模块拆分、技术风险列表，并完成开发规范、分支策略、构建策略确认。
2. M2 核心框架与基础流程完成（第 2 至 4 周）：完成登录、主界面、平台入口、分包加载链路，完成资源管理与缓存基础能力。
3. M3 核心玩法功能完成（第 5 至 8 周）：完成图鉴、养殖、贸易站、任务引导主要流程，完成好友聊天、邮件、功能面板流程。
4. M4 联调优化与提审准备（第 9 至 10 周）：完成双平台联调、性能优化、崩溃与卡顿修复，完成提审包、提审资料与软著材料初稿。
5. M5 提审执行与陪跑上线（上线前 1 至 2 周 + 上线窗口期）：完成双平台提审与驳回整改，配合完成软著提交流程，执行上线陪跑、应急响应与回滚演练。
6. M6 上线后质保期（上线后 4 周）：处理线上阻断问题，并输出质保总结与后续迭代建议。
### 5.2 进度管理要求
1. 每周至少一次例会，同步里程碑完成率。
2. 关键阻塞问题需 24 小时内预警。
3. 任一里程碑延期超过 3 个工作日需提交纠偏方案。
---
## 6. 验收标准
### 6.1 功能验收
1. 首发功能清单全部可用，主路径无阻断。
2. 新手引导可完整走通，20 分钟内可完成首次收鱼与出售。
3. 公告、邮件、聊天、黑名单功能交互符合需求。
4. 异常场景具备重试或降级，不出现无响应死锁界面。
### 6.2 平台与包体验收
1. 微信、抖音双端均可独立构建和运行。
2. 目标平台包中错误平台 API 检出数为 0。
3. 分包加载流程稳定，重复点击不触发重复拉包。
4. 主包与业务包边界符合约定，无跨包违规依赖。
### 6.3 性能与稳定性验收
1. 首屏可交互时间满足目标机型要求（以甲方测试标准为准）。
2. 关键页面切换无明显卡顿或白屏。
3. 长时运行无明显内存泄漏。
4. 资源缓存清理策略生效，缓存总量受控。
### 6.4 缺陷验收
1. P0 缺陷：上线前必须清零。
2. P1 缺陷：上线前必须关闭或有甲方书面豁免。
3. P2/P3 缺陷：需有排期与修复负责人。
### 6.5 文档验收
1. 技术、构建、测试文档完整可复用。
2. 甲方可依据文档独立完成构建出包。
### 6.6 软著与提审验收
1. 软著申报所需材料一次性交付完整，字段与版本信息无冲突。
2. 提审材料包完整可用，覆盖微信与抖音双平台。
3. 如出现驳回，乙方需在约定时限内完成问题定位、整改与复提。
4. 上线前完成至少一次回滚演练并通过甲方确认。
### 6.7 陪跑上线验收
1. 上线窗口期有明确值班安排，关键人员可在约定时段内响应。
2. 上线当天完成发布确认、核心路径巡检与问题播报。
3. 出现 P0 事故时按预案执行降级或回滚，并在时限内输出复盘。
---
## 7. 协作与管理要求
### 7.1 沟通机制
1. 日常沟通群：问题响应不超过 2 小时。
2. 周例会：同步进度、风险、资源需求。
3. 版本评审会：里程碑前必须完成演示与评审。
### 7.2 配合机制
1. 甲方需求变更需走变更单流程。
2. 乙方评估变更影响后给出工期与成本调整建议。
3. 重大风险需升级到项目负责人双周评审。
---
### 8.3 软著、提审、陪跑商务边界
1. 软著官方受理费、代理费由甲方承担，乙方承担材料整理与过程配合。
2. 平台提审产生的重复提审与整改工作，若因乙方交付质量问题导致，不额外计费。
3. 陪跑上线默认包含首发窗口期支持；超出约定周期的驻场或值班按增项结算。
### 8.4 投标材料要求
1. 公司案例与相关小游戏项目经验。
2. 核心成员简历与到岗计划。
3. 技术方案、排期、风险管理方案。
4. 报价明细与不含项说明。
---
## 9. 风险与约束
### 9.1 主要风险
1. 需求澄清不充分导致返工。
2. 平台审核规则变化导致提审延后。
3. 资源体量超预算导致包体风险。
4. 联调节奏不一致导致里程碑延期。
5. 软著材料不齐或版本信息不一致导致申请延误。
6. 审核驳回集中发生在上线窗口导致上线延期。
### 9.2 风险应对
1. 首周完成需求冻结与优先级确认。
2. 每周执行平台合规扫描。
3. 每周输出包体与性能趋势报告。
4. 关键路径模块优先联调，提前暴露问题。
5. 软著材料提前两周冻结版本并完成交叉校验。
6. 提审前完成审核自检清单与模拟提审走查。
7. 上线前完成值班排班、预案演练和沟通升级路径确认。
---
## 10. 附录
### 10.1 参考文档
1. 策划总案。
2. 微信小游戏双层分包架构设计文档。
3. 多平台审核零风险目录结构说明。
### 10.2 术语说明
1. 主包：启动时必须加载的客户端基础包。
2. 业务包：按需加载的重玩法代码与资源包。
3. 平台隔离：不同平台实现代码互不交叉调用。
4. 软著：软件著作权登记申报流程与材料。
5. 提审：向平台提交审核并处理驳回直至通过的过程。
6. 陪跑上线：上线窗口期间的发布、巡检、应急与复盘支持。
---
## 1. 项目背景与目标
### 1.1 项目背景
本项目为休闲养鱼小游戏，核心玩法为 图鉴合成 -> 鱼塘养殖 -> 收获出售 -> 轻社交对抗 的循环。
当前甲方需要引入客户端外包团队，完成微信小游戏与抖音小游戏双平台客户端研发与交付，确保：
1. 首发版本可稳定上线。
2. 包体、审核、性能满足渠道要求。
3. 后续版本具备持续迭代能力。
### 1.2 外包目标
1. 在约定周期内交付可上线客户端版本。
2. 实现主包 + 业务包双层分包架构，控制启动耗时与包体风险。
3. 按平台审核规范隔离平台代码，降低审核驳回风险。
4. 建立规范化代码、构建、测试、文档交付体系。
### 1.3 合作定位
1. 甲方负责：产品需求、系统规则、数值策略、资源素材、验收决策。
2. 乙方负责：客户端架构设计、功能开发、联调支持、性能优化、提审支持。
---
## 2. 外包范围
### 2.1 必须交付范围（V1.0）
平台支持：
1. 微信小游戏版本。
2. 抖音小游戏版本。
3. Web 预览版本（开发调试用）。
功能系统：
1. 登录加载与开始游戏流程。
2. 公告入口与页签公告弹窗。
3. 主界面基础框架与功能面板入口。
4. 鱼类图鉴与合成功能前端表现。
5. 鱼塘养殖（投苗、阶段成长、喂食加速、收获）。
6. 贸易站出售流程与结果反馈。
7. 好友、聊天、黑名单、邻居互访入口。
8. 邮件入口与邮件列表基础交互。
9. 任务与新手引导客户端交互流程。
10. 猫屋与犬舍入口及基础交互页面。
上线支撑事项：
1. 软著申报材料整理与提交流程配合。
2. 微信与抖音平台提审资料整理、提审执行与驳回整改。
3. 上线窗口期陪跑支持（发布、回滚、监控与应急响应）。
客户端基础能力：
1. 主包 + 单业务包分包能力。
2. 资源 manifest 解析与 CDN 加载。
3. 本地缓存（索引、容量、淘汰、版本清理）。
4. 统一事件系统、状态管理、服务调用门面。
5. 错误弹窗、重试、降级与日志上报。
工程化能力：
1. 多平台构建脚本（微信/抖音/Web）。
2. 平台代码隔离与构建剔除。
3. 环境配置（开发、测试、预发、正式）切换。
4. 可执行打包与提审流程说明文档。
### 2.2 不在本次外包范围
1. 服务端功能开发。
2. 协议设计与数据库设计。
3. 运营后台系统。
4. 非小游戏平台原生客户端。
5. 软著官方申请费用与第三方法务费用。
6. 平台投放与买量运营执行。
---
## 3. 技术与架构要求
### 3.1 分包架构要求
1. 架构形式：主包 + 业务包（gameplay）。
2. 主包承载：启动流程、登录流程、基础导航、公共能力。
3. 业务包承载：重玩法逻辑与重资源。
4. 禁止：业务层直接调用分包底层加载接口，必须统一由分包管理器调度。
### 3.2 平台隔离要求
1. 平台代码仅可存在于 platform 目录。
2. 业务代码禁止直接引用平台具体实现。
3. 平台实例只能由统一入口创建。
4. 微信目标包不得包含抖音 API 可执行路径，抖音目标包同理。
### 3.3 资源管理要求
1. 资源键必须统一管理，禁止业务代码硬编码路径。
2. 资源寻址流程：manifest -> 本地缓存 -> CDN。
3. 缓存阈值：150MB；淘汰策略：LRU。
4. 启动时必须执行过期资源清理。
5. 下载失败需支持重试与降级，不得直接阻断主流程。
### 3.4 代码与质量要求
1. 核心模块需有清晰目录边界与注释说明。
2. 关键流程必须具备异常处理与回退路径。
3. 不允许出现阻塞主线程的长耗时同步逻辑。
4. 乙方需提供 Code Review 规则与执行记录。
---
## 4. 交付物要求
### 4.1 代码交付
1. 完整客户端工程源码（含构建脚本）。
2. 分支管理规范与版本标签。
3. 提测包、提审包、发布包产物。
### 4.2 文档交付
1. 客户端技术架构说明。
2. 分包与资源管理说明。
3. 平台隔离与审核规避说明。
4. 构建发布手册（环境、命令、产物路径）。
5. 联调说明（接口依赖、时序、异常码处理）。
6. 测试报告（功能、兼容性、性能、回归）。
7. 已知问题清单与风险清单。
8. 软著材料包（代码说明、功能说明、操作说明、申请信息清单）。
9. 提审材料包（平台资质清单、测试账号清单、审核说明、常见驳回对照表）。
10. 上线陪跑手册（上线流程、回滚预案、值班通讯录、事故分级与响应SOP）。
### 4.3 过程交付
1. 周报：本周完成、风险、下周计划。
2. 版本演示：每个里程碑需提供可运行版本。
3. 缺陷处理台账：问题级别、负责人、修复时间。
4. 提审跟踪台账：平台、版本、提交时间、审核结果、驳回原因、整改状态。
5. 陪跑日报：上线窗口期间每日报告稳定性、问题处理与次日计划。
---
## 5. 进度与里程碑要求
### 5.1 建议里程碑（可在商务阶段细化）
1. M1 需求澄清与技术方案确认（第 1 周）：输出详细排期、模块拆分、技术风险列表，并完成开发规范、分支策略、构建策略确认。
2. M2 核心框架与基础流程完成（第 2 至 4 周）：完成登录、主界面、平台入口、分包加载链路，完成资源管理与缓存基础能力。
3. M3 核心玩法功能完成（第 5 至 8 周）：完成图鉴、养殖、贸易站、任务引导主要流程，完成好友聊天、邮件、功能面板流程。
4. M4 联调优化与提审准备（第 9 至 10 周）：完成双平台联调、性能优化、崩溃与卡顿修复，完成提审包、提审资料与软著材料初稿。
5. M5 提审执行与陪跑上线（上线前 1 至 2 周 + 上线窗口期）：完成双平台提审与驳回整改，配合完成软著提交流程，执行上线陪跑、应急响应与回滚演练。
6. M6 上线后质保期（上线后 4 周）：处理线上阻断问题，并输出质保总结与后续迭代建议。
### 5.2 进度管理要求
1. 每周至少一次例会，同步里程碑完成率。
2. 关键阻塞问题需 24 小时内预警。
3. 任一里程碑延期超过 3 个工作日需提交纠偏方案。
---
## 6. 验收标准
### 6.1 功能验收
1. 首发功能清单全部可用，主路径无阻断。
2. 新手引导可完整走通，20 分钟内可完成首次收鱼与出售。
3. 公告、邮件、聊天、黑名单功能交互符合需求。
4. 异常场景具备重试或降级，不出现无响应死锁界面。
### 6.2 平台与包体验收
1. 微信、抖音双端均可独立构建和运行。
2. 目标平台包中错误平台 API 检出数为 0。
3. 分包加载流程稳定，重复点击不触发重复拉包。
4. 主包与业务包边界符合约定，无跨包违规依赖。
### 6.3 性能与稳定性验收
1. 首屏可交互时间满足目标机型要求（以甲方测试标准为准）。
2. 关键页面切换无明显卡顿或白屏。
3. 长时运行无明显内存泄漏。
4. 资源缓存清理策略生效，缓存总量受控。
### 6.4 缺陷验收
1. P0 缺陷：上线前必须清零。
2. P1 缺陷：上线前必须关闭或有甲方书面豁免。
3. P2/P3 缺陷：需有排期与修复负责人。
### 6.5 文档验收
1. 技术、构建、测试文档完整可复用。
2. 甲方可依据文档独立完成构建出包。
### 6.6 软著与提审验收
1. 软著申报所需材料一次性交付完整，字段与版本信息无冲突。
2. 提审材料包完整可用，覆盖微信与抖音双平台。
3. 如出现驳回，乙方需在约定时限内完成问题定位、整改与复提。
4. 上线前完成至少一次回滚演练并通过甲方确认。
### 6.7 陪跑上线验收
1. 上线窗口期有明确值班安排，关键人员可在约定时段内响应。
2. 上线当天完成发布确认、核心路径巡检与问题播报。
3. 出现 P0 事故时按预案执行降级或回滚，并在时限内输出复盘。
---
## 7. 协作与管理要求
### 7.1 沟通机制
1. 日常沟通群：问题响应不超过 2 小时。
2. 周例会：同步进度、风险、资源需求。
3. 版本评审会：里程碑前必须完成演示与评审。
### 7.2 配合机制
1. 甲方需求变更需走变更单流程。
2. 乙方评估变更影响后给出工期与成本调整建议。
3. 重大风险需升级到项目负责人双周评审。
---
### 8.3 软著、提审、陪跑商务边界
1. 软著官方受理费、代理费由甲方承担，乙方承担材料整理与过程配合。
2. 平台提审产生的重复提审与整改工作，若因乙方交付质量问题导致，不额外计费。
3. 陪跑上线默认包含首发窗口期支持；超出约定周期的驻场或值班按增项结算。
### 8.4 投标材料要求
1. 公司案例与相关小游戏项目经验。
2. 核心成员简历与到岗计划。
3. 技术方案、排期、风险管理方案。
4. 报价明细与不含项说明。
---
## 9. 风险与约束
### 9.1 主要风险
1. 需求澄清不充分导致返工。
2. 平台审核规则变化导致提审延后。
3. 资源体量超预算导致包体风险。
4. 联调节奏不一致导致里程碑延期。
5. 软著材料不齐或版本信息不一致导致申请延误。
6. 审核驳回集中发生在上线窗口导致上线延期。
### 9.2 风险应对
1. 首周完成需求冻结与优先级确认。
2. 每周执行平台合规扫描。
3. 每周输出包体与性能趋势报告。
4. 关键路径模块优先联调，提前暴露问题。
5. 软著材料提前两周冻结版本并完成交叉校验。
6. 提审前完成审核自检清单与模拟提审走查。
7. 上线前完成值班排班、预案演练和沟通升级路径确认。
---
## 10. 附录
### 10.1 参考文档
1. 策划总案。
2. 微信小游戏双层分包架构设计文档。
3. 多平台审核零风险目录结构说明。
### 10.2 术语说明
1. 主包：启动时必须加载的客户端基础包。
2. 业务包：按需加载的重玩法代码与资源包。
3. 平台隔离：不同平台实现代码互不交叉调用。
4. 软著：软件著作权登记申报流程与材料。
5. 提审：向平台提交审核并处理驳回直至通过的过程。
6. 陪跑上线：上线窗口期间的发布、巡检、应急与复盘支持。
---
已有6人报名*************
*************
评论