2026-11-18 07:17:07 +01:00
<mxfile host="Electron">
2026-11-16 09:55:48 +01:00
<diagram name="1. Architecture" id="arch">
2026-11-18 13:50:31 +01:00
<mxGraphModel dx="2678" dy="701" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="900" math="0" shadow="0">
2026-11-16 09:55:48 +01:00
<root>
<mxCell id="0" />
<mxCell id="1" parent="0" />
2026-11-18 07:17:07 +01:00
<mxCell id="9YVmYg31Dtc29ZtFE1oE-1" edge="1" parent="1" source="arch-2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;fillColor=#e51400;strokeColor=#B20000;" target="arch-6">
<mxGeometry relative="1" as="geometry">
<Array as="points">
<mxPoint x="-10" y="240" />
<mxPoint x="-10" y="240" />
</Array>
</mxGeometry>
</mxCell>
<mxCell id="9YVmYg31Dtc29ZtFE1oE-5" connectable="0" parent="9YVmYg31Dtc29ZtFE1oE-1" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];inheritText=1;defaultLabelBackgroundColor=page;" value="e-mail" vertex="1">
<mxGeometry relative="1" x="-0.0667" as="geometry">
<mxPoint y="-10" as="offset" />
</mxGeometry>
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="arch-2" parent="1" style="shape=umlActor;verticalLabelPosition=bottom;verticalAlign=top;html=1;outlineConnect=0;" value="Customer" vertex="1">
2026-11-18 13:50:31 +01:00
<mxGeometry height="70" width="40" x="-220" y="205" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="9YVmYg31Dtc29ZtFE1oE-3" edge="1" parent="1" source="arch-3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;fillColor=#60a917;strokeColor=#2D7600;" target="arch-2">
<mxGeometry relative="1" as="geometry">
<Array as="points">
2026-11-18 13:50:31 +01:00
<mxPoint x="-320" y="470" />
<mxPoint x="-320" y="240" />
2026-11-18 07:17:07 +01:00
</Array>
</mxGeometry>
</mxCell>
<mxCell id="9YVmYg31Dtc29ZtFE1oE-4" connectable="0" parent="9YVmYg31Dtc29ZtFE1oE-3" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];inheritText=1;defaultLabelBackgroundColor=page;" value="Send<div>message</div>" vertex="1">
<mxGeometry relative="1" x="-0.075" as="geometry">
<mxPoint y="-11" as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="arch-3" parent="1" style="shape=umlActor;verticalLabelPosition=bottom;verticalAlign=top;html=1;outlineConnect=0;" value="Support agent<div>(human)</div>" vertex="1">
2026-11-18 13:50:31 +01:00
<mxGeometry height="70" width="40" x="-220" y="435" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="arch-4" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" value="<b>Anthropic</b><div>https://api.anthropic.com/v1</div>" vertex="1">
<mxGeometry height="60" width="180" x="225" y="10" as="geometry" />
</mxCell>
<mxCell id="arch-5" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" value="<b>Ollama</b> + bge-m3<br>embedding model" vertex="1">
<mxGeometry height="60" width="180" x="455" y="10" as="geometry" />
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="9YVmYg31Dtc29ZtFE1oE-2" edge="1" parent="1" source="arch-6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;" target="arch-3">
<mxGeometry relative="1" as="geometry">
<Array as="points">
2026-11-18 13:50:31 +01:00
<mxPoint x="-110" y="470" />
<mxPoint x="-110" y="470" />
2026-11-18 07:17:07 +01:00
</Array>
</mxGeometry>
</mxCell>
2026-11-16 09:55:48 +01:00
<mxCell id="arch-6" parent="1" style="rounded=1;arcSize=3;whiteSpace=wrap;html=1;verticalAlign=top;align=left;spacingLeft=8;fontStyle=1;fillColor=#fafafa;strokeColor=#6c8ebf;" value="LibreDesk" vertex="1">
2026-11-18 13:50:31 +01:00
<mxGeometry height="465" width="970" x="-30" y="160" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-20" edge="1" parent="1" source="arch-7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;endArrow=none;endFill=0;" target="arch-4">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="arch-7" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="<b>Provider</b><br>completion: Claude Sonnet 5.5" vertex="1">
<mxGeometry height="70" width="170" x="230" y="180" as="geometry" />
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-21" edge="1" parent="1" source="arch-8" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;endArrow=none;endFill=0;" target="arch-5">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="arch-8" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="<b>Embedding</b><br>Ollama, bge-m3" vertex="1">
<mxGeometry height="70" width="170" x="460" y="180" as="geometry" />
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-14" edge="1" parent="1" source="arch-9" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;endArrow=none;endFill=0;" target="arch-7">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-15" edge="1" parent="1" source="arch-9" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;endArrow=none;endFill=0;" target="arch-11">
2026-11-18 07:17:07 +01:00
<mxGeometry relative="1" as="geometry">
<Array as="points">
<mxPoint x="315" y="400" />
<mxPoint x="315" y="400" />
</Array>
</mxGeometry>
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="arch-9" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" value="<b>Generate reply</b><br>draft in the editor" vertex="1">
<mxGeometry height="70" width="170" x="230" y="290" as="geometry" />
</mxCell>
<mxCell id="arch-10" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="<b>Snippets</b><br>knowledge base,<br>118 extracts + vectors" vertex="1">
<mxGeometry height="70" width="170" x="700" y="180" as="geometry" />
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="arch-11" parent="1" style="rounded=1;arcSize=3;whiteSpace=wrap;html=1;verticalAlign=top;align=left;spacingLeft=8;fontStyle=1;fillColor=#fafafa;strokeColor=#6c8ebf;" value="Tools <span style="font-weight:normal">(function calling: name + JSON schema, exposed to the LLM)</span>" vertex="1">
2026-11-18 13:50:31 +01:00
<mxGeometry height="210" width="735" x="135" y="390" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-16" edge="1" parent="1" source="arch-12" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;endArrow=none;endFill=0;" target="arch-8">
<mxGeometry relative="1" as="geometry" />
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="HigBPHvGvvlsroYYhkdi-17" connectable="0" parent="HigBPHvGvvlsroYYhkdi-16" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];inheritText=1;defaultLabelBackgroundColor=page;" value="fetch query" vertex="1">
2026-11-16 09:55:48 +01:00
<mxGeometry relative="1" x="0.0571" y="-1" as="geometry">
<mxPoint x="4" y="-13" as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-18" edge="1" parent="1" source="arch-12" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;endArrow=none;endFill=0;" target="arch-10">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-19" connectable="0" parent="HigBPHvGvvlsroYYhkdi-18" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];inheritText=1;defaultLabelBackgroundColor=page;" value="vector search" vertex="1">
<mxGeometry relative="1" x="-0.0896" as="geometry">
<mxPoint x="-60" y="-2" as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="arch-12" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="search_articles" vertex="1">
2026-11-18 07:17:07 +01:00
<mxGeometry height="55" width="90" x="500" y="435" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="arch-13" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;dashed=1;strokeWidth=2;" value="<b>get_station_diagnostic(serial, from, to)</b><br>new custom tool" vertex="1">
<mxGeometry height="75" width="320" x="155" y="510" as="geometry" />
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-13" edge="1" parent="1" source="HigBPHvGvvlsroYYhkdi-3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;defaultLabelBackgroundColor=page;" target="arch-9">
2026-11-18 07:17:07 +01:00
<mxGeometry relative="1" as="geometry">
<Array as="points">
<mxPoint x="140" y="325" />
</Array>
</mxGeometry>
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="HigBPHvGvvlsroYYhkdi-3" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;" value="<div><b>Client</b></div><b>Conversation</b>" vertex="1">
2026-11-18 07:17:07 +01:00
<mxGeometry height="70" width="120" x="80" y="220" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="fix-5" parent="1" style="rounded=1;arcSize=3;whiteSpace=wrap;html=1;verticalAlign=top;align=left;spacingLeft=8;fontStyle=1;fillColor=#fff8ef;strokeColor=#d79b00;dashed=1;strokeWidth=2;" value="Detector service (independent container)" vertex="1">
<mxGeometry height="330" width="420" x="105" y="740" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="fix-6" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;dashed=1;strokeWidth=2;" value="<b>REST API</b><br>GET /stations/{serial}/diagnostic?from=…&amp;to=…<br>→ events: family, start, end, evidence" vertex="1">
2026-11-18 07:17:07 +01:00
<mxGeometry height="80" width="360" x="135" y="780" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 13:50:31 +01:00
<mxCell id="acc-check" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;dashed=1;strokeWidth=2;" value="<b>Access check</b> (before any data is read)<br>same identity headers → access service:<br>serial among the customer's stations? no → 403" vertex="1">
<mxGeometry height="70" width="360" x="135" y="880" as="geometry" />
</mxCell>
<mxCell id="acc-allowed" edge="1" parent="1" source="acc-check" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#d79b00;strokeWidth=2;dashed=1;fontColor=#b36b00;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="fix-7" value="allowed">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="acc-tool" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;dashed=1;strokeWidth=2;" value="<b>get_customer_access()</b><br>no parameter: called first, on Generate reply" vertex="1">
<mxGeometry height="62" width="320" x="155" y="432" as="geometry" />
</mxCell>
<mxCell id="acc-e-conv" edge="1" parent="1" source="HigBPHvGvvlsroYYhkdi-3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#b85450;dashed=1;fontColor=#b85450;" target="acc-tool" value="contact identity<br>(X-Libredesk-Contact-*<br>headers, added by<br>LibreDesk, not the LLM)">
<mxGeometry relative="1" x="-0.1837" as="geometry">
<mxPoint as="offset" />
<Array as="points">
<mxPoint x="40" y="260" />
<mxPoint x="40" y="448" />
</Array>
</mxGeometry>
</mxCell>
<mxCell id="acc-svc" parent="1" style="rounded=1;arcSize=3;whiteSpace=wrap;html=1;verticalAlign=top;align=left;spacingLeft=8;fontStyle=1;fillColor=#fdf3f2;strokeColor=#b85450;dashed=1;strokeWidth=2;" value="Access service (independent container)" vertex="1">
<mxGeometry height="330" width="465" x="-390" y="740" as="geometry" />
</mxCell>
<mxCell id="acc-api" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;dashed=1;strokeWidth=2;" value="<b>REST API</b><br>GET /customer/access (identity from the headers)<br>→ projects the customer may see: project, serial, role" vertex="1">
<mxGeometry height="80" width="425" x="-370" y="780" as="geometry" />
</mxCell>
<mxCell id="acc-lookup" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;dashed=1;strokeWidth=2;" value="<b>Rights lookup</b><br>contact e-mail → dashboard account (auth0|…)<br>→ its UserGroups (user / dev_admin) → Device.serial_number<br>unknown contact → empty list" vertex="1">
<mxGeometry height="150" width="425" x="-370" y="890" as="geometry" />
</mxCell>
<mxCell id="acc-e-api" edge="1" parent="1" source="acc-api" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#b85450;dashed=1;fontColor=#b85450;strokeWidth=2;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="acc-lookup" value="">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="acc-auth0" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" value="<b>utilisateurs.json</b><br>e-mail → auth0|…<br>exported once from Auth0" vertex="1">
<mxGeometry height="70" width="200" x="-390" y="1190" as="geometry" />
</mxCell>
<mxCell id="acc-db" parent="1" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=10;fillColor=#f8cecc;strokeColor=#b85450;" value="<b>Access rights</b> (dashboard DB)<br><b>UserGroupEntry</b>: user → UserGroup<br><b>UserGroup</b>: device × role (user · dev_admin)<br><b>Device</b>.serial_number (1..n per serial)" vertex="1">
<mxGeometry height="120" width="245" x="-170" y="1165" as="geometry" />
</mxCell>
<mxCell id="acc-e-auth0" edge="1" parent="1" source="acc-lookup" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#b85450;dashed=1;fontColor=#b85450;exitX=0.2;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="acc-auth0" value="e-mail → auth0|…">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="acc-e-db" edge="1" parent="1" source="acc-lookup" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#b85450;dashed=1;fontColor=#b85450;exitX=0.75;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="acc-db" value="read-only">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="acc-e-tool" edge="1" parent="1" source="acc-tool" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#b85450;dashed=1;fontColor=#b85450;strokeWidth=2;exitX=0;exitY=0.75;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="acc-api" value="HTTP GET<br>+ identity headers">
<mxGeometry relative="1" as="geometry">
<Array as="points">
<mxPoint x="100" y="478" />
<mxPoint x="100" y="660" />
<mxPoint x="-157" y="660" />
</Array>
</mxGeometry>
</mxCell>
<mxCell id="acc-e-check" edge="1" parent="1" source="acc-check" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#b85450;dashed=1;fontColor=#b85450;exitX=0;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" target="acc-api" value="re-check:<br>the LLM cannot<br>widen access">
<mxGeometry relative="1" as="geometry" />
</mxCell>
2026-11-16 09:55:48 +01:00
<mxCell id="fix-7" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;dashed=1;strokeWidth=2;" value="<b>Detectors</b><br>visibility · obstruction · target issue<br>thermal · no data · displacement<br>→ classified events" vertex="1">
2026-11-18 13:50:31 +01:00
<mxGeometry height="80" width="360" x="135" y="975" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
<mxCell id="fix-8" parent="1" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=10;fillColor=#d5e8d4;strokeColor=#82b366;" value="<b>Station data</b> (AIMsight platform)" vertex="1">
2026-11-18 07:17:07 +01:00
<mxGeometry height="70" width="360" x="135" y="1190" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 13:50:31 +01:00
<mxCell id="fix-10" edge="1" parent="1" source="arch-13" style="rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#d79b00;strokeWidth=2;dashed=1;fontColor=#b36b00;edgeStyle=orthogonalEdgeStyle;" target="fix-6" value="7. HTTP GET (serial, from, to)<br>+ identity headers">
2026-11-18 07:17:07 +01:00
<mxGeometry relative="1" x="0.1306" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 13:50:31 +01:00
<mxCell id="fix-11" edge="1" parent="1" source="fix-6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#d79b00;strokeWidth=2;dashed=1;fontColor=#b36b00;exitX=0.500;exitY=1.000;exitDx=0;exitDy=0;entryX=0.500;entryY=0.000;entryDx=0;entryDy=0;" target="acc-check" value="">
2026-11-16 09:55:48 +01:00
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="fix-12" edge="1" parent="1" source="fix-7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#d79b00;strokeWidth=2;dashed=1;fontColor=#b36b00;exitX=0.500;exitY=1.000;exitDx=0;exitDy=0;entryX=0.500;entryY=0.000;entryDx=0;entryDy=0;" target="fix-8" value="reads the range (read-only)">
<mxGeometry relative="1" as="geometry" />
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-boundary" edge="1" parent="1" style="endArrow=none;html=1;rounded=0;dashed=1;dashPattern=8 4;strokeColor=#999999;strokeWidth=1;" value="">
2026-11-16 09:55:48 +01:00
<mxGeometry relative="1" as="geometry">
2026-11-18 13:50:31 +01:00
<mxPoint x="-400" y="680" as="sourcePoint" />
2026-11-18 07:17:07 +01:00
<mxPoint x="1380" y="680" as="targetPoint" />
2026-11-16 09:55:48 +01:00
</mxGeometry>
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-boundary-lbl" parent="1" style="text;html=1;align=right;verticalAlign=bottom;whiteSpace=wrap;fontColor=#666666;fontSize=11;" value="<b>HTTP / JSON boundary</b><br>below: independent containers, deployable and reusable on their own" vertex="1">
<mxGeometry height="40" width="380" x="1000" y="638" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="9YVmYg31Dtc29ZtFE1oE-8" edge="1" parent="1" source="9YVmYg31Dtc29ZtFE1oE-6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#9673a6;strokeWidth=2;dashed=1;fontColor=#7a4f8f;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="gen-6" value="HTTP (params)">
<mxGeometry relative="1" x="0.1306" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="9YVmYg31Dtc29ZtFE1oE-6" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=light-dark(#9673a6, #d2bbdd);dashed=1;strokeWidth=2;" value="<b>other_tool(params)</b><br>any other capability, same mechanism<br><i>e.g. get_contract(customer_id)</i>" vertex="1">
<mxGeometry height="75" width="280" x="575" y="510" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-5" parent="1" style="rounded=1;arcSize=3;whiteSpace=wrap;html=1;verticalAlign=top;align=left;spacingLeft=8;fontStyle=1;fillColor=#faf6fc;strokeColor=#9673a6;dashed=1;strokeWidth=2;" value="Other service (independent container)" vertex="1">
<mxGeometry height="330" width="340" x="545" y="740" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-6" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;dashed=1;strokeWidth=2;" value="<b>REST API</b><br>GET /{resource}/{id}?…<br>→ structured JSON" vertex="1">
<mxGeometry height="80" width="300" x="565" y="780" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-7" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;dashed=1;strokeWidth=2;" value="<b>Domain logic</b><br>rules · models · computations<br>owned by the service, not by the LLM<br>→ structured result" vertex="1">
<mxGeometry height="150" width="300" x="565" y="890" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-8" parent="1" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=10;fillColor=#f5f5f5;strokeColor=#666666;" value="<b>Domain data</b> (DB, CRM, ERP, …)" vertex="1">
<mxGeometry height="70" width="300" x="565" y="1190" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-11" edge="1" parent="1" source="gen-6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#9673a6;strokeWidth=2;dashed=1;fontColor=#7a4f8f;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="gen-7" value="">
<mxGeometry relative="1" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-12" edge="1" parent="1" source="gen-7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#9673a6;strokeWidth=2;dashed=1;fontColor=#7a4f8f;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="gen-8" value="data access">
<mxGeometry relative="1" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-host" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#999999;dashed=1;fontColor=#666666;" value="<b>Other host app</b><br><i>e.g. sales agent</i><br>own LLM + own tools,<br>calls the same services" vertex="1">
<mxGeometry height="80" width="200" x="960" y="780" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 07:17:07 +01:00
<mxCell id="gen-host-edge" edge="1" parent="1" source="gen-host" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;labelBackgroundColor=#ffffff;endArrow=classic;strokeColor=#999999;dashed=1;fontColor=#666666;exitX=0;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" target="gen-6" value="HTTP">
<mxGeometry relative="1" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
2026-11-18 13:50:31 +01:00
<mxCell id="gen-legend" parent="1" style="shape=note;whiteSpace=wrap;html=1;size=14;align=left;verticalAlign=top;spacingLeft=10;spacingTop=6;spacingRight=8;fillColor=#fff2cc;strokeColor=#d6b656;" value="<b style="font-size:13px">Reusable mechanism</b><br><br><b>1. Host app</b> (here LibreDesk) triggers an action and sends context + tool list to the LLM.<br><b>2. Tool</b> = name + JSON schema + thin HTTP adapter. No business logic in the host.<br><b>3. Independent service</b> = container exposing a REST API; owns its domain logic and its data access, returns structured JSON.<br><b>4.</b> The LLM turns the tool result into the output (here a draft reviewed by a human).<br><b>5. Access</b>: on Generate reply the LLM first calls get_customer_access; LibreDesk adds the contact identity (headers), the access service returns the stations the customer may read (Auth0 export + UserGroup, the dashboard's rule). Each data service checks again with the same headers.<br><br>New capability = one service + one tool declaration.<br>Same pattern for another host app (sales agent: CRM, quotes, stock…).<br><br><b>Legend</b><br><span style="color:#6c8ebf">■</span> existing LibreDesk<br><span style="color:#d79b00">■</span> dashed orange: this use case (planned)<br><span style="color:#b85450">■</span> red: access rights (planned)<br><span style="color:#9673a6">■</span> dashed purple: any other service, plugged the same way<br><span style="color:#999999">■</span> dashed grey: other consumers of the services" vertex="1">
<mxGeometry height="450" width="380" x="1000" y="160" as="geometry" />
2026-11-16 09:55:48 +01:00
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>