MPM Documentation Kit v1.3 (CW-034)

MPM Document Standard 1.3, mpmdoc build engine, templates for TN, INS, SOP,
BOM, SVY, TAP, DWG, TSB, PRO, SOW and WO (Chinese editions for TN and DWG),
glossary, MPM fonts and logos, and the mpm-technical-documents plugin 1.3.0.
Worked examples ship in the kit zip on Drive only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NWatTMmqmGatgHjDZvWs5b

_STANDARDS/templates/SVY/build.py

@@ -0,0 +1,61 @@
+"""TEMPLATE — Site Survey (SVY).  Copy this folder to <PROJECT>/source/ and fill it in. Photos go in img/.
+
+A record of what exists on site and what it means for design. 4–12 pages.
+See MPM_Document_Standard.md §9.5.  Reference: SVY-SOR-MON-01 (SORTA Monument Square).
+
+Order: masthead → control table (kv) → About this document (dark) → Status note
+       → PART 1 Summary of Findings (customer) → PART 2 Engineering Detail (MPM internal)
+       → To verify list → Appendix A Photo log → Appendix B Field notes (verbatim) → Revision history
+Rules: dimensions as recorded in the field (convert, never round away the original); anything not
+measured is TBC or a To-verify item; photos are numbered figures and every one is in the photo log.
+"""
+import sys, pathlib
+HERE = pathlib.Path(__file__).resolve().parent
+sys.path.insert(0, str(next(p / "_STANDARDS" for p in HERE.parents if (p / "_STANDARDS").is_dir())))
+
+from mpmdoc import Doc, verify
+
+doc = Doc(
+    number="SVY-MPM-SITE-01", rev="0.1", date="2026-11-06",
+    customer=None, subject="Site name",
+    title="Site Name Wayside Signage",
+    lede="What was surveyed, for which project, and when the field visit took place.",
+    meta=[("Survey date", "Nov 6, 2026"), ("Surveyor", "Jason Stedwell · MPM")],
+    slug="Customer_Site_Site-Survey",
+    classification="internal",          # internal until Part 2 is split out for the customer
+    history=[("0.1", "2026-11-06", "Preliminary draft from field notes and photographs.")],
+)
+
+doc.add(
+    doc.kv([("Prepared for", "Customer, City, ST"), ("Prepared by", "Message Point Media (MPM): name, role"),
+            ("Basis", "N pages of field notes · N site photographs · drawings received (or none)")]),
+    doc.dark("About this document", [
+        "<b>Part 1, Summary of Findings</b>, is written for the customer.",
+        "<b>Part 2, Engineering Detail</b>, is MPM-internal.",
+        "<b>Appendices</b> hold the photo log and a verbatim transcription of the field notes.",
+    ]),
+    doc.note("Status of this revision", f"Preliminary draft. Items marked {verify()} are points of record to confirm with the customer."),
+
+    doc.part("Part 1", "Summary of Findings"),
+    doc.section("1.1 Purpose"), doc.p("Why the survey was done, in rider/agency terms."),
+    doc.section("1.2 Scope"), doc.p("What was in and out of scope, and why."),
+    doc.section("1.3 What we found"),
+    doc.table([("Stops", ""), ("Structure", ""), ("Existing mount", ""), ("Governing clearance", "")],
+              [["A, B", "Steel column", "Side / cantilever", "Member <b>870 mm</b> from mount"]], caption="Families found on site."),
+    doc.p("<b>Lead with the conclusion.</b> One bold sentence per finding, then what it means for the design."),
+
+    doc.part("Part 2", "Engineering Detail", internal=True),
+    doc.section("2.1 Survey record"),
+    doc.kv([("Survey date / time", "From photo EXIF"), ("Site name", f"As recorded {verify()}")]),
+    doc.section("2.2 Observations and design constraints"),
+    doc.sub("Field observations"), doc.bullets(["What was seen or measured, with the value in bold."]),
+    doc.sub("Design constraints and implications"), doc.bullets(["What the observation forces in the design."]),
+    doc.note("To verify with the customer before release", ["Every point of record still open, with its section number."], tone="verify"),
+
+    doc.part("Appendix A", "Photo Log"),
+    doc.table([("#", "q"), ("Time", "m"), ("File ID", "m"), ("Subject", "")], [["1", "08:46:17", "D2C5E8C7", "What the photo shows"]], cls="tight"),
+    doc.part("Appendix B", "Field Notes: Verbatim Transcription"),
+    doc.transcript("Notebook heading", ["Spelling and abbreviations preserved.", "• bullet as written"]),
+)
+
+doc.build()