# pythontools

**Repository Path**: dengdairiluo/pythontools

## Basic Information

- **Project Name**: pythontools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-20
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PythonTools - 个人工具集

日常使用的工具集合 Web 应用。

## 技术栈

### 后端
- **Python 3.11+**
- **FastAPI** - 高性能 Web 框架
- **PostgreSQL** - 数据库
- **SQLAlchemy** - ORM
- **Poetry** - 依赖管理

### 前端
- **React 18+**
- **TypeScript**
- **Vite** - 构建工具
- **Ant Design** - UI 组件库
- **React Router v6** - 路由

## 项目结构

```
pythonTools/
├── backend/              # Python 后端
│   ├── src/
│   │   └── app/
│   │       ├── api/      # API 路由
│   │       ├── core/     # 核心配置
│   │       └── main.py   # 应用入口
│   ├── tests/            # 测试
│   ├── tools/            # 工具脚本
│   ├── .env              # 环境配置（不提交）
│   ├── .env.example      # 配置示例
│   └── pyproject.toml    # Poetry 配置
│
├── frontend/             # React 前端
│   ├── src/
│   │   ├── components/   # 通用组件
│   │   ├── pages/        # 页面组件
│   │   ├── hooks/        # 自定义 Hooks
│   │   └── main.tsx      # 入口
│   └── package.json
│
├── start.bat / start.sh  # 一键启动脚本
├── stop.bat / stop.sh    # 停止脚本
├── .gitignore
├── README.md
└── AGENTS.md             # 项目规范
```

## 快速开始

### 环境要求
- Python 3.11+
- Node.js 18+
- PostgreSQL 14+
- Poetry (可选)
- npm

### 数据库配置

1. 创建 PostgreSQL 数据库：
```sql
CREATE DATABASE pythontools;
```

2. 复制配置文件：
```bash
cd backend
cp .env.example .env
```

3. 编辑 `.env` 文件，配置数据库连接信息

4. 生成混淆密码（可选，如需修改密码）：
```bash
python tools/encode_password.py
```

5. 测试数据库连接：
```bash
python tools/test_db.py
```

### 后端启动

```bash
cd backend
pip install -r requirements.txt  # 或 poetry install
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

### 一键启动

```bash
# Windows
start.bat

# Linux/macOS
./start.sh
```

### 访问地址
- 前端: http://localhost:5173
- 后端 API: http://localhost:8000
- API 文档: http://localhost:8000/docs

## 开发指南

详细的代码规范和开发指南请参阅 [AGENTS.md](./AGENTS.md)。

## 许可证

MIT