Skip to content

Commit 7ce7ccb

Browse files
committed
added verisioning and AQL definitions
1 parent a84458d commit 7ce7ccb

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

document/core/intro/overview.rst

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -30,21 +30,22 @@ An application is a distinct software component or module that resides within a
3030
**Framework**
3131
A framework is an architectural structure that establishes how an application is represented, organized, and managed within the system. It provides a set of conventions, principles, and practices to ensure consistency and clarity in architectural design. A framework can follow standard models such as TOGAF, C4, or Zachman, offering predefined methodologies to address various organizational or technical needs. Alternatively, it may be a custom framework tailored to meet specific requirements or workflows within the system, ensuring flexibility and adaptability for unique use cases.
3232

33-
.. _element:
33+
.. _archiment:
3434

35-
**Element**
36-
An element is the fundamental building block of an architectural structure, representing the smallest unit that cannot be further decomposed while retaining its functionality or purpose. Each element encapsulates a specific aspect of the architecture, such as a component, module, or service, and plays a distinct role within the overall system. Elements are designed to be self-contained and well-defined, enabling precise understanding, efficient communication, and easier management within the architectural framework. Their composition and interactions with other elements form the foundation of the system's design, behavior, and scalability.
35+
**Archiment**
36+
An architeture element or `archiment` is the fundamental building block of an architectural structure, representing the smallest unit that cannot be further decomposed while retaining its functionality or purpose. Each element encapsulates a specific aspect of the architecture, such as a component, module, or service, and plays a distinct role within the overall system. Elements are designed to be self-contained and well-defined, enabling precise understanding, efficient communication, and easier management within the architectural framework. Their composition and interactions with other elements form the foundation of the system's design, behavior, and scalability.
3737

3838
.. _extension:
3939

4040
**Extensions**
4141
Extensions are modular add-ons to the system designed to enhance its functionality and adaptability. They achieve this by either extending the capabilities of existing models or introducing entirely new models to the architecture. Extensions allow for system customization without altering the core framework, enabling seamless integration of additional features or workflows. They are often developed to address specific requirements, provide scalability, or support future enhancements, ensuring that the system remains flexible and capable of evolving alongside organizational needs. Additionally, extensions can interact with the core components and other extensions through well-defined interfaces, maintaining consistency and reliability within the overall system.
4242

43-
.. _adr:
43+
.. _versioning:
4444

45-
**Architecture Decision Records**
45+
**Versioning**
46+
The architecture model is stored as a versioned database, which maintains a complete history of changes to the model over time. This version control mechanism enables the retrieval of any previous version of the architecture, ensuring that historical configurations can be accessed and analyzed when needed. The versioned database supports traceability and auditability, allowing architects and developers to track changes, revert to earlier versions, and maintain consistency across different stages of the architecture’s evolution. By managing versions efficiently, the system ensures flexibility, accountability, and continuity in architectural decision-making.
4647

47-
.. _fitness:
48+
.. _aql:
4849

49-
**Fitness Functions**
50-
Fitness Functions are measurable, objective criteria used to evaluate and validate the quality and alignment of a software system's architecture with its desired outcomes.
50+
**Architecture Query Language**
51+
The Architecture Query Language (AQL) is a domain-specific language (DSL) designed for querying and manipulating the architecture model. It supports creation, updating, deletion, and retrieval of architectural data, providing a structured approach to model management. AQL is inspired by SQL, offering a familiar syntax that minimizes the learning curve for developers and ensures seamless adoption within existing workflows.

0 commit comments

Comments
 (0)