feat(govdoc): 补 structure/outline API 端点

fastapi_modules/fastapi_leaudit/controllers/govdocController.py

@@ -181,6 +181,24 @@ class GovdocController(BaseController):
             result = await self.GovdocService.GetRunEntities(runId=runId)
             return Result.success(data=result)
 
+        @self.router.get("/runs/{runId}/structure")
+        async def GetRunStructure(
+            runId: int,
+            payload: dict[str, Any] = Depends(verify_access_token),
+        ):
+            """获取文档结构统计（结构面板数据）。"""
+            result = await self.GovdocService.GetRunStructure(runId=runId)
+            return Result.success(data=result)
+
+        @self.router.get("/runs/{runId}/outline")
+        async def GetRunOutline(
+            runId: int,
+            payload: dict[str, Any] = Depends(verify_access_token),
+        ):
+            """获取文档大纲树（大纲面板数据）。"""
+            result = await self.GovdocService.GetRunOutline(runId=runId)
+            return Result.success(data=result)
+
         @self.router.get("/runs/{runId}/paragraphs")
         async def GetRunParagraphs(
             runId: int,

fastapi_modules/fastapi_leaudit/govdoc_bridge/result_adapter.py

@@ -86,6 +86,37 @@ class ResultAdapter:
             })
         return entities
 
+    def AdaptStructure(self, EngineResult: AuditResult) -> list[dict[str, Any]]:
+        """从 AuditResult.structure 提取文档结构统计。"""
+        results: list[dict[str, Any]] = []
+        for s in EngineResult.structure:
+            results.append({
+                "role": s.role,
+                "label": s.label,
+                "count": s.count,
+                "expected": s.expected,
+                "paragraphIndices": s.paragraph_indices,
+                "samples": s.samples,
+                "charTotal": s.char_total,
+                "dominantFont": s.dominant_font,
+                "dominantSizePt": s.dominant_size_pt,
+                "styleUniform": s.style_uniform,
+            })
+        return results
+
+    def AdaptOutline(self, EngineResult: AuditResult) -> list[dict[str, Any]]:
+        """从 AuditResult.outline 提取大纲树（递归）。"""
+
+        def _node(n) -> dict[str, Any]:
+            return {
+                "paragraphIndex": n.paragraph_index,
+                "level": n.level,
+                "text": n.text,
+                "children": [_node(c) for c in (n.children or [])],
+            }
+
+        return [_node(n) for n in EngineResult.outline]
+
     def AdaptArtifacts(self, _EngineResult: AuditResult, _RunId: int) -> list[dict[str, Any]]:
         """从引擎结果提取报告产物清单。
 

fastapi_modules/fastapi_leaudit/govdoc_bridge/runner.py

@@ -77,6 +77,8 @@ class GovdocRunner:
         runSummary = self.ResultAdapter.AdaptRunSummary(engineResult)
         ruleResults = self.ResultAdapter.AdaptRuleResults(engineResult)
         entities = self.ResultAdapter.AdaptEntities(engineResult)
+        structure = self.ResultAdapter.AdaptStructure(engineResult)
+        outline = self.ResultAdapter.AdaptOutline(engineResult)
         artifacts = self.ResultAdapter.AdaptArtifacts(engineResult, RunId)
 
         # 5. 持久化结果
@@ -95,5 +97,7 @@ class GovdocRunner:
             "documentId": DocumentId,
             "status": "completed",
             "ruleResultsCount": len(ruleResults),
+            "structureCount": len(structure),
+            "outlineCount": len(outline),
             "artifactCount": len(artifacts),
         }

fastapi_modules/fastapi_leaudit/services/govdocService.py

@@ -98,6 +98,16 @@ class IGovdocService(ABC):
         """获取前端文档联动视图所需的段落 HTML。"""
         ...
 
+    @abstractmethod
+    async def GetRunStructure(self, runId: int) -> dict[str, Any]:
+        """获取文档结构统计（结构面板数据）。"""
+        ...
+
+    @abstractmethod
+    async def GetRunOutline(self, runId: int) -> dict[str, Any]:
+        """获取文档大纲树（大纲面板数据）。"""
+        ...
+
     @abstractmethod
     async def GetReportHtml(self, runId: int) -> dict[str, Any]:
         """获取 HTML 报告内容或下载地址。"""

fastapi_modules/fastapi_leaudit/services/impl/govdocServiceImpl.py

@@ -111,6 +111,14 @@ class GovdocServiceImpl(IGovdocService):
         logger.info("[Govdoc] GetRunParagraphs placeholder — runId=%s", runId)
         return {"runId": runId, "paragraphs": []}
 
+    async def GetRunStructure(self, runId: int) -> dict[str, Any]:
+        logger.info("[Govdoc] GetRunStructure placeholder — runId=%s", runId)
+        return {"runId": runId, "structure": []}
+
+    async def GetRunOutline(self, runId: int) -> dict[str, Any]:
+        logger.info("[Govdoc] GetRunOutline placeholder — runId=%s", runId)
+        return {"runId": runId, "outline": []}
+
     async def GetReportHtml(self, runId: int) -> dict[str, Any]:
         logger.info("[Govdoc] GetReportHtml placeholder — runId=%s", runId)
         return {"runId": runId, "htmlUrl": ""}