初始化:质量数据分析平台源码
This commit is contained in:
@@ -0,0 +1,29 @@
|
||||
# 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_USER` and `MYSQL_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_USERNAME` and `QUALITY_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+:
|
||||
|
||||
```sh
|
||||
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.
|
||||
Reference in New Issue
Block a user