# pytools

**Repository Path**: nan1314/pytools

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-17
- **Last Updated**: 2025-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Invoice OCR Web (内网部署)

## 新电脑快速上手（必读）
1) 安装前置：
- Python 3.10 或 3.11（推荐 3.11）
- Node.js 18+

2) 创建并激活虚拟环境 `.venv`：
- Windows (PowerShell)：
```powershell
cd backend
python -m venv .venv
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
.\.venv\Scripts\Activate.ps1
```
- macOS / Linux (bash/zsh)：
```bash
cd backend
python3 -m venv .venv
source .venv/bin/activate
```

3) 可选：配置国内镜像（加速下载）
```bash
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
```

4) 后端依赖安装与启动：
```bash
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```
默认管理员：`admin@example.com` / `admin123`

5) 前端依赖安装与启动：
```bash
cd ../frontend
npm install
npm run dev
```
访问 `http://localhost:5173`

## 运行环境与版本
- 后端：Python 3.10/3.11（需使用虚拟环境 `.venv`）
- 前端：Node.js 18+
- 若使用其他 Python 版本，部分二进制依赖可能安装较慢或不兼容

## 提示与常见问题
- 如果安装缓慢，先配置镜像（见上文第 3 步）。
- 如仅需基础功能，可先不安装 OCR 相关大包（如 `paddleocr`），系统仍可运行示例解析逻辑。
- Windows 初次激活虚拟环境若报脚本受限，已在步骤中包含 `Set-ExecutionPolicy` 处理。

## 功能
- 登录 / 注销（JWT）
- 上传发票（PDF/JPG/PNG），解析为示例数据（可替换为 PaddleOCR）
- 列表与导出 Excel（内置简易模板）

## 目录结构
- `backend/` FastAPI + SQLite + JWT
- `frontend/` React + Vite + Ant Design
- 存储目录：`backend/storage`