Periods and approvals

Periods

The admin chooses one period type for the site.

• Weekly: Monday to Sunday.
• Monthly: a calendar month.

Required hours per week default to 40 (0 to 168). For a month the required hours are the weekly figure divided by 5, times the number of weekdays in the month.

Submit

1. In My timesheet, the status row shows the period, a status badge, the last action, a shortfall chip and a Submit timesheet button.
2. Submit stores the period's hours, computed from Jira, with the record. You can submit when the status is Open or Rejected. A rejected sheet shows Resubmit timesheet.
3. The period is now locked: grid cells are grey and read-only, and the Log work panel refuses those dates.

Statuses

Open, Submitted, Approved, Rejected. Each change adds an entry to an audit trail with the actor, time, comment and hours. The last 100 entries are kept.

Approve or reject (team leads and Jira administrators)

Open the Approvals tab. A tab count shows how many sheets wait.

• Pick a team and a period. Prev, Next, Current and Refresh move through periods.
• Each member row shows hours (amber if under the required hours), the status and the last action. Expand it for the audit trail.
• Approve, or Reject with a reason. A rejection needs a comment.
• Approve is offered only for a submitted sheet. An open sheet (never submitted) or a rejected one shows no Approve button: the person submits or resubmits it first. The server refuses any other approval too.
• A submitted or approved sheet can be rejected. An approved sheet can be rejected again.
• Approve all (n) approves every member's submitted sheet for the period. n is that number, and the button is greyed out at 0. Open, rejected and already approved sheets are left as they are, and the message after it says how many.
• The lead or a Jira administrator can act. The person must be a member of the team.

Locks

A submitted or approved period is locked in the app. The app enforces it in the grid, the panel and its own stored data. Jira's own Work log tab and API are not blocked by the app. Edits made there are detected and flagged. See post lock warnings.

To unlock, reject the sheet. The user can then edit and resubmit.

Notes

• Approvals hours come from Jira as the viewer, so only issues the viewer can browse count, and the viewer's time zone buckets the days.
• If Jira keeps refusing with a rate limit, Approvals shows a message and "n/a" for hours, and disables Approve and Approve all, so no sheet is approved with wrong hours.
• Email reminders are not part of this release. Reminders are banners and the pending count.