Initial commit: DIT_C Flask application

- Flask web application for DIT analysis
- Database models for upload history, analysis results, action cards
- LLM service integration with Ollama API
- Dashboard, upload, and history pages
- RESTful API endpoints for analysis operations

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-12 16:00:05 +08:00
commit d4ce4f9ed1
34 changed files with 6747 additions and 0 deletions

86
.02_Vibe_Coding_SOP.md Normal file
View File

@@ -0,0 +1,86 @@
Markdown
# Vibe Coding 專案執行手冊 (SOP & Structure)
> **說明**: 本文件包含標準專案結構與分階段開發流程。
## 📌 專案結構藍圖 (Project Structure)
請依據此結構進行檔案配置:
```text
project_name/
├── .env # 環境變數(不進版控)
├── .env.example # 環境變數範本
├── .gitignore
├── README.md
├── requirements.txt
├── app.py # 主程式入口
├── config.py # 設定檔
├── preview.html # UI 預覽 (先預覽,後實作)
├── docs/ # 文件中心 (先文件,後開發)
│ ├── SDD.md # 系統設計文件
│ ├── security_audit.md # 資安檢視報告
│ ├── user_command_log.md # 用戶指令記錄
│ ├── CHANGELOG.md # 版本變更紀錄
│ └── API_DOC.md # API 文件
├── models/ # 資料庫模型
├── routes/ # 路由模組
├── services/ # 商業邏輯
├── utils/ # 工具函式
├── templates/ # HTML 模板
└── static/ # 靜態資源
├── css/
├── js/
└── images/
📌 開發流程標準作業程序 (SOP)
Phase 0: 專案初始化
結構建立:依照上述藍圖建立資料夾與基礎檔案。
環境變數:建立 .env設定 DB 連線、LLM API Key 與 Flask 設定。
依賴安裝:建立 requirements.txt 並安裝必要套件 (flask, sqlalchemy 等)。
Git 設定:執行 git init 並建立 .gitignore。
Phase 1: 資料庫架構
Schema 設計:優先建立 users, llm_configs, system_logs 等核心表。
文件化:建立 docs/db_schema.md 記錄結構。
種子資料:寫入預設管理員帳號與預設配置。
Phase 2: UI/UX 預覽 (關鍵檢核點)
建立 preview.html純前端頁面不連接後端。
確認事項配色方案、版面配置、RWD 響應式。
規則:必須等待使用者確認 UI 滿意後,才可進入後端實作。
Phase 3: 核心程式開發
主程式:設定 app.py 與 Blueprint 路由註冊。
功能實作:依序開發 auth (認證), admin (後台), api (服務) 模組。
防挫折:若遇錯 3 次即停止並尋求替代方案。
Phase 4: 功能完善與優化
管理者後台:實作使用者管理與 LLM API 設定測試。
通用功能實作全域錯誤視窗、CSV 匯入/匯出、清單排序。
資安檢視:建立 docs/security_audit.md 並修復高風險項目 (SQL Injection, XSS)。
Phase 5: 交付與部署
文件更新:完善 SDD, CHANGELOG 與 README。
最終檢查:確認 .env 未進版控,所有功能測試通過。
Release標記版本 tag 並推送到版控伺服器。
--
執行手冊已載入。請等待使用者指令開始 Phase 0。