Todo · BHG-028
Publish booklet collection to the BHG Working site
Goal
Make the Booklets catalogue, detail pages, responsive readers and original PDF/Publisher downloads reachable on the working site while preserving BHG's staged publication/review arrangement.
Source
- Working-site implementation plan.
- 21 September meeting notes: workshop first; Council/Visitor Centre conversation before Preview or Real.
- 4 September meeting notes: publications/treasurer consultation and booklet IP boundaries.
In scope
- Verify House Site Library size/upload restrictions and .pub/.pdf headers, including ~141 MB largest Publisher file.
- Manifest-based, resumable uploads of large non-Git assets, preferably separate from routine page deploys; test no accidental pruning.
- Deliver the 39-page catalogue/detail set and 38 readers to
working-bhg.house-of-ur.com/booklets/. - Wire and verify 38 PDF/Publisher binary downloads, including direct URL, content type, downloaded bytes/hash and mobile usability.
- User expressly approved Working-only publication on 19 Oct 2026; record full-scope approval and preserve visibly draft editorial caveats. BHG-029 and Council/Visitor Centre consultation remain required before later Preview/Real promotion.
Out of scope
- Automatic promotion to Preview, Real, or
burrasa.net. - Changing historical 2017 catalogue data or putting unrelated National Trust publications online.
Acceptance criteria
- Working-site Booklets menu/catalogue and all 39 pages live, with 38 responsive HTML editions. Live GET tested.
- All 76 PDF/Publisher download URLs live with expected MIME types/sizes; the 800 associated Library objects received full SHA-256 readback verification. Same-origin download attributes supply filenames; House sends no Content-Disposition header.
- Resumable bounded-memory uploader and live transfer completed: 800 assets (1,172,003,794 bytes) verified, including large Publisher files; subsequent normal site deployment preserved Library URLs.
- Explicit BHG site-owner approval for Working only recorded per booklet/format on Dev, pinned to manifest; editorial review remains pending but visibly labelled. No Preview/Real approval.
- Working-site smoke tests, navigation and rollback procedure documented.
Stop and ask
Resolved for Working only, 19 October 2026: user explicitly authorised publication of booklets including large Publisher and PDF files to the Working site. Do not deploy to Preview or Real; Council/Visitor Centre consultation remains a separate promotion decision.
Completion notes — 19 October 2026
The local technical staging is implemented. Detailed staging report. A source SHA-256 verified manifest covers 800 files / 1,172,003,794 bytes (38 PDFs, 38 Publisher originals, 724 responsive reader files) outside Git, under D:\bhg-booklet-recovery-20261019\booklet-release\. All 38 titles have deterministic target paths under the Working Library only; internal JSON/legacy exports are excluded.
New bhgsite-working/scripts/booklets/assets.py, delivery.py, and test_delivery.py provide a read-only offline plan, explicit per-title/per-format decision gate (initially unapproved, then explicitly enabled for Working only), 1 MiB streamed transfers, full downloaded-byte/hash/type verification, atomic resume journal and exclusive writer lock. A local loopback upload test passed; an intentional real --execute --confirm-publication attempt correctly refused before API write/auth, because publication had not yet been authorised. Read-only House API listing confirmed the BHG Working Site mapping.
Done for Working only: All 800 assets transferred and verified by public SHA-256 readback. The Working site catalogue and 39 detail pages were deployed, with 38 responsive readers and 76 original-file links. The independent live smoke test passed 153/153 URLs, including all 38 Publisher originals (some over 100 MB). The Site deployment requested a cache invalidation. A damaged receipt journal was preserved and 655 complete verified receipts recovered into upload-journal-recovered.json; the uploader safely resumed and verified the remaining 145 objects. BHG-029 remains an editorial-quality follow-up; no Preview or Real deployment.