跳至主要内容

框架開發

參與 AppFuse Server 框架開發的指南

文檔索引​

文檔說明
框架架構設計了解 appfuse-server 的架構設計與模組結構
貢獻指南如何參與框架開發、程式碼規範、PR 流程
發布狀態當前發布線、已完成能力與權威查詢入口
主版本升級方法論Spring Boot 主版本升級的標準化流程
Entity 型別對齊參考實作對欄位型別規範的暫時遷移清單
報表產生計畫Headless 報表引擎、PDF renderer、大型預覽與選頁列印的交付工作包
報表 renderer spikeREP-01：代表性報表 corpus、PDFBox 能力驗證、測試 harness 與選型建議
ReportDocument 契約設計REP-02：報表 IR 節點、樣式、列來源生命週期與驗證規則（已通過設計審閱）
PDF renderer 契約設計REP-03：renderer 進入點、字型登錄、排版規則、diagnostic 與輸出語意（已通過設計審閱）
Figure 與圖表契約設計REP-04：受限 SVG 子集與安全政策、點陣內容、長條圖與折線圖 adapter（已實作，通過程式碼審閱）
ReportArtifact 與交付契約設計REP-05：產物與暫存 ownership、保存到 FileStorage、狀態值型別與進度、HTTP 交付與授權／ETag 責任（已實作，通過程式碼審閱）
Ranged read 契約設計REP-06：FileStorage ranged-read 能力、各 backend 原生實作、Range／If-Range／416 語意與 PDF.js 跨來源 headers（已實作，通過程式碼審閱）
大型 PDF 按需預覽設計REP-07：PdfViewer 經 HttpClient 的 range transport、windowing 與有界快取、漸進搜尋、列印修正（已實作，通過程式碼審閱）
選頁 subset 與瀏覽器列印設計REP-08：ReportPages 語法、PdfReportSubsets 擷取與保留規則、createReportPrintAdapter 列印生命週期與錯誤回復（已實作，通過程式碼審閱）
報表 Feature slice 設計FU-103：參考伺服器的 report feature，報表 job 生命週期、非同步產生、object scoped 下載與列印、保存期限維護（已實作，通過程式碼審閱）
升級紀錄各版本升級的計劃、進度與紀錄
安全架構歷史路線圖已被現行 ADR 與指南取代的維護紀錄
安全實作歷史任務安全架構演進期間的任務快照
安全性手動測試紀錄歷史端點與手動驗證步驟

快速連結​

開始開發​

# Clone 專案
git clone <repository-url>
cd appfuse-server

# 建構與測試
./gradlew build
./gradlew test

版本管理​

相關資源​