Update API documentation and remove obsolete plan files

docs/api/math/viewport/getaspectratio.md

@@ -1,34 +1,18 @@
 # Viewport::GetAspectRatio
 
 ```cpp
-float GetAspectRatio() const;
+float GetAspectRatio() const
 ```
 
 获取视口宽高比。
 
-**返回：** 宽高比 (width / height)，如果 height 为 0 则返回 0.0f
-
-**线程安全：** ✅
+**返回：** `float` - 宽高比 (width / height)，height 为 0 时返回 0.0f
 
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
-#include "XCEngine/Math/Rect.h"
-#include <iostream>
-
-using namespace XCEngine::Math;
-
-int main() {
-    Viewport viewport(0.0f, 0.0f, 1920.0f, 1080.0f);
-    float aspect = viewport.GetAspectRatio();
-    std::cout << "Aspect Ratio: " << aspect << "\n";
-    return 0;
-}
+Viewport viewport(0, 0, 1920, 1080);
+float aspect = viewport.GetAspectRatio();  // 1.777... (16:9)
 ```
-
-## 相关文档
-
-- [`Viewport::GetRect`](getrect.md) - 转换为 Rect
-- [Viewport 总览](viewport.md)

docs/api/math/viewport/getrect.md

@@ -1,34 +1,18 @@
 # Viewport::GetRect
 
 ```cpp
-Rect GetRect() const;
+Rect GetRect() const
 ```
 
 将视口转换为 Rect。
 
-**返回：** 对应的 Rect（x, y, width, height），不包含深度范围
-
-**线程安全：** ✅
+**返回：** `Rect` - 对应的矩形 (x, y, width, height)，不包含深度范围
 
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
-#include "XCEngine/Math/Rect.h"
-#include <iostream>
-
-using namespace XCEngine::Math;
-
-int main() {
-    Viewport viewport(0.0f, 0.0f, 1920.0f, 1080.0f, 0.0f, 1.0f);
-    Rect rect = viewport.GetRect();
-    std::cout << "Rect: (" << rect.x << ", " << rect.y << ", " << rect.width << ", " << rect.height << ")\n";
-    return 0;
-}
+Viewport viewport(0, 0, 1920, 1080, 0.0f, 1.0f);
+Rect rect = viewport.GetRect();  // (0, 0, 1920, 1080)
 ```
-
-## 相关文档
-
-- [`Viewport::GetAspectRatio`](getaspectratio.md) - 获取宽高比
-- [Viewport 总览](viewport.md)

docs/api/math/viewport/viewport.md

@@ -1,49 +1,45 @@
 # Viewport
 
-**命名空间**: `XCEngine::Math`
+渲染视口结构体，用于屏幕到归一化坐标的映射。
 
-**类型**: `struct`
+**头文件：** `#include <XCEngine/Math/Rect.h>`
 
-**头文件**: `XCEngine/Math/Viewport.h`
+**命名空间：** `XCEngine::Math`
 
-**描述**: 视口，用于渲染目标区域和坐标映射
+## 结构体定义
 
-## 概述
+```cpp
+struct Viewport {
+    float x = 0.0f;
+    float y = 0.0f;
+    float width = 0.0f;
+    float height = 0.0f;
+    float minDepth = 0.0f;
+    float maxDepth = 1.0f;
 
-Viewport 结构体表示一个渲染视口，除了位置和尺寸外，还包含深度范围 `(minDepth, maxDepth)`。主要用于屏幕到归一化设备坐标（NDC）的映射，以及渲染目标区域的定义。
+    Viewport() = default;
+    Viewport(float x, float y, float w, float h);
+    Viewport(float x, float y, float w, float h, float minD, float maxD);
+};
+```
 
-## 公共方法
+## 构造函数
 
 | 方法 | 描述 |
 |------|------|
-| [`GetAspectRatio`](getaspectratio.md) | 获取视口宽高比 |
-| [`GetRect`](getrect.md) | 转换为 Rect |
+| `Viewport()` | 默认构造 |
+| `Viewport(x, y, w, h)` | 2D 视口 |
+| `Viewport(x, y, w, h, minD, maxD)` | 带深度范围的 3D 视口 |
 
-## 使用示例
+## 方法
 
-```cpp
-#include "XCEngine/Math/Rect.h"
-#include <iostream>
-
-using namespace XCEngine::Math;
-
-int main() {
-    Viewport viewport(0.0f, 0.0f, 1920.0f, 1080.0f, 0.0f, 1.0f);
-    
-    std::cout << "Position: (" << viewport.x << ", " << viewport.y << ")\n";
-    std::cout << "Size: " << viewport.width << " x " << viewport.height << "\n";
-    std::cout << "Depth: " << viewport.minDepth << " to " << viewport.maxDepth << "\n";
-    std::cout << "Aspect Ratio: " << viewport.GetAspectRatio() << "\n";
-    
-    Rect rect = viewport.GetRect();
-    std::cout << "As Rect: (" << rect.x << ", " << rect.y << ", " << rect.width << ", " << rect.height << ")\n";
-    
-    return 0;
-}
-```
+| 方法 | 返回值 | 描述 |
+|------|--------|------|
+| [GetAspectRatio()](viewport-getaspectratio.md) | `float` | 宽高比 (width / height) |
+| [GetRect()](viewport-getrect.md) | `Rect` | 转换为 Rect |
 
 ## 相关文档
 
-- [`Rect`](../rect/rect.md) - 浮点矩形
-- [`RectInt`](../rect/rectint.md) - 整数矩形
-- [`Vector2`](../vector2/vector2.md) - 二维向量
+- [Math 模块总览](../math.md) - 返回 Math 模块总览
+- [Rect](rect-overview.md) - 浮点矩形
+- [RectInt](rectint.md) - 整数矩形