🥋 Karate Task Tracker

📤 Uploading Tasks

• Upload Tasks 📤 Shown when you have no tasks yet. Select your CSV to load your task list.
• ➕ Add a Task 🔒 Merges an additional CSV into your existing task list. Tasks matched by taskid or title are updated; new ones are added; tasks not in the CSV are archived.
• 📋 Upload New CSV 🔒 Replaces your current task list with a new CSV. Old tasks are archived (history preserved), session is cleared. Tasks matched by taskid or title keep their history.

▶️ Running Tasks

• ▶️ Begin All Tasks Starts all tasks in order, one after another. After finishing each task the next begins automatically.
• 🚀 Start Starts the timer for a single task. Only one task can be active at a time.
• ✅ Finished! Marks the active task complete, records your time, calculates focus and impact scores, and advances to the next task. Keyboard: Enter or Space
• ⏸️ Pause Freezes the timer exactly where it is. The Finished button changes to "▶️ Paused — tap to resume". Click it again to continue. Keyboard: P
• ❌ Cancel Task Stops the current task, records the time spent as incomplete, and advances to the next task. No confirmation prompt.

⏱️ Timer Behaviour

• Countdown While time remains, the timer counts down in seconds. Progress bar shows % complete.
• Count-up (overtime) When the countdown reaches zero, a sound plays and the timer switches to counting up in red (+1s, +2s…). Click Finished whenever you're done — the full time is recorded.
• No Countdown Set estimated_time to 0 in your CSV or edit form. No timer is shown — just click Finished to move on.

☰ Hamburger Menu

Items marked 🔒 require the admin password.

• 📊 View ResultsOpens your full results page with completion history, scores, and totals.
• ⬇️ Download My CSVDownloads your current active task list as a CSV file (taskid, task, description, estimated_time, difficulty).
• 💾 Export My DataDownloads a full JSON backup of your tasks and completion history — use this to restore or migrate your data.
• 🏠 HomeReturns to the login page.
• 👥 All UsersShows all students with task counts, results links, per-user export, and a global import tool.
• ⏸️ PausePauses/resumes the active task timer. Also triggered by keyboard shortcut P.
• ❌ Cancel TaskRecords current task as incomplete and moves to the next.
• 📋 Upload New CSV 🔒Replace entire task list with a new CSV. History is preserved.
• ➕ Add a Task 🔒Merge an additional CSV into your existing list.
• ✏️ Modify a Task 🔒Pick a task to edit its title, description, time, or difficulty.
• 🗑️ Remove a Task 🔒Pick a task to permanently delete it from the list.
• 🔄 Reset Session 🔒Cancels the currently active task session. Task list and history are untouched.
• 🧹 Clear Session 🔒Same as Reset Session — clears the active session and reloads.
• 🗑️ Clear All Data for User 🔒Permanently deletes the student account, all tasks, and all history. Cannot be undone.
• 🔔 Sound ▸Hover to expand sound options: No Sound, Ding, Chime, Bell. Your choice is saved across sessions.

⌨️ Keyboard Shortcuts

• EnterClick the Finished button (when a task is active and not paused).
• SpaceSame as Enter — click Finished.
• PPause or resume the active task timer.

📈 Scores Explained

• Focus Score How closely you matched the estimated time. 1.0 = perfect. Finishing early or running significantly over both lower the score. Tasks with no countdown always score 1.0.
• Impact Score Combined score (0–10) based on difficulty × focus. Expert + perfect focus = 10. Easy + perfect focus = 2.5.
• Difficulty Set in CSV or Edit form. 🟢 Easy (0.5), 🟡 Medium (1.0), 🟠 Hard (1.5), 🔴 Expert (2.0). Auto-assigned by time if blank: <5min→Easy, 5–15min→Medium, 15–30min→Hard, >30min→Expert.
• 🌟 Finished Early Green badge shown when a completed task was finished under the estimated time.
• ⏱️ Time to Complete Yellow badge shown when a task was completed but took longer than estimated.
• ❌ Incomplete Red badge shown when a task was cancelled before finishing. Time is still recorded.