docs: convert all 9 ASCII diagrams to mermaid

Audit of docs/ found 32 diagrams: 23 already in mermaid, 9 in ASCII
art (box-drawing chars / +-pipe boxes). Converting all 9 to mermaid
so GitHub renders them as actual diagrams in the docs preview.

Files affected (9 diagram blocks across 6 files):

  docs/architecture.md   block 1 line 706  EST request flow
  docs/architecture.md   block 2 line 798  SCEP request flow
  docs/architecture.md   block 3 line 893  Per-profile TrustAnchor +
                                           Intune challenge dispatch
  docs/architecture.md   block 4 line 935  signer.Driver interface +
                                           4 implementations
  docs/ci-pipeline.md    block 1 line 20   On-push pipeline tree
  docs/est.md            block 1 line 254  WiFi 802.1X / EAP-TLS flow
  docs/legacy-est-scep.md block 1 line 40  TLS-version-bridging proxy
  docs/qa-test-guide.md  block 1 line 41   qa_test.go to demo stack
  docs/scep-intune.md    block 1 line 39   Intune cloud chain

Conversion notes:

  - Linear flows → flowchart TD/LR. Per-step annotations that the
    ASCII had as floating text between arrows are now edge labels —
    cleaner and easier to read.
  - architecture.md block 4 (signer drivers) → flowchart LR with a
    subgraph for the Driver interface. Cleaner than a class diagram
    for the "code uses one of these implementations" semantics.
  - ci-pipeline.md tree → flowchart TD. Adds a dotted '-.depends
    on.->' arrow making the go-build-and-test → deploy-vendor-e2e
    dependency visually obvious (was a parenthetical in the ASCII).
  - est.md WiFi/RADIUS → flowchart LR with EAP, Radius, trusts,
    and EST as four distinct labeled arrows. The 'trusts' annotation
    was floating off to the side in the ASCII; now it's the arrow
    label between Radius and certctl CA.
  - All semantic detail preserved: every node label, arrow direction,
    inline annotation, and multi-line cell content carries through.

Verified: post-conversion audit shows 32 mermaid blocks, 0 ASCII.
Diff is symmetric — 108 inserts, 123 deletes — because mermaid is
slightly more compact than the box-drawing characters it replaces.

GitHub renders mermaid blocks natively in markdown previews since
2022, so all 9 diagrams now render as real flowcharts in the docs
view rather than as monospaced character art.
This commit is contained in:
shankar0123
2026-05-01 05:09:00 +00:00
parent 2643a427ac
commit dcd82d062f
6 changed files with 108 additions and 123 deletions
+9 -16
View File
@@ -38,22 +38,15 @@ either manual-only by design or pending QA-suite coverage:
## Architecture
```
┌────────────────────────┐ ┌─────────────────────────────────┐
qa_test.go │────▶│ certctl demo stack │
│ (//go:build qa) │ │ docker-compose.yml + │
│ │ │ docker-compose.demo.yml │
│ TestQA(t *testing.T) │ │ │
│ ├─ Part01_Infra │ │ ┌─ certctl-server :8443 │
│ ├─ Part02_Auth │ │ ├─ postgres :5432 │
│ ├─ Part03_CertCRUD │ │ └─ certctl-agent (×N) │
│ ├─ ... │ │ ↑ seed_demo.sql provisions │
│ └─ Part52_HelmChart │ │ 12 agent rows (1 active, │
└────────────────────────┘ │ 2 retired, 9 reserved / │
│ sentinel) for the soft- │
│ retire / FSM coverage │
│ Parts 5556 exercise. │
└─────────────────────────────────┘
```mermaid
flowchart LR
QA["qa_test.go (//go:build qa)<br/><br/>TestQA(t *testing.T)<br/>├─ Part01_Infra<br/>├─ Part02_Auth<br/>├─ Part03_CertCRUD<br/>├─ ...<br/>└─ Part52_HelmChart"]
subgraph Stack["certctl demo stack<br/>docker-compose.yml + docker-compose.demo.yml"]
Server["certctl-server :8443"]
Postgres["postgres :5432"]
Agents["certctl-agent (×N)<br/>↑ seed_demo.sql provisions 12 agent rows<br/>(1 active, 2 retired, 9 reserved/sentinel)<br/>for the soft-retire / FSM coverage Parts 5556 exercise"]
end
QA --> Stack
```
> **Multi-agent demo stack (Bundle Q / L-004 closure).** The demo