Add demand and proposed workplan for Attribute Value Type catalog.
Consumer citation-evidence needs closed value types; ITC-DATA has Attribute and DataType stubs but no catalog. Track as ITC-WP-0013.
This commit is contained in:
parent
e49b3ae5b5
commit
bd656d4516
2 changed files with 168 additions and 0 deletions
74
demand/AttributeValueTypes.md
Normal file
74
demand/AttributeValueTypes.md
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
# 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.
|
||||
94
workplans/ITC-WP-0013-attribute-value-type-catalog.md
Normal file
94
workplans/ITC-WP-0013-attribute-value-type-catalog.md
Normal file
|
|
@ -0,0 +1,94 @@
|
|||
---
|
||||
id: ITC-WP-0013
|
||||
type: workplan
|
||||
title: "Attribute Value Type catalog (Data Model extension)"
|
||||
domain: infotech
|
||||
repo: info-tech-canon
|
||||
status: proposed
|
||||
priority: high
|
||||
created: "2026-07-30"
|
||||
updated: "2026-07-30"
|
||||
depends_on_workplans:
|
||||
- ITC-WP-0006
|
||||
owner: codex
|
||||
spec_refs:
|
||||
- demand/AttributeValueTypes.md
|
||||
- seeds/InfoTechCanonDataModel_RC1_seed.md
|
||||
- ../citation-evidence/wiki/AttributeValueTypes-proposal.md
|
||||
---
|
||||
|
||||
# ITC-WP-0013 — Attribute Value Type Catalog
|
||||
|
||||
## Goal
|
||||
|
||||
Turn the demand in `demand/AttributeValueTypes.md` into a **canonical,
|
||||
machine-readable catalog of attribute value types** under the Data Model
|
||||
(or a tightly coupled standard), so consumers such as citation-evidence share
|
||||
stable type ids, encodings, and CodeList cardinality rules.
|
||||
|
||||
## Intent
|
||||
|
||||
ITC-DATA already owns Attribute / Field / DataType / Representation / CodeList
|
||||
but does not close the set of practical value types for structured capture.
|
||||
This workplan fills that gap without inventing a parallel “form field”
|
||||
universe.
|
||||
|
||||
## Tasks
|
||||
|
||||
### T01 — Demand intake (PURPOSES)
|
||||
|
||||
```task
|
||||
id: ITC-WP-0013-T01
|
||||
status: todo
|
||||
priority: high
|
||||
```
|
||||
|
||||
Process `demand/AttributeValueTypes.md` under Purpose/Demand (ITC-WP-0006)
|
||||
if still required for kernel-adjacent standards; record decision to extend
|
||||
ITC-DATA vs new sibling standard.
|
||||
|
||||
### T02 — Draft catalog standard
|
||||
|
||||
```task
|
||||
id: ITC-WP-0013-T02
|
||||
status: todo
|
||||
priority: high
|
||||
depends_on: [T01]
|
||||
```
|
||||
|
||||
Draft seed standard section or document:
|
||||
|
||||
- closed AttributeValueType list (MVP from consumer proposal)
|
||||
- wire encoding rules
|
||||
- mapping to Representation / CodeList / Constraint
|
||||
- out-of-scope rules (email-as-type, etc.)
|
||||
|
||||
### T03 — Machine-readable catalog
|
||||
|
||||
```task
|
||||
id: ITC-WP-0013-T03
|
||||
status: todo
|
||||
priority: high
|
||||
depends_on: [T02]
|
||||
```
|
||||
|
||||
Add YAML (+ schema) under `infospace/` and register in indexes/validation.
|
||||
|
||||
### T04 — Consumer alignment note
|
||||
|
||||
```task
|
||||
id: ITC-WP-0013-T04
|
||||
status: todo
|
||||
priority: medium
|
||||
depends_on: [T03]
|
||||
```
|
||||
|
||||
Publish short alignment note for citation-evidence (and future form UIs);
|
||||
link from Data Model kernel map.
|
||||
|
||||
---
|
||||
|
||||
## Out of scope
|
||||
|
||||
- Implementing React widgets (citation-evidence CE-WP-0012).
|
||||
- Full ISO 11179 tooling.
|
||||
Loading…
Add table
Add a link
Reference in a new issue