Skip to content

Commit

Permalink
removed some adr, slight formatting changes
Browse files Browse the repository at this point in the history
  • Loading branch information
u207365 committed Nov 22, 2024
1 parent 38f7752 commit c09c910
Show file tree
Hide file tree
Showing 5 changed files with 53 additions and 85 deletions.
12 changes: 11 additions & 1 deletion docs/content/architecture/01_introduction/02_quality_goals.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,14 @@ draft: true
cascade:
type: docs
---
DRAFT
The following table describes the key quality objectives of DAS.

| Quality Goal | Motivation/description |
|:------------------------------------------------------------------------|:------------------------|
| Railway operations depend on it (Reliability) | |
| Provided information is correct (Functional Suitability) | |
| Reliable and efficient operation (Operability) | |
| Changes need to be implemented efficiently and safely (Maintainability) | |
| Support, not distract the engine driver (Usability) | |

The [Quality Requirements in section 10](../../10_quality_requirements/) detail these goals and serve to evaluate their achievement.
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,43 @@ draft: true
cascade:
type: docs
---
DRAFT
The following list contrasts the [quality goals](../../01_introduction/02_quality_goals/) of DAS with matching architecture approaches and thus provides easy access to the solution.

**Railway operations depend on it (Reliability)**
* decoupling
* caching the data
* reduce number of involved systems

**Provided information is correct (Functional Suitability)**
* comprehensive testing
* read-only View-Model / immutable objects
* using Mappers

**Reliable and efficient operation (Operability)**
* logging and monitoring
* crash recorder on mobile
* no unnecessary dependencies

**Changes need to be implemented efficiently and safely (Maintainability)**
* no unnecessary dependencies, quality check
* cohesive and well-structured internal data model
* APIM ->
* modularization
* Interfaces for core abstractions ->
* using standards
* lint enforced
* check architecture with tools (ArchUnit)

**Support, not distract the engine driver (Usability)**
* intense collaboration between UX- and dev-team

Further goals which are important for DAS:

**Auditability**
* logging
* open source
* comprehensive documentation

**Safety**
* follow (SBB internal) processes to assess risks
* comprehensive testing
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@ DAS is operated for various RUs and must therefore have an exchangeable or broad

## Influences on the Decision
* Azure is the standard technology for IAM at SBB.
*In order to authenticate other companies/EVUs, a federation of Azure ADs must be created.
* In order to authenticate other companies/EVUs, a federation of Azure ADs must be created.
* With Multitenant, the partner RUs must manage the identities and can therefore be delegated.
*With Crosstenant, all identities would have to be managed by SBB. However, SBB does not know the identities and cannot know which identities should have which access.
* With Crosstenant, all identities would have to be managed by SBB. However, SBB does not know the identities and cannot know which identities should have which access.
* If there is no identity federation, each RU would have to operate a DAS itself, which is not currently planned.
* Exchange with the Beacon Management project has taken place. Azure Multitenant is already used there with many TUs and there is multi-client capability and delegated role management.

Expand All @@ -32,7 +32,6 @@ DAS is operated for various RUs and must therefore have an exchangeable or broad


## Considered Alternatives
* Multitenant
* Crosstenant

## Decisions
Expand Down
27 changes: 0 additions & 27 deletions docs/content/architecture/09_design_decisions/cenelec_adr.md

This file was deleted.

53 changes: 0 additions & 53 deletions docs/content/architecture/09_design_decisions/open_source_adr.md

This file was deleted.

0 comments on commit c09c910

Please sign in to comment.