Pre-L3库介绍与代码审查流程

0 阅读4分钟

Pre-L3库介绍与代码审查流程

1. 总览:核心双擎架构

本章节展示了构筑射频验证体系的两大基石:能力底座与质量护城河。

1.1 核心双擎

  • 能力底座 (Capability Foundation):Pre-L3 Library
    • 标准化射频自动化测试框架,聚合丰富的 Python 与终端控制模块。
    • 实现测试用例的高效复用与跨设备兼容。
  • 质量护城河 (Quality Moat):Gerrit Code Review
    • 严格基于 Git/Gerrit 的版本控制与同行评审流程。
    • 确保零缺陷代码合入,保障主分支绝对稳定。

核心双擎架构

核心价值:强大的底层测试库结合严格的协同评审机制,构筑了射频验证体系的高效与高可靠运转闭环。


2. 人员与协作流程:CI用例与底层库解耦

为了实现敏捷协作,我们严格分离了测试逻辑设计与底层驱动开发。

2.1 协作流转图

  1. CI Case Owner (用例侧)
    • 需求分析 -> 用例设计/更新
    • 检查:是否有新关键字需求?
      • No -> 直接提交。
      • Yes -> 创建 Jira 任务。
  2. Product Owner & Library Developer (底层库侧)
    • 编码开发 -> 生成关键字 -> 底层库提交。

解耦协作流程

2.2 核心交接点

  • Jira 任务管理:作为跨角色协作的唯一入口。
  • 价值:严格分离测试逻辑设计与底层驱动开发,通过 Jira 实现跨角色敏捷协作。

3. 系统架构概览

3.1 架构分层

Pre-L3 仓库在逻辑上分为团队工作区与 CI 核心库,架构设计实现了测试案例层与技术支撑层的彻底解耦。

层级名称核心模块职责描述
顶层接口与用例集robotws , prel3, AT, CIT, CRT业务逻辑编排
业务控制中枢UE Control, BTS Control, PDU Control设备调度与控制
基础通信与稳定器MCS Control, SA/SG Control, Log基础设施稳定性保障

Pre-L3架构蓝图


4. Python 模块矩阵

4.1 技术栈全景

我们的技术栈分为四个层级,覆盖从基础框架到深度定制的全场景需求:

  1. 核心自动化框架:Robotframework , SSH Library 等等
    • 提供标准化的自动化执行骨架。
  2. 第三方基座支持
    • 引入业界成熟方案处理大数据计算与协议解析。
  3. 通用控制台 (TAF)
    • 实现跨硬件的 CM/FM/PM 统一调度。
  4. 深度定制脚本
    • 针对射频实验室特定硬件环境的精准破局。

Python模块矩阵


5. 治理机制:关键字维护责任

为了保障庞大的底层测试库稳定演进,我们实施了责任到人的治理机制。


6. 代码评审质量关卡:基于 Gerrit 的协同机制

6.1 Gerrit 核心业务优势

  • 效率与协同 (Efficiency & Synergy)
    • 极致提效:分秒必争的闪电级版本控制。
    • 离线隔离:支持全天候、全地域的本地开发验证。
    • 生态接轨:业界最强版本控制生态。
  • 风控与质量 (Risk & Quality)
    • 绝对容错:随时回滚试错。
    • 颗粒度把控:精准到代码行的暂存区管理 (Staging Area)。
    • 沙箱隔离:通过分支彻底隔离不同特性的开发。

6.2 Gerrit 协同运转架构

Gerrit架构图

核心逻辑:所有代码在合入主干前必须经过 Pending 隔离区,强制拦截不合格代码。


7. 日常代码流转与安全周期

7.1 标准化接入流程

  1. 工具链部署:标准化安装 Git 与命令行环境。
  2. 身份认证配置:全局绑定 公司 内部邮箱。
  3. 核心鉴权接入:生成 RSA 密钥并绑定 Gerrit 账户。

7.2 代码流转四步曲

  1. 同步基线 (Sync)
  2. 隔离开发 (Isolate)
  3. 演进与合并 (Evolve)
  4. 规范提交 (Submit)

核心红线:严禁直接 push 到生产主干,所有变动强制路由至 refs/for/master 评审队列。

7.3 代码评审质量关卡

  • Submitter 视角:监控个人提交状态,主动添加 Reviewer 触发自动化邮件通知。
  • Reviewer 视角:执行量化打分。
    • Review Gate (+2):架构合规,准许合入主干 (Ready to Merge)。

代码评审关卡


8. 自动化测试平台核心价值总结

核心资产高维沉淀权责网格化管理质量流水线闭环
Pre-L3 提供高复用、广覆盖的异构设备自动化生态。脚本模块精确绑定第一责任人,响应速度与维护质量双提升。Gerrit 机制全天候拦截劣质代码,实现主干版本 100% 健壮运行。

结语:规范的底层架构与严苛的协作评审,共同构筑了 RF 自动化测试平台不可撼动的护城河。