Skip to content

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.

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.

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.

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 rejected

Only approved logs are considered final for reporting and billing purposes. Rejected logs return to the worker for correction.

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.

  • 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