info-tech-canon/demand/AttributeValueTypes.md

75 lines
2.2 KiB
Markdown
Raw Normal View History

# Demand: Attribute Value Type Catalog
**Status:** inbound demand (un-reviewed)
**Date:** 2026-07-30
**Source:** citation-evidence Capture UX (consumer)
**Related consumer draft:** `citation-evidence/wiki/AttributeValueTypes-proposal.md`
**Proposed workplan:** ITC-WP-0013
---
## Demand signal
Consumer **citation-evidence** needs a **closed, versioned catalog of
attribute value types** for evidence-backed structured capture (key / type /
value), including:
- `time`, `datetime`
- `amount` (quantity + currency)
- `one-of` (single selection from a code list)
- `some-of` (multi selection from a code list)
plus existing scalars `text`, long text, `date`.
The consumer must not invent a permanent private type system if InfoTechCanon
is the semantic reference layer for info-tech domains.
---
## Gap vs current canon
`InfoTechCanonDataModel` already defines:
- Attribute, Field, DataElement, Representation, DataType, CodeList, Constraint
But:
- **DataType** is only a one-line stub,
- **Representation** lists open examples without a closed catalog,
- there is **no** machine-readable AttributeValueType registry for application
forms / capture UIs.
This demand is for a **canonical collection of value types** (and encoding
rules), not for a new domain entity competing with Attribute/Field.
---
## Proposed placement
**Preferred:** extension or section under **ITC-DATA** (Data Model):
- concept: `AttributeValueType` (or closed `Representation` profile for
capture/forms)
- artifact: markdown standard + YAML catalog under `infospace/`
- relationships: AttributeValueType → CodeList (for one-of/some-of), → Constraint
**Avoid:** scattering type ids only inside citation-evidence.
---
## Success criteria
1. Closed list of type ids with definitions and wire encodings.
2. Clear mapping to Representation / CodeList / Constraint.
3. Consumer citation-evidence can depend on the catalog (copy or generated
constants) without forking names.
4. Processed via Purpose/Demand if required by ITC-WP-0006 before kernel edit.
---
## Non-goals
- Full statistical data type system.
- UI widget standards (consumer concern).
- Vendor form-builder schemas (SurveyJS, etc.) as canon.