spec.md 1.8 KB

MODIFIED Requirements

Requirement: R5 命名一致(Impl 后缀)

archive 后并入 specs/client-service-layering/spec.md 的 R5 段

R5 演进:从「新增代码强制后缀,存量钉钉中缀为待整改技术债」演进为「全仓所有实现类一律 XxxImpl 后缀」。

钉钉模块 14 个存量中缀文件已按本 change 分 4 批整改为后缀风格:

DDImplClient DDClientImpl
DDImplService DDServiceImpl
DDImplClient_Attendance DDClient_AttendanceImpl
DDImplClient_Contacts DDClient_ContactsImpl
DDImplClient_Dedicated DDClient_DedicatedImpl
DDImplClient_Event DDClient_EventImpl
DDImplClient_Extension DDClient_ExtensionImpl
DDImplClient_Group DDClient_GroupImpl
DDImplClient_Notice DDClient_NoticeImpl
DDImplClient_Personnel DDClient_PersonnelImpl
DDImplClient_Report DDClient_ReportImpl
DDImplClient_Schedule DDClient_ScheduleImpl
DDImplClient_Storage DDClient_StorageImpl
DDImplClient_Workflow DDClient_WorkflowImpl

R5 全文(更新后):

所有实现类命名风格统一为 XxxImpl 后缀

  • 正:DDClientImpl / DDClient_AttendanceImpl / DDServiceImpl / YDClient_FormImpl / BSServiceImpl
  • 负:DDImplClient / DDImplClient_Attendance / DDImplService(中缀风格,全仓禁止)

Scenario: 新增实现类(同 archive 前)

  • WHEN 给某 Client 接口新增实现
  • THEN 文件名必须用 XxxImpl 后缀,禁用 XxxImplXxx 中缀

Scenario: 钉钉新增子 client 实现(更新)

  • WHENservice/dingtalk/impl/ 新增子 client 实现
  • THEN 必须用 DDClient_XImpl 后缀
  • AND 周围所有存量文件均已是后缀风格,无回退诱因