%% FF For Future — End-to-End Architecture (HAPPI/1.1)
%% Render: https://mermaid.live (paste this block) or `mmdc -i architecture.mmd -o architecture.svg`

flowchart TD
    subgraph User["👤 Analyser (Sepolia EOA)"]
        OPER[V>> / Rob / future analyst]
    end

    subgraph DApp["🎨 Front-end / CLI"]
        CLI["happi.md run<br/>cmd: rwa.analyse"]
    end

    subgraph HAPPI["🛰 HAPPI/1.1 Envelope (NDJSON event stream)"]
        ENV["{<br/>  v: 'happi/1.1',<br/>  cmd: 'rwa.analyse',<br/>  flags: { token, deal, model, ... }<br/>}"]
    end

    subgraph Handler["🤖 GRIP / HAL handler (handler/rwa_analyse.py)"]
        VALID[validate envelope]
        READ[read data CID from contract]
        FETCH[fetch borrower JSON via IPFS gateway]
        COUNCIL["HAL council<br/>(Claude + Gemini + Devil's Advocate)"]
        STAMP[stamp IDR provenance<br/>data_cid · model · deal · envelope_id]
        PIN[pin IDR to Pinata]
        ANCHOR[setIdrCid via web3<br/>updateRecord on contract]
    end

    subgraph Chain["⛓ Sepolia Testnet"]
        CONTRACT["FinancialDataRegistry.sol<br/>publishRecord / updateRecord<br/>getCID / getRecord / getAllRecordIds"]
        DATAREC["data:thornfields-2026-q1<br/>cid = bafkreig...<br/>version: 1"]
        IDR1["idr:thornfields-2026-q1:claude-3.5<br/>cid = bafy-idr-1<br/>version: 1"]
        IDR2["idr:thornfields-2026-q1:gemini-1.5-pro<br/>cid = bafy-idr-2<br/>version: 1<br/>(replay run — different verdict)"]
    end

    subgraph IPFS["🌐 IPFS (content-addressed)"]
        DATAFILE[("data CID<br/>borrower JSON<br/>Thornfields Capital AG")]
        IDRFILE1[("IDR CID — Claude<br/>intent · data · reasoning · decision · outcome")]
        IDRFILE2[("IDR CID — Gemini<br/>(replay disagreement)")]
    end

    OPER --> CLI
    CLI --> ENV
    ENV --> VALID
    VALID --> READ
    READ -->|getCID record_id| CONTRACT
    CONTRACT --> DATAREC
    DATAREC -->|cid| FETCH
    FETCH -->|HTTP GET /ipfs/cid| DATAFILE
    DATAFILE -->|JSON| COUNCIL
    COUNCIL -->|completed event<br/>+ IDR payload| STAMP
    STAMP --> PIN
    PIN -->|POST /pinning/pinFileToIPFS| IDRFILE1
    IDRFILE1 -->|cid| ANCHOR
    ANCHOR -->|updateRecord IDR_KEY,cid| CONTRACT
    CONTRACT --> IDR1

    %% Replay path — second model, same data
    COUNCIL -.->|model=gemini-1.5-pro| STAMP
    STAMP -.-> PIN
    PIN -.-> IDRFILE2
    IDRFILE2 -.-> ANCHOR
    ANCHOR -.-> IDR2

    %% Verification path — any third party with Sepolia RPC
    THIRD["🧐 Third-party verifier<br/>(investor / auditor / regulator)"]
    THIRD -->|getAllRecordIds| CONTRACT
    THIRD -->|getCID for each id| CONTRACT
    THIRD -->|fetch from IPFS<br/>compare IDRs| IPFS

    classDef writeCall fill:#ffeaa7,stroke:#fdcb6e,stroke-width:2px;
    classDef readCall fill:#dfe6e9,stroke:#b2bec3,stroke-width:1px;
    classDef chain fill:#74b9ff,stroke:#0984e3,color:#fff,stroke-width:2px;
    classDef ipfs fill:#a29bfe,stroke:#6c5ce7,color:#fff,stroke-width:2px;

    class READ,FETCH readCall;
    class ANCHOR,PIN writeCall;
    class CONTRACT,DATAREC,IDR1,IDR2 chain;
    class DATAFILE,IDRFILE1,IDRFILE2 ipfs;