统一自主分析工具范围与执行前校验,严格核验正常结束、最终正文和图表恢复状态,并显示空回答及恢复失败原因。 包含两次已上线修复及回归测试,保留已有回答与业务数据。 验证:1101 项 Python、469 项前端、97 项后端测试通过;前后端构建和真实模型、页面验收通过。
Quality platform backend
Java 21 / Spring Boot API and ingestion service. The service binds to 127.0.0.1:5281; its production data store is MySQL 8.4 with Flyway migrations. There is no embedded database fallback.
Local configuration
Set the following environment variables before starting the API:
MYSQL_URL— JDBC URL for the local MySQL database, including UTF-8 and UTC options.MYSQL_USERandMYSQL_PASSWORD— least-privilege application account.QUALITY_ARCHIVE_ROOT— absolute directory for immutable source revisions and runtime artifacts (defaults to./runtimedata/archive).QUALITY_ALLOWED_ROOTS— path-separator-delimited directories that the scanner may inspect. Each entry is canonicalized; symlinks escaping the configured root are rejected.QUALITY_BOOTSTRAP_ADMIN_USERNAMEandQUALITY_BOOTSTRAP_ADMIN_PASSWORD— optional one-time local administrator bootstrap. Neither value is logged. Omit both to require provisioning through an existing administrative path.
The API does not accept a filesystem path from a browser as a scan target. Callers select source IDs returned by /api/sources. Multipart uploads are stored under the archive root after size and extension checks. Files without a year in their name use QUALITY_DEFAULT_SOURCE_YEAR (default 2026), matching the current workbook title.
Run
From this directory, use the Maven wrapper when present, or Maven 3.9+:
mvn spring-boot:run
Flyway applies src/main/resources/db/migration at startup. The initial account must be explicitly bootstrapped; no public default credentials are created.
API
The front-end contract is served below /api. GET /api/auth/csrf returns a CSRF token and sets XSRF-TOKEN; mutation requests include the same value in X-XSRF-TOKEN. The authenticated session cookie is HttpOnly and SameSite=Strict. Data APIs require a session, and management mutations additionally require role authorization and an idempotency key or expected-version check.