> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md).

# Task timeline

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/housekeeping/timeline.md).
{% endhint %}

The day's housekeeping tasks on each staff member's timeline, next to the unassigned ones; managers assign, move, unassign, reset and create tasks here.

![Task timeline](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-dd2ee0bee558abfd0faa40b379852b19809fa287%2Ftimeline.png?alt=media)

* **Where:** web `/housekeeping`, "Timeline" tab (the page and its tabs are described on [Staff schedule](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/schedule.md)). iOS: the Plan tab's "Housekeeping" chip, or the side menu item "Housekeeping" ([Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md)). Android: the Plan tab's "Housekeeping" chip, or the side menu item "Housekeeping"; the Fix tab reopens the screen when it was the last Fix page used. On iOS and Android the screen opens on its Assigned tab.
* **Who:** site admins. Web: role "Admin" on the site, with housekeeping on and no multi-site selected; others are sent to `/fix`. iOS: account admins, when the site has housekeeping on. Android: account admins, when a building of the site has housekeeping on. Other users do not see the entries. On iOS the chip also shows inside a group's Planned Tasks for account admins.
* **Feature:** [Assigning housekeeping tasks](https://docs.snapfix.com/product/features/housekeeping/housekeeping-assignment.md); the tasks are [cleaning tasks](https://docs.snapfix.com/product/features/housekeeping/cleaning-tasks.md) and [inspections](https://docs.snapfix.com/product/features/housekeeping/inspections.md)

The rules differ by platform; see [Platform differences](#platform-differences). The tasks themselves open in [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md).

## Layout

### Web

1. **Header.** "Today's Schedule", then "Reset All", "Bulk Actions", "Auto Assign Tasks" (it reads "Reassign Tasks" when no task is unassigned and some are on the timeline), a round "+", an expand icon and a print icon. The header is the same on all three tabs, but "Reset All", "Bulk Actions" and "Auto Assign Tasks" work only on this tab. In bulk mode the header is replaced by the bulk bar; see [Header and bulk actions](#header-and-bulk-actions-web).
2. **Filter banner.** Lists the active filters, on this tab only and only when a filter is set.
3. **Timeline bar.** The "Search" box; an info icon with the legend, "Task Status" ("Task not started", "In Progress", "Completed") and "Task Type" (the site's clean types and their sub types); the scale control ("Zoom out", the "Time Scale" menu, "Zoom in"); the filter button; and the tabs.
4. **Left panel.** The heading "Task Timeline", and the people under the role dividers "Both (Inspector & Housekeeper)", "Self Checker", "Inspector", "Housekeeper", "House Person" and "HK Maintenance". A divider with nobody under it is not shown. Each row shows the avatar, the name, a red count of the person's tasks outside their working hours, and, when the person has red tasks, an "Actions" menu with one item, "Reset Tasks". "Add Staff" sits under the rows; it switches to the [Staff schedule](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/schedule.md) with a new row.
5. **Right panel.** A ruler of hours, labelled like "12.10" and "13.00". It starts an hour before the earliest working time or task and ends an hour after the latest, within 00.00 to 24.00. Today's tasks are cards placed by their start and end times. A vertical line marks the current time, updated every minute; when the tab opens, the timeline scrolls to it.
6. **Task card.** A status bar (red, amber or green), the room name, the "Occupied" and "Arrival" icons when they apply, and a star with "1" or "2" when a priority is set.
7. **Task list.** Below the timeline, and below the other two tabs too; hidden while the timeline is expanded. The tabs are "All Tasks", "Housekeeping Tasks" (the default) and "Other Tasks". Cards load 50 at a time as you scroll. "Drag here" shows while a task hovers over the list. "All tasks have been assigned to staff" shows when the list is empty.

### iOS

1. **Plan page.** The planner's top bar, trial banner and chip row sit above the screen. The embedded screen's own title, "Today's housekeeping", belongs to its view controller; the page shows the planner's bar.
2. **Header.** "Today's Works", with a filter button. The "+" in the top bar opens [Create Tasks](#create-tasks).
3. **Tabs.** "Assigned Task" and "Unassigned Tasks".
4. **Assigned tab.** A staff filter row: "All Staff", then each person with working hours that day. Below it the day as 15-minute slots, each listing the tasks that start in it and each a drop target. When the tab appears, it scrolls to the current slot. Pull down to refresh.
5. **Unassigned tab.** The filter tabs "All Tasks", "HK Tasks" and "Other Tasks", then the unassigned tasks, 10 per page. "No Tasks left" shows when the list is empty.

### Android

1. **Header.** "Todays Works" with a filter icon. The top bar "+" opens [Create Tasks](#create-tasks). A code comment says creating housekeeping tasks is disabled for now, but the line that would hide the "+" is commented out, so it shows \[[ASK-96](https://github.com/snapfix/docs/blob/main/ASK.md#ask-96-is-creating-housekeeping-tasks-meant-to-be-on-in-the-android-app)].
2. **Plan chips.** Only when the screen is opened from the Plan tab or the side menu: "Planned Tasks", "Asset registers", "Comply" and "Housekeeping".
3. **Tabs.** "Assigned Tasks" and "Unassigned Tasks". The pages do not swipe; use the tab row.
4. **Assigned tab.** A staff spinner with "All Staff", then the people with working hours that day. A switch between grid and list views. A 15-minute time grid of bookings, with the current slot marked, and swipe to refresh.
5. **Unassigned tab.** The filter tabs "All Tasks", "HK Tasks" and "Others Tasks", then the list. "No Tasks left." shows when it is empty.

## Inputs

### Filters

The web uses the shared filter drawer, titled "Filters", with the tabs "Snapfilters" and "Advanced" and the buttons "Clear Filters" and "Apply"; "Apply" is off until a filter changes. The apps use a "Filters" sheet with "Clear Filters" and "Apply".

| Field       | Type                                                                                                                                                                           | Required | Default              | Rules and messages                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | -------------------- | -------------------------------------------------------------------------------------------- |
| Status      | Web: "New Tasks", "Tasks In Progress", "Completed Task"; iOS: "New Tasks", "Tasks in progress", "Completed tasks"; Android: "New tasks", "Tasks in progress", "Completed Task" | No       | All three on the web | Limits the lists to those colours.                                                           |
| Room status | "Occupied", "Arrival"                                                                                                                                                          | No       | None                 | Limits the lists to rooms in those states.                                                   |
| Priority    | "1" and "2"                                                                                                                                                                    | No       | None                 | Limits the lists to those priorities.                                                        |
| Clean type  | The site's clean types; the web also lists the sub types                                                                                                                       | No       | None                 | The iOS section is "Cleaning Status"; the web and Android section is "Clean Type".           |
| Staff       | One or more people on the schedule                                                                                                                                             | No       | All                  | Web only, on the drawer's "Advanced" tab. The apps choose staff on the Assigned tab instead. |

* The filters apply to the timeline and the task list on the web, and to both tabs in the apps. The [Dashboard](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/dashboard.md), the Schedule tab and the task list under them ignore them.
* The choice is saved per site on each device: browser storage on the web, user defaults on iOS, and app preferences on Android.

### Staff picker (apps)

* **iOS:** the staff filter row on the Assigned tab. Choosing a person limits the tab to them; "All Staff" removes the limit.
* **Android:** the staff spinner on the Assigned tab, filled from the site's working hours for the day.

### Create Tasks

Web: the "Create Tasks" dialog from the header's "+". Apps: the "Create Tasks" sheet from the top bar's "+". Save creates one task per chosen room.

| Field                | Type                                     | Required                                                | Default                                                                                                     | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ---------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Task title           | Text                                     | Yes, for one room; hidden when several rooms are chosen | For one room, filled in as the room and the clean type until the user types                                 | Labels: "Task Title" (web), "Task title" (iOS), "Task name" (Android). Placeholder "Write a description..." on the web and iOS, "Write a description…" on Android. Web: up to 255 characters; more shows "Your input exceeds the maximum allowed length of 255 characters".                                                                                                                                           |
| Room Number          | One or more rooms                        | Yes                                                     | None                                                                                                        | Web: a paged list searched as you type, placeholder "Ex. 001", "No data available" when nothing matches. Up to 100 rooms: "You can select up to 100 rooms". With several rooms the field reads "{n} room(s) selected" and each room shows as a removable chip. Apps: a room picker that also takes several rooms.                                                                                                     |
| Clean Type           | One choice, "Select type"                | Yes                                                     | None                                                                                                        | The site's clean types. The clean type sets the default group, the roles that may take the task, and whether Allocate Time and Touch Up Clean Types appear. Opened and closed empty, the web field turns red with no message.                                                                                                                                                                                         |
| Touch Up Clean Types | One sub type, "Select type"              | Yes, when the clean type has sub types                  | None                                                                                                        | Only for clean types with sub types, such as Touch Up Clean.                                                                                                                                                                                                                                                                                                                                                          |
| Allocate Time        | "Hours" (0 to 2) and "Minutes" (0 to 59) | Yes, for clean types that allow a custom duration       | The clean type's default                                                                                    | Only for those clean types. Web: hours above 2 become 2, minutes become 0 at 2 hours, and the total must be at least 1 minute; the hint is "Maximum 2 hours". iOS: "Maximum allowed duration is 2 hours!" past the limit; 0 leaves the server's default. Android: "Maximum 2 hours"; 0 sends no duration. All three send the duration in seconds, which the server reads as seconds. The minimum differs by platform. |
| Priority             | Two stars ("Priority")                   | No                                                      | None                                                                                                        | One star is priority 1, two stars priority 2. Web: tap the chosen star again to clear it.                                                                                                                                                                                                                                                                                                                             |
| Status               | Display only: "Unoccupied" or "Occupied" | No                                                      | From the room, for one room                                                                                 | Not chosen by the user, and not sent. Hidden when several rooms are chosen.                                                                                                                                                                                                                                                                                                                                           |
| Group                | One group, "Select a group"              | Yes                                                     | From the first room's housekeeping rule: the inspection group for inspections, otherwise the cleaning group | Changes when the first room changes. The user can pick another group.                                                                                                                                                                                                                                                                                                                                                 |
| Assigned to          | One staff member, "Select"               | No                                                      | None                                                                                                        | Web: on once a room, a clean type and, for one room, a title are set; lists only scheduled staff whose role can take the clean type. Apps: on once a clean type is set; Android lists only staff whose roles can take it. The assignment is made after the tasks are created.                                                                                                                                         |

* Web and iOS keep Save off until the form is valid.
* Android keeps Save off until the required fields are filled, so its messages ("Please enter a task title", "Please select a clean type", "Please select a touch up clean type", "Please select a group") cannot show.

## Actions

### Drag and drop

Only red tasks (not started) can be moved, on every platform. The server also refuses a person whose role today does not fit the task, on every move.

| Action                                 | Who   | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | API                                                                                                                                                                     |
| -------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Move a task to a person and time (web) | Admin | Drag a red task from the list, or from another row, onto a row. The start is the 5-minute step under the pointer. The task moves at once and the change is sent. A drop in the past, or onto a role that cannot take the task, is ignored with no message. If the server refuses, the task goes back and the shared alert shows the server's message.                                                                                                                                                                                                                                                                                                              | [`POST /v1/app/housekeeping/reassignment/{uuid}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingreassignmentuuid)            |
| Move a clean's inspection (web)        | Admin | When a clean moves and its linked inspection would now start before the clean ends, the inspection is moved to start after the clean, within the inspector's working hours. Not when either person is a self-checker.                                                                                                                                                                                                                                                                                                                                                                                                                                              | As above                                                                                                                                                                |
| Unassign by dragging back (web)        | Admin | Drag a red task from a row onto the task list. The task loses its person.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | As above, with only `unassignUserUuid`                                                                                                                                  |
| Drop selected tasks on a row (web)     | Admin | In bulk mode, moves every selected task to that person from the drop time. Asks "Reassign Tasks?" first when some already have a person.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | [`POST /v1/app/housekeeping/bulk-reassignment-async`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingbulk-reassignment-async) |
| Move a task (iOS)                      | Admin | Drag a red task onto a slot or another task. The move shows at once; if the server refuses it, it is rolled back and an alert shows the server's message. A past slot shows "This time has already passed. You can only move the task to a later slot on today's schedule." Dropped on an empty part of a slot, a role that cannot take the task shows "This user's role is not allowed for this task type."; dropped onto another task, the server's message shows instead, an untranslated key. Working hours are not checked \[[ASK-95](https://github.com/snapfix/docs/blob/main/ASK.md#ask-95-should-tasks-be-placed-only-inside-the-persons-working-hours)]. | As above                                                                                                                                                                |
| Move a booking (Android)               | Admin | Drag a red booking to a slot. A past slot shows the same message as iOS. A slot outside the person's shifts shows an alert with the person's name, "is not working during this hour." and the day's shifts. If loading the shifts takes more than about 6 seconds, the move is cancelled with "Could not load working hours. Try again." A failed save shows "Could not save this change. Please try again."                                                                                                                                                                                                                                                       | As above                                                                                                                                                                |

### Task actions

| Action                                | Who   | What happens                                                                                                                                                          | API                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tap a task (web)                      | Admin | Opens the preview drawer on the right; see [Task preview](#task-preview-web). In bulk mode a tap selects the task instead.                                            | [`GET /v1/app/tasks/{uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v1apptasksuuid)                                                                                                                                                                                                                                                                                                                                                 |
| Tap a task (iOS)                      | Admin | Opens the task ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)). Repeat taps on the same task within 0.6 seconds are ignored. | None here                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Tap a booking (Android)               | Admin | Opens the task ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)).                                                              | None here                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Tap an unassigned task (iOS, Android) | Admin | Opens [Assign Task](#assign-task-apps).                                                                                                                               | [`POST /v1/app/housekeeping/working-hours/list`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingworking-hourslist), [`POST /v1/app/housekeeping/assigned-tasks/list`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingassigned-taskslist), then [reassignment](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingreassignmentuuid) |

Inside a housekeeping task on iOS and Android, people can snooze it ("Snooze Task", with "DND - Do Not Disturb", "NSR - No Service Required" or another reason), pick its start time (on iOS in 5-minute steps) and reject an inspection; these are in [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#approval-and-housekeeping). What a snooze does to the start time differs between iOS and Android \[[ASK-90](https://github.com/snapfix/docs/blob/main/ASK.md#ask-90-what-should-a-dnd-or-other-snooze-do-to-the-tasks-time)].

### Header and bulk actions (web)

| Action                                                              | Who   | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                    | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search                                                              | Admin | Filters the rows by name or username, and on this tab also by room name, 1 second after the last key press. Nothing is sent to the server. A search with no match empties the timeline.                                                                                                                                                                                                                                                                         | None                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Scale menu, "Zoom in", "Zoom out", Ctrl or Cmd with the mouse wheel | Admin | Sets the minutes per column: "5 Minutes" to "50 Minutes" in steps of 5, or "1 Hour" (the default). The choice is saved as the user's preference for the site after 5 seconds without a change.                                                                                                                                                                                                                                                                  | [`PUT /v1/app/user/preferences`](https://docs.snapfix.com/engineering-reference/api/account.md#put-v1appuserpreferences); read with [`GET /v1/app/user/preferences`](https://docs.snapfix.com/engineering-reference/api/account.md#get-v1appuserpreferences)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Filter                                                              | Admin | Opens the filter drawer; see [Filters](#filters).                                                                                                                                                                                                                                                                                                                                                                                                               | The two lists below, with the filters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Bulk Actions                                                        | Admin | Turns on selection. Red tasks in the list and on the timeline get checkboxes. The header becomes a bar with the count and "Task Selected", "Unassign All", "Assign Tasks" (both off until a task is selected) and a close icon. The list shows "Select All Unassign Tasks".                                                                                                                                                                                     | None                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Unassign All                                                        | Admin | Unassigns the selected tasks that have a person. Results: "{n} Tasks successfully reset.", "{n} tasks reset, {m} failed. Review and retry failed tasks." or "Tasks reset failed. Please try again."                                                                                                                                                                                                                                                             | [`POST /v1/app/housekeeping/bulk-reset-async`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingbulk-reset-async), polled at [`GET /v1/app/housekeeping/bulk-actions/status/{taskId}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1apphousekeepingbulk-actionsstatustaskid) every 3 seconds                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Assign Tasks                                                        | Admin | Opens [Assigned Users](#assigned-users-web).                                                                                                                                                                                                                                                                                                                                                                                                                    | [`POST /v1/app/housekeeping/bulk-reassignment-async`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingbulk-reassignment-async), polled as above                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Auto Assign Tasks, or Reassign Tasks                                | Admin | Off when there is no task at all. With nobody on the schedule, opens [No Staff Available](#auto-assign-and-reset-web). When some tasks were placed by hand, asks first. The loader covers the page while the run goes on, and the page checks its status every 5 seconds. Results: "All tasks assigned to staff", or "Some tasks are still unassigned. All staff are fully booked for today." with "Add More Staff". On failure: "Failed to auto-assign tasks". | [`POST /v1/app/housekeeping/auto-assign-tasks-async`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingauto-assign-tasks-async), then [`GET /v1/app/housekeeping/auto-assign-tasks/status/{taskId}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1apphousekeepingauto-assign-tasksstatustaskid)                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Reset All                                                           | Admin | Confirms, then resets the day's red assigned tasks of everyone on the schedule. Off the Timeline tab, or with no red assigned task, it looks disabled and does nothing, but it is not marked disabled.                                                                                                                                                                                                                                                          | [`GET /v1/app/housekeeping/reset-tasks-async/{parentUuid}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1apphousekeepingreset-tasks-asyncparentuuid), polled at bulk-actions/status                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Reset Tasks (a person's "Actions" menu)                             | Admin | Confirms, then resets that person's red tasks.                                                                                                                                                                                                                                                                                                                                                                                                                  | [`GET /v1/app/housekeeping/reset-user-tasks-async/{userUuid}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1apphousekeepingreset-user-tasks-asyncuseruuid), polled as above                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| "+"                                                                 | Admin | Opens [Create Tasks](#create-tasks), on any tab.                                                                                                                                                                                                                                                                                                                                                                                                                | [`GET /v1/app/housekeeping/manual-clean-types`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1apphousekeepingmanual-clean-types) for the clean types                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Save a new task                                                     | Admin | Creates the tasks, checks every 3 seconds until they exist (up to 5 minutes), then assigns them to the chosen person, if any. Web results: "Tasks created successfully", "Tasks created and assigned successfully" or "Task creation completed, but some assignments could not be completed." iOS: "Failed to create task" and "Failed to assign user". Android: "Task Created successfully…".                                                                  | [`POST /v1/app/housekeeping/manual-hk-task/bulk`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingmanual-hk-taskbulk), [`GET .../manual-hk-task/bulk/status/{taskId}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1apphousekeepingmanual-hk-taskbulkstatustaskid), [`POST /v1/app/housekeeping/bulk-reassignment-async`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingbulk-reassignment-async); the room search is [`POST /v1/app/rooms/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomslist) and the groups [`GET /v1/app/rooms/{uuid}/hk-businesses`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#get-v1approomsuuidhk-businesses) |
| Expand icon                                                         | Admin | Hides the task list so the timeline uses the space; the icon toggles back.                                                                                                                                                                                                                                                                                                                                                                                      | None                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Print icon                                                          | Admin | Builds the day's schedule report and opens it in a new tab when it is ready. It checks the report every 5 seconds, up to 6 times; if it is not ready, "Failed to generate report, please try again later."                                                                                                                                                                                                                                                      | `?action=user_tasks_schedule_report` and `?action=user_reports` on php-apis ([Reports API](https://docs.snapfix.com/engineering-reference/api/reports.md#post-actionuser_tasks_schedule_report))                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Refresh                                                             | Admin | Web: every 60 seconds while this tab is visible and auto-assign is not running, and on return to the browser tab after a minute or more. iOS: every 60 seconds, paused while dragging, and when a push says a task on the screen changed; pull to refresh. Android: every 60 seconds, and swipe to refresh.                                                                                                                                                     | The two lists below                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

The timeline reads [`POST /v1/app/housekeeping/assigned-tasks/list`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingassigned-taskslist) (the people's tasks) and the list [`POST /v1/app/housekeeping/tasks`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md#post-v1apphousekeepingtasks) (the unassigned tasks). Opening the tab loads both. On the QA site these calls took 1.5 to 2.8 seconds.

## States

* **Loading:** web: the page shows a skeleton until today's staff loads, then a spinner in the timeline and one in the task list until the tasks arrive. iOS: a spinner over the screen until the first tasks arrive. Android: the pull-to-refresh spinner, with the timeline hidden until the first answer.
* **Busy (web):** while a bulk action runs, "Bulk Actions", "Reset All" and the person menus are off and dragging is locked. The auto-assign loader shows five messages, such as "Calculating the perfect route. Your team's step-tracker will thank us.", changing every 10 seconds; it comes back after a reload while the run goes on. A bulk action that takes over 5 minutes shows "This is taking longer than expected. The timeline has been refreshed."; a failed one shows the server's error or "Something went wrong, please try again".
* **Empty:** web: nobody on today's schedule shows "Start Your Day" ([Staff schedule](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/schedule.md)); an empty task list shows "All tasks have been assigned to staff"; the timeline itself has no empty text. iOS: "No Tasks left" on the Unassigned tab, no text on the Assigned tab. Android: "No Tasks left." on the Unassigned tab.
* **Error:** web: a failed load shows the shared error alert, and the lists keep what they had. iOS: when no tasks are loaded, the server's message or "Failed to load tasks" shows in the middle of the screen. Android: a failed load shows the empty time slots and, when the server sent a message, the toast "Something went wrong. Please try again after sometime."
* **Refused moves:** see [Drag and drop](#drag-and-drop).
* **No permission:** as under **Who**.
* **Offline:** the web has no offline mode. iOS makes no offline check here; failed requests show the server's message. Android's requests return "You must be connected to the Internet to carry out this task. Please connect and try again." with no connection.

## Dialogs and sheets

### Task preview (web)

A drawer on the right, titled "Room - {room name}": the room card with the "Occupied" and "Arrival" icons, "Task details" with "Issue by", "Start Time" and "End Time", the checklist (view only) and the linked tasks. Tapping the room card or a linked task opens that task in a new browser tab when the user is in its group; otherwise "You're not a member of this group." shows.

### Assigned Users (web)

The bulk assign dialog: a search field, one choice per person on the schedule, "Cancel" and "Assign". "Assign" is on once a person is chosen. If some selected tasks already have staff, "Reassign Tasks?" asks first: "Some selected tasks are already assigned. Reassigning will replace the current assignees." with "Cancel" and "Confirm". The server picks the start times. Results: "{n} Tasks successfully reassigned.", "{n} tasks assigned, {m} failed. Review and retry failed tasks." or "Tasks reassigned failed. Please try again."

### Auto assign and reset (web)

* **No Staff Available:** "There are no staff members available to assign tasks. Please add staff to the schedule first." with "Add Staff" (opens the [Staff schedule](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/schedule.md) with a new row) and "Cancel".
* **Auto Assign Tasks:** when some tasks were placed by hand, "Do you want to auto-assign manually assigned tasks?" with "No" (they keep their staff) and "Yes" (they are reassigned too). Closing the dialog cancels.
* **Reset All Assigned Tasks?:** "You're about to reset all assigned tasks. This action cannot be undone.", or for one person "You're about to reset all assigned tasks for {name}. This action cannot be undone.", with "Cancel" and "Reset Tasks". The message says all assigned tasks, but only red tasks are reset.

### Assign Task (apps)

Tapping an unassigned task opens the "Assign Task" sheet. It lists the people with working hours that day whose role may take the task, with a "Search users" field. Choosing a person assigns the task at a free time (see [Platform differences](#platform-differences)). On Android an empty list shows "No users with working hours were found." A failed assignment shows its message, and the sheet stays open.

### Other sheets (apps)

* **Create Tasks:** the fields under [Create Tasks](#create-tasks), with a clean type picker, a room picker, a group picker and a staff picker for "Assigned to".
* **Filters:** see [Filters](#filters).
* **Alerts:** for refused or rolled-back moves, with "OK".

## Platform differences

| Topic                                                  | Web                                                                  | iOS                                                                                                                                           | Android                                                                                                                                                                                                          |
| ------------------------------------------------------ | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Layout                                                 | staff rows on an hour ruler, task list below                         | 15-minute slots for all staff, staff filter row                                                                                               | 15-minute grid or list, staff spinner                                                                                                                                                                            |
| Time steps                                             | drops snap to 5 minutes; 5 to 60 minutes per column                  | 15-minute slots                                                                                                                               | 15-minute slots                                                                                                                                                                                                  |
| Past time                                              | ignored, no message                                                  | alert                                                                                                                                         | alert                                                                                                                                                                                                            |
| Wrong role                                             | ignored, no message                                                  | alert on an empty part of a slot, else the server's message                                                                                   | not checked; the server refuses                                                                                                                                                                                  |
| Working hours on a move                                | not checked                                                          | not checked \[[ASK-95](https://github.com/snapfix/docs/blob/main/ASK.md#ask-95-should-tasks-be-placed-only-inside-the-persons-working-hours)] | refused outside a shift                                                                                                                                                                                          |
| Assigning an unassigned task                           | drag onto a row, or the bulk dialog, where the server picks the time | tap: the first free gap inside the person's working hours                                                                                     | tap: the first free time from the task's start, without checking working hours \[[ASK-95](https://github.com/snapfix/docs/blob/main/ASK.md#ask-95-should-tasks-be-placed-only-inside-the-persons-working-hours)] |
| Bulk actions, auto-assign, resets, print, zoom, expand | yes                                                                  | no                                                                                                                                            | no \[[ASK-89](https://github.com/snapfix/docs/blob/main/ASK.md#ask-89-which-housekeeping-actions-should-the-mobile-apps-have)]                                                                                   |
| Staff filter                                           | filter drawer                                                        | Assigned tab row                                                                                                                              | Assigned tab spinner                                                                                                                                                                                             |
| Opening a task                                         | preview drawer; new browser tab for group members                    | task detail                                                                                                                                   | task detail                                                                                                                                                                                                      |
| Refresh                                                | every 60 seconds while visible                                       | every 60 seconds, on a push, pull                                                                                                             | every 60 seconds, swipe                                                                                                                                                                                          |
| Create                                                 | dialog, up to 100 rooms                                              | sheet                                                                                                                                         | sheet                                                                                                                                                                                                            |

The title label and placeholder differ, and so does the minimum allocated time. The [Staff schedule](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/schedule.md) and the [Dashboard](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/dashboard.md) are web only.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
