# ViewDesignEngine 工程文档

## 文档索引

| 编号 | 文档 | 说明 |
|------|------|------|
| **第一阶段：需求分析** | | |
| 01 | [市场调研与竞品分析](01-需求分析/01-市场调研与竞品分析.md) | CGAL、OCCT、libigl 等 7 个引擎对标 |
| 02 | [需求规格说明书](01-需求分析/02-需求规格说明书.md) | 14 类功能需求 + 5 类非功能需求（v1.0 完整版） |
| 03 | [用例文档](01-需求分析/03-用例文档.md) | 6 个核心用例场景 |
| 04 | [功能差距分析](01-需求分析/04-功能差距分析.md) | 41 项功能差距，5 级优先级，分版本路线 |
| **第二阶段：概要设计** | | |
| 05 | [系统架构设计](02-概要设计/01-系统架构设计.md) | 7 层模块架构 + 数据流 + 设计原则 |
| 06 | [模块划分](02-概要设计/02-模块划分.md) | 7 个模块详细组件清单与依赖关系 |
| 07 | [接口定义](02-概要设计/03-接口定义.md) | C++ 虚接口抽象 + C API + 错误处理约定 |
| **第三阶段：详细设计** | | |
| 08 | [数据结构设计](03-详细设计/01-数据结构设计.md) | 半边网格、NURBS、BVH、公差系统 |
| 09 | [核心算法设计](03-详细设计/02-核心算法设计.md) | Delaunay、GJK、QEM、SAH 等算法伪代码 |
| 10 | [类设计](03-详细设计/03-类设计.md) | 类关系图、工厂模式、策略模式、访问者模式 |
| **第四阶段：编码实现** | | |
| 11 | [编码规范](04-编码实现/01-编码规范.md) | C++17 命名、格式、注释、内存、错误处理规范 |
| 12 | [目录结构](04-编码实现/02-目录结构.md) | 完整工程目录树 + CMakeLists.txt 骨架 |
| **第五阶段：测试验证** | | |
| 13 | [测试计划](05-测试验证/01-测试计划.md) | 测试策略、CI 流程、性能基准、回归测试 |
| 14 | [测试用例](05-测试验证/02-测试用例.md) | 8 组详细测试用例，含输入/预期输出 |
| **第六阶段：部署维护** | | |
| 15 | [构建指南](06-部署维护/01-构建指南.md) | Linux/Win/macOS 构建 + FetchContent 集成 |
| 16 | [API 参考](06-部署维护/02-API参考.md) | 7 个模块全部公开 API 签名 |

## 版本路线

```
v0.1.0        v0.3.0          v0.5.0          v1.0.0          v2.0.0
  ✅ 已完成  →  P0 核心缺口  →  P1 算法广度  →  P2 B-Rep    →  P4 高级功能
               追上 Clipper2   追上 Manifold   追上 OCCT       追上 CGAL
               + Manifold      + libigl        建模层          高级
```

## 技术栈

- **语言**: C++17
- **构建**: CMake 3.16+
- **依赖**: Eigen 3.3+
- **测试**: Google Test
- **许可证**: Apache 2.0