Full Integration Mermaid diagrams report
Summary
- Markdown files scanned: 18
- Image references found: 2
- Clear diagrams converted: 2
- Ambiguous diagrams reported: 0
- Screenshots/charts skipped: 0
- Blocked conversions: 0
- Image files left untouched: 2
Converted diagrams
| Markdown file | Original image | Diagram type | Mermaid type | Verification source | Notes |
|---|---|---|---|---|---|
identity-options/sso-user-creation-and-authorisation.md | /broker-oauth/fixedCreation.png | Sequence diagram | sequenceDiagram | Current docs API spec tables + legacy-backup/Flows_Stages/User_Creation_Flow.md | Title normalised from "SSO (OAuth) User Creation Flow" → "SSO user creation flow" (per canonical terminology rule). API call codes 3.2, 3.3, 3.4, 4.2 replaced with verified endpoint paths. |
feature-modules/embedded-ctrader-web.md | /broker-oauth/fixembedded2.png | Sequence diagram | sequenceDiagram | Current docs API spec tables + legacy-backup/Flows_Stages/Embedded_Web_Flow.md | Title normalised from "SSO (OAuth) Embedded cTrader Web Flow". Participant "cTrader App" normalised to "cTrader Web" (module context: embedded web, not desktop app). API call code 4.2 replaced with verified endpoint path. |
Image files left untouched
| Image file | Referenced from | Status | Recommended human action |
|---|---|---|---|
static/broker-oauth/fixedCreation.png | identity-options/sso-user-creation-and-authorisation.md | Replaced by Mermaid; file untouched | Decide whether to archive or delete now that the image is no longer referenced in Markdown |
static/broker-oauth/fixembedded2.png | feature-modules/embedded-ctrader-web.md | Replaced by Mermaid; file untouched | Decide whether to archive or delete now that the image is no longer referenced in Markdown |
Ambiguous or skipped images
None found.
Blocked conversions
None.
Endpoint and terminology verification
| Diagram / image | Item checked | Current docs result | Legacy backup result | Decision |
|---|---|---|---|---|
fixedCreation.png | POST /oauth2/ctid/create (API call 3.2) | Present in SSO API spec table | Confirmed: ## 3.2. Create a User in API_Calling_Backend.md | Verified — used in Mermaid |
fixedCreation.png | POST /webserv/traders (API call 3.3) | Present in SSO API spec table | Confirmed: ## 3.3 Create a Trader in API_Calling_Backend.md | Verified — used in Mermaid |
fixedCreation.png | POST /ctid/link (API call 3.4) | Present in SSO API spec table | Confirmed: ## 3.4. Link a Trading Account to a User in API_Calling_Backend.md | Verified — used in Mermaid |
fixedCreation.png | POST /oauth2/onetime/authorize (API call 4.2) | Present in SSO cTrader→CRM spec table | Confirmed: ## 4.2. Verify and Exchange an OT Token in API_Calling_CRM.md | Verified — used in Mermaid |
fixembedded2.png | POST /oauth2/onetime/authorize (API call 4.2) | Present in SSO cTrader→CRM spec table | Confirmed: ## 4.2. Verify and Exchange an OT Token in API_Calling_CRM.md | Verified — used in Mermaid |
fixedCreation.png | Title uses "SSO (OAuth)" | Current docs use "SSO"; "OAuth" avoided in user-facing flow labels | Legacy backup uses same "SSO (OAuth)" legacy label | Safe correction per rule 6.4 — Mermaid uses SSO terminology |
fixembedded2.png | Participant "cTrader App" | Module is "Embedded cTrader Web"; URL is app.ctrader.com (web) | Legacy backup calls it "cTrader Web" in prose | Safe correction per rule 6.4 — Mermaid uses "cTrader Web" |
Existing Mermaid blocks
No existing Mermaid blocks found in docs/full-integration before this conversion.
Commands run
find docs/full-integration -type f | sort
rg "!\[.*\]\(.*\)|<img|\.png|\.jpg|\.jpeg|\.svg|\.webp|diagram|flow|chart|architecture|sequence" docs/full-integration
rg "```mermaid|sequenceDiagram|flowchart|graph TD|graph LR" docs/full-integration
find static/broker-oauth -name "fixedCreation.png" -o -name "fixembedded2.png"
find docs/full-integration-suite/legacy-backup -type f | sort
rg "GET |POST |PUT |DELETE |/oauth2|/ctid|/webserv" docs/full-integration-suite/legacy-backup/API_Calling_Backend.md
rg "GET |POST |PUT |DELETE |/oauth2|/ctid" docs/full-integration-suite/legacy-backup/API_Calling_CRM.md
git diff -- docs/full-integration
Human review checklist
- Review converted Mermaid diagrams in rendered Docusaurus pages.
- Review original image files listed as left untouched — decide whether to delete, archive or keep
static/broker-oauth/fixedCreation.pngandstatic/broker-oauth/fixembedded2.png. - Confirm "cTrader Web" is the correct participant label in the Embedded cTrader Web flow diagram (vs "cTrader App" used in the original image).
- Confirm no diagram implies unsupported module dependencies.
- Confirm Mermaid diagrams match current API specs and terminology.