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

437
tools/build_meli_fraud_from_adbsplusadbd.py Normal file
View File

@@ -0,0 +1,437 @@
#!/usr/bin/env python3
"""
Build MELI Fraud As-Is and To-Be .drawio files by cloning and editing
examples/output-meli-fraud-adbd-migration/adbsplusadbd.drawio — the ADB
(ATP-S / ATP-D) reference Diego already accepted visually.
Strategy:
1. Load the source file.
2. Partition cells into AS-IS (x < 4630) and TO-BE (x >= 4630) panels;
edges are assigned to a panel based on their source/target cell.
3. For each output, delete the panel we don't need.
4. Relabel the title banner, notes, and trade-offs text for MELI.
5. Clone the ATP-S / ATP-D icon cells (single-cell stencils) to add a
second workload row (Transactional) and a Clone column (As-Is only).
6. Add a Montreal DR region panel to the right.
7. Save.
Constraint: interior labels like "OCI Ashburn" / "AD 3" / "AD 2" / "R/W Pool"
are plain mxCell values we CAN edit — so we rename AD 3 → AD-X, AD 2 → AD-Y,
adjust R/W Pool label, etc.
"""
from __future__ import annotations
import copy
import re
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("examples/output-meli-fraud-adbd-migration/adbsplusadbd.drawio")
OUT_DIR = Path("examples/output-meli-fraud-adbd-migration")
# Oracle palette
ORACLE_RED = "#C74634"
ORACLE_GREEN = "#00875A"
SLATE_BLUE = "#6E89AD"
AMBER = "#E8A92F"
MUTED_GREY = "#70665E"
CHARCOAL = "#312D2A"
# ---------------------------------------------------------------------------
# Panel partitioning
# ---------------------------------------------------------------------------
def partition_panels(t: DrawioTemplate, split_x: float = 4630):
"""Return (as_is_ids, to_be_ids) — both sets cover all vertex cells.
Edges are classified by their source/target positions.
"""
as_is, to_be = set(), set()
def cell_x(cid: str) -> float | None:
c = t.cells.get(cid)
if c is None:
return None
geo = c.find("mxGeometry")
if geo is None:
return None
try:
return float(geo.get("x") or 0)
except ValueError:
return None
# Vertices first: classify by absolute x (walk parents to get absolute x)
def abs_x(cid: str) -> float:
x = 0.0
cur = cid
guard = 0
while cur and cur in t.cells and guard < 30:
geo = t.cells[cur].find("mxGeometry")
if geo is not None:
try:
x += float(geo.get("x") or 0)
except ValueError:
pass
parent = t.cells[cur].get("parent") or ""
if parent in ("0", "1", ""):
break
cur = parent
guard += 1
return x
for cid, c in t.cells.items():
if cid in ("0", "1"):
continue
if c.get("edge") == "1":
continue
ax = abs_x(cid)
if ax >= split_x:
to_be.add(cid)
else:
as_is.add(cid)
# Edges follow their source/target
for cid, c in t.cells.items():
if c.get("edge") != "1":
continue
src = c.get("source")
tgt = c.get("target")
in_tobe = any(ref and ref in to_be for ref in (src, tgt))
in_asis = any(ref and ref in as_is for ref in (src, tgt))
if in_tobe and not in_asis:
to_be.add(cid)
elif in_asis and not in_tobe:
as_is.add(cid)
else:
# Ambiguous — keep with TO BE by default
to_be.add(cid)
return as_is, to_be
def delete_cells(t: DrawioTemplate, cell_ids: set[str]) -> None:
for cid in list(cell_ids):
c = t.cells.get(cid)
if c is not None:
try:
t.model_root.remove(c)
except ValueError:
pass
t.reindex()
# ---------------------------------------------------------------------------
# Text helpers — Oracle templates often store rich-HTML values
# ---------------------------------------------------------------------------
def replace_rich_label(t: DrawioTemplate, cell_id: str, plain_text: str,
color: str = CHARCOAL, bold: bool = True,
size: int = 16) -> None:
"""Replace a cell's <value> with simple HTML — keeps drawio rendering happy."""
weight = "bold" if bold else "normal"
html = (
f'<h1 style="color: {color}; text-align: left; '
f'line-height: 1.1; margin: 0; font-size: {size}px; font-weight: {weight};">'
f'{plain_text}</h1>'
)
t.cells[cell_id].set("value", html)
def add_pill(t: DrawioTemplate, text: str, x: float, y: float,
fill: str, stroke: str, font_color: str = "#FCFBFA",
w: float = 130, 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_soft_box(t: DrawioTemplate, label: str, x: float, y: float,
w: float, h: float, fill: str, stroke: str,
font_color: str = CHARCOAL) -> str:
style = (
f"rounded=1;whiteSpace=wrap;html=1;fillColor={fill};"
f"strokeColor={stroke};strokeWidth=1;dashed=1;dashPattern=6 4;"
f"fontColor={font_color};fontSize=12;fontStyle=1;"
f"fontFamily=Oracle Sans;align=left;verticalAlign=top;"
f"spacingLeft=8;spacingTop=6;arcSize=4;"
)
return t.add_cell(label, style, "1", x, y, w, h)
# ---------------------------------------------------------------------------
# As-Is builder — left panel of adbsplusadbd, ATP-S icons
# ---------------------------------------------------------------------------
def build_as_is() -> None:
t = DrawioTemplate(SRC)
as_is, to_be = partition_panels(t)
delete_cells(t, to_be)
P = "GVNBTaRQvtpjXlJZoCOU" # id prefix used in the source
# Title: cell 87 holds the AS IS title banner text
replace_rich_label(t, f"{P}-87", "MELI Fraud — As-Is (ADB-S)",
color="#FCFBFA", bold=True, size=22)
# Make the banner red + solid
t.patch_style(f"{P}-87",
fillColor=ORACLE_RED,
strokeColor="none",
fontColor="#FCFBFA",
align="center",
verticalAlign="middle")
# Remove the notes and trade-offs text boxes — not needed in the simple view
for cid in (f"{P}-88", f"{P}-89", f"{P}-86"):
if cid in t.cells:
t.delete_subtree(cid)
# Relabel AD 3 → AD-X, AD 2 → AD-Y to match the prompt
if f"{P}-93" in t.cells:
t.set_label(f"{P}-93", "AD-X")
if f"{P}-94" in t.cells:
t.set_label(f"{P}-94", "AD-Y")
# Rename R/W Pool → Fraude (it holds Fraude's primary + standby)
# Cell 95 is the R/W Pool container in AS IS.
if f"{P}-95" in t.cells:
t.set_label(f"{P}-95", "Fraude (19c · ADB-S)")
# Relabel the ATP-S icons: 100 = primary, 99 = L-SBY. Replace their
# rich HTML values with simple labels.
if f"{P}-100" in t.cells:
replace_rich_label(t, f"{P}-100", "Fraude — Primary", color=ORACLE_RED,
size=11)
if f"{P}-99" in t.cells:
replace_rich_label(t, f"{P}-99", "Fraude — Local Standby (ADG)",
color=SLATE_BLUE, size=11)
# Cell 112 is an extra ATP-S icon floating; reuse as Fraude Clone (amber)
if f"{P}-112" in t.cells:
replace_rich_label(t, f"{P}-112", "Fraude — Clone (R/O)",
color="#7A5510", size=11)
# No tone override on the stencil itself — keep the OCI teal icon but
# wrap an amber dashed pill around it.
geo = t.cells[f"{P}-112"].find("mxGeometry")
if geo is not None:
gx = float(geo.get("x") or 0)
gy = float(geo.get("y") or 0)
gw = float(geo.get("width") or 60)
gh = float(geo.get("height") or 50)
t.add_cell(
"", style=(
f"rounded=1;whiteSpace=wrap;html=1;fillColor=none;"
f"strokeColor={AMBER};strokeWidth=2;dashed=1;dashPattern=6 4;"
f"arcSize=8;"
),
parent="1", x=gx - 6, y=gy - 6, w=gw + 12, h=gh + 14,
)
# Delete notes cell 111 if present (the "A) Allow L-SBY..." side note)
if f"{P}-111" in t.cells:
t.delete_subtree(f"{P}-111")
# ── Second workload row (Transactional) — clone the pool + icons ────
# Clone the pool container (95), primary stencil (100), standby (99),
# and the small customer icon group (101) with a y-offset of ~290 so
# they sit below the existing row.
dy = 290
clone_map = {}
for src_id in (f"{P}-95", f"{P}-100", f"{P}-99"):
if src_id not in t.cells:
continue
m = t.clone_subtree(src_id, dx=0, dy=dy,
id_prefix=f"txn_{src_id.split('-')[-1]}_")
clone_map.update(m)
# Label the cloned pool
cloned_pool = clone_map.get(f"{P}-95")
if cloned_pool:
t.set_label(cloned_pool, "Transactional — Fraude Team (26ai · ADB-S)")
cloned_primary = clone_map.get(f"{P}-100")
if cloned_primary:
replace_rich_label(t, cloned_primary, "Transactional — Primary",
color=ORACLE_RED, size=11)
cloned_sby = clone_map.get(f"{P}-99")
if cloned_sby:
replace_rich_label(t, cloned_sby, "Transactional — Local Standby (ADG)",
color=SLATE_BLUE, size=11)
# Transactional Refreshable Clone — clone the ATP-S icon (cell 112) and
# place it below the Fraude clone
if f"{P}-112" in t.cells:
m = t.clone_subtree(f"{P}-112", dx=0, dy=dy,
id_prefix="txn_clone_")
cloned_clone = m.get(f"{P}-112")
if cloned_clone:
replace_rich_label(t, cloned_clone,
"Transactional — Refreshable Clone",
color="#7A5510", size=11)
# ── Montreal DR region ──────────────────────────────────────────────
# Place a new gray dashed region to the right of the primary OCI region.
# OCI Ashburn in source is at x=4155, w=344 → right edge ≈ 4499.
# The panel backdrop (85) ends at x=3543+1101=4644. Push Montreal to the
# right, extending the panel size if needed.
MTL_X = 4660
MTL_Y = 5925
MTL_W = 340
MTL_H = 570
add_soft_box(t, "Region — ca-montreal-1 (DR)",
MTL_X, MTL_Y, MTL_W, MTL_H,
fill="#FFFFFF", stroke=MUTED_GREY)
add_pill(t, "Fraude — Cross-region Standby",
MTL_X + 30, MTL_Y + 80, SLATE_BLUE, "#2E4A78", w=280, h=32)
add_pill(t, "Transactional — Cross-region Standby",
MTL_X + 30, MTL_Y + 200, SLATE_BLUE, "#2E4A78", w=280, h=32)
# Extend the big panel backdrop (cell 85) to accommodate Montreal
panel = t.cells.get(f"{P}-85")
if panel is not None:
geo = panel.find("mxGeometry")
if geo is not None:
# Widen from 1101 to ~1500
geo.set("width", "1530")
geo.set("height", "870")
# Footer line
t.add_text(
"Out of scope: Mexico · Catálogo · Attribution.",
x=3561, y=6600, w=900, h=22,
font_size=11, font_color=MUTED_GREY, bold=False,
)
OUT_DIR.mkdir(parents=True, exist_ok=True)
out = OUT_DIR / "fraud-as-is.drawio"
t.save(out)
print(f"✓ wrote {out}")
# ---------------------------------------------------------------------------
# To-Be builder — right panel of adbsplusadbd, ATP-D icons
# ---------------------------------------------------------------------------
def build_to_be() -> None:
t = DrawioTemplate(SRC)
as_is, to_be = partition_panels(t)
delete_cells(t, as_is)
P = "GVNBTaRQvtpjXlJZoCOU"
# Title: cell 4 holds the TO BE title in the source
replace_rich_label(t, f"{P}-4",
"MELI Fraud — To-Be (ADB-D Dedicated)",
color="#FCFBFA", bold=True, size=22)
t.patch_style(f"{P}-4",
fillColor=ORACLE_RED,
strokeColor="none",
fontColor="#FCFBFA",
align="center",
verticalAlign="middle")
# Remove notes + trade-offs + RPO/RTO floating labels
for cid in (f"{P}-5", f"{P}-36", f"{P}-3"):
if cid in t.cells:
t.delete_subtree(cid)
# Rename AD 3 → AD-X, AD 2 → AD-Y
if f"{P}-40" in t.cells:
t.set_label(f"{P}-40", "AD-X — Primary · Quarter Rack X11M")
if f"{P}-41" in t.cells:
t.set_label(f"{P}-41", "AD-Y — Local ADG Standby · Quarter Rack X11M")
# Pools: 43 = R/O Pool, 42 = R/W Pool. Rename to AVMC-per-workload framing.
if f"{P}-43" in t.cells:
t.set_label(f"{P}-43", "AVMC · CDB-FRAUDE / CDB-TRANSACTIONAL — Primary")
if f"{P}-42" in t.cells:
t.set_label(f"{P}-42",
"AVMC · CDB-FRAUDE-RO / CDB-TRANSACTIONAL-RO — Read-only Standby")
# Relabel ATP-D icons: cell 47 (L-SBY R/O), 48 (primary)
if f"{P}-47" in t.cells:
replace_rich_label(t, f"{P}-47", "Fraude — Read-only Standby",
color=ORACLE_GREEN, size=11)
if f"{P}-48" in t.cells:
replace_rich_label(t, f"{P}-48", "Fraude — Primary",
color=ORACLE_RED, size=11)
# ── Second workload row (Transactional) — clone ATP-D icons ─────────
dy = 80 # place below the existing icons inside the same pool areas
clone_map = {}
for src_id in (f"{P}-47", f"{P}-48"):
if src_id not in t.cells:
continue
m = t.clone_subtree(src_id, dx=0, dy=dy,
id_prefix=f"txn_{src_id.split('-')[-1]}_")
clone_map.update(m)
cloned_ro = clone_map.get(f"{P}-47")
if cloned_ro:
replace_rich_label(t, cloned_ro, "Transactional — Read-only Standby",
color=ORACLE_GREEN, size=11)
cloned_primary = clone_map.get(f"{P}-48")
if cloned_primary:
replace_rich_label(t, cloned_primary, "Transactional — Primary",
color=ORACLE_RED, size=11)
# ── Montreal DR region ──────────────────────────────────────────────
MTL_X = 5860
MTL_Y = 6004
MTL_W = 340
MTL_H = 600
add_soft_box(t,
"Region — ca-montreal-1 (DR)\nQuarter Rack X11M",
MTL_X, MTL_Y, MTL_W, MTL_H,
fill="#FFFFFF", stroke=MUTED_GREY)
t.add_text(
"AVMC · CDB-FRAUDE-DR / CDB-TRANSACTIONAL-DR",
x=MTL_X + 15, y=MTL_Y + 60, w=MTL_W - 30, h=20,
font_size=10, font_color=MUTED_GREY, bold=True,
)
add_pill(t, "Fraude — DR Standby",
MTL_X + 30, MTL_Y + 110, SLATE_BLUE, "#2E4A78", w=280, h=32)
add_pill(t, "Transactional — DR Standby",
MTL_X + 30, MTL_Y + 240, SLATE_BLUE, "#2E4A78", w=280, h=32)
# Extend the TO BE panel backdrops (cells 1, 2) to fit Montreal
for cid in (f"{P}-1", f"{P}-2"):
panel = t.cells.get(cid)
if panel is None:
continue
geo = panel.find("mxGeometry")
if geo is not None:
geo.set("width", "1540")
geo.set("height", "870")
# Footer
t.add_text(
"Three Quarter Rack X11M total (2 in Ashburn + 1 in Montreal). "
"Active Data Guard in-region · Cross-region DG to Montreal.",
x=4708, y=6675, w=1500, h=22,
font_size=11, font_color=MUTED_GREY, bold=False,
)
OUT_DIR.mkdir(parents=True, exist_ok=True)
out = OUT_DIR / "fraud-to-be.drawio"
t.save(out)
print(f"✓ wrote {out}")
def main() -> None:
build_as_is()
build_to_be()
if __name__ == "__main__":
main()