diff --git a/spec_artifacts_iso/manifest.yaml b/spec_artifacts_iso/manifest.yaml index 855e1d7..2813c6a 100644 --- a/spec_artifacts_iso/manifest.yaml +++ b/spec_artifacts_iso/manifest.yaml @@ -589,6 +589,37 @@ artifact_types: required: true assert: level: 2 +- name: Glossary + # FR-044: a project Ubiquitous-Language glossary. Its `## Terms` table + # (Term | Definition) is harvested by quire-rs and fed to the EARS + # object-aware vague-response check as accepted concrete terms. + grammar_ref: iso-spec-core + frontmatter_schema_ref: schemas/glossary-frontmatter.schema.json + defaults: + id_pattern: GLO-{next:03d} + allowed_links: + - references + - depends_on + examples: [] + lint_rules_ref: [] + body_extraction: + yield_pattern: + match: + terms: + from: section_body + after_heading: Terms + required: true + assert: + level: 2 + terms_table: + from: table_row + under_section: Terms + required: true + assert: + columns: + - Term + - Definition + min_rows: 1 doc_kinds: - spec object_types: [] diff --git a/spec_artifacts_iso/schemas/glossary-frontmatter.schema.json b/spec_artifacts_iso/schemas/glossary-frontmatter.schema.json new file mode 100644 index 0000000..43f1911 --- /dev/null +++ b/spec_artifacts_iso/schemas/glossary-frontmatter.schema.json @@ -0,0 +1,30 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "type": "object", + "required": [ + "id", + "title", + "type" + ], + "additionalProperties": true, + "properties": { + "id": { + "type": "string", + "minLength": 1 + }, + "type": { + "const": "Glossary" + }, + "title": { + "type": "string", + "minLength": 1 + }, + "scope": { + "type": "string", + "description": "Optional: the bounded context / component this glossary serves." + }, + "description": { + "type": "string" + } + } +} diff --git a/spec_artifacts_iso/skeletons/glossary.md b/spec_artifacts_iso/skeletons/glossary.md new file mode 100644 index 0000000..c72768d --- /dev/null +++ b/spec_artifacts_iso/skeletons/glossary.md @@ -0,0 +1,29 @@ +--- +id: GLO-001 +title: "Order Management Glossary" +type: Glossary +scope: order-management +--- + +# [GLO-001] Order Management Glossary + +## Terms + +| Term | Definition | +|------|------------| +| Place | Convert a draft order into a binding purchase request. | +| Capture | Confirm payment for a placed order at the authorised amount. | +| Fulfilment | The pick, pack, and ship work that completes a paid order. | +| Cancellation window | The period during which a placed order may still be cancelled without compensation steps. |