# platform/model

Database models live here and are the source of truth for table structure. Migrations must reference these models or be kept in sync with them.

Required model groups:

- users and roles.
- game management plugins and installed plugin versions.
- server instances and config versions.
- AI providers and secret references.
- run endpoints and capabilities.
- jobs and job events.
- artifacts and chunks.
- log streams and ingestion cursors.
- audit events.

Every implemented database model must include field comments, JSON/database tags, and an explicit table name function or equivalent mapping in the chosen stack.