C4 Model in AsciiDoctor

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
@startuml
!include <C4/C4_Container>
title System Context diagram for Internet Banking System

Person(customer, "Personal Banking Customer", "A customer of the bank, with personal bank accounts.")
System(banking_system, "Internet Banking System", "Allows customers to view information about their bank accounts, and make payments.")

System_Ext(mail_system, "E-mail system", "The internal Microsoft Exchange e-mail system.")
System_Ext(mainframe, "Mainframe Banking System", "Stores all of the core banking information about customers, accounts, transactions, etc.")

Rel(customer, banking_system, "Uses")
Rel_Back(customer, mail_system, "Sends e-mails to")

Rel_Neighbor(banking_system, mail_system, "Sends e-mails using", "SMTP")
Rel(banking_system, mainframe, "Gets account information from, and makes payments using")
@enduml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
name: Build and deploy

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    container:
      image: asciidoctor/docker-asciidoctor:1.54
      volumes:
        # /documents/ is the default working directory of the docker-asciidoctor container
        - ${{ github.workspace }}:/documents/

    env:
      BUILD_PATH: target
      DEPLOY_PATH: _site

    steps:
      - name: Checkout 🛎️
        uses: actions/checkout@v4

      - name: Generate html 📝
        run: >
          asciidoctor 
          --require asciidoctor-diagram
          --destination-dir ${{ env.BUILD_PATH }}
          docs/index.adoc 

      - name: Generate pdf 📝
        run: >
          asciidoctor-pdf
          --require asciidoctor-diagram
          --destination-dir ${{ env.BUILD_PATH }}
          docs/index.adoc

      - name: Copy artifacts 📂
        run: |
          apk add rsync tar
          rsync -av --exclude=".*" ${{ env.BUILD_PATH }}/ ${{ env.DEPLOY_PATH }}

      - name: Package and upload 📦
        uses: actions/upload-pages-artifact@v3

  deploy:
    needs: build
    runs-on: ubuntu-latest

    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
    permissions:
      pages: write      # to deploy to Pages
      id-token: write   # to verify the deployment originates from an appropriate source

    # Deploy to the github-pages environment
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}

    steps:
      - name: Deploy to GitHub Pages 🚀
        id: deployment
        uses: actions/deploy-pages@v4