{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/workday-tracking-system/refs/heads/main/json-schema/workday-tracking-system-time-block-schema.json",
  "title": "TimeBlock",
  "description": "A reported or calculated time block representing hours worked by an employee in the Workday system",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique Workday ID of the time block"
    },
    "workerId": {
      "type": "string",
      "description": "Workday ID of the worker who logged this time block"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date of the time block (YYYY-MM-DD)",
      "example": "2026-05-03"
    },
    "startTime": {
      "type": "string",
      "format": "time",
      "description": "Start time of the time block (HH:MM:SS)",
      "example": "09:00:00"
    },
    "endTime": {
      "type": "string",
      "format": "time",
      "description": "End time of the time block (HH:MM:SS)",
      "example": "17:00:00"
    },
    "hours": {
      "type": "number",
      "description": "Total hours recorded in this time block",
      "minimum": 0,
      "maximum": 24,
      "example": 8.0
    },
    "type": {
      "type": "string",
      "description": "Category of time worked",
      "enum": ["Regular", "Overtime", "Holiday", "Leave"],
      "example": "Regular"
    },
    "status": {
      "type": "string",
      "description": "Approval and processing status of the time block",
      "enum": ["Reported", "Calculated", "Approved", "Rejected"],
      "example": "Approved"
    },
    "projectId": {
      "type": "string",
      "description": "Associated project identifier (optional)"
    },
    "taskId": {
      "type": "string",
      "description": "Associated task identifier (optional)"
    },
    "comment": {
      "type": "string",
      "description": "Optional worker comment about this time block",
      "maxLength": 500
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the time block was created",
      "readOnly": true
    },
    "modifiedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the time block was last modified",
      "readOnly": true
    }
  },
  "required": ["workerId", "date", "hours", "type"],
  "additionalProperties": false
}