xmsn-demo · 需脉枢纽

B2B 代工制造供需智能语义匹配平台（种子轮 PoC：真实数据、真实运行、真实效果）。

仓库结构（monorepo）

xmsn-demo/
├── frontend/   # 前端 monorepo（pnpm workspace：apps/user-web + apps/admin-web + packages/*）
├── backend/    # 后端 FastAPI（模块化单体，域 = 未来微服务）
├── infra/      # 部署与运维（docker-compose / nginx / 脚本 / .env.example）
├── doc/        # 文档体系（产品三文档 + 系统文档）
└── README.md

一键部署·本地（唯一本地入口，保证数据全新）

# docker 在 WSL 内，需在 WSL 中执行：
wsl -d Ubuntu-22.04 -- bash infra/deploy_local.sh

infra/deploy_local.sh = 全铲（down -v 清空 PG/Milvus/uploads 数据卷）→ 全新构建 → 启动（api 启动时 create_all 建全新空表）→ 全量重灌演示数据（seed_curated --reset，10 家智能音箱厂商 + 10 份 PDF + 知识 + 客户/管理员/厂家账号）。数据重灌只发生在此部署动作，容器日常重启不重灌。

一键部署·远程（deploy_remote.py）

复制 infra/deploy_remote.ini.example → infra/deploy_remote.ini，填写远端后：

python infra/deploy_remote.py
# 可选：--host/--user/--seed always/--backup/--clean/--compress/--force-env

流程 = 远端前置检查（[OK]/[FAIL] 逐项，任一不满足退出）→ 上传部署文件（compose×2 + nginx + .env，远端不构建）→ 本地构建镜像 → docker save → scp 上传 → 远端 docker load → docker compose up -d（叠加 docker-compose.remote.yml 收敛端口，公网仅暴露 80）→ /healthz 探活 → 按配置 seed=always|never 灌数据。远端 .env 默认保留，占位 JWT_SECRET/ADMIN_INIT_PASSWORD 自动随机加固。详见脚本头部注释。

认证：默认 SSH 密钥（ssh_key）；也可在 deploy_remote.ini 配 password（需本地 sshpass：sudo apt install sshpass，或用环境变量 XMSN_SSH_PASSWORD），二者二选一。

一键启动（M8 容器化，开发调试）

# 1) 配置密钥：复制 infra\.env.example → infra\.env，填写 LLM/Embedding Key
# 2) 一键构建 + 拉起（PostgreSQL + Milvus + 后端 api + 前端 web，端口 80）
.\start-all.ps1

# 3) 预置种子数据（100 家 passed 厂商 + 领域知识库 + 演示账号 + 双轨向量；幂等可重跑）
cd infra
docker compose exec api python scripts/seed_data.py

演示账号（种子数据预置，passed）

角色	手机号	密码	入口
客户	13912345678	customer123	http://localhost:5173（对话萃取→提交匹配→结果→查看原文）
厂商	18812345678	vendor123	http://localhost:5173（上传文档→AI 能力档案）
管理员	13800000000	123456	http://localhost:5174（数据概览/需求/厂商/客户/日志）

本地开发模式（手动启动，替代容器化）

• 基础设施：cd infra && docker compose -f docker-compose.local.yml up -d（PostgreSQL :5432 + Milvus :19530）
• 后端：cd backend && .\.venv\Scripts\python.exe -m uvicorn app.main:app --app-dir backend --host 127.0.0.1 --port 8000
• 客户端：cd frontend/apps/user-web && $env:VITE_USE_MOCK="false"; npm run dev（:5173）
• 管理后台：cd frontend/apps/admin-web && $env:VITE_USE_MOCK="false"; npm run dev（:5174）
• API 文档：http://localhost:8000/docs

里程碑（M1-M7 已完成 ✅，M8 部署容器化规划中）

M	内容	状态
M1	前端优先 + 契约先行（monorepo/契约/mock/全部页面 01A~03D）	✅
M2	基础业务（auth/文件/厂商解析/双轨向量/审核）	✅
M3	对话 Agent（Schema/会话/编排/RAG/快照/画像/评估）	✅
M4	匹配引擎（双通道打分/兜底/评估）	✅
M5	解释生成（异步 AI 评语/三组判定/查看原文）	✅
M6	知识库与后台（知识管理/画像注入/审计/概览）	✅
M7	联调与种子数据（100 家厂商/50 家匹配/性能/一键启动/收尾）	✅
M8	部署容器化（补充：后端/前端镜像 + compose 全量一键，任务可扩展）	✅

文档索引

• 产品：doc/产品/
• 系统：doc/系统/（架构 / 核心需求 / 前端规范 / 用户画像 / 代理 / 匹配 / 厂商解析 / 开发计划）