Add versioned board canvas persistence and stable SEO slugs
This commit is contained in:
@@ -72,3 +72,35 @@ disables command execution tools. It receives prompts via stdin and returns
|
||||
the final agent message. The worker has no published port and Foundry receives
|
||||
neither the Codex home nor the Docker socket. Keep both containers on the same
|
||||
host for Unix socket access.
|
||||
|
||||
### Board Canvas snapshots and slugs
|
||||
|
||||
Apply `db/003-canvas.sql` through the normal migration runner before starting this
|
||||
version. `GET /projects/{project}/workspaces/{workspace}/materials/{board}/canvas`
|
||||
returns `{version, document}` and a quoted `ETag`. An untouched board returns
|
||||
version 1 and an empty schema-1 graph. `PATCH` takes `{document: <full snapshot>}`
|
||||
and the quoted `If-Match`; it atomically replaces the snapshot and returns
|
||||
`{version}` with the new `ETag`. Canvas and material metadata have separate
|
||||
versions. GET uses existing material read permissions; PATCH requires editor or
|
||||
admin. Missing versions return 428, stale versions 412 `version_conflict`, invalid
|
||||
graphs 400 `invalid_canvas`, and bodies over 5 MiB (UTF-8 bytes) 413. PNG/JPEG/WebP/
|
||||
GIF data URLs up to 2 MiB decoded and HTTPS image URLs are supported. Temporary
|
||||
node selection/drag/measurement state and mirrored styles are discarded.
|
||||
|
||||
Workspace and material create/get/list responses include `slug`. Create and
|
||||
metadata PATCH accept an optional slug (1–100 lowercase ASCII letters/digits,
|
||||
with single hyphens between segments; UUID-form custom values are reserved).
|
||||
Workspace slugs are unique within a project, material slugs within a workspace;
|
||||
duplicates return 409. Defaults use the ASCII name/title and UUID, falling back
|
||||
to a generic prefix for names without ASCII letters/digits. Existing records are
|
||||
backfilled. Renaming leaves slugs stable unless explicitly supplied. Workspace
|
||||
and material path parameters accept either ID or slug, with unchanged permissions.
|
||||
Canvas uses its board material's slug; there is no separate Canvas identity.
|
||||
Slugs enable frontend SEO URLs but do not make private content public or add
|
||||
search-engine metadata. Changing a custom slug does not retain an old alias.
|
||||
|
||||
Frontend follow-up: allowlist the Canvas proxy route and set its body limit to
|
||||
at least 5 MiB; load the server snapshot, offer migration of old local drafts,
|
||||
serialize autosaves and handle 412 explicitly. Restore node style dimensions
|
||||
from width/height and render edges as Bézier curves. These frontend changes are
|
||||
outside this Core delivery; local drafts alone are not database persistence.
|
||||
|
||||
Reference in New Issue
Block a user