# paohe

**Repository Path**: quanpower/paohe

## Basic Information

- **Project Name**: paohe
- **Description**: 美驰跑合台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 主减线防错追溯系统

## 项目概述
本项目用于产线防错与追溯，打通扫码枪、PLC、跑合台和气密仪，实现从上料到完工的状态流转与数据记录。

## 当前技术栈
- 前端：React + TypeScript + Vite + Ant Design
- 后端：FastAPI + SQLAlchemy
- 数据库：默认 SQLite（可通过 `DATABASE_URL` 切换）
- 设备通信：`tcpSocket` 中间层 + PLC 轮询

## 当前核心流程
产品状态按以下顺序推进：
`LOADING -> ASSEMBLY -> RUN_IN -> AIRTIGHT -> COMPLETED / NG_BUFFER`

流程触发主要来自 PLC DB102 信号边沿与设备回传数据，后端落库后通过 WebSocket 推送前端页面实时刷新。

## 关键目录
```
paohe/
├── backend/
│   ├── main.py                # FastAPI API 与 WebSocket
│   ├── models.py              # Product / StationRecord 模型
│   ├── crud.py                # 数据读写逻辑
│   ├── export_service.py      # Excel 报表导出
│   ├── verify_export.py       # 导出验证脚本
│   └── verify_full_system.py  # 联调验证脚本
├── tcpSocket/
│   ├── TcpSocketServer.py     # 设备 TCP 服务入口
│   ├── tasks_new.py           # 产线流程编排与 PLC 逻辑
│   └── config.yaml            # tcpSocket 配置
├── frontend/
│   ├── src/
│   ├── package.json
│   └── tsconfig.json
└── start_all.bat              # 一键启动脚本
```

## 运行方式
1. 安装依赖
   - Python 依赖：`pip install -r requirements.txt`
   - 前端依赖：`cd frontend && npm install`
2. 一键启动
   - 在项目根目录运行：`start_all.bat`
3. 导出验证
   - 在项目根目录运行：`python -m backend.verify_export`

## 常用接口
- `POST /products/`：创建产品
- `PUT /products/{sn}/status`：更新产品状态
- `POST /station_records/`：新增工位记录
- `GET /export_report/`：生成导出报表
- `WS /ws`：前端实时状态推送