企業級股票分析平台

基於 FastAPI 的模組化離線優先股票分析後端系統
專為長期維護性、透明度與可擴展性而設計

🚀 FastAPI 📁 Local CSV 🇹🇼 台灣股市 📴 離線優先 🏗️ 清晰架構 🔒 資料自主
查看原始碼 架構文件 技術故事
100%
離線可用性
3層
清晰架構分層
0
外部依賴鎖定
長期可維護性

專案存在的理由

許多股票系統的失敗不是因為演算法問題,而是因為數據增長、邏輯分散、 以及沒有人記得當初為什麼要這樣設計。

本專案將架構、資料所有權和長期清晰度視為首要關注點, 確保系統能夠隨時間演進而不是腐化。

核心設計原則

📁

本地 CSV 為真實來源

透明、可檢查、可移植的數據格式。 沒有供應商鎖定,沒有隱藏狀態, 所有數據都在你的掌控之中。

🏗️

嚴格的層次分離

API、服務層和核心工具清晰分離, 使系統易於演進,新功能不會破壞舊功能。

🔤

編碼感知設計

台灣股市數據編碼問題被刻意處理, 而非事後補救,確保中文資料完美呈現。

🤖

AI 作為消費者

AI 端點消費已處理的數據, 但永遠不控制核心業務邏輯。

效能優化

智慧快取機制、批次處理和非同步載入, 確保即使處理大量數據也能快速回應。

🔍

可追溯性

從 API 到原始數據的完整追蹤鏈, 問題調試變得簡單直接。

專案結構

清晰的目錄結構確保每個開發者都能快速理解系統架構

Some heading


Jelly cotton candy apple pie toffee soufflé tiramisu pastry cupcake lollipop. Jelly beans wafer ice cream pastry topping topping gingerbread gummies. Brownie cotton candy sweet halvah oat cake.

camera on a map on a desk

Some other heading


Jelly-o chocolate cake sweet fruitcake soufflé. Dessert halvah gummi bears lollipop powder brownie candy bear claw. Jelly-o marshmallow candy candy jujubes croissant fruitcake. Lollipop pudding brownie icing halvah dessert dessert.

mountain landscape

技術棧與工具鏈

FastAPI 後端

現代、高效能的 Python Web 框架, 自動生成 OpenAPI 文件,支援非同步處理。

🐼

Pandas 數據處理

強大的數據分析庫,處理 CSV 檔案 和複雜的時間序列運算。

📊

NumPy 科學計算

高效能的數值運算,支援技術指標 計算和統計分析。

🔄

Uvicorn ASGI Server

閃電般快速的 ASGI 伺服器, 支援高併發和 WebSocket。

安全的功能擴展

清晰的架構分層讓你能夠輕鬆添加新功能, 而不會影響現有的功能。每個模組都有明確的職責邊界, 降低維護成本,提高開發效率。

🔧

清晰的除錯流程

從 API 回應到原始 CSV 數據的完整追蹤鏈。 問題發生時,你能迅速定位是數據問題、業務邏輯問題, 還是 API 層問題。

🔍

未來遷移彈性

CSV 可以在需要時輕鬆替換為 SQLite 或傳統資料庫。 抽象層的設計讓你能夠逐步升級, 而不需要重寫整個系統。

🚀

適用場景

📈 個人投資組合追蹤

管理你的股票投資組合,追蹤績效並生成詳細報告

🔬 量化策略回測

使用歷史數據測試你的交易策略,優化參數

📊 市場數據分析

深入分析市場趨勢、技術指標和統計模式

🤖 AI 模型訓練

為機器學習模型準備高品質的訓練數據

📱 客製化前端整合

為你的網頁或行動應用提供可靠的後端 API

🏢 企業級應用

可擴展的架構支援企業級應用和團隊協作

準備開始了嗎?

立即開始使用這個專業的股票分析系統, 體驗清晰架構帶來的開發效率提升

查看 GitHub 閱讀文件 快速開始