raulrgmx/oci-deal-accelerator
1
0
Fork 0
forked from diegoecab/oci-deal-accelerator
Code Pull Requests Activity

MELI Fraud: case-specific scaffolding scripts (3 chassis variants)

Browse Source 
Three one-shot Python scripts that build the MELI Fraud As-Is /
To-Be .drawio pair by cloning an Oracle Architecture Center chassis
and overlaying MELI-specific labels, region renames, and workload
pills. Useful as worked examples of the chassis-then-overlay
transform pattern (drawio_template_transform.DrawioTemplate) that
the diagram procedure recommends:

  • build_meli_fraud_from_adbsplusadbd.py — clones the locally
    accepted ATP-S/ATP-D side-by-side reference and partitions cells
    into AS-IS / TO-BE panels by x-coordinate.
  • build_meli_fraud_from_crossregion.py — uses Oracle's
    exadata-dedicated-cross-region-dataguard ref-arch (two regions
    with DRG + RPC + Data Guard already drawn) as chassis and only
    overlays MELI-specific pills.
  • build_meli_fraud_from_templates.py — combines the in-region and
    cross-region Exadata ref-archs and clones the in-region
    topology to the right for the Montreal DR.

All three honour the standing rule: do not edit text inside Oracle
SVG stencil shapes — overlay new mxCells in whitespace instead.
Outputs land under examples/output-meli-fraud-adbd-migration/.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
root
2026-04-27 09:29:37 -03:00
parent 5566a171b0
commit 1b4828f293
3 changed files with 958 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

238
tools/build_meli_fraud_from_crossregion.py Normal file
View File

@@ -0,0 +1,238 @@
#!/usr/bin/env python3
"""
Alternate MELI Fraud diagrams — built on top of the Oracle
`exadata-dedicated-cross-region-dataguard` reference architecture as chassis.
Why this chassis:
It ships with exactly the layout both prompts want — two OCI regions
side-by-side, each with a VCN (Client Subnet + Backup Subnet), a Database
Service icon, DRG + Remote Peering, Service Gateway, and Oracle Services
Network (DNS + Object Storage) — with the Oracle Data Guard arrow drawn
between the two regions.
We keep the chassis largely untouched and overlay MELI-specific pills +
region rename + title banner, per Diego's earlier feedback that preserving
Oracle's official polish is the goal. The Exadata stencil stays (it is an
Oracle shape representing the database infrastructure) but the pills
identify the specific databases layered on top of it for MELI's estate.
Output:
examples/output-meli-fraud-adbd-migration/fraud-as-is-alt.drawio
examples/output-meli-fraud-adbd-migration/fraud-to-be-alt.drawio
"""
from __future__ import annotations
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent))
from drawio_template_transform import DrawioTemplate # noqa: E402
SRC = Path(
"kb/diagram/assets/archcenter-refs/exadata-dedicated-cross-region-dataguard/"
"exadata-dedicated-cross-region-dataguard-uncompressed.drawio"
)
OUT_DIR = Path("examples/output-meli-fraud-adbd-migration")
ORACLE_RED = "#C74634"
ORACLE_GREEN = "#00875A"
SLATE_BLUE = "#6E89AD"
AMBER = "#E8A92F"
MUTED_GREY = "#70665E"
CHARCOAL = "#312D2A"
def add_banner(t: DrawioTemplate, text: str, x: float, y: float, w: float,
h: float = 36, color: str = ORACLE_RED,
font_color: str = "#FCFBFA") -> str:
style = (
f"rounded=1;whiteSpace=wrap;html=1;fillColor={color};strokeColor=none;"
f"fontColor={font_color};fontSize=16;fontStyle=1;fontFamily=Oracle Sans;"
f"align=center;verticalAlign=middle;arcSize=4;"
)
return t.add_cell(text, style, "1", x, y, w, h)
def add_pill(t: DrawioTemplate, text: str, x: float, y: float,
fill: str, stroke: str, font_color: str = "#FCFBFA",
w: float = 170, h: float = 22) -> str:
style = (
f"rounded=1;whiteSpace=wrap;html=1;fillColor={fill};"
f"strokeColor={stroke};strokeWidth=1;fontColor={font_color};"
f"fontSize=10;fontStyle=1;fontFamily=Oracle Sans;"
f"align=center;verticalAlign=middle;arcSize=30;"
)
return t.add_cell(text, style, "1", x, y, w, h)
def add_region_label(t: DrawioTemplate, text: str, x: float, y: float,
color: str = CHARCOAL) -> str:
style = (
f"text;html=1;align=left;verticalAlign=middle;whiteSpace=wrap;"
f"fontFamily=Oracle Sans;fontSize=12;fontStyle=1;fontColor={color};"
f"strokeColor=none;fillColor=none;"
)
return t.add_cell(text, style, "1", x, y, 340, 20)
def add_footer(t: DrawioTemplate, text: str, x: float, y: float,
w: float = 1000) -> str:
style = (
f"text;html=1;align=left;verticalAlign=middle;whiteSpace=wrap;"
f"fontFamily=Oracle Sans;fontSize=10;fontColor={MUTED_GREY};"
f"strokeColor=none;fillColor=none;fontStyle=2;"
)
return t.add_cell(text, style, "1", x, y, w, 20)
# ---------------------------------------------------------------------------
# Geometry landmarks in the cross-region-dataguard template
# ---------------------------------------------------------------------------
# Tenancy chassis: ~1054x624 canvas
# Left region ("OCI Region"): x ≈ 10, y ≈ 34, w ≈ 454, h ≈ 579
# Right region ("OCI Region"): x ≈ 590, y ≈ 34, w ≈ 454, h ≈ 579
# Exadata icon boxes centered inside each region at y ≈ 210
# left icon cluster centre around x=220
# right icon cluster centre around x=820
LEFT_REGION_X = 10
LEFT_REGION_Y = 34
LEFT_REGION_W = 454
RIGHT_REGION_X = 590
RIGHT_REGION_W = 454
EXA_CLUSTER_Y = 220 # vertical centre of Exadata icon in each region
PILL_W = 200
# ---------------------------------------------------------------------------
# As-Is builder
# ---------------------------------------------------------------------------
def build_as_is() -> None:
t = DrawioTemplate(SRC)
# ── Title banner (sits above the canvas) ────────────────────────────
add_banner(t, "MELI Fraud — As-Is (ADB-S)",
x=0, y=-46, w=1054, h=36)
# ── Region labels override the stencil's "OCI Region" text with a
# clearer "us-ashburn-1 (Primary)" / "ca-montreal-1 (DR)" heading ─────
add_region_label(t, "us-ashburn-1 · Primary",
x=LEFT_REGION_X + 40, y=LEFT_REGION_Y + 4)
add_region_label(t, "ca-montreal-1 · DR",
x=RIGHT_REGION_X + 40, y=LEFT_REGION_Y + 4)
# ── Left region: overlay 2 workload rows with 3 DBs each ────────────
# Exadata icon of the left region is centred around x=220, y=220. We
# place pills below it identifying the databases MELI has on ADB-S.
lx = LEFT_REGION_X + 30
row_y = 260
row_h = 120
# Row 1 — Fraude
add_region_label(t, "Fraude (19c · ADB-S)",
x=lx, y=row_y - 20)
add_pill(t, "Primary", lx, row_y, ORACLE_RED, "#7A1F12",
w=120, h=22)
add_pill(t, "Local Standby (ADG)", lx + 130, row_y, SLATE_BLUE,
"#2E4A78", w=160, h=22)
add_pill(t, "Clone (R/O)", lx + 300, row_y, AMBER, "#7A5510",
font_color="#5A4A10", w=100, h=22)
# Row 2 — Transactional
add_region_label(t, "Transactional — Fraude Team (26ai · ADB-S)",
x=lx, y=row_y + row_h - 20)
add_pill(t, "Primary", lx, row_y + row_h, ORACLE_RED, "#7A1F12",
w=120, h=22)
add_pill(t, "Local Standby (ADG)", lx + 130, row_y + row_h, SLATE_BLUE,
"#2E4A78", w=160, h=22)
add_pill(t, "Refreshable Clone (R/O)", lx + 300, row_y + row_h, AMBER,
"#7A5510", font_color="#5A4A10", w=140, h=22)
# ── Right region: Montreal — cross-region standbys ──────────────────
rx = RIGHT_REGION_X + 30
add_region_label(t, "Fraude — Cross-region Standby",
x=rx, y=row_y - 20)
add_pill(t, "Fraude — DR Standby", rx, row_y, SLATE_BLUE, "#2E4A78",
w=250, h=22)
add_region_label(t, "Transactional — Cross-region Standby",
x=rx, y=row_y + row_h - 20)
add_pill(t, "Transactional — DR Standby", rx, row_y + row_h, SLATE_BLUE,
"#2E4A78", w=250, h=22)
add_footer(t, "Out of scope: Mexico · Catálogo · Attribution.",
x=10, y=635, w=1000)
OUT_DIR.mkdir(parents=True, exist_ok=True)
out = OUT_DIR / "fraud-as-is-alt.drawio"
t.save(out)
print(f"✓ wrote {out}")
# ---------------------------------------------------------------------------
# To-Be builder
# ---------------------------------------------------------------------------
def build_to_be() -> None:
t = DrawioTemplate(SRC)
add_banner(t, "MELI Fraud — To-Be (ADB-D Dedicated)",
x=0, y=-46, w=1054, h=36)
add_region_label(t, "us-ashburn-1 · Primary · AD-X + AD-Y",
x=LEFT_REGION_X + 40, y=LEFT_REGION_Y + 4)
add_region_label(t, "ca-montreal-1 · DR",
x=RIGHT_REGION_X + 40, y=LEFT_REGION_Y + 4)
# ── Left region: 2 ADs, each with AVMC → CDB → PDB ──────────────────
lx = LEFT_REGION_X + 30
ad_y = 260
row_h = 120
add_region_label(t,
"AD-X — Primary · Quarter Rack X11M · AVMC",
x=lx, y=ad_y - 20)
add_pill(t, "CDB-FRAUDE · Fraude PDB — Primary",
lx, ad_y, ORACLE_RED, "#7A1F12", w=320, h=22)
add_pill(t, "CDB-TRANSACTIONAL · Transactional PDB — Primary",
lx, ad_y + 28, ORACLE_RED, "#7A1F12", w=380, h=22)
add_region_label(t,
"AD-Y — Local ADG Standby · Quarter Rack X11M · AVMC",
x=lx, y=ad_y + row_h - 20)
add_pill(t, "CDB-FRAUDE-RO · Fraude — Read-only Standby",
lx, ad_y + row_h, ORACLE_GREEN, "#044C33", w=340, h=22)
add_pill(t, "CDB-TRANSACTIONAL-RO · Transactional — Read-only Standby",
lx, ad_y + row_h + 28, ORACLE_GREEN, "#044C33", w=400, h=22)
# ── Right region: Montreal DR — Quarter Rack X11M, AVMC ─────────────
rx = RIGHT_REGION_X + 30
add_region_label(t,
"Cross-region DR · Quarter Rack X11M · AVMC",
x=rx, y=ad_y - 20)
add_pill(t, "CDB-FRAUDE-DR · Fraude — DR Standby",
rx, ad_y, SLATE_BLUE, "#2E4A78", w=310, h=22)
add_pill(t, "CDB-TRANSACTIONAL-DR · Transactional — DR Standby",
rx, ad_y + 28, SLATE_BLUE, "#2E4A78", w=370, h=22)
add_footer(
t,
"Three Quarter Rack X11M total (2 in Ashburn + 1 in Montreal). "
"Active Data Guard in-region · Cross-region DG to Montreal.",
x=10, y=635, w=1040,
)
OUT_DIR.mkdir(parents=True, exist_ok=True)
out = OUT_DIR / "fraud-to-be-alt.drawio"
t.save(out)
print(f"✓ wrote {out}")
def main() -> None:
build_as_is()
build_to_be()
if __name__ == "__main__":
main()