sys design: organizing and add diagram

specification/docs/system-design/system-design.md

@@ -1,3 +1,36 @@
+# System Design
+
+```mermaid
+flowchart TD
+    Homeserver[Matrix\nHomeserver]
+    Contracts <-- Node.js blockchain\nclient library (ethers) --> API
+    Contracts <-- Web-based blockchain client library\n(MetaMask / Casper Wallet)--> WebApp
+    Contracts <-- Web-based blockchain client library\n(MetaMask / Casper Wallet)--> Widget
+    WebApp <-- HTTPS --> API
+    Widget <-- HTTPS --> API
+    Widget <-- Element-web Widget API\n(npm matrix-widget-api) --> Homeserver
+    API <-- Matrix Client-Server Protocol\n(npm matrix-bot-sdk) --> Homeserver
+```
+
+
+Topics
+
+- Contracts
+- Web Client
+- Widget
+- API / Staking Client
+    - API
+        - Read
+        - Write
+        - Import from Semantic Scholar
+        - Import from Matrix
+    - Event handlers
+        - Validation Pool
+        - Register Matrix Identity
+        - On-chain Direct Pool
+        - Rollup
+        - Bot Commands
+
 ## Contracts
 
 In the [Requirements](./requirements.md) section, we identified the following smart contracts:
@@ -26,3 +59,6 @@ The Rollup Post can weight authorship in accordance with the off-chain Validatio
 
 To address the need for coordination of off-chain Posts and Validation Pools, we introduce Matrix. [Matrix](matrix.org) is a messaging protocol, and it has multiple implementations. Our prototype uses Synapse as the Homeserver. Our system communicates with the Homeserver using the Client-Server protocol.
 
+## Element-web Widget
+
+

specification/mkdocs.yml

@@ -18,5 +18,13 @@ nav:
   - Overview: index.md
   - Terminology: terminology.md
   - Requirements: requirements.md
-  - System Design: system-design.md
-  - Implementation: implementation.md
+  - System Design:
+      - Overview: system-design/system-design.md
+      - Contracts:
+          - Reputation: system-design/contracts/reputation.md
+          - Bench: system-design/contracts/bench.md
+          - Work: system-design/contracts/work.md
+          - Proposal: system-design/contracts/proposal.md
+          - Forum: system-design/contracts/Forum.md
+          - Rollup: system-design/contracts/rollup.md
+  - Implementation: system-design/implementation.md