Tasks

Tasks are the workhorse unit of operations: title, description, assignee, due date, priority, status, optional checklist, optional time estimate. They can stand alone (personal tasks) or attach to a Project, Customer, Ticket, or Contract. Sub-tasks and checklist items satisfy the most common single-level decomposition without forcing an explicit hierarchy. Recurring tasks (daily / weekly / monthly) are a separate schedule that stamps a fresh task on each cycle.

Time tracking is integrated: any task can start a timer that writes a Time Entry row when stopped, which feeds project billing and the staff timesheet.

Related endpoints

• GET /api/tenant/tasks — list with assignee, status, due-date filters.
• POST /api/tenant/tasks — create.
• PATCH /api/tenant/tasks/:id — update fields (status, assignee, due date).
• POST /api/tenant/tasks/:id/timer/start — start time tracking.
• POST /api/tenant/tasks/:id/timer/stop — stop and persist.
• GET /api/tenant/tasks/recurring — list recurring schedules.

See the source at apps/web/src/app/(tenant)/tasks and apps/api/src/tasks.