docs(rendering): realign api docs to module structure

docs/api/XCEngine/Rendering/Execution/SceneRenderer/BuildRenderRequests.md

@@ -0,0 +1,65 @@
+# SceneRenderer::BuildRenderRequests
+
+**命名空间**: `XCEngine::Rendering`
+
+**类型**: `method`
+
+**头文件**: `XCEngine/Rendering/Execution/SceneRenderer.h`
+
+## 签名
+
+```cpp
+std::vector<CameraRenderRequest> BuildRenderRequests(
+    const Components::Scene& scene,
+    Components::CameraComponent* overrideCamera,
+    const RenderContext& context,
+    const RenderSurface& surface);
+```
+
+## 行为说明
+
+基于当前场景生成一组“可以立即执行”的 `CameraRenderRequest`。
+
+## 当前流程
+
+1. 调用 `m_requestPlanner.BuildRequests(...)` 生成基础 request
+2. 调用 `ResolveCameraFinalColorPolicies(...)`，把 pipeline 默认值和相机 override 合并成 `request.finalColorPolicy`
+3. 调用 `AttachFullscreenStageRequests(...)`
+4. 返回最终 request 数组
+
+## fullscreen 阶段补全规则
+
+`AttachFullscreenStageRequests(...)` 当前会：
+
+- 为每个 request 按需构建 post-process sequence
+- 为每个 request 按需构建 final-output sequence
+- 为这些 sequence 分配 `FullscreenPassSurfaceCache`
+- 把 `sourceSurface`、`destinationSurface`、`sourceColorView` 和 `passes` 写回 request
+
+但并不是所有 request 都会成功挂上 fullscreen 阶段。当前会跳过这些情况：
+
+- `request.camera == nullptr`
+- `request.context.device == nullptr`
+- `request.surface` 没有有效颜色目标
+- post-process 和 final-output 都为空
+- 主颜色 surface 是多重采样
+- 颜色格式未知
+- 中间 surface cache 创建失败
+
+## 为什么这里不是纯 planner
+
+`BuildRenderRequests(...)` 已经不只是“收集相机并填基础字段”，它还会分配执行阶段真正需要的临时资源。  
+因此它必须位于 `SceneRenderer`，而不是继续下沉到 planner 层。
+
+## 返回值
+
+- 一组已完成基础规划、final-color 解析和 fullscreen 阶段补全的 request
+- 如果当前场景没有可用相机，结果可能为空
+
+## 相关文档
+
+- [SceneRenderer](SceneRenderer.md)
+- [Render](Render.md)
+- [SceneRenderRequestPlanner](../../Planning/SceneRenderRequestPlanner/SceneRenderRequestPlanner.md)
+- [CameraRenderRequest](../../Planning/CameraRenderRequest/CameraRenderRequest.md)
+- [FinalColorSettings](../../Planning/FinalColorSettings/FinalColorSettings.md)