RCOSDP · chiku-samugari · Jun 30, 2026 · Jul 11, 2026
diff --git a/StorageAddon/README.md b/StorageAddon/README.md
diff --git a/StorageAddon/images/architecture.mmd b/StorageAddon/images/architecture.mmd
@@ -0,0 +1,13 @@
+flowchart LR
+    subgraph PLUGIN["nextcloud_plugin（単一の Python パッケージ）"]
+        direction TB
+        A["addon<br/>(osf.io アドオン)"]
+        I["addon_imp<br/>(GravyValet Addon Imp)"]
+        P["provider<br/>(WaterButler Provider)"]
+    end
+    FE["angular-osf<br/>(フロントエンド)"] --> OSF[("osf.io")]
+    FE --> GV[("GravyValet")]
+    FE --> WB[("WaterButler")]
+    A -. "pip install" .-> OSF
+    I -. "poetry install" .-> GV
+    P -. "poetry install" .-> WB
diff --git a/StorageAddon/images/architecture.png b/StorageAddon/images/architecture.png
diff --git a/StorageAddon/images/crud.png b/StorageAddon/images/crud.png
diff --git a/StorageAddon/images/crud.uml b/StorageAddon/images/crud.uml
diff --git a/StorageAddon/images/delegation.mmd b/StorageAddon/images/delegation.mmd
@@ -0,0 +1,14 @@
+sequenceDiagram
+    participant FE as angular-osf
+    participant OSF as osf.io
+    participant GV as GravyValet
+    participant WB as WaterButler
+    participant NC as NextCloud
+    FE->>OSF: ファイル操作要求（provider = nextcloud）
+    OSF->>GV: 認証情報・設定を要求（wb_key = nextcloud）
+    Note over GV: Addon Imp の build_wb_config() が settings を生成し、<br/>認証アカウントから credentials を取得
+    GV-->>OSF: credentials ＋ settings
+    OSF->>WB: make_provider(credentials, settings)
+    WB->>NC: WebDAV でアクセス（CRUD）
+    NC-->>WB: 応答
+    WB-->>FE: 応答
diff --git a/StorageAddon/images/delegation.png b/StorageAddon/images/delegation.png
diff --git a/StorageAddon/images/gravyvalet-add-external-storage-service.png b/StorageAddon/images/gravyvalet-add-external-storage-service.png
diff --git a/StorageAddon/images/naming.mmd b/StorageAddon/images/naming.mmd
@@ -0,0 +1,8 @@
+flowchart TB
+    KEY(["識別名 canonical key = nextcloud"])
+    KEY --> SN["osf.io アドオン<br/>short_name = nextcloud"]
+    KEY --> PV["osf.io アドオン<br/>_provider = nextcloud"]
+    KEY --> WK["GravyValet<br/>wb_key = nextcloud"]
+    KEY --> AI["GravyValet<br/>addon_imp_name = NEXTCLOUD<br/>.lower() = nextcloud"]
+    KEY --> EP["WaterButler<br/>エントリポイント名 = nextcloud"]
+    KEY --> LB["osf.io アドオン<br/>label / app_label = addons_nextcloud"]
diff --git a/StorageAddon/images/naming.png b/StorageAddon/images/naming.png
diff --git a/StorageAddon/images/osf_class.png b/StorageAddon/images/osf_class.png
diff --git a/StorageAddon/images/osf_class.uml b/StorageAddon/images/osf_class.uml
diff --git a/StorageAddon/images/proxy-routing.mmd b/StorageAddon/images/proxy-routing.mmd
@@ -0,0 +1,7 @@
+flowchart LR
+    B["ブラウザ<br/>http://localhost"] --> C{{"Caddy<br/>単一オリジン<br/>リバースプロキシ"}}
+    C -->|"/v2, /_/"| API[("osf.io API<br/>:8000")]
+    C -->|"/v1/resources/*"| WB[("WaterButler<br/>:7777")]
+    C -->|"/v1, /static/*/icons"| GV[("GravyValet<br/>:8004")]
+    C -->|"/login /logout /oauth /api/v1 /download"| CAS[("osf.io web/CAS<br/>:5000")]
+    C -->|"上記以外すべて"| NG[("angular-osf<br/>:4200")]
diff --git a/StorageAddon/images/proxy-routing.png b/StorageAddon/images/proxy-routing.png
diff --git a/StorageAddon/images/wb_class.png b/StorageAddon/images/wb_class.png
diff --git a/StorageAddon/images/wb_class.uml b/StorageAddon/images/wb_class.uml
diff --git a/StorageAddon/osf.io/addon/__init__.py b/StorageAddon/osf.io/addon/__init__.py
diff --git a/StorageAddon/osf.io/addon/apps.py b/StorageAddon/osf.io/addon/apps.py
diff --git a/StorageAddon/osf.io/addon/migrations/__init__.py b/StorageAddon/osf.io/addon/migrations/__init__.py