System Requirements Document (SRD)

Project: purple-hacker

Prepared for: HEMEN ASHODIA Country: IN Version: 1.0 Date: 2025-07-14

1. Introduction

This document defines the System Requirements for purple-hacker, a hacker-themed, AI-powered task management application. The system leverages a Large Language Model (LLM) to intelligently analyze and score tasks out of 100 based on their raw content, automatically sorting them by priority. Users retain full manual control via drag-and-drop reordering. This SRD serves as the foundational blueprint for design, development, and delivery of the purple-hacker platform.

2. System Overview

purple-hacker is a web-based to-do application built with a dark, terminal-inspired hacker aesthetic. When a user adds a task, the system sends the raw task content to an LLM, which evaluates and assigns a priority score (0–100). Tasks are then automatically sorted in the UI by their score (highest priority first). Users may override the AI-determined order at any time using drag-and-drop. The system includes user authentication, persistent task storage, and a real-time, responsive interface.

3. Functional Requirements

• As a User, I should be able to register and log in to my account securely
• As a User, I should be able to add a new task by entering raw text content
• As a User, I should be able to see the LLM-generated priority score (out of 100) assigned to each task
• As a User, I should be able to see my tasks automatically sorted by their AI-assigned score when a new task is added
• As a User, I should be able to manually reorder tasks using drag-and-drop to override the AI sort order
• As a User, I should be able to edit the content of an existing task and trigger a re-score from the LLM
• As a User, I should be able to mark a task as complete
• As a User, I should be able to delete a task
• As a User, I should be able to view all tasks in a single dashboard with their scores and statuses
• As a User, I should be able to see a visual indicator (e.g., score badge, color gradient) reflecting the priority level of each task
• As a User, I should be able to log out of my account
• As an Admin, I should be able to view all registered users
• As an Admin, I should be able to deactivate or remove a user account
• As an Admin, I should be able to monitor LLM usage and API call statistics

4. User Personas

4.1 Authenticated User

A registered individual who uses purple-hacker daily to manage personal or professional tasks. They rely on the AI scoring to prioritize their workload and occasionally override the order manually when context demands it.

4.2 Admin

A privileged operator responsible for managing the platform — overseeing user accounts, monitoring system health, and tracking LLM API consumption. The admin does not typically manage tasks but ensures the system runs smoothly.

4.3 Guest (Unauthenticated Visitor)

A visitor who lands on the purple-hacker homepage. They can view the product's features and aesthetic but must register or log in to access task management functionality.

5. Visuals, Colors, and Theme

Theme: Dark Terminal / Hacker Console

The visual identity of purple-hacker is rooted in the aesthetic of old-school hacking terminals, cyberpunk interfaces, and command-line environments — but elevated with modern UI polish.

Design Notes

• All UI elements use monospace fonts to reinforce the terminal feel
• Subtle scanline overlays and CRT glow effects on key components
• Score badges use a color gradient from red (0) → amber (50) → green (100)
• Buttons and inputs styled as command-line prompts (e.g., > ADD_TASK_)
• Subtle matrix-style particle animations in the background (sparse, not distracting)

6. Signature Design Concept

⚡ "THE HACKER'S WAR ROOM" — Live Terminal Intelligence Dashboard

The homepage feels like you've just broken into a classified government system — and it's beautiful.

Landing Page Experience:

When a visitor first arrives at purple-hacker, they are greeted by a full-screen, animated terminal boot sequence. Lines of green-on-black text cascade down the screen in rapid succession — fake system logs, IP traces, kernel messages — all building atmosphere. After ~2 seconds, the sequence halts and a single blinking cursor appears:

> INITIALIZING PURPLE-HACKER SYSTEM...
> AUTHENTICATING USER... [UNKNOWN]
> ACCESS LEVEL: GUEST
> PRESS [ENTER] TO BREACH THE SYSTEM_

Pressing Enter (or clicking) shatters the terminal screen with a glitch-burst transition — pixels scatter, RGB channels split apart momentarily — and the main dashboard materializes behind it.

The Main Dashboard — "The War Room":

• The task list is displayed as a live terminal feed, each task appearing as a line entry with a blinking cursor at the bottom
• Each task card is styled as a classified file dossier — monospace text, a redacted-style score badge on the left, and a subtle purple glow border that intensifies as the score approaches 100
• When a new task is submitted, the UI shows a real-time LLM "analysis" animation: a progress bar labeled > ANALYZING THREAT LEVEL... pulses across the screen, followed by the score being typed out digit by digit like a teletype machine
• The score badge uses a radial arc meter (like a radar sweep) that animates from 0 to the final score with a satisfying sweep sound (optional, toggleable)
• Drag-and-drop reordering is visualized as tasks being "cut" from the list with a scissor-snip glitch effect and "pasted" into the new position with a stamp animation
• The background features a slow-moving purple hex-grid — like a circuit board coming alive — with faint purple pulses traveling along the grid lines
• Completed tasks don't disappear — they get a [TERMINATED] stamp overlaid in red with a strikethrough, then fade into a "completed archive" section at the bottom
• The top navigation bar is a command palette — users type commands like /add, /sort, /clear as an alternative to clicking buttons
• Micro-interaction: Hovering over any task causes the surrounding hex-grid to pulse outward from that task's position, as if it's emitting a signal
• Score color aura: Each task card emits a subtle colored glow matching its priority — green for high, amber for medium, red for low — making the priority landscape immediately readable at a glance

This design makes every interaction feel like an act of digital warfare against chaos — and winning.

7. Non-Functional Requirements