QualiFlow 是星云智联设备有限公司的“AI 售后服务与产品质量闭环平台”。它把客户会话、正式工单、SLA、维修/换货/退款、现场派工、质量信号、质量事件、CAPA 和知识沉淀连接为可解释、可审计的业务闭环。
- Next.js 双入口：员工从
/login进入企业工作台；客户从/portal/login进入独立服务门户，路由、导航和后端数据范围均隔离。 - 员工工作台：客服三栏会话台、现场工程师任务中心、实时调度中心、售后服务、AI 服务监督、售后运营台账、质量、知识和系统管理页面。
- FastAPI 模块化单体：HttpOnly Cookie、Refresh 轮换、CSRF、RBAC/数据范围、集中状态机、通知、审计、附件、WebSocket 与 REST 增量同步。
- MySQL 8 +
asyncmy：115 张业务表，Alembic head38e7cc690879，数据库是会话、回执、分派、监督、售后履约和运营流水的最终事实来源。 - 实时链路：REST + WebSocket + Transactional Outbox；本地默认
LocalRealtimeBroker，无需 Redis 或 Docker。 - AI 服务边界：真实数据库只读工具、写操作仅生成待人工确认的 proposal；AI 服务监督按提醒、重要警告、强制人工确认分级，禁止 AI 批准退款/换货、删除工单、关闭质量事件或修改权限。
- Windows 11 + PowerShell，不依赖 WSL 或 Docker Desktop。
- Web：Next.js 15、React 19、TypeScript、pnpm、Vitest、Playwright。
- API：Python 3.12、FastAPI、SQLAlchemy Async、Alembic、uv、pytest、Ruff。
- 数据：MySQL 8 为主运行时；SQLite 仅用于隔离测试和紧急演示。
- 附件：本地 Storage Provider；Redis/Celery 是可选部署能力。
powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1
Copy-Item .env.example .env
$env:PYTHONPATH = (Resolve-Path .\apps\api).Path
Set-Location .\apps\api
uv run alembic upgrade head
Set-Location ..\..
powershell -ExecutionPolicy Bypass -File .\scripts\seed-data.ps1在两个 PowerShell 终端分别运行：
powershell -ExecutionPolicy Bypass -File .\scripts\start-api.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\start-web.ps1- Web：http://localhost:3000
- API：http://localhost:8000
- Swagger：http://localhost:8000/docs
- Readiness：http://localhost:8000/api/v1/readiness
实时本地模式适用于单个 API 进程、开发、Playwright 和答辩演示。多 API 实例部署必须接入 Redis 或其他共享消息代理；当前 RedisRealtimeBroker 仅保留接口，尚未实现共享传输。
当前演示环境的实时 AI 会话使用可审计的 Mock Provider；.env 中 DeepSeek Key 为空，因此本轮未发起或伪造真实模型调用。系统管理页明确显示 Mock、最近执行、成功率、延迟与 Token 指标。Embedding 默认同样为 Mock。BGE-M3 Provider 已实现但默认禁用，首次启用需明确模型缓存位置并允许下载；.model-cache/ 不进入 Git。
AI 可以读取客户、订单、设备、保修、工单、知识、队列和派工状态；创建工单、转人工、维修、换货、退款和现场服务只能产生 proposal，由后端权限和人工操作确认。
仅用于本地开发，统一密码 QualiFlow@123。
| 角色 | 邮箱 |
|---|---|
| 管理员 | admin@qualiflow.local |
| 客户 | customer@qualiflow.local |
| 客服 | agent@qualiflow.local |
| 技术工程师 | engineer@qualiflow.local |
| 现场工程师 | field.engineer1@qualiflow.local |
| 调度主管 | dispatcher@qualiflow.local |
| 技术主管 | technical.manager@qualiflow.local |
| 质量经理 | quality.manager@qualiflow.local |
| 售后主管 | service@qualiflow.local |
powershell -ExecutionPolicy Bypass -File .\scripts\test-all.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\lint-all.ps1
uv run --project apps/api python .\scripts\acceptance.py
corepack pnpm --dir apps/web e2e实时业务 Playwright 脚本位于 apps/web/e2e/realtime.spec.ts；本轮精修验收位于 apps/web/e2e/refinement.spec.ts。三档真实 Chromium 截图位于 docs/screenshots/refinement/，截图脚本同时断言 Console/Page Error 和失败 API 为 0。