feat(portfolio): fold in RAILIANCE-WP-0016 apps-pg evidence
First delegated evidence from RESOURCE-WP-0003-T04 to land. railiance-platform delivered apps-pg capacity, utilization, consumers, and the apps-pg-dbbytes-v1 allocation driver, and correctly delivered no EUR. - data/resources/apps-pg.json: real capacity; allocation unattributed -> shared under apps-pg-dbbytes-v1; second consumer vergabe-teilnahme registered - data/control-cycle/apps-pg-2026-09-base.json: first operational control-cycle record in the repository - examples/control-cycle/apps-pg-*.json retired; the invented fixture collided with the real record's identifier - data/portfolio-coverage-2026-08-14.json: gap marked delivered with three residual unknowns still open The real evidence exposed a design gap in the T05 schema: v0.1 required a number for every cost field, so recording genuine usage without a booked cost meant inventing one. Schema 0.2 permits null costs, null unattributed_eur, a technical unattributed_share, and null measurements. Null is unknown, never zero; an unknown component makes the total null rather than the sum of the known parts; and the comparator classifies unknown amounts as data_quality instead of computing a variance. Existing 0.1 records are not rewritten. apps-pg is now measured (idle at 5.8% of volume) and attributed, and remains unpriced: delivered technical evidence does not create a booked cost. 86 tests pass. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
parent
b64b5683df
commit
17de8b831e
16 changed files with 908 additions and 71 deletions
|
|
@ -4,81 +4,286 @@
|
|||
"title": "Immutable resource forecast or actual observation",
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["schema_version", "record_id", "record_type", "resource_id", "resource_class", "period", "created_at", "usage_proxies", "capacity", "costs", "allocation", "service_constraints", "evidence"],
|
||||
"required": [
|
||||
"schema_version",
|
||||
"record_id",
|
||||
"record_type",
|
||||
"resource_id",
|
||||
"resource_class",
|
||||
"period",
|
||||
"created_at",
|
||||
"usage_proxies",
|
||||
"capacity",
|
||||
"costs",
|
||||
"allocation",
|
||||
"service_constraints",
|
||||
"evidence"
|
||||
],
|
||||
"properties": {
|
||||
"schema_version": {"const": "0.1"},
|
||||
"record_id": {"type": "string", "minLength": 1},
|
||||
"record_type": {"enum": ["forecast", "actual"]},
|
||||
"resource_id": {"type": "string", "pattern": "^resource:"},
|
||||
"resource_class": {"enum": ["storage", "vm", "cluster_compute", "shared_platform_service", "managed_service", "other"]},
|
||||
"period": {"type": "string", "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$"},
|
||||
"created_at": {"type": "string", "format": "date-time"},
|
||||
"scenario": {"enum": ["low", "base", "high", "observed"]},
|
||||
"forecast_ref": {"type": ["string", "null"]},
|
||||
"revision_of": {"type": ["string", "null"]},
|
||||
"schema_version": {
|
||||
"enum": [
|
||||
"0.1",
|
||||
"0.2"
|
||||
],
|
||||
"description": "0.2 permits null cost components for facts the authoritative repository has not supplied. Existing 0.1 records stay valid and are never rewritten; immutability applies to the record, not to the schema."
|
||||
},
|
||||
"record_id": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"record_type": {
|
||||
"enum": [
|
||||
"forecast",
|
||||
"actual"
|
||||
]
|
||||
},
|
||||
"resource_id": {
|
||||
"type": "string",
|
||||
"pattern": "^resource:"
|
||||
},
|
||||
"resource_class": {
|
||||
"enum": [
|
||||
"storage",
|
||||
"vm",
|
||||
"cluster_compute",
|
||||
"shared_platform_service",
|
||||
"managed_service",
|
||||
"other"
|
||||
]
|
||||
},
|
||||
"period": {
|
||||
"type": "string",
|
||||
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$"
|
||||
},
|
||||
"created_at": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
},
|
||||
"scenario": {
|
||||
"enum": [
|
||||
"low",
|
||||
"base",
|
||||
"high",
|
||||
"observed"
|
||||
]
|
||||
},
|
||||
"forecast_ref": {
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
]
|
||||
},
|
||||
"revision_of": {
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
]
|
||||
},
|
||||
"usage_proxies": {
|
||||
"type": "object",
|
||||
"minProperties": 1,
|
||||
"additionalProperties": {"$ref": "#/$defs/measurement"}
|
||||
"additionalProperties": {
|
||||
"$ref": "#/$defs/measurement"
|
||||
}
|
||||
},
|
||||
"capacity": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["model", "provisioned", "used"],
|
||||
"required": [
|
||||
"model",
|
||||
"provisioned",
|
||||
"used"
|
||||
],
|
||||
"properties": {
|
||||
"model": {"enum": ["fixed", "elastic", "hybrid"]},
|
||||
"provisioned": {"type": "object", "additionalProperties": {"$ref": "#/$defs/measurement"}},
|
||||
"used": {"type": "object", "additionalProperties": {"$ref": "#/$defs/measurement"}}
|
||||
"model": {
|
||||
"enum": [
|
||||
"fixed",
|
||||
"elastic",
|
||||
"hybrid"
|
||||
]
|
||||
},
|
||||
"provisioned": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"$ref": "#/$defs/measurement"
|
||||
}
|
||||
},
|
||||
"used": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"$ref": "#/$defs/measurement"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"costs": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["currency", "infrastructure", "internal_labor", "external_labor", "total"],
|
||||
"required": [
|
||||
"currency",
|
||||
"infrastructure",
|
||||
"internal_labor",
|
||||
"external_labor",
|
||||
"total"
|
||||
],
|
||||
"properties": {
|
||||
"currency": {"const": "EUR"},
|
||||
"infrastructure": {"type": "number", "minimum": 0},
|
||||
"internal_labor": {"type": "number", "minimum": 0},
|
||||
"external_labor": {"type": "number", "minimum": 0},
|
||||
"total": {"type": "number", "minimum": 0},
|
||||
"booked_cost_refs": {"type": "array", "items": {"type": "string"}, "uniqueItems": true}
|
||||
}
|
||||
"currency": {
|
||||
"const": "EUR"
|
||||
},
|
||||
"infrastructure": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"description": "EUR, or null when the amount is not yet known. Null is unknown, never zero."
|
||||
},
|
||||
"internal_labor": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"description": "EUR, or null when the amount is not yet known. Null is unknown, never zero."
|
||||
},
|
||||
"external_labor": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"description": "EUR, or null when the amount is not yet known. Null is unknown, never zero."
|
||||
},
|
||||
"total": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"description": "EUR, or null when the amount is not yet known. Null is unknown, never zero."
|
||||
},
|
||||
"booked_cost_refs": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
},
|
||||
"uniqueItems": true
|
||||
}
|
||||
},
|
||||
"description": "Cost components split so a cheaper unit price that raises operator hours is visible. Any component may be null when the authoritative repository or fin-hub has not supplied it; total must then also be null, and variance for that component is reported as unknown."
|
||||
},
|
||||
"allocation": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["method", "driver", "method_version", "unattributed_eur"],
|
||||
"required": [
|
||||
"method",
|
||||
"driver",
|
||||
"method_version",
|
||||
"unattributed_eur"
|
||||
],
|
||||
"properties": {
|
||||
"method": {"type": "string", "minLength": 1},
|
||||
"driver": {"type": "string", "minLength": 1},
|
||||
"method_version": {"type": "string", "minLength": 1},
|
||||
"unattributed_eur": {"type": "number", "minimum": 0}
|
||||
"method": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"driver": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"method_version": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"unattributed_eur": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"description": "EUR that reaches no consumer under the stated method, or null when the underlying cost itself is unknown. Null is unknown, never zero."
|
||||
},
|
||||
"unattributed_share": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"maximum": 1,
|
||||
"description": "Fraction of the allocation driver that reaches no consumer. Recordable from technical evidence alone, before any EUR amount exists."
|
||||
}
|
||||
}
|
||||
},
|
||||
"service_constraints": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"$ref": "#/$defs/measurement"
|
||||
}
|
||||
},
|
||||
"service_constraints": {"type": "object", "additionalProperties": {"$ref": "#/$defs/measurement"}},
|
||||
"uncertainty": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["level", "notes"],
|
||||
"required": [
|
||||
"level",
|
||||
"notes"
|
||||
],
|
||||
"properties": {
|
||||
"level": {"enum": ["low", "medium", "high"]},
|
||||
"notes": {"type": "array", "items": {"type": "string"}}
|
||||
"level": {
|
||||
"enum": [
|
||||
"low",
|
||||
"medium",
|
||||
"high"
|
||||
]
|
||||
},
|
||||
"notes": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"variance_attribution": {
|
||||
"type": "object",
|
||||
"additionalProperties": {"enum": ["demand", "provider_price", "allocation", "labor", "model", "data_quality"]}
|
||||
"additionalProperties": {
|
||||
"enum": [
|
||||
"demand",
|
||||
"provider_price",
|
||||
"allocation",
|
||||
"labor",
|
||||
"model",
|
||||
"data_quality"
|
||||
]
|
||||
}
|
||||
},
|
||||
"evidence": {"type": "array", "minItems": 1, "items": {"type": "string"}}
|
||||
"evidence": {
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"$defs": {
|
||||
"measurement": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["value", "unit"],
|
||||
"required": [
|
||||
"value",
|
||||
"unit"
|
||||
],
|
||||
"properties": {
|
||||
"value": {"type": "number", "minimum": 0},
|
||||
"unit": {"type": "string", "minLength": 1}
|
||||
"value": {
|
||||
"type": [
|
||||
"number",
|
||||
"null"
|
||||
],
|
||||
"minimum": 0,
|
||||
"description": "Null means the quantity is unknown or unbounded, never zero. A declared service constraint with a null value records that no objective exists yet."
|
||||
},
|
||||
"unit": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue