Review

Select any passage to ask a question about it or to propose replacement wording.

Review

Part of Nidus Ontology V3 · Relationship Map

Definition

A Review is a recorded evaluation of one or more objects, judging correctness, completeness, performance, compliance, or outcome validity. It is the district's oversight of its own record, and it is the act through which a recorded value is corrected.

Ontological Position

An informational object, added alongside what it evaluates. A Feature, an Assignment, a Signal, or an Inspection can be reviewed, and the Review records what the examiner found.

A Review either changes what a record states or adds to it. Where it corrects, it carries the previous value, the new value, and the justification for the change, and that is the official way a recorded value changes. Where it annotates, it states a finding and leaves the record's values as they are.

A Review raises work through a Work Order. The finding that calls for investigation or repair produces a Work Order, and the Assignment that executes it reaches the Review through that Work Order.

  • A Review is made by exactly one Technician (Technician ||──o{ Review).
  • A Review evaluates one or more objects, enumerated in the Review (every reviewed concept carries its own Review relation).
  • A Review may raise one or more Work Orders (Review }o──o{ Work Order).
  • A Review may be evaluated by a later Review (Review }o──o{ Review).

Properties

Who and when

  • Reviewer — the Technician who performed the evaluation.
  • Time — when the evaluation was made.

Scope

  • Referenced objects — every object the Review concerns, each attached and named.

Finding

  • Type — the kind of evaluation, taken from Review Type. The set is incomplete and grows as review practice is examined.
  • Corrections — each change the Review makes, carrying the previous value, the new value, and the justification for the change.
  • Findings — what the evaluation established, stated as the conclusion it reached.
  • Severity — how serious the finding is, where it carries a seriousness. Values: Low, Moderate, High.
  • Recommended action — what the Reviewer proposes, where the finding calls for action.

Rules

  1. A Review attaches to every object it concerns. Each reviewed concept carries its own Review relation, and nothing falls within a Review that is not attached to it.
  2. A Review corrects a record by stating the previous value, the new value, and the justification. The record then states the new value, and the Review is where the change comes from.
  3. A Review may annotate without changing anything. An annotation states a finding, and the record's values stay as they were.
  4. A Review raises Work Orders. The Assignment that executes the work reaches the Review through its Work Order, by provenance and never by a direct relation.
  5. Findings stand once recorded. Later work, including the work a Review raises, leaves the Review's findings as they were made.
  6. A Review may itself be reviewed. The later Review evaluates the earlier one and both remain.

Relations

Every relation this concept takes part in is drawn on the relationship map.

Relationship diagram: Review
Open this diagram at full size