复杂APP开发原则技能#

何时使用此技能#

当用户需要以下场景时激活此技能：

1. 从头开发I漫剧APP - 从需求分析到最终交付的完整流程
2. 重构现有APP项目 - 按模块化原则重新组织代码结构
3. 制定APP开发规范 - 建立团队统一的开发流程标准
4. 模块化开发咨询 - 获取模块划分、数据共享、测试策略等指导
5. 开发流程审计 - 检查现有开发流程是否符合规范

---

核心开发原则#

原则1：建立科学的开发流程#

理解和建立APP实现最终功能须经历的步骤，从而建立包含若干必须功能模块的科学先进的开发流程。

实施要点：

• 分析APP最终功能需求
• 拆解功能为独立的必须模块
• 建立模块间的依赖关系和调用顺序
• 制定每个模块的开发标准和验收标准

原则2：模块独立与数据共享#

各功能模块独立打包，并按使用逻辑相互联系，各模块生成的数据可在各模块间顺畅共享和理解识别。

实施要点：

• 每个功能模块独立开发、独立测试
• 定义统一的数据接口规范
• 建立模块间数据共享机制
• 确保数据格式在各模块间可被正确识别和处理

原则3：开发者确认与代码锁定#

开发过程中设置开发者确认功能，一经开发者确认，须锁定确认前的所有模块功能及相应代码，清除其他无效或与现确认功能不相一致的代码。

实施要点：

• 每个模块完成后必须经过开发者确认
• 确认后的模块代码进入锁定状态
• 自动清除与已确认功能不一致的冗余代码
• 锁定记录可追溯，便于问题回溯

原则4：顺序测试调试#

开发流程从前往后对功能模块逐一测试调试，期间不涉及其他模块，一经开发者确认方进入下一模块。

实施要点：

• 按流程顺序依次测试各功能模块
• 当前模块测试期间不引入其他模块干扰
• 开发者确认通过后才能进入下一模块
• 记录每个模块的测试结果和问题

原则5：全局测试与最终锁定#

全部模块测试确认后，测试全局，并按开发者意见不断完善修正，最后锁定。

实施要点：

• 所有模块联调，进行全局功能测试
• 根据开发者反馈进行优化修正
• 最终全面验收后锁定全部代码
• 生成开发完成报告和交付物清单

---

功能模块参考框架（I漫剧APP）#

基础模块层（Layer 1）#

模块名称功能描述优先级用户认证模块注册、登录、权限管理、OAuth第三方登录P0内容管理模块漫剧内容的上传、编辑、审核、版本控制P0用户画像模块用户行为数据收集与分析、偏好建模P1

业务模块层（Layer 2）#

模块名称功能描述优先级播放引擎模块漫剧内容的播放、控制、缓存、画质切换P0互动社区模块评论、点赞、分享、弹幕、话题讨论P1推荐算法模块个性化内容推荐、冷启动、热榜P1

支撑模块层（Layer 3）#

模块名称功能描述优先级消息通知模块推送、提醒、站内信、系统通知P2支付结算模块付费内容、会员订阅、虚拟货币P2数据分析模块运营数据统计、报表、AB测试P2

公共模块（Infrastructure）#

模块名称功能描述优先级日志记录模块系统运行日志、用户行为日志P0配置管理模块应用配置、热更新、开关控制P1异常处理模块全局异常捕获与处理、容灾降级P0

---

开发流程#

text

┌─────────────────────────────────────────────────────────────────┐
│                         开发阶段流程                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  [1.需求分析] → [2.模块设计] → [3.模块开发] → [4.模块测试]        │
│        ↓                ↓              ↓              ↓         │
│        └────────────────┴──────────────┴──────────────┘         │
│                           ↓                                      │
│                    [5.开发者确认]                                 │
│                           ↓                                      │
│        ┌────────────────┬───────────────┬────────────────┐      │
│        ↓                ↓               ↓                ↓      │
│  [6.模块联调] ← [循环至所有模块确认] → [7.联调测试] → [8.全局测试] │
│        ↓                                                            │
│   [9.最终锁定]                                                      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

阶段详细说明#

阶段输入输出验收标准1.需求分析产品需求文档、用户故事功能清单、优先级排序需求覆盖完整、无遗漏2.模块设计功能清单模块划分图、接口定义、数据字典模块边界清晰、依赖关系明确3.模块开发模块设计文档可运行代码、单元测试代码符合规范、测试通过4.模块测试模块代码测试报告、缺陷列表功能完整、无阻塞缺陷5.开发者确认测试报告确认签字、代码锁定开发者审核通过6-8.联调测试已锁定模块集成测试报告全流程跑通、性能达标9.最终锁定测试报告发布版本、交付清单验收通过、代码冻结

---

代码锁定机制#

锁定规则#

1. 单模块锁定：单个模块开发测试完成后，开发者确认即锁定
2. 级联锁定：后续模块依赖已锁定模块时，不得修改已锁定模块
3. 解锁流程：如需修改已锁定模块，必须走解锁审批流程

锁定检查清单#

• 模块代码已提交到指定分支
• 所有单元测试通过
• 开发者审核签字
• 依赖此模块的其他模块已记录
• 锁定记录已创建

---

数据共享规范#

接口设计原则#

text

┌─────────────┐      接口契约      ┌─────────────┐
│   模块A     │ ←───────────────→ │   模块B     │
│             │   统一数据格式     │             │
└─────────────┘                   └─────────────┘

数据格式标准#

• 使用JSON作为模块间数据交换格式
• 关键字段必须包含： id、 type、 timestamp、 version
• 敏感数据需加密传输

共享数据示例#

json

{
  "id": "unique_identifier",
  "type": "data_type",
  "timestamp": "2026-03-24T03:52:44Z",
  "version": "1.0.0",
  "payload": {}
}

---

参考资源#

资源类型路径说明模块设计模板references/module_design_template.md模块设计文档模板接口定义规范references/api_specification.mdAPI接口设计规范测试用例模板references/test_case_template.md测试用例编写规范交付清单模板references/delivery_checklist.md项目交付检查清单

---

脚本工具#

脚本名称用途命令validate_structure.py验证项目目录结构python scripts/validate_structure.py``generate_module.py生成模块骨架代码python scripts/generate_module.py <module_name>``lock_module.sh锁定指定模块bash scripts/lock_module.sh <module_name>

---

版本变更记录#

版本日期变更内容1.0.02026-03-24初始版本，定义五大核心原则和模块框架