# process-ai-platform

**Repository Path**: XiaoLC/process-ai-platform

## Basic Information

- **Project Name**: process-ai-platform
- **Description**: 工艺AI
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-15
- **Last Updated**: 2025-12-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工艺AI助手 · 全栈脚手架（Vue3 + FastAPI）
## 启动
### 后端
cd packages/backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
./run.sh  # http://localhost:8000/docs
### 前端
cd packages/frontend
npm i && npm run dev  # http://localhost:5173
### 一键冒烟
bash scripts/smoke.sh

## 工位自动匹配模块
1. 通过 `POST /api/station/rules/import` 上传包含 **关键规则 / 工位分配工厂编码 / 工位编码** 的 Excel/CSV/JSON，系统会生成结构化规则集并持久化到 `processed/station_rules.json`。
2. 若需要逐条配置“字段 -> 关键词 -> 工厂/工位”规则，可在 Station 页面使用“新建规则”弹框，或直接调用 `POST /api/station/rules/create`：单条规则可包含多条件 AND/OR 组合，条件类型支持 `equals / contains / regex / range / startswith / endswith`，可输出目标工位、备选工位、责任人等元信息，所有变更即时生效并可在“规则预览”中查看。
3. 如需快速从自然语言生成规则，可调用 `POST /api/station/rules/from-text`，支持选择是否直接落库或仅用于校对。
4. 使用 `POST /api/station/assign` 上传需求 Excel，后端会自动补齐 `上层物料+对象标识` 字段、执行规则匹配、写入 `新工位赋值列` 并在 `processed/` 目录输出命名为 `station_assignment_*.xlsx` 的诊断工作簿，可经 `/api/files/{filename}` 下载。
5. 若需要基于历史样本进行向量匹配，可继续使用 `/api/station/ingest` + `/api/station/match` 接口，两套策略可以并行调试。

## 工艺数据 + 核价平台
- `/api/process-data` 提供材料、设备、结构件的增删改查以及统计接口；SQLite 会自动落地相关数据表，并与前端 `Costing.vue` 中的管理面板对应。
- `/api/costing/calculate-full`、`/api/costing/records`、`/api/costing/templates`、`/api/costing/config` 等接口覆盖自动核价、历史记录、模板与核价配置管理；返回结果同时写入 `costing_records` 表，前端自动核价页可实时展示成本构成。

## 工艺作业指导书模块
- 前端新入口 `/sop` 提供 STL 装配体在线浏览、爆炸视图与截图能力，支持拖拽上传多零件、示例模型加载以及零件列表定位。
- 基于 three.js 与 STLLoader 渲染器，内置线框模式、自动旋转、爆炸距离调节等交互控件，可直接导出当前视角 PNG 用于作业指导书。
- 所有前端资源完全本地化，示例模型位于 `packages/frontend/public/assets/work-instruction/sample.stl`，可替换为企业标准件。