Instruction file imported from suyunkai/EVCam (.cursor/rules/code-maintainability.mdc). Copyright stays with the author.

代码可维护性原则

核心原则

修改或新增代码时，必须保持项目的可维护性和模块化设计。

具体要求

1. 避免在 MainActivity 中堆积业务逻辑

// ❌ BAD - 把业务逻辑写在 MainActivity
private void uploadWechatVideos(String commandId, String timestamp) {
    // 查找文件、上传、传输...大量业务代码
}

// ✅ GOOD - 委托给专门的 Manager 类
wechatRemoteManager.handleRecordingComplete(commandId, timestamp, callback);

2. 参考现有模式

• 新增远程平台功能时，参考 DingTalkHandler、TelegramHandler 等已验证的实现模式
• 使用现有工具类如 MediaFileFinder、WakeUpHelper 等
• 遵循项目中已有的架构分层

3. Manager 类职责划分

4. 独立可维护性

每个功能模块（如微信小程序）应该：

• 有独立的包结构（如 com.kooo.evcam.wechat）
• 逻辑自包含，不散落在多个无关文件中
• 可以独立理解和修改，不影响其他模块