Skip to content

Commit

Permalink
Update 08_concepts.adoc
Browse files Browse the repository at this point in the history
  • Loading branch information
AlbertoFAz authored Feb 19, 2024
1 parent f72958e commit bc7957b
Showing 1 changed file with 6 additions and 52 deletions.
58 changes: 6 additions & 52 deletions docs/src/08_concepts.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,65 +6,19 @@ ifndef::imagesdir[:imagesdir: ../images]

[role="arc42help"]
****
.Content
This section describes overall, principal regulations and solution ideas that are relevant in multiple parts (= cross-cutting) of your system.
Such concepts are often related to multiple building blocks.
They can include many different topics, such as
* models, especially domain models
* architecture or design patterns
* rules for using specific technology
* principal, often technical decisions of an overarching (= cross-cutting) nature
* implementation rules
.Motivation
Concepts form the basis for _conceptual integrity_ (consistency, homogeneity) of the architecture.
Thus, they are an important contribution to achieve inner qualities of your system.
Some of these concepts cannot be assigned to individual building blocks, e.g. security or safety.
.Form
The form can be varied:
* concept papers with any kind of structure
* cross-cutting model excerpts or scenarios using notations of the architecture views
* sample implementations, especially for technical concepts
* reference to typical usage of standard frameworks (e.g. using Hibernate for object/relational mapping)
.Structure
A potential (but not mandatory) structure for this section could be:
* Domain concepts
* User Experience concepts (UX)
* Safety and security concepts
* Architecture and design patterns
* "Under-the-hood"
* development concepts
* operational concepts
Note: it might be difficult to assign individual concepts to one specific topic
on this list.
image::08-Crosscutting-Concepts-Structure-EN.png["Possible topics for crosscutting concepts"]
.Further Information
See https://docs.arc42.org/section-8/[Concepts] in the arc42 documentation.
****

=== _Domain Model_

=== _<Concept 1>_

_<explanation>_
_TBD_

=== _Security_

_The communication between the application's APIs will be through the secure mode of HTTP._

=== _<Concept 2>_
=== _Privacy_

_<explanation>_
_The user's data will be stored in a MongoDb database. That implies that the information is stored securely._

...

Expand Down

0 comments on commit bc7957b

Please sign in to comment.