# Daily Schedule

<p class="doc-lead">View and update project tasks planned for a chosen day from the Field Sale App <b>Home</b> tab — grouped by project, with inline progress or quantity updates, bulk save, and new task creation.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Overview</span>
<div class="doc-toc-links">
<a href="#/field-sale-app/daily-schedule?id=open">Open Daily Schedule</a>
<a href="#/field-sale-app/daily-schedule?id=filters">Filters</a>
<a href="#/field-sale-app/daily-schedule?id=task-list">Task list</a>
<a href="#/field-sale-app/daily-schedule?id=progress-mode">Progress tracking mode</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Actions</span>
<div class="doc-toc-links">
<a href="#/field-sale-app/daily-schedule?id=save-changes">Save Changes</a>
<a href="#/field-sale-app/daily-schedule?id=new-task">New Task</a>
<a href="#/field-sale-app/daily-schedule?id=task-detail">Task detail</a>
<a href="#/field-sale-app/daily-schedule?id=task-attachments">Task attachments</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/field-sale-app/daily-schedule?id=access">Access</a>
<a href="#/field-sale-app/daily-schedule?id=faq">FAQ</a>
<a href="#/field-sale-app/daily-schedule?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="open">Open Daily Schedule</h2>

**Home** tab → **Daily Schedule**.

Requires **Daily Schedule** access and either **Task Schedule** or **Work Schedule** report access on the user role.

The screen opens with **today's** date and loads tasks scheduled for that day. Web equivalent: <a href="#/project/daily-schedule">Project → Daily Schedule</a>.

> Screenshot pending — `field-sale-app/images/daily-schedule.webp`

<hr class="doc-section-divider">

<h2 id="filters">Filters</h2>

| **Filter** | **Description** |
|------------|-----------------|
| **Schedule Date** | Day to view. Changing the date reloads the schedule. |
| **Project** | Optional — limit results to one project. Shown when **Project — List** access is granted. |

Tap **Generate** to reload after changing filters. Pull down on the task list to refresh.

<hr class="doc-section-divider">

<h2 id="task-list">Task list</h2>

Tasks appear in project groups. Each group header shows the project name, bill number (when set), employee in charge, and a task count.

Each task row shows:

| **Field** | **Description** |
|-----------|-----------------|
| **Task name** | Tap to open read-only task detail. |
| **Status** | Not Started, In Progress, or Completed badge. |
| **Task number** | Bill or reference number when set. |
| **Category** | Project category name. |
| **Team** | Employee in charge or team members assigned to the task. |
| **Progress / quantity** | See <a href="#/field-sale-app/daily-schedule?id=progress-mode">Progress tracking mode</a> below. |

<hr class="doc-section-divider">

<h2 id="progress-mode">Progress tracking mode</h2>

<b>Progress tracking mode</b> is set under <a href="#/project/project-settings">Project Settings</a> on the web ERP. The app uses the same company setting as the web Daily Schedule.

<h3>Quantity mode</h3>

When quantity tracking is enabled, each task shows:

| **Field** | **Editable** |
|-----------|--------------|
| **Target Qty** | Read-only, with unit when set. |
| **Completed Qty** | Editable when you have **Project Task — progress** access. |
| **Progress** | Read-only percentage derived from completed vs target quantity. |

<h3>Progress (percentage) mode</h3>

When percentage tracking is enabled, each task shows a single **Progress** value. Users with **Project Task — progress** access can edit the percentage (0–100). Others see the value as read-only.

Edited rows are highlighted until saved.

> **Status updates automatically.** After you save, a task moves to **In Progress** once progress goes above 0, and to **Completed** when progress reaches 100% (in quantity mode, when completed quantity reaches the target). Lowering progress below 100% on a completed task reopens it to **In Progress**.

<hr class="doc-section-divider">

<h2 id="save-changes">Save Changes</h2>

When you edit progress or completed quantity on one or more tasks, a **Save Changes (N)** footer appears at the bottom of the screen, where **N** is the number of pending edits.

Tap **Save Changes** to submit all pending updates in one step. A success message confirms when the save completes.

Users without **Project Task — progress** access see progress and quantity as read-only and do not get the save footer.

<hr class="doc-section-divider">

<h2 id="new-task">New Task</h2>

When **Project Task — create** access is granted:

- Tap **New Task** in the filter area to create a task (optionally pre-selecting the project filter).
- Tap **New Task** on a project group header to create a task with that project pre-selected.

The **New Task** form includes:

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| **Task Definition** | No | Predefined task picked from the <a href="#/project/project-task-definition">Project Task Definition</a> list. Selecting one fills the **Task name** automatically when it is still empty. |
| **Task name** | Yes | Name of the project task. |
| **Project** | Yes | Project the task belongs to. Locked when opened from a project group. |
| **Project Category** | No | Category from the project category list. |
| **Planned Start Date** | Yes | Defaults to the schedule date. |
| **Planned End Date** | Yes | Defaults to the schedule date. |
| **Employee In Charge** | No | Single employee responsible for the task. |
| **Team Members** | No | Additional assignees (multi-select). |
| **Target Qty** | No | Planned quantity when quantity tracking is used. |
| **Description** | No | Task notes or remarks. |

After a successful save, the schedule reloads and the new task appears when its planned dates cover the selected day.

<hr class="doc-section-divider">

<h2 id="task-detail">Task detail</h2>

Tap a task name (or the task header row) to open a read-only **Task Detail** modal with full task information — dates, assignees, quantities, progress, status, and description.

Use this to review a task without leaving the Daily Schedule screen. Editing progress or quantity remains on the main schedule list.

<hr class="doc-section-divider">

<h2 id="task-attachments">Task attachments</h2>

The **Task Detail** modal includes an **Attachments** section listing files linked to the task. These are the same attachments shown on the web <a href="#/project/project-task">Project Task</a> view, so files added from the app appear on the web ERP and the other way round.

| **Action** | **Description** |
|------------|-----------------|
| **Add** | Tap **Add** to open the upload screen, add an optional note, choose a file from the device, and tap **Upload**. |
| **Download / open** | Tap the download icon on a file to save and open it with the device's default viewer. |
| **Delete** | Tap the delete icon and confirm to remove a file. |

The list refreshes automatically after an upload or delete. When a task has no files, the section shows **No attachments**.

<hr class="doc-section-divider">

<h2 id="access">Access</h2>

| **Feature** | **Permission** |
|-------------|----------------|
| **Daily Schedule** tile on Home | Daily Schedule and (Task Schedule or Work Schedule report) |
| **Project** filter | Project — List |
| Edit **Completed Qty** or **Progress** | Project Task — progress |
| **New Task** | Project Task — create |
| Read-only schedule (no edits) | Task Schedule or Work Schedule report (without progress/create) |

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>How is this different from Work Schedule on Reports?</b><br>
<a href="#/field-sale-app/reports?id=work-schedule">Work Schedule</a> is read-only — for viewing and sharing the day's plan. Daily Schedule is for updating progress or quantity and creating tasks in the field.</p>

<p><b>How is this different from the web Daily Schedule?</b><br>
Both show the same day's tasks grouped by project. The web screen adds Excel export and print. The mobile app is optimised for field updates and task creation on site.</p>

<p><b>Why is the schedule empty?</b><br>
No tasks have planned dates covering the selected day, or the project filter excludes them. Try another date or clear the project filter.</p>

<p><b>Why can't I edit progress?</b><br>
Grant <b>Project Task — progress</b> on the Field Sale App user role. Without it, progress and quantity display as read-only.</p>

<p><b>Can I export or print from the app?</b><br>
No. Use the web <a href="#/project/daily-schedule">Daily Schedule</a> for Excel export and print.</p>

<p><b>What date is used when I add a new task?</b><br>
Planned start and planned end default to the schedule date shown in the filter area.</p>

<p><b>Can I attach files to a task from the app?</b><br>
Yes. Open the task from the schedule to show the <b>Task Detail</b> modal, then use the <b>Attachments</b> section to add, download, or delete files. They are shared with the web <a href="#/project/project-task">Project Task</a> view.</p>

<hr class="doc-section-divider">

<h2 id="related">Related topics</h2>

<ul>
<li><a href="#/project/daily-schedule">Daily Schedule</a> (web ERP)</li>
<li><a href="#/field-sale-app/reports?id=work-schedule">Work Schedule</a> (mobile report)</li>
<li><a href="#/field-sale-app/projects">Projects</a></li>
<li><a href="#/field-sale-app/hr-and-payroll/attendance">Attendance</a> — optional project task per line</li>
<li><a href="#/project/project-settings">Project Settings</a></li>
<li><a href="#/project/project-task">Project Task</a> (web)</li>
<li><a href="#/project/project-task-definition">Project Task Definition</a> (web)</li>
</ul>
