PTPGE API — Changelog

The notation system is restructured per SD-0020. Three rules: (1) Printing Process only — Ordering Process terms (products, audiences, geography) no longer carry notations; they're referenced by URI or label. ~280 OP-* notations removed. (2) Two separators: dash (-) for structural levels in hierarchical form, silcrow (§) for leaf elements in flat form. (3) Length-by-level for structural: group 2 chars (CF, CP, ST, MG, TC, FT, SB); category 3 chars (CF-FMT, CP-FIN); sub-category 4 chars (CF-FMT-ASER, CP-FIN-LAMI); deeper levels add 4-char segments. Leaves flat: CF§A4, CP§GLOSS, FT§CMYK, ST§ISO12647-7, SB§SCANDIA-SMOOTH-IVORY (brand-prefixed). Collision fixes: 20 leaf slugs renamed to be globally unique — international envelopes get env- prefix (env-b4, env-c5, etc.) to distinguish from paper formats; vendors on multiple equipment lines get category suffix (heidelberg-press vs heidelberg-fin, hp-press vs hp-wf, esko-ae-pf vs esko-ae-wf); Lessebo Scandia colour variants get grade prefix (smooth-ivory, digital-natural); generic words renamed (custom → custom-color/custom-foil, thermal → thermography/thermal-inkjet, corrugated → corrugated-roll/corrugated-sheet). Total impact: 595 leaves and groups receive new format notation, ~80 categories/sub-categories receive new hierarchical notation, 20 file renames, 0 orphan references, 0 collisions. Tools added: tools/check_orphans.py (URI integrity), tools/check_notation_collisions.py (uniqueness), tools/generate_notations.py (notation generator with dry-run/apply modes).

The Layer 1 Product Model reaches v1.0 with a comprehensive consolidation and naming overhaul, documented in the new standalone specification PTPGE-Product-Model.md. Sections replace surfaces: perSurfaceSupports* predicates are renamed to perSectionSupports* to align with the canonical "1 Section = 1 substrate-side = 1 Print Layer Stack" rule established in SD-0019. Brochures consolidated: ~138 deeply enumerated brochure leaf concepts (each format × orientation × fold-direction combination as a separate term) are replaced by 13 Brochure Templates, one per Setup Model — single-fold, tri-fold, z-fold, gate-fold and its open/closed/double-closed variants, accordion-fold, tri-fold-stand, double-parallel-fold, cross-fold, cross-tri-fold, and roll-fold. All format, orientation, and fold-direction variation is now expressed via supports* predicates and resolved at Layer 2 (Configurator). Setup Models expanded: folded-sheet family grows from 1 pilot variant to 13 variants covering the full topology space; single-fold-4-panel is renamed to single-fold to match the corresponding Folding term. Controlled vocabularies introduced: /v1/ordering/use-cases/ (10 terms) and /v1/ordering/audiences/ (7 terms), referenced from Product Templates via typicalUse and typicalAudience (now URI references rather than string literals). Notation prefix migration: all notations now carry top-concept prefix — OP- for Ordering Process, PP- for Printing Process — providing globally unique identifiers. Ordering Process top-concept gets notation OP-O; Printing Process gets PP-P. Printing Process sub-category normalisation: 27 sub-categories normalised to the 4-char length convention (e.g., FD→PP-FOLD, QU→PP-QUAL, HG→PP-HYGR). Two critical fixes addressed: PS duplicate (paper-suppliers / paper-surfaces) disambiguated to PP-PASU and PP-PASF; PP (printing-presses) renamed to PP-PRPS to avoid collision with the new PP- prefix. Business Cards cleanup: legacy standards/color-systems/* URIs migrated to features/colors/*; features/surface-finishes/* migrated to completions/finishing/laminations/*; technology URIs upgraded to current hierarchy; certification URIs corrected to /environmental/ subtree; compound color concepts (cmyk-plus-white) replaced with atomic Layer-1-correct values (white); Business Card notation changes from BCRD to OP-CARD-BUSI following the 3-part product notation convention. Total impact: 480+ notations updated, 138 deep brochure leaves removed, 22 new vocabulary terms added (use-cases + audiences + setup models + brochure templates), zero deprecated URIs (this is pre-launch v1.0 — no breaking-change announcement required, but future releases will follow the standard deprecation path).

Ordering Process Products now use a Hybrid Composition model: Product Templates carry per-term supports* cross-references into Printing Process (instead of duplicating production vocabulary), plus a small set of product-conceptual typical* properties. A new Setup Composition Grammar describes the structural topology of each printed product via ptpge:setupModel, which references one of three setup families: Flat Sheet (2 surfaces — Front, Back), Folded Sheet (4–12 panels grouped in outside / inside macro-faces), and Multi-page (variable surface count grouped in cover-outside / cover-inside / interior). New URI hierarchy under /v1/ordering/setup-models/. New ptpge: predicates registered in /v1/context: setupModel, surfaceCount, setupConfigurable, perSurfaceProperties, surfaceRoles, macroFaces, surfaceGroups; full supports* inventory (Format, Orientation, Technology, Substrate, ColorMode, Embellishment, Folding, Binding, Certification, etc.); per-surface variants (perSurfaceSupportsColorMode, perSurfaceSupportsEmbellishment, etc.). Rule of thumb for the Layer 1 / Layer 2 boundary: per-term declarative constraints (Brochure supports A4) live in open Layer 1; cross-term combinatorial rules (saddle-stitch requires page count divisible by 4) live in licensed Layer 2. Pilot scope of this release: 2 Product Templates migrated to the new model (Business Card under /v1/ordering/products/buy-online/sheets/business-cards, and Single Fold A5 Portrait Left leaflet under /v1/ordering/products/buy-online/sheets/brochures/single-fold/a5/portrait/left); 2 of 3 Setup Model families published (Flat Sheet, Folded Sheet — Multi-page next); 199 duplicated option-tree nodes pruned (colors/, paper/, quantity/, embellishments/, delivery/ subtrees under Products that duplicated Printing Process concepts). Total term count drops from 932 to 734 as a result. The remaining ~30 leaflet/brochure variant Templates will follow the same pattern in subsequent releases.

PTPGE Layer 1 now serves six languages: three at production quality (en, nb, de — native-speaker / professional review) plus Japanese, Spanish and Simplified Chinese as LLM-draft pending professional print-domain translator review. Coverage is complete on all 464 Printing Process terms — label, definition, and scopeNote where applicable. Translation provenance is machine-readable. The concept scheme at /v1/scheme now carries two new fields: ptpge:translationStatus (an object mapping each language code to either "production" or "llm-draft") and ptpge:translationProvenance (detailed metadata about generation method and review status for non-production languages). API consumers that only want professional-reviewed content can filter on translationStatus == "production". The three LLM-draft languages are part of PTPGE's published roadmap toward 14+ languages by end of 2027 via Founding Partner language sponsorship; professional translator review is scheduled for v1.1 (Q3 2026 — Japanese, highest priority because Japan is the global centre of digital production presses: Komori, Konica Minolta, Canon, Ricoh, Fujifilm, Mimaki, Mutoh, Roland DG, Brother, Mitsubishi, Horizon, Duplo), v1.2 (Q4 2026 — Spanish), and v1.3 (Q1 2027 — Simplified Chinese). The Ordering Process tree remains label-only for now and will receive multilingual coverage in a future release.

Two structural changes ship together in this release. First: the original Manufacturing top concept is renamed to Printing Process (SD-0013). The new label is more precise (the standard describes the printing process, not generic manufacturing) and aligns vocabulary with how the industry actually talks. All URIs under /v1/manufacturing/... have moved to /v1/printing/... — this is a breaking change, but PTPGE is pre-launch and there are no public clients depending on the old paths yet. Second: the Ordering Process top concept ships in full (it was previously deferred). Ordering covers the end-user view — Knowledge (20 terms), Geography (38 terms), and Products (409 terms) — and lets the same vocabulary serve both manufacturing and end-customer ordering workflows (the two-role model). Combined, the API now exposes 932 terms across 2 top concepts, 10 Groups, 35 categories, 148 sub-categories, and 737 leaf elements. The scheme.jsonld now lists both top concepts; the term schema's group enum is extended with the three Ordering groups; the per-term URI structure is unchanged within each branch.

Layer 1 of PTPGE Print Infrastructure is now branded as PTPGE Standard (previously: PTPGE Taxonomy). The technical type description in API docs and RDF context is "a structured vocabulary". The tagline is "The open reference for print". Layer 2's role descriptor shifts from Standard to Logic (since "Standard" now lives at Layer 1). No URIs change. No JSON-LD structure changes. No notation codes change. No API contract changes. Public-facing changes: dashboard and editor titles, API landing-page subtitle, scheme.jsonld definition, README/STATUS/CONTRIBUTING/api-v1-README.md, glossary, decisions, layers, and skos-mapping pages. Rationale: with multilingual labels (4 languages), structured properties (width / height / unit / aspectRatio / standard / area), and external mappings (exactMatch / closeMatch), "Taxonomy" underdescribes what Layer 1 actually is. "Standard" positions PTPGE in the same category as ICC, ISO, JDF, and PDF/X — and differentiates clearly from UPT (Universal Product Taxonomy).

Japanese definition (and scopeNote where applicable) is now populated on every term in the Manufacturing branch — scheme, top concept, all 7 group _index files, and every leaf element across Standards (68), Management (51), Technologies (98), Configurations (118), Features (16), Substrates (74), and Completions (38). 464 of 464 terms (100%) now carry English (en), Norwegian Bokmål (nb), German (de), and Japanese (ja) content. Translations follow established Japanese print-industry terminology (印刷, 製版, 規格, 色空間, 色域, 認証制度, 用紙寸法, 製本, 仕上げ, 折り, 校正, etc.) and use loanwords (デジタル, インクジェット, ラミネート) where these are the established industry term. Strategic intent: Japan is the centre of gravity for the global digital production-press industry (Komori, Konica Minolta, Canon, Ricoh, Fujifilm, Mimaki, Mutoh, Roland DG, Brother, Mitsubishi, Horizon, Duplo) — having JA available removes a frequent adoption barrier for Japanese vendors and buyers.

First Japanese batch — Standards group only. (Superseded by full-coverage release the same day.)

German definition (and scopeNote where applicable) is now populated on every term in the Manufacturing branch — scheme, top concept, all 7 group _index files, and every leaf element across Standards (68), Management (51), Technologies (98), Configurations (118), Features (16), Substrates (74), and Completions (38). 464 of 464 terms (100%) now carry English (en), Norwegian Bokmål (nb), and German (de) content. Translations follow standard German print-industry terminology (Bedruckstoff, Klebebindung, Drahtheftung, Wickelfalz, Bogenoffsetdruck, Tiefdruck, Stichtiefdruck, Briefumschlag, Visitenkarte, etc.).

Two Format-element labels carried typos that broke programmatic parsing of dimensions: A1 (594m x 841 mm) → A1 (594 x 841 mm), and Business Card Japan 91 x 55 mm) (missing opening parenthesis) → Business Card Japan (91 x 55 mm). Term URIs unchanged. Properties (width, height, etc.) populated unchanged.

The unit field on Format properties now accepts mm, cm, in, or px. Pixel-based formats — digital photo sizes, web banners, social-media formats, screen resolutions — are first-class Layer 1 formats alongside paper. Pixel-based area is in px²; aspectRatio is dimensionless and remains comparable across all unit types.

The element-level descriptive-data field is now called properties on every term, in the JSON-LD context (predicate ptpge:hasProperty), and in the schema. The previous label attributes was overloaded with the editor's UI section header; renaming aligns with Schema.org / RDF / eCl@ss convention. Breaking change in shape — clients that read the attributes key must switch to properties.

Every rectangular Format element in configurations/formats/ now carries structured properties: width, height, unit, aspectRatio, standard, area. A4 receives {width: 210, height: 297, unit: "mm", aspectRatio: 1.4142, standard: "ISO 216", area: 62370} and equivalents for all other formats. The single exception is customized (X), which intentionally has no fixed dimensions.

First publicly-tracked release of the PTPGE Standard. 464 terms across the seven Manufacturing groups: Standards (68), Management (51), Technologies (98), Configurations (119), Features (16), Substrates (75), Completions (36). 1 top concept, 7 groups, 22 categories, 54 sub-categories, 380 elements. Every term has a permanent URI under https://ptpge.org/v1/manufacturing/.... English and Norwegian Bokmål definitions populated. Cross-walks to Wikidata and other vocabularies via exactMatch / closeMatch.