66 lines
950 B
Markdown
66 lines
950 B
Markdown
# Website Data Flow (Strict)
|
|
|
|
This document defines the **apps/website** data flow.
|
|
|
|
Authoritative contract: [`docs/architecture/website/WEBSITE_CONTRACT.md`](docs/architecture/website/WEBSITE_CONTRACT.md:1).
|
|
|
|
Website scope:
|
|
|
|
- `apps/website/**`
|
|
|
|
## 1) Website role
|
|
|
|
The website is a **delivery layer**.
|
|
|
|
It renders truth from the API and forwards user intent to the API.
|
|
|
|
## 2) Read flow
|
|
|
|
```text
|
|
RSC page.tsx
|
|
↓
|
|
PageQuery
|
|
↓
|
|
API client (infra)
|
|
↓
|
|
API Transport DTO
|
|
↓
|
|
Page DTO
|
|
↓
|
|
Presenter (client)
|
|
↓
|
|
ViewModel (optional)
|
|
↓
|
|
Presenter (client)
|
|
↓
|
|
ViewData
|
|
↓
|
|
Template
|
|
```
|
|
|
|
## 3) Write flow
|
|
|
|
All writes enter through **Server Actions**.
|
|
|
|
```text
|
|
User intent
|
|
↓
|
|
Server Action
|
|
↓
|
|
Command Model / Request DTO
|
|
↓
|
|
API
|
|
↓
|
|
Revalidation
|
|
↓
|
|
RSC reload
|
|
```
|
|
|
|
## 4) Non-negotiable rules
|
|
|
|
1. Templates accept ViewData only.
|
|
2. Page Queries do not format.
|
|
3. Presenters do not call the API.
|
|
4. Client state is UI-only.
|
|
|