# 质量中心:质量数据分析平台 用于质量数据查询、分析、规则管理与数据治理的本地优先应用。 ## 架构 - 前端:React、TypeScript、Vite。 - 后端:Java、Spring Boot、MySQL。 - 公网入口:[https://quality.lyunlab.me](https://quality.lyunlab.me)。服务器提供前端静态页面和 HTTPS;API 经 SSH 加密回连到本机后端。 - MySQL、模型凭据、业务来源文件和运行数据保存在本机,不包含在本仓库中。本机需保持开机联网且项目服务运行,其他电脑才能使用完整功能。 ## 本机运行 本机启动脚本面向 macOS Apple Silicon。首次运行需要安装项目运行依赖并构建: python3 scripts/setup_runtime.py pnpm --dir web install --frozen-lockfile python3 scripts/project.py build 随后运行: python3 scripts/project.py start 打开 http://127.0.0.1:5280/。停止服务: python3 scripts/project.py stop 登录信息由本机启动流程生成并保存在 runtimedata/;凭据文件和运行配置被 Git 忽略。 ## 数据与本地配置 本仓库只包含应用源码和必要的构建文件。业务工作簿、数据库、模型 API 密钥、登录凭据、验收报告和运行时文件均不上传。首次克隆后没有预置业务数据,需要在本机导入授权的数据来源。原工作簿迁移验收基线也保留在本机;缺少该私有基线时,对应的原始来源对账功能会明确报告未配置。 本机模型凭据放在项目根目录的 apikey.txt,严禁提交到代码仓库。