geo/docs/03-开发指南/setup.md

环境搭建

环境要求

组件	版本	说明
Python	3.12+	后端运行环境
Node.js	18+	前端运行环境
Docker	24+	容器化部署
PostgreSQL	15+	主数据库
Redis	7+	缓存和队列

Docker方式（推荐）

1. 克隆项目

git clone http://8.153.107.96/fischer/geo.git
cd geo

2. 配置环境变量

cp .env.example .env
# 编辑.env文件，配置必要的环境变量

3. 启动服务

docker-compose up -d

4. 访问服务

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

本地开发

后端开发环境

cd backend

# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 数据库迁移
alembic upgrade head

# 启动开发服务器
uvicorn app.main:app --reload --port 8000

前端开发环境

cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

IDE配置

VS Code推荐插件

• Python: Pylance, Python
• TypeScript: TypeScript Vue Plugin (Volar)
• ESLint
• Prettier

PyCharm配置

• Python解释器: 选择backend/.venv
• 工作目录: 项目根目录