TimeCraft_Backend/documentation/README.md

Workflow

Input: Json

COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX
COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX
COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX COMPLEX


[
  {
    "type": "daily",
    "task_name": "Critical Daily Stand-up",
    "task_description": "Non-negotiable daily sync for core project team. Early birds only.",
    "time_settings": {
      "start_time": "09:00",
      "end_time": "09:15",
      "duration": null
    },
    "category": "work",
    "repeat_on_1": "Every weekday, but skip public holidays (LLM to infer)",
    "repeat_on_2": ["M", "T", "W", "T", "F"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 5,
      "time_unit": "Minutes"
    }
  },
  {
    "type": "daily",
    "task_name": "Daily Team Scrum",
    "task_description": "New mandatory daily team scrum, might conflict with other meetings. Needs 1 hour.",
    "time_settings": {
      "start_time": "09:00",
      "end_time": "10:00",
      "duration": null
    },
    "category": "work",
    "repeat_on_1": "Every Monday to Friday. Very high priority.",
    "repeat_on_2": ["M", "T", "W", "T", "F"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 10,
      "time_unit": "Minutes"
    }
  },
  {
    "type": "weekly",
    "task_name": "Executive Leadership Meeting",
    "task_description": "Mandatory weekly meeting with executive board. Fixed slot.",
    "time_settings": {
      "start_time": "09:00",
      "end_time": "10:00",
      "duration": null
    },
    "category": "work",
    "repeat_on_1": "Every Tuesday, but starting from the 3rd week of the month only. Cannot be moved.",
    "repeat_on_2": ["T"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 15,
      "time_unit": "Minutes"
    }
  },
  {
    "type": "monthly",
    "task_name": "Monthly HR Check-in",
    "task_description": "Meet with HR for personal development. Fixed slot, 1 hour.",
    "time_settings": {
      "start_time": "11:00",
      "end_time": "12:00",
      "duration": null
    },
    "category": "personal",
    "repeat_on_1": "Every second Saturday of the month.",
    "repeat_on_2": ["S"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 1,
      "time_unit": "Days"
    }
  },
  {
    "type": "monthly",
    "task_name": "Board Meeting Prep & Review",
    "task_description": "Extensive preparation for monthly board meeting. Flexible, 8-hour task, needs continuous block if possible.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "8 Hours"
    },
    "category": "work",
    "repeat_on_1": "Any weekday in the first week of every month, as long as it's not Monday or Friday. Prefer early morning. Highly flexible on exact time within that day.",
    "repeat_on_2": ["T", "W", "T"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 2,
      "time_unit": "Days"
    }
  },
  {
    "type": "daily",
    "task_name": "Personal Workout Session",
    "task_description": "Daily exercise, needs 45 minutes, flexible around work hours. Prioritize morning but accept evening.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "45 Minutes"
    },
    "category": "personal",
    "repeat_on_1": "Daily, prefer 07:00-08:00 AM OR 18:00-19:00 PM, but can be done anytime between 6 AM and 10 PM. Prioritize morning.",
    "repeat_on_2": ["S", "M", "T", "W", "T", "F", "S"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 30,
      "time_unit": "Minutes"
    }
  },
  {
    "type": "weekly",
    "task_name": "Team Building Activity",
    "task_description": "Organize a fun team activity. Needs 2 hours, afternoon only.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "2 Hours"
    },
    "category": "extra",
    "repeat_on_1": "Last Friday of every second month (starting from this month), flexible between 2 PM and 5 PM.",
    "repeat_on_2": ["F"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 1,
      "time_unit": "Days"
    }
  },
  {
    "type": "monthly",
    "task_name": "Complex Financial Report",
    "task_description": "Prepare the complex financial report for audit. Requires 5 hours, ideally split over two consecutive days if necessary.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "5 Hours"
    },
    "category": "work",
    "repeat_on_1": "Any two consecutive weekdays in the third week of the month, prioritizing Tuesday-Wednesday or Wednesday-Thursday. Flexible 09:00-17:00.",
    "repeat_on_2": ["M", "T", "W", "T", "F"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 7,
      "time_unit": "Days"
    }
  },
  {
    "type": "daily",
    "task_name": "Morning Coffee Break",
    "task_description": "A short 15-minute break. Highly flexible, but must be before 11 AM, avoiding any fixed meetings.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "15 Minutes"
    },
    "category": "personal",
    "repeat_on_1": "Daily, any time between 09:15 and 11:00 AM, avoiding other fixed meetings.",
    "repeat_on_2": ["M", "T", "W", "T", "F"],
    "reminder_on": {
      "is_active": false,
      "numeric_input": null,
      "time_unit": null
    }
  },
  {
    "type": "weekly",
    "task_name": "Deep Dive Code Review",
    "task_description": "Dedicated slot for reviewing complex PRs. Needs 3 hours, strictly afternoon.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "3 Hours"
    },
    "category": "work",
    "repeat_on_1": "Every Thursday, after 11:00 AM, but before 4:00 PM. Cannot overlap with any other work meetings.",
    "repeat_on_2": ["T"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 4,
      "time_unit": "Hours"
    }
  },
  {
    "type": "monthly",
    "task_name": "Personal Finance Audit",
    "task_description": "Review personal budget and investments. 1 hour, weekday only.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "1 Hour"
    },
    "category": "personal",
    "repeat_on_1": "The 15th of every month, if it's a weekday. Otherwise, the closest preceding weekday.",
    "repeat_on_2": ["M", "T", "W", "T", "F"],
    "reminder_on": {
      "is_active": true,
      "numeric_input": 24,
      "time_unit": "Hours"
    }
  },
  {
    "type": "daily",
    "task_name": "Evening Wind-Down",
    "task_description": "Read a book or meditate. 30 minutes, before bed. No fixed time.",
    "time_settings": {
      "start_time": null,
      "end_time": null,
      "duration": "30 Minutes"
    },
    "category": "personal",
    "repeat_on_1": "Daily, between 9 PM and 11 PM. Avoid any fixed late-night calls.",
    "repeat_on_2": ["S", "M", "T", "W", "T", "F", "S"],
    "reminder_on": {
      "is_active": false,
      "numeric_input": null,
      "time_unit": null
    }
  }
]

📅 Weekly Task Schedule Visualization

Sample Week: July 14–20, 2025

Time	Mon (14)	Tue (15)	Wed (16)	Thu (17)	Fri (18)	Sat (19)	Sun (20)
06:00–07:00	🟢 🧘 Workout (Flexible)	🟢 🧘 Workout (Flexible)	🟢 🧘 Workout (Flexible)	🟢 🧘 Workout (Flexible)	🟢 🧘 Workout (Flexible)	🟢 🧘 Workout (Flexible)	🟢 🧘 Workout (Flexible)
07:00–08:00	⭐ 🧘 Workout (Preferred)	⭐ 🧘 Workout (Preferred)	⭐ 🧘 Workout (Preferred)	⭐ 🧘 Workout (Preferred)	⭐ 🧘 Workout (Preferred)	⭐ 🧘 Workout (Preferred)	⭐ 🧘 Workout (Preferred)
08:30–09:00	🟢 ☕ Coffee Break	🟢 ☕ Coffee Break	🟢 ☕ Coffee Break	🟢 ☕ Coffee Break	🟢 ☕ Coffee Break
09:00–09:15	🔒 ⚠️ Stand-up + Scrum 🎯	🔒 ⚠️ Stand-up + Scrum 🎯	🔒 ⚠️ Stand-up + Scrum 🎯	🔒 ⚠️ Stand-up + Scrum 🎯	🔒 ⚠️ Stand-up + Scrum 🎯
09:15–10:00	⚠️ Scrum Continues 🎯	⚠️ Scrum Continues 🎯	⚠️ Scrum Continues 🎯	⚠️ Scrum Continues 🎯	⚠️ Scrum Continues 🎯
10:00–11:00	🟢 Board Prep / Overflow Slot	🔒 🧑‍💼 Exec Leadership Meeting	🟢 Report Split (Day 2)	🔒 🧑‍💼 Deep Code Review	🟢 🎯 Team Activity Slot
11:00–12:00	🟢 Report Prep ⭐	🟢 Report Prep ⭐	🟢 Report or Code Review	🔒 🧑‍💼 Code Review Ends	🟢 Team Activity Cont.	🔒 🧘 HR Check-in (2nd Sat)
12:00–13:00	🟢 🍽 Lunch / Overflow	🟢 🍽 Lunch / Overflow	🟢 🍽 Lunch / Overflow	🟢 🍽 Lunch / Overflow	🟢 🍽 Lunch / Overflow	🟢 🍽 Lunch / Overflow	🟢 🍽 Lunch / Overflow
13:00–14:00	🟢 ⭐ Board Meeting Prep	🟢 ⭐ Board Meeting Prep	🟢 ⭐ Board Meeting Prep	🟢 Board Prep / Flex	🟢 Team Activity Overflow	🟢 Free	🟢 Free
14:00–17:00	🟢 Deep Work / Report Block	🟢 Deep Work	🟢 Deep Work	🟢 Deep Work	🟢 Deep Work	🟢 Flex Time	🟢 Flex Time
18:00–19:00	🧘 Workout (Fallback)	🧘 Workout (Fallback)	🧘 Workout (Fallback)	🧘 Workout (Fallback)	🧘 Workout (Fallback)	🧘 Workout (Fallback)	🧘 Workout (Fallback)
21:00–22:00	🧘 Evening Wind-Down	🧘 Evening Wind-Down	🧘 Evening Wind-Down	🧘 Evening Wind-Down	🧘 Evening Wind-Down	🧘 Evening Wind-Down	🧘 Evening Wind-Down

---

🔵 Legend

• 🔒 = Fixed time slot
• ⚠️ = Conflict or overlap
• ⭐ = Preferred or high-priority
• 🧘 = Personal task
• 🧑‍💼 = Work task
• 🎯 = High-impact / urgent
• 🟢 = Flexible slot
• ☕ = Break
• 🍽 = Lunch

---

🧠 Notes & Insights

• 09:00 Conflict: Critical Daily Stand-up and Team Scrum overlap every weekday → consider merging or shifting.
• Board Prep & Financial Reports are scheduled with max flexibility to avoid blocking.
• Workouts are morning-preferred with evening fallback for sustainability.
• Personal wellness tasks are spread across early morning and late evening with no overlaps.

---

Want this in .csv, .ics, or as a visual HTML calendar? Just let me know.