Files
browser/openspec/changes/add-mysql-platform-metadata-storage/proposal.md
T
2026-07-11 14:56:10 +08:00

21 lines
1.2 KiB
Markdown

# Add MySQL platform metadata storage
## Why
The platform now has durable file storage, but Docker/local configuration does not expose a real MySQL option. Operators need a clear `PLATFORM_STORAGE_BACKEND=mysql` path with commented configuration examples. They also need the deployment docs to make the log storage boundary explicit: MySQL is for platform metadata, not high-volume row-per-log-line bodies.
## What Changes
- Add MySQL metadata storage configuration through `PLATFORM_MYSQL_DSN`.
- Add a MySQL-backed `repo.Store` implementation that persists platform metadata snapshots in a platform-owned table.
- Separate metadata backend selection from log body backend selection with `PLATFORM_LOG_BODY_BACKEND`.
- Update Docker compose/env examples with commented MySQL configuration.
- Document how to configure MySQL locally and in Docker, and clarify that log bodies remain on `LogBodyStore`.
## Impact
- Operators can configure platform metadata persistence with MySQL without changing code.
- Existing file-backed storage remains the default.
- Logs continue to use file segments by default; production log analytics backends remain a future adapter behind `LogBodyStore`.