The_Personal_Lines_Task.Tra.../README.md

48 lines
2.9 KiB
Markdown
Raw Normal View History

2025-08-14 07:03:38 -07:00
# The (Personal Lines) Task Tracker
2025-08-14 07:03:12 -07:00
2025-08-14 07:04:03 -07:00
A gamified task management and progress tracking tool designed for insurance agency workflows. Built in Node-RED with a clean React-based UI, SQLite persistence, and support for daily task tracking, seasonal story progression, and admin control features.
# 🚀 Version 1.0 Initial Release
The first official release of the **Personal Lines Task Tracker** — a gamified task management and progress tracking tool designed for insurance agency workflows. Built in **Node-RED** with a clean **React-based UI**, **SQLite** persistence, and support for daily task tracking, seasonal story progression, and admin control features.
---
## ✨ Key Features
- **Agent Dashboard** — Displays daily tasks, completion status, earned points, energy level, and story progress.
- **Gamified Story Mode** — 30-day seasonal and light story arcs with daily interactive actions and energy costs.
- **Energy System** — Agents complete tasks to gain energy, spend it on story actions, and track their journey.
- **Task Templates** — Full CRUD (Create, Read, Update, Delete) interface for reusable task templates.
- **Global Announcements** — Post and clear announcements visible to all agents.
- **Admin Control Center** — Secure login for super admins to manage agents, reset progress, update templates, and post announcements.
- **Progress Reset** — Ability to reset an agents story and daily progress from the admin dashboard.
- **SQLite Database Storage** — All agent data, tasks, and templates are persisted locally.
- **Authentication System** — Session-based admin login/logout with cookie handling.
- **Responsive UI** — TailwindCSS + React for a clean, mobile-friendly interface.
- **Dark Mode Support** — Full light/dark mode styling for comfortable use in any environment.
---
## 🛠 Endpoints & API
- `/login`, `/logout`, `/control-center` — Admin authentication & dashboard
- `/get-all-data`, `/task-templates`, `/announcement` — Data retrieval and management
- `/agent/:agentId/start-story` — Begin seasonal or light story for an agent
- `/agent/:agentId/story-action` — Process a story action with energy validation
- `/agent/:agentId/reset` — Reset an agents story progress and daily tasks
- `/tasks/:agentId/:date/:taskId/status` — Update task status for a given date
- `/agents/:id` — Delete an agent
---
## 📖 Story Content
- **Seasonal Story Arc** — Dark, immersive 30-day storyline with branching daily actions.
- **Light Story Arc** — Wholesome, casual alternative with small-town themed actions.
- **Dynamic Outcomes** — Every story action triggers unique text outcomes, saved to the daily log.
---
This release establishes the foundation of the **Personal Lines Task Tracker**, combining productivity tracking with engaging narrative gameplay to boost agent engagement and performance.