ChronoChem - 化學時空之旅 🌟

ChronoChem 是一個創新的平台，讓使用者能夠穿越時空，與歷史上著名的化學家進行互動對話，探索化學發展的精彩歷程。

✨ 主要功能

• 🧪 3D 互動場景：探索不同時期的化學實驗室
• 👨‍🔬 化學家對話：與歷史上的化學家進行 AI 驅動的對話
• 📚 歷史事件：了解重要的化學發現和突破
• 🌍 時空旅行：體驗不同時期的化學發展

🚀 快速開始

系統需求

• Node.js 18+
• Python 3.8+
• PostgreSQL 13+
• Docker & Docker Compose (可選)

使用 Docker 運行（推薦）

1
2
3
4
5
6

# 克隆專案
git clone https://github.com/peihe07/chrono-chem.git
cd chrono-chem

# 使用 Docker Compose 啟動
docker-compose up -d

手動安裝

1. 後端設置：

1
2
3
4
5
6

cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

2. 前端設置：

1
2
3

cd frontend
npm install
npm run dev

📚 技術棧

前端

• Vue 3
• Three.js
• TypeScript
• Vite
• Pinia

後端

• Django
• Django REST Framework
• PostgreSQL
• OpenAI API

🔧 開發指南

目錄結構

chrono-chem/
├── frontend/          # Vue 3 前端
├── backend/           # Django 後端
├── docs/             # 文檔
└── docker/           # Docker 配置

環境變數

複製 .env.example 到 .env 並設置必要的環境變數：

1

cp .env.example .env

📝 版本歷史

v1.0.0 (當前版本)

• 完成核心功能實現
• 支援化學家對話
• 3D 場景展示
• 歷史事件瀏覽

v1.1.0 (規劃中)

• 效能優化
• 事件動畫
• 使用者回饋系統
• 分享功能

🤝 貢獻指南

1. Fork 專案
2. 創建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 開啟 Pull Request

📄 授權

本專案採用 MIT 授權 - 詳見 LICENSE 文件

👥 團隊

• 開發者：[peihe]

🙏 致謝

• OpenAI - 提供 AI 對話能力
• Three.js - 3D 渲染引擎
• Vue.js - 前端框架

📞 聯絡方式

• 專案連結：[https://github.com/peihe07/chrono-chem]
• 網站連結：[https://chronochem.uno/]

⚠️ 已知限制

• 部分效能優化功能將在 v1.1.0 中實現
• 使用者回饋系統正在開發中
• 分享功能將在後續版本加入

🔮 未來規劃

• 支援更多化學家
• 加入實驗模擬功能
• 擴充互動動畫
• 優化載入時間
• 實作評分系統