Skip to content

Global calendar ​

The most important part. Everything time-bound is an event on one global calendar. Each user sees a filtered view of it. The calendar is tied to outputs: if it is not on the calendar, nobody will do it.

Event types declare who can see them ​

event_type is a table (owner-editable in Settings), not an enum in code:

FieldMeaning
key, label, colour, iconDisplay
visible_toRoles that can ever see this type
scopeWhich events of this type a viewer sees: all, assigned_crew (crew assigned to the event's client/video), own_client (the client business it belongs to), own_sales (the salesperson who owns the lead)
client_visible_fieldsWhat a client sees (internal notes, crew names, lead links are always redacted for clients)
generatedTrue if the system creates/moves it from a rule (Content schedule) rather than a person

Clarification (spec 1.0.0 notes)

The scope list above has no value for "own" rows such as payday and personal unavailability, which belong to one user. The code adds own_user for them. Seed data: packages/domain/src/events.ts.

Starting event types:

TypeOwnerSalesVideographerEditorClient
Discovery call (booked from the form)✓own
Shoot day✓assignedassignedown
Script delivery (shoot − 4 days)✓assignedassignedown
Script approval / change deadline (shoot − 3 days)✓assignedown
Footage hand-off (videographer → editor)✓assignedassigned
Edit due✓assigned
Internal review due✓assignedassigned
Release to client✓assignedassignedown
Client review deadline (release + 2 days)✓assignedassignedown
Approved / success marker✓assignedassignedown
Posting date✓own
Payday / payout✓ownownown
Contract renewal✓own
Client's own to-do items with a dateown
Personal / unavailable (crew)✓ownown

Calendar behaviour ​

  • Views: month, week, agenda (list). Agenda is the default on phones.
  • An event can link to a client, a lead, a video and several assignees at once.
  • Generated events move with their anchor: move the shoot day and its script-delivery and approval-deadline events move too. Manually edited generated events are marked "overridden" and stop following the rule.
  • Owner can drag to reschedule. Clients and crew cannot move events; they can only see them (and crew can mark unavailable days).
  • When an event is created or moved, every affected user gets an in-app notification and an email (Notifications and jobs).
  • Optional later: iCal feed per user (read-only, token URL).

Internal documentation. Not for clients.