# PinMAP ↔ PinList 双向转换器 测试报告 (v1.5.0)

> **版本**: v1.5.0
> **日期**: 2026-06-06
> **测试类型**: 单元测试 + 集成测试 + 端到端测试
> **测试环境**: Python 3.x, Linux x64

---

## v1.5.0 变更覆盖

v1.5.0 引入三项核心变更：
- **F009**: MAP→List 使用 BallList-Template.xlsx（独立模板）
- **F010**: List→MAP 使用 BallMAP-Template.xlsx（独立模板）
- **F011**: 模板格式提取式应用（字体/边框/填充/对齐/列宽/行高）
- **F012**: PinName 位置确认（bottom=max_row-1, top=min_row+1）

## 测试覆盖矩阵

| 特性 | 单元测试 | 集成测试 | 状态 |
|------|---------|---------|------|
| F009 — BallList 模板加载 | ✅ `test_template_path_generation` | ✅ TC-v1.5-001/002/005 | ✅ |
| F010 — BallMAP 模板加载 | ✅ `test_template_path_generation` | ✅ TC-v1.5-003/004/005 | ✅ |
| F011 — 模板字体应用 | ✅ `test_f011_template_fonts_in_styles_xml` | ✅ TC-v1.5-007/010/013 | ✅ |
| F011 — 模板边框应用 | ✅ `test_f011_template_borders_in_styles_xml` | ✅ TC-v1.5-007/010 | ✅ |
| F011 — 模板填充应用 | ✅ `test_f011_template_fills_in_styles_xml` | ✅ TC-v1.5-010 | ✅ |
| F011 — 默认样式降级 | ✅ `test_f011_default_styles_xml` | ✅ TC-v1.5-002/004/012 | ✅ |
| F011 — 输出 dim 由 Pin 决定 | ✅ `test_f011_output_dims_determined_by_pins` | ✅ TC-v1.5-014 | ✅ |
| F011 — 列宽应用 | — | ✅ TC-v1.5-008/014 | ✅ |
| F011 — 行高应用 | — | ✅ TC-v1.5-009 | ✅ |
| F012 — PinName 位置 | ✅ `test_f012_pinname_position` | — | ✅ |
| 损坏模板优雅降级 | — | ✅ TC-v1.5-006 | ✅ |
| 极简模板 | — | ✅ TC-v1.5-013 | ✅ |
| 无模板完整流程 | — | ✅ TC-v1.5-012 | ✅ |
| 完整往返+模板隔离 | — | ✅ TC-v1.5-011 | ✅ |
| 空 fonts/样式回退 | ✅ `test_template_empty_fonts_fallback` | — | ✅ |
| FF 颜色前缀补全 | ✅ `test_template_color_prefix_auto_fix` | — | ✅ |
| 缺失 styles.xml 降级 | ✅ `test_template_no_styles_xml` | — | ✅ |

## 测试概览

| 类别 | 用例数 | 通过 | 失败 |
|------|--------|------|------|
| 单元测试 (test_pinmap.py) | **18** | **18** | **0** |
| MAP->List 回归 | 6 | 6 | 0 |
| List->MAP 新增 | 17 | 17 | 0 |
| v1.5 模板/样式集成 | 14 | 14 | 0 |
| **总计** | **55** | **55** | **0** |

---

## Part 1: MAP→List 回归测试

### TC-MAP-001: 标准4x4 PinMAP转换
- **结果**: ✅ 通过
- **详情**: 封装=QFP12, Pin数=12, 序号递增

### TC-MAP-002: 长方形PinMAP转换
- **结果**: ✅ 通过
- **详情**: 封装=LQFP100, Pin数=11, 序号递增

### TC-MAP-003: 序号不连续检测
- **结果**: ✅ 通过
- **详情**: 错误: Pin序号不连续 — 缺失的序号: [3]

### TC-MAP-004: 序号重复检测
- **结果**: ✅ 通过
- **详情**: 错误: Pin序号重复 — 重复的序号: [2]

### TC-MAP-005: PinName缺失警告
- **结果**: ✅ 通过
- **详情**: 警告: 检测到 3 个引脚缺少 PinName — 缺失引脚序号: [2, 3, 4]，将默认为 NC

### TC-MAP-006: A1为空检测
- **结果**: ✅ 通过
- **详情**: 正确报错: A1 单元格为空，缺少封装信息

## Part 2: List→MAP 新增功能测试

### TC-LM-001: 5×5 PinList→PinMAP (20引脚)
- **结果**: ✅ 通过
- **详情**: 解析成功, 封装=QFP-20, Pin数=20, 5×5布局验证通过

### TC-LM-002: 6×10 PinList→PinMAP (32引脚)
- **结果**: ✅ 通过
- **详情**: 解析成功, 封装=LQFP-32, Pin数=32, 6×10布局+文件输出验证通过

### TC-LM-003: 带模板文件的转换
- **结果**: ✅ 通过
- **详情**: 模板样式读取成功, 带模板输出文件包含styles.xml

### TC-LM-004: Pin序号不连续
- **结果**: ✅ 通过
- **详情**: 正确报错: Pin序号不连续 — 缺失的序号: [3]

### TC-LM-005: Pin序号重复
- **结果**: ✅ 通过
- **详情**: 正确报错: Pin序号不连续 — 缺失的序号: [4]

### TC-LM-006: Pin总数不匹配
- **结果**: ✅ 通过
- **详情**: 正确报错: Pin数量与网格周长不匹配 — 网格 3×4 需要 14 个引脚，但 PinList 有 8 个

### TC-LM-007: 缺少PinName (warning)
- **结果**: ✅ 通过
- **详情**: 验证通过(有warning): 检测到 1 个引脚缺少 PinName — 缺失引脚序号: [2]，将默认为 NC

### TC-LM-008: 非4倍数提示
- **结果**: ✅ 通过
- **详情**: 验证通过, Pin数=14 (非4倍数)

### TC-LM-009: 布局计算正确性
- **结果**: ✅ 通过
- **详情**: 布局计算正确: left=3, bottom=3, right=3, top=3, 逆时针顺序正确

### TC-LM-010: 模板文件检测(无模板)
- **结果**: ✅ 通过
- **详情**: 无模板文件时优雅返回None

### TC-LM-011: 无效尺寸输入(行数<2)
- **结果**: ✅ 通过
- **详情**: 正确报错: 行数无效: 1，至少需要 2 行

### TC-LM-011b: 无效尺寸输入(列数<2)
- **结果**: ✅ 通过
- **详情**: 正确报错: 列数无效: 1，至少需要 2 列

### TC-LM-012: 输出文件正确性
- **结果**: ✅ 通过
- **详情**: 输出文件验证通过: A1=QFP-12, 包含Pin1-Pin12

### TC-LM-013: 端到端Roundtrip (MAP→List→MAP)
- **结果**: ✅ 通过
- **详情**: Roundtrip成功: PinList(12) → PinMAP(3×3) → PinList(12), 序号一致

### TC-LM-014: 输出路径生成
- **结果**: ✅ 通过
- **详情**: 路径生成正确: /path/to/my_pinlist_PinMAP.xlsx

### TC-LM-015: 空PinList文件
- **结果**: ✅ 通过
- **详情**: 正确报错: 未找到任何引脚数据（A/B 列为空）

### TC-LM-016: A1为空的PinList
- **结果**: ✅ 通过
- **详情**: 正确报错: A1 单元格为空，无法获取封装信息

## Part 3: v1.5 模板/样式集成测试

### TC-v1.5-001: MAP->List 加载 BallList 模板
- **结果**: ✅ 通过
- **详情**: 模板加载成功: fonts=2, borders=2, width_A=25.0

### TC-v1.5-002: MAP->List 无模板降级
- **结果**: ✅ 通过
- **详情**: 无模板文件时优雅返回 None

### TC-v1.5-003: List->MAP 加载 BallMAP 模板
- **结果**: ✅ 通过
- **详情**: 模板加载成功: fonts=2, borders=2, row_height=25.0

### TC-v1.5-004: List->MAP 无模板降级
- **结果**: ✅ 通过
- **详情**: 无模板文件时优雅返回 None

### TC-v1.5-005: 两个方向独立使用各自模板
- **结果**: ✅ 通过
- **详情**: 两个模板独立: BL fonts=2, BM fonts=2

### TC-v1.5-006: 模板损坏优雅降级
- **结果**: ✅ 通过
- **详情**: 损坏模板优雅返回 None

### TC-v1.5-007: 模板字体应用到输出文件
- **结果**: ✅ 通过
- **详情**: 输出 styles.xml 包含模板字体(宋体 14pt)

### TC-v1.5-008: 模板列宽应用到输出文件
- **结果**: ✅ 通过
- **详情**: 列宽验证通过: A=25.0, B=18.0

### TC-v1.5-009: 模板行高应用到输出文件
- **结果**: ✅ 通过
- **详情**: 行高验证通过: ht=25

### TC-v1.5-010: 两个方向不同模板各自的格式
- **结果**: ✅ 通过
- **详情**: 两个方向输出字体不同: BL->楷体, BM->宋体

### TC-v1.5-011: 完整往返+模板隔离
- **结果**: ✅ 通过
- **详情**: 往返成功: 12 pins, 楷体->PinList, 宋体->PinMAP

### TC-v1.5-012: 无模板完整流程
- **结果**: ✅ 通过
- **详情**: 无模板完整流程正常

### TC-v1.5-013: 极简模板(只有字体)
- **结果**: ✅ 通过
- **详情**: 极简模板: font=Courier New

### TC-v1.5-014: 列宽扩展
- **结果**: ✅ 通过
- **详情**: 列宽扩展正确: A=15.0, B=12.0, C=10.0, D=8.0, E=8.0

---

## 结论

✅ **所有测试用例通过，项目可进入发布阶段。**

---

*测试完成*