Skip to content

Make the url-shortener diagram vertical with white subgraph backgrounds #116

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
paolosalvatori merged 2 commits into from
Aug 11, 2026
Merged

Make the url-shortener diagram vertical with white subgraph backgrounds #116

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a3ba1c5
Make the url-shortener diagram vertical with white subgraph backgrounds
paolosalvatori Aug 11, 2026
a8a36ac
Untangle the url-shortener diagram's edge routing
paolosalvatori Aug 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 20 additions & 18 deletions samples/url-shortener/python/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,32 +23,37 @@ The solution is composed of the following Azure resources:
- *QrGenerator* ([Queue Storage trigger](https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-storage-queue-trigger)): Requests the QR SVG render for the short link.

```mermaid
flowchart LR
%%{init: {"flowchart": {"nodeSpacing": 60, "rankSpacing": 80}}}%%
flowchart TB
user((User))

subgraph webapp["Web App (Flask)"]
shorten["POST /shorten"]
follow["GET /l/{code}"]
shorten["POST /shorten"]
internal["POST /internal/*<br/>(token-protected)"]
end

kv["Key Vault<br/>link-sign-key, pg-conn"]
pg[("PostgreSQL<br/>clicks db")]
sb[["Service Bus<br/>link-events queue"]]
links[("links table<br/>(Storage Account)")]
qrjobs[["qrjobs queue<br/>(Storage Account)"]]
qrcodes[("qrcodes container<br/>(Storage Account, public read)")]
logs["Log Analytics"]

subgraph functions["Function App (worker)"]
abuse["AbuseScan<br/>(Service Bus trigger)"]
qrgen["QrGenerator<br/>(queue trigger)"]
end

subgraph storage["Storage Account"]
links[("links table")]
qrjobs[["qrjobs queue"]]
qrcodes[("qrcodes container<br/>public read")]
end
user -->|"2: follow short link"| follow
user -->|"1: shorten URL"| shorten
user -.->|"3: fetch QR"| qrcodes

kv["Key Vault<br/>link-sign-key, pg-conn"]
sb[["Service Bus<br/>link-events queue"]]
pg[("PostgreSQL<br/>clicks db")]
logs["Log Analytics"]
follow -.->|"read pg-conn"| kv
follow -->|"click row"| pg
follow -->|"hit counter"| links

user -->|"1: shorten URL"| shorten
shorten -.->|"read sign key"| kv
shorten -->|"write link + sig"| links
shorten -->|"link-created event"| sb
Expand All @@ -61,13 +66,10 @@ flowchart LR
internal -->|"scan / qr status"| links
internal -->|"QR SVG"| qrcodes

user -->|"2: follow short link"| follow
follow -->|"hit counter"| links
follow -.->|"read pg-conn"| kv
follow -->|"click row"| pg
links -.->|"transaction metrics<br/>(diagnostic settings)"| logs

user -.->|"3: fetch QR"| qrcodes
storage -.->|"transaction metrics"| logs
style webapp fill:#ffffff,stroke:#999999,color:#333333
style functions fill:#ffffff,stroke:#999999,color:#333333
```

The flow of a single link: `POST /shorten` → Table Storage + Key Vault + Service Bus + Queue Storage → workers → internal API → Table Storage + Blob Storage → `GET /l/<code>` → PostgreSQL + 302 redirect. The home page renders the link table with hit counts, signatures, scan verdicts and QR links.
Expand Down