# python-ocr

**Repository Path**: kasxbls/python-ocr

## Basic Information

- **Project Name**: python-ocr
- **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-05-02
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于图像识别的高校失物招领系统

## 当前阶段

当前仓库已初始化为以下结构：

- `backend/`: FastAPI 后端
- `frontend/`: Vue2 前端
- `deploy/windows/`: Windows 启动脚本
- `docs/`: 后续补充接口文档、数据库设计、部署说明

## 开发环境

本项目约定在 `conda` 虚拟环境 `wangjiayue` 中运行。

```bash
conda activate wangjiayue
```

## 后端启动

```bash
cd backend
cp .env.example .env
pip install -r requirements.txt
uvicorn app.main:app --reload
```

## 前端启动

```bash
cd frontend
npm install
npm run serve
```

## 当前验证结果

目前已经完成：

1. 创建 `wangjiayue` 虚拟环境，Python 版本为 `3.10.20`
2. 安装后端依赖到 `wangjiayue`
3. 安装前端依赖
4. 验证后端应用可导入
5. 验证前端可成功生产构建

## 第一阶段目标

1. 跑通前后端基础框架
2. 完成注册、登录、用户信息接口
3. 完成失物/拾物发布与查询
4. 完成认领申请与管理员审核
5. 预留 OCR 接口，第二阶段接入 PaddleOCR

## Windows 部署说明

当前已经预置：

- `deploy/windows/start_backend.bat`
- `deploy/windows/start_frontend.bat`
- `deploy/windows/build_frontend.bat`
- `deploy/windows/start_app.bat`
- `deploy/windows/install_paddleocr.bat`
- `deploy/windows/install_all.bat`
- `deploy/windows/package_release.py`

后续正式部署到对方 Windows 电脑时，我们会补齐：

1. `wangjiayue` 环境的依赖导出文件
2. Windows 安装与启动说明
3. 前端生产构建与后端静态托管方案
4. 如有需要，再补一个后端 exe 打包方案