Time and Calendar
Time Logs & Entries
How GreenVee records actual work time through Time Logs and Time Entries, including the approval flow.
Once work happens, it needs to be recorded. GreenVee uses two objects for this: Time Logs (the session record) and Time Entries (the time windows inside a session). Timers and labels — the tools used to fill a Time Log in — are covered on their own page: Timers & Labels.
Time Log
Section titled “Time Log”A Time Log is the primary record of a work session. It belongs to an Employee and a Project, and optionally a Task.
| Field | What it stores |
|---|---|
| Employee | Who did the work |
| Project | Which project the work belongs to |
| Task | The specific task (optional) |
| Date | The date of the session |
| Description | Free-text note about the session |
| State | pending, approved, or rejected |
| Billable | Whether this time is billable to the client |
| Approved at | When the log was approved (empty until it is) |
| Rejected at | When the log was rejected (empty until it is) |
| Time Tracking Labels | Tags applied to the log (many-to-many) |
A single Time Log represents one session for one employee on one project. It does not store the clock times directly — those live in Time Entries.
Time Entry
Section titled “Time Entry”A Time Entry is a specific start-to-end window within a Time Log.
| Field | What it stores |
|---|---|
| Start time | When work began |
| End time | When work ended |
| Time Log | The parent log this entry belongs to |
One Time Log can hold multiple Time Entries. For example: a technician works on the same project in the morning and again after lunch. Both sessions belong to the same Time Log for that day, but each has its own Time Entry with its own start and end times.
Approval flow
Section titled “Approval flow”Every Time Log starts in pending state. A manager reviews pending logs and moves them to approved or rejected, which stamps the Approved at or Rejected at timestamp accordingly.
Worker submits time → pending → manager reviews → approved or rejectedOnly approved logs are considered final for reporting and billing purposes. Rejected logs return to the worker for correction.
How these objects relate
Section titled “How these objects relate”Time Log → Project / Task └── Time Entry (start–end window) └── Time Tracking Labels (tags)A Time Log holds one or more Time Entries (start–end windows) and carries the approval state, billable flag, description, and labels.
Related pages
Section titled “Related pages”- Planned Effort — the estimate that actual time is measured against
- Bookings — how time on a task is reserved before it happens
- Timers & Labels — capturing time live and tagging logs