add docs

docs/architecture.md

@@ -0,0 +1,28 @@
+# Obsero System Architecture
+
+## Components
+
+- Probe: Performs observations and signs data.
+- IPFS Node: Stores full proofs.
+- Smart Contract: Anchors proof hashes and CIDs.
+- Blockchain: Publicly verifiable ledger.
+- Explorer/Client: Visualization and validation of proofs.
+
+## Workflow
+
+1. Probe observes service and creates JSON proof.
+2. Probe signs and uploads proof to IPFS.
+3. Proof hash and CID are submitted on-chain.
+4. Public verification of data integrity is possible.
+
+## Diagram
+
+```mermaid
+flowchart TD
+    A[Observer Probe] --> B[Ping Target]
+    B --> C[Generate JSON Observation]
+    C --> D[Hash and Sign Observation]
+    D --> E[Upload JSON to IPFS]
+    E --> F[Submit Hash and CID to Smart Contract]
+    F --> G[Proof Publicly Verifiable]
+```