Carolopedia

A public encyclopedia of Carolverse.

๐Ÿ“– Carolopedia โ€บ Guides โ€บ DesignGuide page

Design

๐Ÿ“–What it means

A detailed technical artifact describing how something in the project should be built: architecture, workflow, UI, data model, API, policy mapping. Stored as a row in the design records -> designs table. Every design has title, description, type, department, status (draft/review/approved/retired), version, and content markdown. Designs are the 'how' layer between policies (rules) and code (what exists).

๐Ÿ“–Easily confused with

[{"term": "Requirement", "distinction": "A design is the HOW; a requirement is the WHAT."}, {"term": "Cookbook entry", "distinction": "A design describes a built thing; a cookbook entry prescribes an action to take."}]

๐Ÿ“–Also called

- design record
- architecture doc

๐Ÿ“–Filed under

Category: records.

Service: Governance.

See also: Requirements

See also: Cookbook

Source: Data Dictionary ยท Public information reflected here.