Initial commit: YouTube Studio Flow (backend, frontend, infrastructure, docs)

2026-08-11 12:27:44 +02:00
commit d5af006443
304 changed files with 74604 additions and 0 deletions
@@ -0,0 +1,24 @@
+# Calendar
+
+## User Perspective
+The Content Calendar (`/calendar`) visualizes scheduled and published videos on a calendar grid. The UI exposes two views: **Month** and **Agenda** (next 30 days). A week view exists at the API level but is not surfaced in the frontend.
+
+Each entry shows:
+- Video title
+- Scheduled/published date
+- Template name
+- Assigned collaborators
+- Lint status
+- Privacy status
+
+## Developer Perspective
+
+### Backend
+- **Module**: `backend/src/modules/calendar/`
+- **Endpoint**: `GET /calendar?view=month|week|agenda&date=YYYY-MM`
+- Returns videos where `scheduledAt` OR `publishedAt` falls within the computed date range
+- For `agenda` view: next 30 days from the given date
+- For `week` view: the week containing day 1 of the given month. **Known limitation:** the `date` param is `YYYY-MM` (no day), so the week view always anchors to the first of the month — arbitrary week navigation is not possible at the API level. The frontend does not expose this view.
+
+## Related
+- [[12 - Calendar API]]