view data fixes

docs/architecture/website/WEBSITE_DATA_FLOW.md

@@ -28,16 +28,29 @@ API Transport DTO
   ↓
 ViewData Builder (lib/builders/view-data/)
   ↓
-ViewData
+ViewData (Plain JSON)
   ↓
 Template
 ```
 
-### Client Components
+### Client Components (Hydration / Interactive)
+```text
+Client Wrapper / Component
+  ↓
+ViewData (from Props)
+  ↓
+ViewModel (lib/view-models/) -- [new ViewModel(viewData)]
+  ↓
+Display Objects (lib/display-objects/) -- [formatting]
+  ↓
+Interactive UI State
+```
+
+### Client Components (Direct Fetch)
 ```text
 Client Component
   ↓
-API client (useEffect)
+API client (useEffect / useQuery)
   ↓
 API Transport DTO
   ↓