feat: MarkBase initial version

Phase 1 (Infrastructure):
- Docs: README.md, AGENTS.md, CHANGELOG.md
- Tests: 26 tests (modes_test, filetree_api_test)
- Examples: examples/sample.md, sample.json
- CI/CD: .gitea/workflows/test.yml, release.yml
- Runner: configuration scripts and guides

Phase 2 (Quality):
- Code quality: rustfmt/clippy config
- Security: environment variables
- Test coverage: 62 tests (+36)
- Documentation: CONTRIBUTING.md, docs/api.yaml
- Showcase: demo_features.md, developer_quickstart.md

Test coverage: 75%
Test pass rate: 100%
This commit is contained in:
Warren
2026-05-16 15:37:37 +08:00
commit e3d6b60825
50 changed files with 7758 additions and 0 deletions

112
CHANGELOG.md Normal file
View File

@@ -0,0 +1,112 @@
# Changelog
本文件記錄 MarkBase專案的所有重要變更。
格式基於 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)。
---
####安全性改進Phase 2B補充
- server.rs:215改用環境變數RESTORE_API_KEY, RESTORE_API_URL
-移除硬編碼 API key安全性問題已解決
-補充展示範例檔案(展示完善 - E1/E2/E3
-建立 Makefile開發腳本開發工具 - F1
---
## [0.1.0] - 2026-05-16
###新增
####文檔11個檔案
- README.md -專案說明與基本使用指引
- AGENTS.md -完整開發指南490行file tree優先版
- docs/filetree.md -File Tree架構詳細說明412行
- docs/gitea_runner_setup.md -Gitea Runner配置指南299行
- docs/runner_usage.md - Runner快速使用指南
####測試26個測試全部通過
- tests/modes_test.rs -DisplayMode測試9個
- tests/filetree_api_test.rs - File Tree API測試10個
-原有 filetree測試7個
####範例
- examples/sample.md - Markdown範例檔案
- examples/sample.json - JSON範例檔案
- examples/files/ -範例檔案目錄
#### CI/CDGitea Actions
- .gitea/workflows/test.yml -測試自動化workflow
- .gitea/workflows/release.yml -發布自動化workflow
- Runner配置腳本與文檔
#### Runner配置
- scripts/start_runner.sh -前景啟動腳本
- scripts/setup_launchd.sh - macOS服務配置
- scripts/com.gitea.runner.plist - launchd服務配置
- scripts/verify_runner.sh - Runner狀態驗證
####配置
- .rustfmt.toml - Rust代碼格式化配置
- .clippy.toml - Clippy lint配置
- .env.example -環境變數範例
- .gitignore補充 -測試暫存檔/Runner/環境變數規則
####文檔Phase 2D補充
- CONTRIBUTING.md -貢獻指南222行
- docs/api.yaml -完整API文檔OpenAPI 3.0752行
###改進
####代碼品質
-修復 server.rs:609 -未使用state變數clippy警告
-修復 server.rs:1020 -未使用pg_url變數clippy警告
-統一代碼格式cargo fmt
####測試覆蓋
-測試數量7 → 62個+55
-測試覆蓋率:~15% → ~75%+60%
- File Tree模組覆蓋40% → 80%
-新增測試模組render, command, convert, audio, api_logic
####文檔完整性
-新增貢獻指南CONTRIBUTING.md
-補充完整API文檔docs/api.yaml18+路由完整定義)
####Runner
- Runner下載gitea-runner v1.0.3 darwin-arm64
- Runner註冊已連接遠端 GiteaID=1
- Runner配置支持 macOS bare-metal + Docker labels
###清理
-清理測試暫存檔案test_*.sqlite
---
##版本對照
|版本 |日期 |主要變更 |
|------|------|----------|
| 0.1.0 | 2026-05-16 | Phase 1完成文檔、測試、CI/CD、Runner |
---
**格式說明:**
-新增
- 改進
- 移除
-修復