# 后段服务器

**Repository Path**: Blight001/BackSight

## Basic Information

- **Project Name**: 后段服务器
- **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-09-18
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BackSight 后段品质监控

智能锁 PCB 封装前功能测试记录 + 后段工序日报。把现场 Excel 搬进系统，并支持测试工位扫码过站。

## 本地开发

需要 Python 3.12+（3.14 也可）和 Node 20+。

在仓库根目录双击 `start-dev.bat`，或执行：

```powershell
.\start-dev.bat
.\start-dev.ps1
```

或手动：

```powershell
# 后端（默认 SQLite，库文件在 apps/api/data/）
python -m venv .venv
.\.venv\Scripts\python -m pip install -r apps\api\requirements.txt
cd apps\api
..\..\.venv\Scripts\python -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8000

# 前端（另开一个终端）
cd apps\web
npm install
npm run dev
```

浏览器打开 http://127.0.0.1:5173

## 演示账号

| 账号 | 密码 | 职位 |
|---|---|---|
| admin | Admin@123 | 系统管理员 |
| quality01 | Quality@123 | 品质员 |
| clerk01 | Clerk@123 | 录入员 |
| tester01 | Tester@123 | 测试员 |
| lead01 | Lead@123 | 线长 |
| qm01 | Manager@123 | 品质主管 |

已预置 2026-09-15 ~ 09-17 现场日报（3.5图传 / 彩屏 / 黑白屏）。品质看板默认看最近有数据的日期。

员工自助注册须使用管理员在「系统设置 → 注册授权码」中发放的授权码，授权码可指定注册后的职位（不能发管理员）。找回密码和邮箱验证需先配置 SMTP。

## Docker 部署（内网 / 服务器）

```bash
docker compose up --build -d
```

国内服务器构建时会走清华 PyPI / npmmirror，避免直连 PyPI 超时。

打开 http://服务器IP:8080

生产环境请修改 `docker-compose.yml` 里的 `SECRET_KEY` 和数据库密码。

若用 1Panel「容器编排」：compose 文件所在目录必须同时包含 `apps/api/Dockerfile` 和 `apps/web/Dockerfile`。只更新根目录 yml、不覆盖这两个 Dockerfile，pip 国内源不会生效。改完后要「重建」而不是只启动。

## 当前已实现

- 登录、授权码注册、找回密码、可选邮箱验证
- 系统设置：SMTP 邮箱参数、授权码发放（按职位）
- 登录与职位权限（管理员 / 录入员 / 品质 / 测试员 / 线长 / 主管）
- 生产日报矩阵（对应 Excel 列，复测分行，`/` 与 0 区分）
- 不良原因目录、产品工序路由
- Excel 导出
- 测试工位 SN 过站（Pass/Fail/作废），回写当日测试列
- 品质看板（合格/不良/良率条、工序流量、产品卡片）
- 操作记录（管理员追踪日报、过站、主数据的增改）
- SN 追溯、员工账号管理