Skip to content

Commit 7ab157f

Browse files
committed
Update Quarto build script
1 parent 7b58b2a commit 7ab157f

16 files changed

Lines changed: 196 additions & 203 deletions

.github/workflows/build-blueprint.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ jobs:
2626

2727
- name: Build static files
2828
id: build
29-
run: cd blueprint && ./build.sh --github-action
29+
run: cd blueprint && ./build-quarto.sh --github-action
3030

3131
- name: Upload static files
3232
id: deployment

blueprint/01-executive-summary.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
1+
---
2+
title: WE BUILD — Architecture & Integration Blueprint (D4.1)
3+
---
4+
15
# Executive Summary and Project Context
26
## Background
37
[WE BUILD](https://webuildconsortium.eu/) is a [Large Scale Pilot (LSP)](https://ec.europa.eu/digital-building-blocks/sites/spaces/EUDIGITALIDENTITYWALLET/pages/694487808/What+are+the+Large+Scale+Pilot+Projects) funded by the European Commission. The project tests how the European Digital Identity (EUDI) Wallet and the European Business Wallet (EBW) can support cross-border business processes across the EU.

blueprint/_quarto.yml

Lines changed: 42 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,60 @@
11
project:
22
title: "WE BUILD — Architecture & Integration Blueprint (D4.1)"
3-
type: manuscript
3+
type: website
4+
output-dir: _site
45

5-
manuscript:
6-
article: blueprint.qmd
6+
highlight-style: a11y
7+
8+
website:
9+
site-url: https://webuild-consortium.github.io/wp4-architecture/blueprint/blueprint.html
10+
repo-url: https://github.com/webuild-consortium/wp4-architecture
11+
page-navigation: true
12+
bread-crumbs: true
13+
llms-txt: true
14+
search:
15+
show-item-context: true
16+
type: overlay
17+
page-footer:
18+
left: |
19+
![EU](eu.png){width=200px} ![WE BUILD](/we_build.png){width=200px}
20+
navbar:
21+
background: light
22+
collapse-below: lg
23+
left:
24+
- text: "Architecture & Integration Blueprint"
25+
href: blueprint.qmd
26+
- text: "Architecture Decision Records"
27+
href: appendix-adr.qmd
28+
- text: "Conformance Specifications"
29+
href: appendix-cs.qmd
30+
- text: "Business Wallet Definition"
31+
href: appendix-ebw-definition.qmd
32+
- text: "Trust Infrastructure"
33+
href: appendix-trust-ecosystem.qmd
34+
- text: "QTSP Documentation"
35+
href: appendix-qtsp.qmd
736

837
toc: true
938

1039
format:
1140
html:
12-
page-layout: full
41+
number-depth: 4
1342
number-sections: true
14-
notebook-links: false
15-
theme: cerulean
16-
self-contained: true
17-
collapse-level: 4
18-
toc-location: left
43+
toc: true
1944
toc-depth: 4
2045
toc-expand: 4
21-
toc-collapse: false
22-
search: false
46+
include-in-header:
47+
- text: |
48+
<img src="eu.png" width="200px"> <img src="we_build.png" width="200px">
49+
theme:
50+
- cosmo
51+
- brand
2352
mermaid:
2453
theme: default
2554
# docx:
26-
# reference-doc: p20_template_we_build_deliverabl.docx
55+
# reference-doc: template.docx
2756

2857
filters:
2958
- shift_headings.lua
3059

60+
# freeze: true

blueprint/appendix-adr.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
1-
# Appendix G. Architecture decision records
1+
---
2+
title: Architecture decision records
3+
---
24

35
[WE BUILD](https://www.webuildconsortium.eu/) maintains a lightweight architecture decision record (ADR) for each software-related decision affecting interoperability.
46

57
Propose new ADRs using the [template](_template.md). Announce them to the [Architecture group](https://portal.webuildconsortium.eu/group/architecture) in the Portal to get feedback to understand the consortium’s opinion.
68

7-
## ADR process for WE BUILD
9+
# ADR process for WE BUILD
810

911
```mermaid
1012
stateDiagram-v2
@@ -23,5 +25,5 @@ stateDiagram-v2
2325
rejected --> [*]
2426
```
2527

26-
## ADR overview
28+
# ADR overview
2729

blueprint/appendix-cs.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,36 @@
1-
# Appendix H. Conformance Specifications (CS)
1+
---
2+
title: Conformance Specifications (CS)
3+
---
24

3-
## About
5+
# About
46

57
The Conformance Specifications define how WE BUILD participants implement wallet interfaces and communication protocols between issuers, wallets, and relying parties (RPs).
68
They ensure interoperability and conformance by translating ADR decisions into precise implementation requirements.
79

810
The ITB will be based on the CS as a starting point. The test suites in the ITB are relying predominantly on the CS.
911

10-
## Contributing
12+
# Contributing
1113

1214
The Architecture group define the CS, with help from all implementing participants (wallets, issuers and verifiers). For members of the consortium, find more information on the CS processes are held on [open social - Architecture Group](https://portal.webuildconsortium.eu/group/architecture).
1315

14-
## CS Process Summary for WE BUILD Large Scale Pilots (LSPs)
16+
# CS Process Summary for WE BUILD Large Scale Pilots (LSPs)
1517

1618
Conformance Specifications (CS) progress through the following process towards the Large Scale Pilots (LSPs):
1719

1820
![CS Process and Roles](https://github.com/webuild-consortium/wp4-architecture/blob/main/images/WPRoles.png)
1921

20-
### Approved CSs
22+
## Approved CSs
2123

2224
| **CS #** | **CS Title** |
2325
| -------- | ------------------------------------|
2426
| CS-001 | Credential Issuance - v1.0 |
2527
| CS-002 | Credential Presentation - v1.0 |
2628
| | |
2729

28-
### CSs Under Development
30+
## CSs Under Development
2931

3032
| **CS #** | **CS Title** |
3133
| -------- | ------------ |
3234
| | |
3335

34-
## Conformance Specifications
36+
# Conformance Specifications

blueprint/appendix-ebw-definition.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,18 @@
1-
# Appendix D. Business Wallet Definition
1+
---
2+
title: Business Wallet Definition
3+
---
24

35
Revision 1.0
46

5-
## Scope and context
7+
# Scope and context
68

79
This document sets out a non-technical working definition of “business wallet” as introduced in the European Business Wallet regulatory proposal, to support a common interpretation within WE BUILD and in dialogue with the European Commission. It is intended as reference material for the WE BUILD use case and capability work. It does not cover detailed architecture, protocol choices, implementation design, or use case roadmaps.
810

911
This document draws on the EUDI Wallet regulations, EWC deliverables<sup><sup>[\[1\]](#footnote-0)</sup></sup>, and relevant industry and consortium publications, and incorporates the draft Implementing Act on Business Wallet.
1012

11-
## Core concepts
13+
# Core concepts
1214

13-
### Description
15+
## Description
1416

1517
A **Business Wallet** is a product and service that enables an organisation to identify itself, manage authorisations, exchange verified attributes and documents, and receive legally relevant notifications in support of administrative and regulatory procedures. Unlike European Digital Identity Wallets, an European Business Wallet does not need to be an eID means under an eID scheme, although it may reuse similar components.
1618

@@ -24,7 +26,7 @@ The wallet owner is defined by **European Business Wallet Owner Identification D
2426

2527
A Business Wallet can have multiple **wallet users**, meaning natural or legal persons that operate the wallet through a user interface or an application programming interface under roles and mandates set by the wallet owner. These wallet users may apply software applications to access these interfaces. Some users may be **authorised representatives**, while others may be employees or service providers operating within delegated permissions.
2628

27-
### Conceptual model
29+
## Conceptual model
2830
```mermaid
2931
graph LR
3032
A(Other Business Wallets) --> B(Business Wallets)
@@ -40,9 +42,9 @@ graph LR
4042
class B businessWallet
4143
```
4244

43-
## Business Wallet definition
45+
# Business Wallet definition
4446

45-
### Roles supported
47+
## Roles supported
4648

4749
A business wallet enables its owner, amongst other operations, to act as:
4850

@@ -62,15 +64,15 @@ Other relevant roles are:
6264
- Wallet provider: the entity that provides the business wallet solution to its owner (potentially the owner themselves)
6365
- Owner identification data provider: the entity that verifies the identity of an authorised representative enrolling the wallet owner and attests, using an electronic attestation of attributes, the wallet owner's identification data in accordance with authentic source registrations
6466

65-
### Key functions
67+
## Key functions
6668

67-
#### Wallet lifecycle management
69+
### Wallet lifecycle management
6870

6971
The business wallet enrols its owner via the electronic identification of an authorised representative and facilitates enrolment in connected trust services and directory services. The wallet provider is responsible for attesting to its validity to relying parties and enabling authorised representatives to revoke the business wallet and perform other lifecycle changes. In several cases, the wallet provider is also responsible for notifying authorised representatives and government authorities about lifecycle changes.
7072

7173
**_WE BUILD implementation note:_** _This will be the responsibility of the WP4 Wallet Providers group. At least several providers will be ready to manage their wallet solution and issue wallet units under new and changing business wallet requirements._
7274

73-
#### Digital document management
75+
### Digital document management
7476

7577
The business wallet enables the wallet owner to create, store, use and validate various types of digital documents:
7678

@@ -84,18 +86,18 @@ For this purpose, the business wallet implements several applications, including
8486

8587
**_WE BUILD implementation note:_** _The WP4 Wallet Providers provide, as part of their business wallet solutions, a subset of the functionalities required by the use cases. For the functionalities that require qualified trust services, such as the issuance of qualified certificates or the sealing of documents with qualified electronic seals, the WP4 QTSP group provides these services within WE BUILD. For reference, see the [QTSP documentation](#appendix-f-qtsp-documentation)._
8688

87-
#### Secure communication channel
89+
### Secure communication channel
8890

8991
To enable public and private sector information exchange, such as in B2G eGovernment notifications, B2B/B2G eProcurement business documents and other business use cases, a business wallet implements a secure communication channel with other business wallets, with users of digital identity wallets, or with alternative solutions provided through a gateway. This channel enables cross-border delivery and receipt of submissions and notifications with legal effect, and provides a trusted channel with public authorities and other regulated parties across the EU. The channel is implemented using a qualified electronic registered delivery service (QERDS). The digital address for the channel is registered in a standard digital directory.
9092

9193
**_WE BUILD implementation note:_** _the WP4 QTSP group will explore delivering an interoperable pre-production QERDS, along with CIR (EU) 2025/1944 requirements, as a service to the WP4 Wallet Providers group, working with the WP4 Architecture group on cross-cutting concerns, such as interoperability specifications. This enables wallet providers to provide a business wallet to the use cases with a digital address and access to the designated QERDS. For reference, see the [QERDS documentation](#qerds-documentation)._
9294

93-
#### Access control mechanism
95+
### Access control mechanism
9496

9597
To enable wallet owners, authorised representatives and other authorised users to access the business wallet while preventing unauthorised access, each business wallet implements role-based access control for the assets it protects, including digital documents and the secure communication channel. To identify, authenticate, and authorise wallet users, the access control mechanism relies on electronic identification means, such as digital identity wallets, and, potentially, on trust services for the electronic attestation of attributes.
9698

9799
**_WE BUILD implementation note:_** _The WP4 Architecture group, in collaboration with the WP4 Wallet Providers group, will explore the access-control mechanism for business-wallet solutions. This may rely on the EUDI wallets within WE BUILD or on other electronic identification means._
98100

99-
#### Digital transaction management
101+
### Digital transaction management
100102

101103
Business wallets keep logs and provide dashboard user interfaces to enable control over transactions, including operations on the wallet lifecycle and on digital documents and messages sent and received over the secure communication channel. In addition, these logs enable dispute resolution regarding potentially unauthorised transactions, failures to meet reporting obligations, or administrative or procedural activities.

blueprint/appendix-qtsp.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: QTSP documentation
3+
---
4+
5+
The WP4 QTSP group collaborates on [internal reference code and documentation](https://github.com/webuild-consortium/wp4-qtsp-group) to increase interoperability. This appendix lists the entry points for this reference documentation by each provided service.
6+

blueprint/appendix-qtsp.qmd

Lines changed: 0 additions & 110 deletions
This file was deleted.

0 commit comments

Comments
 (0)