Mask Authority Validation

One mask drives all three surfaces · Writer = Preview = Delivered PDF

Template: Angel at Desk (angel_desk_01) · Dimensions derived from uploaded assets

Upload AssetsMigration Dashboard
Live TemplateGeometry State — angel_desk_01
No active TemplateGeometry record for angel_desk_01. Upload assets at Admin → Template Upload.
1

Mask Record Loaded — Asset-Driven Dimensions

Pending

Confirms the TemplateGeometry record for angel_desk_01 exists, is active, has processed mask_bands, and that canvas dimensions come from the uploaded assets.

2

Geometry Parity — Same Mask Drives All Three Surfaces

Pending

Computes pixel-level zone coordinates for Writer/Preview and PDF renderer from the same mask_bands. All values must match.

3

Composition Parity — Writer = Preview = PDF

Pending

Runs paginateItems() with mask geometry and confirms the result is deterministic. The same layout will be used by Writer, Preview, and the PDF renderer.

4

Rollback — is_active Toggle

Pending

Setting is_active=false must instantly revert all three surfaces to the hardcoded Angel geometry. No deployment required.

Current state: No record
5

Visual Surfaces — Writer · Preview · PDF

Pending

Shows Writer (blue boundary visible) and Preview (no boundary) with the same letter body. Visual inspection: composition, line breaks, and page breaks must match. Generate a PDF via the editor to complete the three-surface comparison.

Approval Gate — Angel Mask Authority (angel_desk_01)

✗TemplateGeometry record exists (template_id = "angel_desk_01")
✗production_image_url set — Angel at Desk artwork PNG
✗mask_image_url set — Writing Region Mask PNG
✗mask_bands processed (shape extracted from mask PNG)
✗Canvas dimensions set from uploaded assets (pdf_w × pdf_h)
✗is_active = true
1. Select or enter template_id: angel_desk_01
2. Upload the Angel at Desk production PNG as "Production Background"
3. Upload the Angel Writing Region Mask PNG (white=writable, black=protected)
4. The system will read canvas dimensions from the uploaded files. Confirm they are correct.
5. Check Active and Save. Return here and click Refresh.
Validation Procedure
1. Admin → Template Upload — enter template_id angel_desk_01, upload production PNG and Writing Region Mask PNG.
2. The system reads canvas dimensions from the uploaded files. No hardcoded values.
3. Return here, click Refresh, run Tests 1–4.
4. Test 5: expand Visual Surfaces, inspect that Writer and Preview show identical composition.
5. Test 4 (Rollback): toggle is_active off, confirm surfaces revert, restore.
6. All tests pass + visual inspection confirms Writer = Preview → migration approved.
7. Complete three-surface validation: generate a PDF from the Editor and compare against Test 5 visuals.