神秘大地 Web版 (Terra Mystica Web)

基于Web的神秘大地桌游在线平台。

技术栈

后端

• FastAPI - 现代Python Web框架
• SQLAlchemy - ORM
• PostgreSQL - 数据库
• Redis - 缓存和会话管理
• WebSocket - 实时通信
• Alembic - 数据库迁移

前端

• React 18 + TypeScript
• Vite - 构建工具
• Ant Design - UI组件库
• Tailwind CSS - 样式框架
• Zustand - 状态管理
• Axios - HTTP客户端

快速开始

使用Docker Compose（推荐）

1. 克隆项目

git clone <repository-url>
cd terra

2. 启动服务

docker-compose up -d

3. 访问应用

• 前端: http://localhost:5173
• 后端API: http://localhost:8000
• API文档: http://localhost:8000/docs

本地开发

后端

1. 创建虚拟环境

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

2. 安装依赖

pip install -r requirements.txt

3. 配置环境变量

cp .env.example .env
# 编辑 .env 文件，配置数据库等信息

4. 运行数据库迁移

alembic upgrade head

5. 启动服务

uvicorn app.main:app --reload

前端

1. 安装依赖

cd frontend
npm install

2. 配置环境变量

cp .env.example .env

3. 启动开发服务器

npm run dev

项目结构

terra/
├── backend/                # 后端代码
│   ├── app/
│   │   ├── api/           # API路由
│   │   ├── core/          # 核心配置
│   │   ├── models/        # 数据库模型
│   │   ├── schemas/       # Pydantic schemas
│   │   ├── services/      # 业务逻辑
│   │   └── main.py        # 应用入口
│   ├── alembic/           # 数据库迁移
│   ├── requirements.txt   # Python依赖
│   └── Dockerfile
├── frontend/              # 前端代码
│   ├── src/
│   │   ├── components/    # React组件
│   │   ├── pages/         # 页面组件
│   │   ├── services/      # API服务
│   │   ├── store/         # 状态管理
│   │   ├── types/         # TypeScript类型
│   │   └── utils/         # 工具函数
│   ├── package.json
│   └── Dockerfile
└── docker-compose.yml     # Docker编排配置

开发计划

详见 开发计划.md

许可证

MIT