---
title: "Architecture walkthrough"
url: https://afflom.github.io/prism-devrel/case-studies/rule30/architecture/
diataxis: explanation
developer-journey: learn
collection: case-studies
collection-group: "Rule 30"
subject: https://github.com/afflom/rule30
commit: e3be477fded263029479127363f7fb6a3597e7d4
---

# Architecture walkthrough

> Who Rule 30 is for, what they care about, its parts and how they connect.

Subject: [Rule 30](https://github.com/afflom/rule30) at commit [`e3be477fded2`](https://github.com/afflom/rule30/tree/e3be477fded263029479127363f7fb6a3597e7d4), 2180 facet records, source digest `c4584388f052fc09`.

**Figure: Architecture records by kind.** The 37 records this page teaches, one bar for each kind. Each kind has its own section below.

| | Count |
| --- | --- |
| Component | 9 |
| Concern | 3 |
| Edge | 18 |
| Stakeholder | 1 |
| View | 3 |
| Viewpoint | 3 |

The architecture facet is an ISO/IEC/IEEE 42010 architecture description. It says who the system is for (stakeholders) and what they worry about (concerns). It names the parts (components) and how data and control move between them (edges). Viewpoints and views answer each concern. Each record is a definition whose result is a `Foundation.Arch` record, numbered by its identifier. The rules are in [PrismPM SPEC section 2](https://github.com/UOR-Foundation/prismpm/blob/15f630aa6deec5d6490ac22e222381fa28d6f17d/SPEC.md#2-facet-packages-and-formal-metamodel). How to write them is in [Write the model](https://uor.foundation/docs/guides/write-the-model).

- Start with the stakeholders and concerns: every viewpoint pairs one of each.
- Components carry a kind: service, database, external system, CLI adapter, static site or release binary.
- An edge's `fromIndex` and `toIndex` are component indexes; the drawing below follows them.

[Architecture facet](https://afflom.github.io/prism-devrel/facets/architecture/) explains the facet for every Prism model, with the counts of every case study.

## Components and edges

Diagram: 9 elements: factory, host, inspection, journal, kernel, library, portfolio, publication, recovery. factory to kernel (controlFlow). factory to library (controlFlow). inspection to host (controlFlow). inspection to kernel (controlFlow). inspection to library (controlFlow). journal to host (controlFlow). journal to library (controlFlow). kernel to host (controlFlow). library to host (controlFlow). portfolio to factory (controlFlow). portfolio to inspection (controlFlow). portfolio to publication (controlFlow). portfolio to recovery (controlFlow). publication to journal (controlFlow). publication to kernel (controlFlow). publication to library (controlFlow). recovery to host (controlFlow). recovery to journal (controlFlow).

## Every record

| Index | Record | Kind | Name |
| --- | --- | --- | --- |
| 541 | `ResearchArchitecture::evidence` | Concern | evidence |
| 542 | `ResearchArchitecture::evidenceView` | View | evidenceView |
| 543 | `ResearchArchitecture::evidenceViewpoint` | Viewpoint | evidenceViewpoint |
| 544 | `ResearchArchitecture::factory` | Component | factory |
| 545 | `ResearchArchitecture::factoryRequiresKernel` | Edge | factoryRequiresKernel |
| 546 | `ResearchArchitecture::factoryRequiresLibrary` | Edge | factoryRequiresLibrary |
| 549 | `ResearchArchitecture::host` | Component | host |
| 551 | `ResearchArchitecture::inspection` | Component | inspection |
| 552 | `ResearchArchitecture::inspectionRequiresHost` | Edge | inspectionRequiresHost |
| 553 | `ResearchArchitecture::inspectionRequiresKernel` | Edge | inspectionRequiresKernel |
| 554 | `ResearchArchitecture::inspectionRequiresLibrary` | Edge | inspectionRequiresLibrary |
| 555 | `ResearchArchitecture::journal` | Component | journal |
| 556 | `ResearchArchitecture::journalRequiresHost` | Edge | journalRequiresHost |
| 557 | `ResearchArchitecture::journalRequiresLibrary` | Edge | journalRequiresLibrary |
| 558 | `ResearchArchitecture::kernel` | Component | kernel |
| 561 | `ResearchArchitecture::kernelRequiresHost` | Edge | kernelRequiresHost |
| 562 | `ResearchArchitecture::library` | Component | library |
| 564 | `ResearchArchitecture::libraryRequiresHost` | Edge | libraryRequiresHost |
| 566 | `ResearchArchitecture::maintainer` | Stakeholder | maintainer |
| 572 | `ResearchArchitecture::ownership` | Concern | ownership |
| 573 | `ResearchArchitecture::ownershipView` | View | ownershipView |
| 574 | `ResearchArchitecture::ownershipViewpoint` | Viewpoint | ownershipViewpoint |
| 575 | `ResearchArchitecture::portfolio` | Component | portfolio |
| 576 | `ResearchArchitecture::portfolioRequiresFactory` | Edge | portfolioRequiresFactory |
| 577 | `ResearchArchitecture::portfolioRequiresInspection` | Edge | portfolioRequiresInspection |
| 578 | `ResearchArchitecture::portfolioRequiresPublication` | Edge | portfolioRequiresPublication |
| 579 | `ResearchArchitecture::portfolioRequiresRecovery` | Edge | portfolioRequiresRecovery |
| 580 | `ResearchArchitecture::publication` | Component | publication |
| 581 | `ResearchArchitecture::publicationRequiresJournal` | Edge | publicationRequiresJournal |
| 582 | `ResearchArchitecture::publicationRequiresKernel` | Edge | publicationRequiresKernel |
| 583 | `ResearchArchitecture::publicationRequiresLibrary` | Edge | publicationRequiresLibrary |
| 586 | `ResearchArchitecture::recovery` | Component | recovery |
| 587 | `ResearchArchitecture::recoveryRequiresHost` | Edge | recoveryRequiresHost |
| 588 | `ResearchArchitecture::recoveryRequiresJournal` | Edge | recoveryRequiresJournal |
| 595 | `ResearchArchitecture::velocity` | Concern | velocity |
| 596 | `ResearchArchitecture::velocityView` | View | velocityView |
| 597 | `ResearchArchitecture::velocityViewpoint` | Viewpoint | velocityViewpoint |

## Component (9)

### `factory`

`ResearchArchitecture::factory` · Component · #544 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `0`
- kind: `(ctor Foundation.Arch::ComponentKind.service)`

Taught by: architecture

### `host`

`ResearchArchitecture::host` · Component · #549 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `1`
- kind: `(ctor Foundation.Arch::ComponentKind.externalSystem)`

Taught by: architecture

### `inspection`

`ResearchArchitecture::inspection` · Component · #551 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `2`
- kind: `(ctor Foundation.Arch::ComponentKind.service)`

Taught by: architecture

### `journal`

`ResearchArchitecture::journal` · Component · #555 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `3`
- kind: `(ctor Foundation.Arch::ComponentKind.database)`

Taught by: architecture

### `kernel`

`ResearchArchitecture::kernel` · Component · #558 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `4`
- kind: `(ctor Foundation.Arch::ComponentKind.service)`

Taught by: architecture

### `library`

`ResearchArchitecture::library` · Component · #562 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `5`
- kind: `(ctor Foundation.Arch::ComponentKind.database)`

Taught by: architecture

### `portfolio`

`ResearchArchitecture::portfolio` · Component · #575 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `6`
- kind: `(ctor Foundation.Arch::ComponentKind.service)`

Taught by: architecture

### `publication`

`ResearchArchitecture::publication` · Component · #580 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `7`
- kind: `(ctor Foundation.Arch::ComponentKind.service)`

Taught by: architecture

### `recovery`

`ResearchArchitecture::recovery` · Component · #586 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `8`
- kind: `(ctor Foundation.Arch::ComponentKind.service)`

Taught by: architecture

## Concern (3)

### `evidence`

`ResearchArchitecture::evidence` · Concern · #541 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `0`

Taught by: case-study, architecture, slides

### `ownership`

`ResearchArchitecture::ownership` · Concern · #572 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `1`

Taught by: case-study, architecture

### `velocity`

`ResearchArchitecture::velocity` · Concern · #595 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `2`

Taught by: case-study, architecture

## Edge (18)

### `factoryRequiresKernel`

`ResearchArchitecture::factoryRequiresKernel` · Edge · #545 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `0`
- fromIndex: `0`
- toIndex: `4`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `factoryRequiresLibrary`

`ResearchArchitecture::factoryRequiresLibrary` · Edge · #546 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `1`
- fromIndex: `0`
- toIndex: `5`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `inspectionRequiresHost`

`ResearchArchitecture::inspectionRequiresHost` · Edge · #552 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `2`
- fromIndex: `2`
- toIndex: `1`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `inspectionRequiresKernel`

`ResearchArchitecture::inspectionRequiresKernel` · Edge · #553 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `3`
- fromIndex: `2`
- toIndex: `4`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `inspectionRequiresLibrary`

`ResearchArchitecture::inspectionRequiresLibrary` · Edge · #554 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `4`
- fromIndex: `2`
- toIndex: `5`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `journalRequiresHost`

`ResearchArchitecture::journalRequiresHost` · Edge · #556 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `5`
- fromIndex: `3`
- toIndex: `1`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `journalRequiresLibrary`

`ResearchArchitecture::journalRequiresLibrary` · Edge · #557 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `6`
- fromIndex: `3`
- toIndex: `5`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `kernelRequiresHost`

`ResearchArchitecture::kernelRequiresHost` · Edge · #561 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `7`
- fromIndex: `4`
- toIndex: `1`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `libraryRequiresHost`

`ResearchArchitecture::libraryRequiresHost` · Edge · #564 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `8`
- fromIndex: `5`
- toIndex: `1`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `portfolioRequiresFactory`

`ResearchArchitecture::portfolioRequiresFactory` · Edge · #576 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `9`
- fromIndex: `6`
- toIndex: `0`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `portfolioRequiresInspection`

`ResearchArchitecture::portfolioRequiresInspection` · Edge · #577 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `10`
- fromIndex: `6`
- toIndex: `2`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `portfolioRequiresPublication`

`ResearchArchitecture::portfolioRequiresPublication` · Edge · #578 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `11`
- fromIndex: `6`
- toIndex: `7`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `portfolioRequiresRecovery`

`ResearchArchitecture::portfolioRequiresRecovery` · Edge · #579 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `12`
- fromIndex: `6`
- toIndex: `8`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `publicationRequiresJournal`

`ResearchArchitecture::publicationRequiresJournal` · Edge · #581 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `13`
- fromIndex: `7`
- toIndex: `3`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `publicationRequiresKernel`

`ResearchArchitecture::publicationRequiresKernel` · Edge · #582 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `14`
- fromIndex: `7`
- toIndex: `4`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `publicationRequiresLibrary`

`ResearchArchitecture::publicationRequiresLibrary` · Edge · #583 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `15`
- fromIndex: `7`
- toIndex: `5`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `recoveryRequiresHost`

`ResearchArchitecture::recoveryRequiresHost` · Edge · #587 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `16`
- fromIndex: `8`
- toIndex: `1`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

### `recoveryRequiresJournal`

`ResearchArchitecture::recoveryRequiresJournal` · Edge · #588 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `17`
- fromIndex: `8`
- toIndex: `3`
- kind: `(ctor Foundation.Arch::EdgeKind.controlFlow)`

Taught by: architecture

## Stakeholder (1)

### `maintainer`

`ResearchArchitecture::maintainer` · Stakeholder · #566 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `0`

Taught by: case-study, architecture

## View (3)

### `evidenceView`

`ResearchArchitecture::evidenceView` · View · #542 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `0`
- viewpointIndex: `0`
- modelKindIndex: `2`

Taught by: architecture

### `ownershipView`

`ResearchArchitecture::ownershipView` · View · #573 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `1`
- viewpointIndex: `1`
- modelKindIndex: `0`

Taught by: architecture

### `velocityView`

`ResearchArchitecture::velocityView` · View · #596 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `2`
- viewpointIndex: `2`
- modelKindIndex: `1`

Taught by: architecture

## Viewpoint (3)

### `evidenceViewpoint`

`ResearchArchitecture::evidenceViewpoint` · Viewpoint · #543 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `0`
- stakeholderIndex: `0`
- concernIndex: `0`
- modelKindIndex: `2`

Taught by: architecture

### `ownershipViewpoint`

`ResearchArchitecture::ownershipViewpoint` · Viewpoint · #574 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `1`
- stakeholderIndex: `0`
- concernIndex: `1`
- modelKindIndex: `0`

Taught by: architecture

### `velocityViewpoint`

`ResearchArchitecture::velocityViewpoint` · Viewpoint · #597 · [source](https://github.com/afflom/rule30/blob/e3be477fded263029479127363f7fb6a3597e7d4/rule30-api/src/ResearchArchitecture.lex.tex)

- index: `2`
- stakeholderIndex: `0`
- concernIndex: `2`
- modelKindIndex: `1`

Taught by: architecture

