FR-001checkpassingdescribeModels MUST compose the modules, project them and bind them for each dialect it is given, and give one described model for each module, or say why the composition, the projection or the binding failed.
0057-sql-describe · owner if · domain data
FR-001checkpassingdescribeModels MUST compose the modules, project them and bind them for each dialect it is given, and give one described model for each module, or say why the composition, the projection or the binding failed.
FR-002checkpassingA described model MUST have the three layers (governance, logical, physical), each with a title and a summary that says what the layer is, which code writes it and whether it may be edited, and the kinds of element it holds.
FR-003checkpassingA described model MUST have, with a stable id each (unique within the model, of the form layer:...): in governance its module, concepts, attributes, relationships, code lists and codes, each with its definition and what is said of it (identity, datatype, multiplicity, annotations); in logical the tables, columns, foreign keys, uniques and indexes it owns; in physical the SQL of each table for each dialect and the typed table that reads and writes it.
FR-004checkpassingA described model MUST trace each governance concept to its table, each attribute and relationship to its columns, and each table to its SQL for each dialect and to its typed table; every end of a trace MUST be an element of the models; the typed table MUST name a file and an export that exist.
FR-005checkpassingThe same models MUST give the same bytes as JSON, and the source of an element (a file and a line) MUST be what the caller's locate says of it, none where it says none.
FR-006checkpassingWhat has no definition (a module, a concept, an attribute, a relationship, a code list), a concept identified by nothing, a code list with no code, and personal data held for no purpose MUST each be a finding that names the element and says what to do; the models of this library MUST have none.
OQ-1open questionWhether an operation (governance's operation) becomes an element of the governance layer with a trace to its SQL routine, or stays with the library that implements it.
SC-001success criterionAn agent that is given only a described model (as JSON) can say which file to edit to add an attribute, which command regenerates what follows, and what will change in each layer.