Ship the three C4 examples and model:scaffold --example
- examples/: c4-standard-web-app, c4-e-shop (was online-shop), c4-event-based-integration; the same models the extension offers under Archify | New Model… - model-scaffold --example <name> copies one and renames id, name, description and the overview title; never overwrites - tests cover every example and the copy; docs updated
This commit is contained in:
root-at-skic committed
1 parent
b6b5e57922
commit
55894fbade
27 files changed
+538
-17
No files matched your search
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -1,13 +1,13 @@
|
||||
schema_version: 1
|
||||
model:
|
||||
id: online-shop
|
||||
name: Online Shop
|
||||
id: e-shop
|
||||
name: E-Shop
|
||||
description: >
|
||||
The web shop, its API and workers, and the stores behind them.
|
||||
Context, containers and components, C4 style.
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: Online Shop — overview
|
||||
title: E-Shop — overview
|
||||
output: main.html
|
||||
components:
|
||||
- ref: customer
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -0,0 +1,26 @@
|
||||
schema_version: 1
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: System context
|
||||
output: context.html
|
||||
components:
|
||||
- ref: crm
|
||||
pos: [40, 60]
|
||||
size: [130, 60]
|
||||
- ref: erp
|
||||
pos: [40, 260]
|
||||
size: [130, 60]
|
||||
- ref: platform
|
||||
pos: [280, 160]
|
||||
size: [170, 60]
|
||||
- ref: warehouse
|
||||
pos: [540, 60]
|
||||
size: [150, 60]
|
||||
- ref: ops
|
||||
pos: [540, 260]
|
||||
size: [150, 60]
|
||||
connections:
|
||||
- { from: crm, to: platform, label: customer events, variant: emphasis }
|
||||
- { from: erp, to: platform, label: order events, variant: emphasis }
|
||||
- { from: platform, to: warehouse, label: pick lists }
|
||||
- { from: ops, to: platform, label: replays, variant: dashed }
|
||||
@@ -0,0 +1,46 @@
|
||||
schema_version: 1
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: Containers
|
||||
output: containers.html
|
||||
components:
|
||||
- ref: crm
|
||||
pos: [40, 60]
|
||||
size: [130, 60]
|
||||
- ref: erp
|
||||
pos: [40, 260]
|
||||
size: [130, 60]
|
||||
- ref: ingest
|
||||
pos: [250, 160]
|
||||
size: [140, 60]
|
||||
- ref: bus
|
||||
pos: [470, 160]
|
||||
size: [140, 60]
|
||||
- ref: router
|
||||
pos: [690, 160]
|
||||
size: [150, 60]
|
||||
- ref: dlq
|
||||
pos: [690, 320]
|
||||
size: [150, 60]
|
||||
- ref: store
|
||||
pos: [920, 60]
|
||||
size: [140, 60]
|
||||
- ref: notifier
|
||||
pos: [920, 160]
|
||||
size: [140, 60]
|
||||
- ref: analytics
|
||||
pos: [920, 260]
|
||||
size: [140, 60]
|
||||
boundaries:
|
||||
- kind: region
|
||||
label: Integration platform
|
||||
wraps: [ingest, bus, router, dlq, store, notifier, analytics]
|
||||
connections:
|
||||
- { from: crm, to: ingest, label: HTTPS, variant: emphasis }
|
||||
- { from: erp, to: ingest, label: HTTPS, variant: emphasis }
|
||||
- { from: ingest, to: bus, label: publish }
|
||||
- { from: bus, to: router, label: consume }
|
||||
- { from: router, to: store, label: append }
|
||||
- { from: router, to: notifier, label: notify }
|
||||
- { from: router, to: analytics, label: flatten }
|
||||
- { from: router, to: dlq, label: failed, variant: dashed, labelDy: 24 }
|
||||
@@ -0,0 +1,46 @@
|
||||
schema_version: 1
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: Event router components
|
||||
output: router.html
|
||||
components:
|
||||
- ref: bus
|
||||
pos: [40, 160]
|
||||
size: [140, 60]
|
||||
- id: validate
|
||||
type: security
|
||||
label: Validate
|
||||
sublabel: schema check
|
||||
pos: [270, 160]
|
||||
size: [130, 60]
|
||||
- id: enrich
|
||||
type: backend
|
||||
label: Enrich
|
||||
sublabel: reference data
|
||||
pos: [480, 160]
|
||||
size: [130, 60]
|
||||
- id: dispatch
|
||||
type: backend
|
||||
label: Dispatch
|
||||
pos: [690, 160]
|
||||
size: [130, 60]
|
||||
- ref: store
|
||||
pos: [920, 60]
|
||||
size: [140, 60]
|
||||
- ref: notifier
|
||||
pos: [920, 160]
|
||||
size: [140, 60]
|
||||
- ref: dlq
|
||||
pos: [270, 320]
|
||||
size: [150, 60]
|
||||
boundaries:
|
||||
- kind: region
|
||||
label: Event router
|
||||
wraps: [validate, enrich, dispatch]
|
||||
connections:
|
||||
- { from: bus, to: validate, label: event }
|
||||
- { from: validate, to: enrich, label: valid }
|
||||
- { from: enrich, to: dispatch, label: enriched }
|
||||
- { from: dispatch, to: store, label: append }
|
||||
- { from: dispatch, to: notifier, label: notify }
|
||||
- { from: validate, to: dlq, label: invalid, variant: dashed, labelDy: 24 }
|
||||
@@ -0,0 +1,29 @@
|
||||
schema_version: 1
|
||||
model:
|
||||
id: event-based-integration
|
||||
name: Event-Based Integration
|
||||
description: >
|
||||
Systems that never call each other directly; events go through a bus,
|
||||
a router validates and enriches them, consumers react. Context,
|
||||
containers, the router's components and one flow, C4 style.
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: Event-Based Integration — overview
|
||||
output: main.html
|
||||
components:
|
||||
- ref: crm
|
||||
pos: [40, 60]
|
||||
size: [130, 60]
|
||||
- ref: erp
|
||||
pos: [40, 260]
|
||||
size: [130, 60]
|
||||
- ref: platform
|
||||
pos: [280, 160]
|
||||
size: [170, 60]
|
||||
- ref: warehouse
|
||||
pos: [540, 160]
|
||||
size: [150, 60]
|
||||
connections:
|
||||
- { from: crm, to: platform, label: customer events, variant: emphasis }
|
||||
- { from: erp, to: platform, label: order events, variant: emphasis }
|
||||
- { from: platform, to: warehouse, label: pick lists }
|
||||
@@ -0,0 +1,40 @@
|
||||
schema_version: 1
|
||||
elements:
|
||||
ingest:
|
||||
type: backend
|
||||
label: Ingest API
|
||||
sublabel: HTTPS in, events out
|
||||
description: Accepts events from systems that cannot publish to the bus themselves.
|
||||
bus:
|
||||
type: messagebus
|
||||
label: Event bus
|
||||
sublabel: Kafka
|
||||
brand: apache-kafka
|
||||
description: One topic per event type; retained for seven days.
|
||||
router:
|
||||
type: backend
|
||||
label: Event router
|
||||
sublabel: validate, enrich, dispatch
|
||||
description: Checks each event against its schema, adds reference data, hands it to the consumers.
|
||||
diagram: 0300-components/router.archify
|
||||
dlq:
|
||||
type: messagebus
|
||||
label: Dead-letter queue
|
||||
sublabel: failed events
|
||||
description: Events the router could not process; replayed by operations.
|
||||
store:
|
||||
type: database
|
||||
label: Event store
|
||||
sublabel: PostgreSQL
|
||||
brand: postgresql
|
||||
description: Every accepted event, for audit and replay.
|
||||
notifier:
|
||||
type: backend
|
||||
label: Notifier
|
||||
sublabel: email, chat
|
||||
description: Turns selected events into messages to people.
|
||||
analytics:
|
||||
type: database
|
||||
label: Analytics
|
||||
sublabel: warehouse tables
|
||||
description: Flattened events for reporting.
|
||||
@@ -0,0 +1,7 @@
|
||||
schema_version: 1
|
||||
elements:
|
||||
ops:
|
||||
type: external
|
||||
label: Operations
|
||||
sublabel: on-call
|
||||
description: Watches the dead-letter queue and replays failed events.
|
||||
@@ -0,0 +1,23 @@
|
||||
schema_version: 1
|
||||
elements:
|
||||
platform:
|
||||
type: cloud
|
||||
label: Integration platform
|
||||
sublabel: the system
|
||||
description: Receives events from the business systems, routes them, keeps a record.
|
||||
diagram: 0200-containers/platform.archify
|
||||
crm:
|
||||
type: external
|
||||
label: CRM
|
||||
sublabel: customers
|
||||
description: Source of customer events; created, updated, merged.
|
||||
erp:
|
||||
type: external
|
||||
label: ERP
|
||||
sublabel: orders and stock
|
||||
description: Source of order events and the target of stock updates.
|
||||
warehouse:
|
||||
type: external
|
||||
label: Warehouse system
|
||||
sublabel: fulfilment
|
||||
description: Receives pick lists; reports shipments back as events.
|
||||
@@ -0,0 +1,26 @@
|
||||
schema_version: 1
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: System context
|
||||
output: context.html
|
||||
components:
|
||||
- ref: user
|
||||
pos: [40, 60]
|
||||
size: [130, 60]
|
||||
- ref: admin
|
||||
pos: [40, 260]
|
||||
size: [130, 60]
|
||||
- ref: webapp
|
||||
pos: [280, 160]
|
||||
size: [160, 60]
|
||||
- ref: idp
|
||||
pos: [530, 60]
|
||||
size: [150, 60]
|
||||
- ref: email
|
||||
pos: [530, 260]
|
||||
size: [150, 60]
|
||||
connections:
|
||||
- { from: user, to: webapp, label: uses, variant: emphasis }
|
||||
- { from: admin, to: webapp, label: administers }
|
||||
- { from: webapp, to: idp, label: signs in via, variant: security }
|
||||
- { from: webapp, to: email, label: sends mail }
|
||||
@@ -0,0 +1,38 @@
|
||||
schema_version: 1
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: Containers
|
||||
output: containers.html
|
||||
components:
|
||||
- ref: user
|
||||
pos: [40, 160]
|
||||
size: [130, 60]
|
||||
- ref: spa
|
||||
pos: [250, 160]
|
||||
size: [150, 60]
|
||||
- ref: api
|
||||
pos: [480, 160]
|
||||
size: [130, 60]
|
||||
- ref: idp
|
||||
pos: [480, 20]
|
||||
size: [130, 60]
|
||||
- ref: cache
|
||||
pos: [690, 60]
|
||||
size: [130, 60]
|
||||
- ref: db
|
||||
pos: [690, 160]
|
||||
size: [130, 60]
|
||||
- ref: storage
|
||||
pos: [690, 260]
|
||||
size: [130, 60]
|
||||
boundaries:
|
||||
- kind: region
|
||||
label: Web Application
|
||||
wraps: [spa, api, cache, db, storage]
|
||||
connections:
|
||||
- { from: user, to: spa, label: HTTPS, variant: emphasis }
|
||||
- { from: spa, to: api, label: JSON }
|
||||
- { from: api, to: idp, label: verify token, variant: security, labelAt: [531, 110] }
|
||||
- { from: api, to: cache, label: read }
|
||||
- { from: api, to: db, label: SQL }
|
||||
- { from: api, to: storage, label: files }
|
||||
@@ -0,0 +1,42 @@
|
||||
schema_version: 1
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: API components
|
||||
output: api.html
|
||||
components:
|
||||
- ref: spa
|
||||
pos: [40, 160]
|
||||
size: [150, 60]
|
||||
- id: auth
|
||||
type: security
|
||||
label: Auth
|
||||
sublabel: token check
|
||||
pos: [270, 40]
|
||||
size: [130, 60]
|
||||
- id: accounts
|
||||
type: backend
|
||||
label: Accounts
|
||||
pos: [270, 160]
|
||||
size: [130, 60]
|
||||
- id: content
|
||||
type: backend
|
||||
label: Content
|
||||
pos: [270, 280]
|
||||
size: [130, 60]
|
||||
- ref: db
|
||||
pos: [500, 160]
|
||||
size: [130, 60]
|
||||
- ref: storage
|
||||
pos: [500, 280]
|
||||
size: [130, 60]
|
||||
boundaries:
|
||||
- kind: region
|
||||
label: API
|
||||
wraps: [auth, accounts, content]
|
||||
connections:
|
||||
- { from: spa, to: auth, label: token, variant: security }
|
||||
- { from: spa, to: accounts, label: profile }
|
||||
- { from: spa, to: content, label: pages }
|
||||
- { from: accounts, to: db, label: SQL }
|
||||
- { from: content, to: db, label: SQL }
|
||||
- { from: content, to: storage, label: files }
|
||||
@@ -0,0 +1,29 @@
|
||||
schema_version: 1
|
||||
model:
|
||||
id: standard-web-app
|
||||
name: Standard Web App
|
||||
description: >
|
||||
A classic web application; a single-page app, an API, a database,
|
||||
a cache and file storage, with sign-in through an identity provider.
|
||||
Context, containers and the API's components, C4 style.
|
||||
diagram_type: architecture
|
||||
meta:
|
||||
title: Standard Web App — overview
|
||||
output: main.html
|
||||
components:
|
||||
- ref: user
|
||||
pos: [40, 160]
|
||||
size: [130, 60]
|
||||
- ref: webapp
|
||||
pos: [250, 160]
|
||||
size: [160, 60]
|
||||
- ref: idp
|
||||
pos: [490, 60]
|
||||
size: [150, 60]
|
||||
- ref: email
|
||||
pos: [490, 260]
|
||||
size: [150, 60]
|
||||
connections:
|
||||
- { from: user, to: webapp, label: uses, variant: emphasis }
|
||||
- { from: webapp, to: idp, label: signs in via, variant: security }
|
||||
- { from: webapp, to: email, label: sends mail }
|
||||
@@ -0,0 +1,32 @@
|
||||
schema_version: 1
|
||||
elements:
|
||||
spa:
|
||||
type: frontend
|
||||
label: Single-page app
|
||||
sublabel: React
|
||||
brand: react
|
||||
description: The user interface; talks only to the API.
|
||||
api:
|
||||
type: backend
|
||||
label: API
|
||||
sublabel: Node.js
|
||||
brand: node-js
|
||||
description: Owns accounts, content and files; checks tokens from the identity provider.
|
||||
diagram: 0300-components/api.archify
|
||||
db:
|
||||
type: database
|
||||
label: Database
|
||||
sublabel: PostgreSQL
|
||||
brand: postgresql
|
||||
description: Accounts and content; the source of truth.
|
||||
cache:
|
||||
type: database
|
||||
label: Cache
|
||||
sublabel: Redis
|
||||
brand: redis
|
||||
description: Sessions and hot content; safe to lose.
|
||||
storage:
|
||||
type: cloud
|
||||
label: Object storage
|
||||
sublabel: uploaded files
|
||||
description: User uploads and generated exports.
|
||||
@@ -0,0 +1,12 @@
|
||||
schema_version: 1
|
||||
elements:
|
||||
user:
|
||||
type: external
|
||||
label: User
|
||||
sublabel: browser
|
||||
description: Anyone with an account; uses the application from a browser.
|
||||
admin:
|
||||
type: external
|
||||
label: Administrator
|
||||
sublabel: back office
|
||||
description: Manages users and content from the same application with extra rights.
|
||||
@@ -0,0 +1,18 @@
|
||||
schema_version: 1
|
||||
elements:
|
||||
webapp:
|
||||
type: cloud
|
||||
label: Web Application
|
||||
sublabel: the system
|
||||
description: Everything we build and run; the single-page app, the API and its stores.
|
||||
diagram: 0200-containers/web-app.archify
|
||||
idp:
|
||||
type: external
|
||||
label: Identity provider
|
||||
sublabel: OpenID Connect
|
||||
description: Signs users in and issues tokens; we never store passwords.
|
||||
email:
|
||||
type: external
|
||||
label: Email service
|
||||
sublabel: transactional mail
|
||||
description: Sends sign-up confirmations and notifications.
|
||||
Reference in new issue
Block a user