diff --git a/Claude.md b/Claude.md
index 2998213..490304f 100644
--- a/Claude.md
+++ b/Claude.md
@@ -2,20 +2,34 @@
## Project Status (January 2026)
-**Current Phase**: All 5 core features implemented and deployed. Ready for ANSI Art redesign.
+**Current Phase**: All core features implemented. ANSI Art terminal redesign complete. System is production-ready.
-**Recent Completion**:
+**Completed Features**:
- ✅ Activity Timeline (Feature 1)
- ✅ Ticket Assignment (Feature 2)
- ✅ Status Transitions with Workflows (Feature 3)
- ✅ Ticket Templates (Feature 4)
- ✅ Bulk Actions - Admin Only (Feature 5)
+- ✅ ANSI Art Terminal Redesign
+- ✅ File Attachments
+- ✅ Ticket Dependencies
+- ✅ @Mentions in Comments
+- ✅ Recurring Tickets
+- ✅ Custom Fields
+- ✅ Advanced Search with Saved Filters
+- ✅ Export to CSV/JSON
+- ✅ Admin Pages (Templates, Workflow, Recurring, Custom Fields, User Activity, Audit Log)
-**Next Priority**: 🎨 ANSI Art Redesign (major visual overhaul)
+**Recent Updates** (January 2026):
+- Added admin dropdown navigation in dashboard header
+- Fixed template/recurring ticket modals (larger size, type/assignee fields)
+- Made dashboard stat cards clickable for quick filtering
+- Fixed table overflow on dashboard
+- Improved error handling for ticket dependencies API
## Project Overview
-Tinker Tickets is a feature-rich, self-hosted ticket management system built for managing data center infrastructure issues. It features SSO integration with Authelia/LLDAP, workflow management, Discord notifications, and a comprehensive web interface.
+Tinker Tickets is a feature-rich, self-hosted ticket management system built for managing data center infrastructure issues. It features SSO integration with Authelia/LLDAP, workflow management, Discord notifications, and a retro terminal-style web interface.
**Tech Stack:**
- Backend: PHP 7.4+ with MySQLi
@@ -40,57 +54,100 @@ Controllers → Models → Database
Views
```
-### Project Structure (Updated)
+### Project Structure
```
/tinker_tickets/
├── api/ # API endpoints
│ ├── add_comment.php # POST: Add comment
-│ ├── assign_ticket.php # POST: Assign ticket to user (NEW)
-│ ├── bulk_operation.php # POST: Bulk operations - admin only (NEW)
-│ ├── get_template.php # GET: Fetch ticket template (NEW)
-│ ├── get_users.php # GET: Get user list (NEW)
-│ └── update_ticket.php # POST: Update ticket (workflow validation)
+│ ├── assign_ticket.php # POST: Assign ticket to user
+│ ├── bulk_operation.php # POST: Bulk operations - admin only
+│ ├── check_duplicates.php # GET: Check for duplicate tickets
+│ ├── delete_attachment.php # POST/DELETE: Delete attachment
+│ ├── export_tickets.php # GET: Export tickets to CSV/JSON
+│ ├── get_template.php # GET: Fetch ticket template
+│ ├── get_users.php # GET: Get user list
+│ ├── manage_recurring.php # CRUD: Recurring tickets (admin)
+│ ├── manage_templates.php # CRUD: Templates (admin)
+│ ├── manage_workflows.php # CRUD: Workflow rules (admin)
+│ ├── ticket_dependencies.php # GET/POST/DELETE: Ticket dependencies
+│ ├── update_ticket.php # POST: Update ticket (workflow validation)
+│ └── upload_attachment.php # GET/POST: List or upload attachments
├── assets/
│ ├── css/
-│ │ ├── dashboard.css # Shared + dashboard + bulk actions
-│ │ └── ticket.css # Ticket + timeline + dark mode fixes
+│ │ ├── dashboard.css # Dashboard + terminal styling
+│ │ └── ticket.css # Ticket view styling
│ ├── js/
-│ │ ├── dashboard.js # Dashboard + hamburger + bulk actions + templates
-│ │ └── ticket.js # Ticket + comments + status updates + assignment
+│ │ ├── advanced-search.js # Advanced search modal
+│ │ ├── ascii-banner.js # ASCII art banner
+│ │ ├── dashboard.js # Dashboard + bulk actions + templates
+│ │ ├── keyboard-shortcuts.js # Keyboard shortcuts
+│ │ ├── markdown.js # Markdown rendering
+│ │ ├── settings.js # User preferences
+│ │ ├── ticket.js # Ticket + comments + assignment
+│ │ └── toast.js # Toast notifications
│ └── images/
│ └── favicon.png
├── config/
│ └── config.php # Config + .env loading
-├── controllers/ # MVC Controllers
-│ ├── DashboardController.php # Dashboard with assigned_to column
+├── controllers/
+│ ├── DashboardController.php # Dashboard with stats + filters
│ └── TicketController.php # Ticket CRUD + timeline + templates
-├── models/ # Data models
+├── cron/
+│ └── create_recurring_tickets.php # Process recurring ticket schedules
+├── helpers/
+│ └── ResponseHelper.php # Standardized JSON responses
+├── middleware/
+│ ├── AuthMiddleware.php # Authelia SSO integration
+│ ├── CsrfMiddleware.php # CSRF protection
+│ ├── RateLimitMiddleware.php # API rate limiting
+│ └── SecurityHeadersMiddleware.php # Security headers
+├── models/
│ ├── AuditLogModel.php # Audit logging + timeline
-│ ├── BulkOperationsModel.php # Bulk operations tracking (NEW)
+│ ├── BulkOperationsModel.php # Bulk operations tracking
│ ├── CommentModel.php # Comment data access
-│ ├── TemplateModel.php # Ticket templates (NEW)
+│ ├── CustomFieldModel.php # Custom field definitions/values
+│ ├── DependencyModel.php # Ticket dependencies
+│ ├── RecurringTicketModel.php # Recurring ticket schedules
+│ ├── StatsModel.php # Dashboard statistics
+│ ├── TemplateModel.php # Ticket templates
│ ├── TicketModel.php # Ticket CRUD + assignment
-│ ├── UserModel.php # User management (NEW)
-│ └── WorkflowModel.php # Status transition workflows (NEW)
-├── views/ # PHP templates
+│ ├── UserModel.php # User management
+│ ├── UserPreferencesModel.php # User preferences
+│ └── WorkflowModel.php # Status transition workflows
+├── scripts/
+│ └── cleanup_orphan_uploads.php # Clean orphaned uploads
+├── uploads/ # File attachment storage
+├── views/
+│ ├── admin/
+│ │ ├── AuditLogView.php # Audit log browser
+│ │ ├── CustomFieldsView.php # Custom field management
+│ │ ├── RecurringTicketsView.php # Recurring ticket management
+│ │ ├── TemplatesView.php # Template management
+│ │ ├── UserActivityView.php # User activity report
+│ │ └── WorkflowDesignerView.php # Workflow transition designer
│ ├── CreateTicketView.php # Ticket creation with templates
-│ ├── DashboardView.php # Dashboard with bulk actions + assigned column
+│ ├── DashboardView.php # Dashboard with stats + bulk actions
│ └── TicketView.php # Ticket view with timeline + assignment
-├── migrations/ # Database migrations
-│ ├── 001_initial_schema.sql
-│ ├── 007_add_ticket_assignment.sql # Ticket assignment
-│ ├── 008_add_status_workflows.sql # Workflow rules
-│ ├── 009_add_ticket_templates.sql # Ticket templates
-│ ├── 010_add_bulk_operations.sql # Bulk operations
-│ └── 011_remove_view_tracking.sql # Remove view audit logs
-├── .env # Environment variables (GITIGNORED)
-├── Claude.md # This file
-├── README.md # User documentation
-├── index.php # Dashboard entry point
-└── ticket.php # Ticket view/create router
+├── .env # Environment variables (GITIGNORED)
+├── Claude.md # This file
+├── README.md # User documentation
+└── index.php # Main router
```
-## Database Schema (Updated)
+## Admin Pages
+
+All admin pages are accessible via the **Admin dropdown** in the dashboard header (for admin users only).
+
+| Route | Description |
+|-------|-------------|
+| `/admin/templates` | Create and edit ticket templates |
+| `/admin/workflow` | Visual workflow transition designer |
+| `/admin/recurring-tickets` | Manage recurring ticket schedules |
+| `/admin/custom-fields` | Define custom fields per category |
+| `/admin/user-activity` | View per-user activity statistics |
+| `/admin/audit-log` | Browse all audit log entries |
+
+## Database Schema
**Database**: `ticketing_system` at 10.10.10.50
**User**: `tinkertickets`
@@ -98,443 +155,63 @@ Controllers → Models → Database
### Core Tables
-#### `tickets` Table (Updated)
-```sql
-CREATE TABLE tickets (
- ticket_id INT AUTO_INCREMENT PRIMARY KEY,
- title VARCHAR(255) NOT NULL,
- description TEXT,
- status VARCHAR(50) DEFAULT 'Open',
- priority INT DEFAULT 4,
- category VARCHAR(50) DEFAULT 'General',
- type VARCHAR(50) DEFAULT 'Issue',
- created_by INT, -- User who created
- updated_by INT, -- User who last updated
- assigned_to INT, -- User assigned to (NEW)
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
- FOREIGN KEY (created_by) REFERENCES users(user_id),
- FOREIGN KEY (updated_by) REFERENCES users(user_id),
- FOREIGN KEY (assigned_to) REFERENCES users(user_id) ON DELETE SET NULL,
- INDEX idx_status (status),
- INDEX idx_assigned_to (assigned_to)
-) ENGINE=InnoDB;
-```
+- `tickets` - Core ticket data with assignment
+- `ticket_comments` - Markdown-supported comments
+- `ticket_attachments` - File attachment metadata
+- `ticket_dependencies` - Ticket relationships (blocks/blocked_by/relates_to/duplicates)
+- `users` - User accounts synced from LLDAP
+- `user_preferences` - User settings and preferences
+- `audit_log` - Complete audit trail
+- `status_transitions` - Workflow configuration
+- `ticket_templates` - Reusable ticket templates
+- `recurring_tickets` - Scheduled ticket definitions
+- `custom_field_definitions` - Custom field schemas
+- `custom_field_values` - Custom field data per ticket
+- `saved_filters` - User-saved dashboard filters
+- `bulk_operations` - Bulk operation tracking
-#### `users` Table (SSO Integration)
-```sql
-CREATE TABLE users (
- user_id INT AUTO_INCREMENT PRIMARY KEY,
- username VARCHAR(100) UNIQUE NOT NULL,
- display_name VARCHAR(255),
- email VARCHAR(255),
- is_admin BOOLEAN DEFAULT FALSE,
- last_login TIMESTAMP NULL,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB;
-```
-
-#### `comments` Table
-```sql
-CREATE TABLE comments (
- comment_id INT AUTO_INCREMENT PRIMARY KEY,
- ticket_id INT NOT NULL,
- user_id INT,
- comment_text TEXT NOT NULL,
- markdown_enabled BOOLEAN DEFAULT FALSE,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- FOREIGN KEY (ticket_id) REFERENCES tickets(ticket_id) ON DELETE CASCADE,
- FOREIGN KEY (user_id) REFERENCES users(user_id),
- INDEX idx_ticket_id (ticket_id)
-) ENGINE=InnoDB;
-```
-
-#### `audit_log` Table (Activity Timeline)
-```sql
-CREATE TABLE audit_log (
- log_id INT AUTO_INCREMENT PRIMARY KEY,
- user_id INT,
- action_type VARCHAR(50) NOT NULL, -- 'create', 'update', 'comment', 'assign', etc.
- entity_type VARCHAR(50) NOT NULL, -- 'ticket', 'comment'
- entity_id INT NOT NULL, -- ticket_id or comment_id
- details JSON, -- JSON details of what changed
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- FOREIGN KEY (user_id) REFERENCES users(user_id),
- INDEX idx_entity (entity_type, entity_id),
- INDEX idx_user (user_id),
- INDEX idx_action (action_type)
-) ENGINE=InnoDB;
-```
-
-#### `status_transitions` Table (Workflow Rules)
-```sql
-CREATE TABLE status_transitions (
- transition_id INT AUTO_INCREMENT PRIMARY KEY,
- from_status VARCHAR(50) NOT NULL,
- to_status VARCHAR(50) NOT NULL,
- requires_comment BOOLEAN DEFAULT FALSE, -- Transition requires comment
- requires_admin BOOLEAN DEFAULT FALSE, -- Transition requires admin
- is_active BOOLEAN DEFAULT TRUE,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- UNIQUE KEY unique_transition (from_status, to_status),
- INDEX idx_from_status (from_status)
-) ENGINE=InnoDB;
-```
-
-Default transitions:
-```sql
--- Open → Pending → In Progress → Closed
--- In Progress → Closed, Pending
--- Closed → X
-```
-
-#### `ticket_templates` Table
-```sql
-CREATE TABLE ticket_templates (
- template_id INT AUTO_INCREMENT PRIMARY KEY,
- template_name VARCHAR(100) NOT NULL,
- title_template VARCHAR(255) NOT NULL,
- description_template TEXT NOT NULL,
- category VARCHAR(50),
- type VARCHAR(50),
- default_priority INT DEFAULT 4,
- created_by INT,
- is_active BOOLEAN DEFAULT TRUE,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- FOREIGN KEY (created_by) REFERENCES users(user_id),
- INDEX idx_template_name (template_name)
-) ENGINE=InnoDB;
-```
-
-Default templates: Hardware Failure, Software Installation, Network Issue, Maintenance Request
-
-#### `bulk_operations` Table
-```sql
-CREATE TABLE bulk_operations (
- operation_id INT AUTO_INCREMENT PRIMARY KEY,
- operation_type VARCHAR(50) NOT NULL, -- 'bulk_close', 'bulk_assign', 'bulk_priority'
- ticket_ids TEXT NOT NULL, -- Comma-separated ticket IDs
- performed_by INT NOT NULL,
- parameters JSON, -- Operation parameters
- status VARCHAR(20) DEFAULT 'pending',
- total_tickets INT,
- processed_tickets INT DEFAULT 0,
- failed_tickets INT DEFAULT 0,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- completed_at TIMESTAMP NULL,
- FOREIGN KEY (performed_by) REFERENCES users(user_id),
- INDEX idx_performed_by (performed_by),
- INDEX idx_created_at (created_at)
-) ENGINE=InnoDB;
-```
-
-## API Endpoints (Updated)
+## API Endpoints
### Authentication
All API endpoints check: `$_SESSION['user']['user_id']` for authentication.
Admin-only endpoints check: `$_SESSION['user']['is_admin']`.
-### POST `/api/update_ticket.php`
-Updates ticket with workflow validation.
+### Core Endpoints
-**Request:**
-```json
-{
- "ticket_id": 123,
- "status": "In Progress", // Validated against workflow rules
- "priority": 2,
- "title": "Updated title",
- "description": "...",
- "category": "Software",
- "type": "Task"
-}
-```
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/update_ticket.php` | POST | Update ticket with workflow validation |
+| `/api/assign_ticket.php` | POST | Assign ticket to user |
+| `/api/add_comment.php` | POST | Add comment to ticket |
+| `/api/get_template.php` | GET | Fetch ticket template |
+| `/api/get_users.php` | GET | Get user list for assignments |
+| `/api/bulk_operation.php` | POST | Perform bulk operations (admin) |
+| `/api/ticket_dependencies.php` | GET/POST/DELETE | Manage ticket dependencies |
+| `/api/upload_attachment.php` | GET/POST | List or upload attachments |
+| `/api/delete_attachment.php` | POST/DELETE | Delete attachment |
+| `/api/export_tickets.php` | GET | Export tickets to CSV/JSON |
+| `/api/check_duplicates.php` | GET | Check for duplicate tickets |
-**Response:**
-```json
-{
- "success": true,
- "status": "In Progress",
- "priority": 2,
- "message": "Ticket updated successfully"
-}
-```
+## Dashboard Features
-**Features:**
-- Workflow validation via WorkflowModel
-- Partial updates (only send changed fields)
-- User tracking (updated_by)
-- Discord webhook notifications
-- Audit logging
+- **Stats Widgets**: Clickable cards for quick filtering (Open, Critical, Unassigned, Created Today, Closed Today)
+- **Admin Dropdown**: Quick access to all admin pages
+- **Sortable Columns**: Click headers to sort
+- **Advanced Search**: Date ranges, priority ranges, user filters
+- **Saved Filters**: Save and load custom filter combinations
+- **Bulk Actions** (admin): Select multiple tickets for bulk close/assign/priority/status
+- **Export**: Export selected tickets to CSV or JSON
+- **Left Sidebar**: Status, Category, Type filters
-### POST `/api/assign_ticket.php` (NEW)
-Assigns ticket to a user.
+## Terminal UI Design
-**Request:**
-```json
-{
- "ticket_id": 123,
- "assigned_to": 5 // user_id, or null to unassign
-}
-```
-
-**Response:**
-```json
-{
- "success": true
-}
-```
-
-### GET `/api/get_users.php` (NEW)
-Returns list of all users for assignment dropdowns.
-
-**Response:**
-```json
-{
- "success": true,
- "users": [
- {
- "user_id": 1,
- "username": "jared",
- "display_name": "Jared Vititoe",
- "is_admin": true
- }
- ]
-}
-```
-
-### GET `/api/get_template.php?template_id=1` (NEW)
-Fetches a ticket template.
-
-**Response:**
-```json
-{
- "success": true,
- "template": {
- "template_id": 1,
- "template_name": "Hardware Failure",
- "title_template": "Hardware Failure: [Device Name]",
- "description_template": "Device: \nIssue: \n...",
- "category": "Hardware",
- "type": "Problem",
- "default_priority": 2
- }
-}
-```
-
-### POST `/api/bulk_operation.php` (NEW - ADMIN ONLY)
-Performs bulk operations on tickets.
-
-**Request:**
-```json
-{
- "operation_type": "bulk_close", // or 'bulk_assign', 'bulk_priority'
- "ticket_ids": [123, 456, 789],
- "parameters": { // For bulk_assign or bulk_priority
- "assigned_to": 5, // For bulk_assign
- "priority": 2 // For bulk_priority
- }
-}
-```
-
-**Response:**
-```json
-{
- "success": true,
- "operation_id": 42,
- "processed": 3,
- "failed": 0,
- "message": "Bulk operation completed: 3 succeeded, 0 failed"
-}
-```
-
-### POST `/api/add_comment.php`
-Adds comment to ticket.
-
-**Request:**
-```json
-{
- "ticket_id": 123,
- "comment_text": "Comment content",
- "markdown_enabled": true
-}
-```
-
-**Response:**
-```json
-{
- "success": true,
- "user_name": "Jared Vititoe",
- "created_at": "Jan 01, 2026 12:00"
-}
-```
-
-## Key Features Implementation
-
-### Feature 1: Activity Timeline
-**Location**: Ticket view → Activity tab
-
-**Implementation**:
-- `AuditLogModel->getTicketTimeline()` - Fetches all events for a ticket
-- Shows: creates, updates, comments, assignments, status changes
-- Displays: user, action, timestamp, details
-- CSS: timeline-content boxes with icons
-- Dark mode: Fully supported
-
-**Code**: `views/TicketView.php:258-282`, `models/AuditLogModel.php:getTicketTimeline()`
-
-### Feature 2: Ticket Assignment
-**Location**: Ticket view → "Assigned to" dropdown, Dashboard → "Assigned To" column
-
-**Implementation**:
-- Database: `tickets.assigned_to` column
-- Models: `TicketModel->assignTicket()`, `TicketModel->unassignTicket()`
-- API: `api/assign_ticket.php`
-- Dashboard: Shows assigned user in table
-- Auto-saves on change
-- Audit logged
-
-**Code**: `views/TicketView.php:170-181`, `assets/js/ticket.js:handleAssignmentChange()`
-
-### Feature 3: Status Transitions with Workflows
-**Location**: Ticket view → Status dropdown (header)
-
-**Implementation**:
-- Database: `status_transitions` table defines allowed transitions
-- Models: `WorkflowModel->isTransitionAllowed()`, `WorkflowModel->getAllowedTransitions()`
-- Dropdown shows only valid transitions for current status
-- Server-side validation prevents invalid changes
-- Can require comments or admin privileges
-- Removed from hamburger menu (was duplicate)
-
-**Code**: `models/WorkflowModel.php`, `api/update_ticket.php:130-144`, `views/TicketView.php:185-198`
-
-### Feature 4: Ticket Templates
-**Location**: Create ticket page → Template selector
-
-**Implementation**:
-- Database: `ticket_templates` table
-- Models: `TemplateModel->getAllTemplates()`, `TemplateModel->getTemplateById()`
-- API: `api/get_template.php`
-- JavaScript: `loadTemplate()` in dashboard.js
-- Auto-fills: title, description, category, type, priority
-- 4 default templates included
-
-**Code**: `views/CreateTicketView.php:27-39`, `assets/js/dashboard.js:loadTemplate()`
-
-### Feature 5: Bulk Actions (Admin Only)
-**Location**: Dashboard → Checkboxes + Toolbar (admins only)
-
-**Implementation**:
-- Database: `bulk_operations` table tracks operations
-- Models: `BulkOperationsModel->processBulkOperation()`
-- API: `api/bulk_operation.php`
-- UI: Toolbar appears when tickets selected
-- Operations: Bulk close, bulk assign, bulk priority
-- All operations audit logged
-- Server-side admin validation
-
-**Code**: `views/DashboardView.php:176-188`, `assets/js/dashboard.js:bulkClose()`, `models/BulkOperationsModel.php`
-
-## Authentication & SSO Integration
-
-### Authelia Integration
-User information passed via HTTP headers:
-- `Remote-User`: Username
-- `Remote-Name`: Display name
-- `Remote-Email`: Email
-- `Remote-Groups`: Comma-separated groups
-
-### Session Management
-```php
-$_SESSION['user'] = [
- 'user_id' => 123,
- 'username' => 'jared',
- 'display_name' => 'Jared Vititoe',
- 'email' => 'jared@lotusguild.org',
- 'is_admin' => true // true if 'admins' in Remote-Groups
-];
-```
-
-### Admin Privileges
-- Bulk operations (close, assign, priority)
-- Future: Admin-only transitions
-
-## Frontend Components (Updated)
-
-### Dashboard (`DashboardView.php` + `dashboard.js`)
-
-**Features**:
-- Sortable columns including new "Assigned To" column
-- Search (title, description, ticket_id, category, type)
-- Status filtering (default: Open + In Progress)
-- Pagination (configurable)
-- Dark mode toggle
-- **Bulk Actions Toolbar** (admin only):
- - Checkboxes on each ticket
- - "Select All" checkbox
- - Bulk close, assign, priority buttons
- - Shows count of selected tickets
-
-**Hamburger Menu**:
-- Category/Type filtering
-- Apply/Clear filters
-- No status field (removed)
-
-### Ticket View (`TicketView.php` + `ticket.js`)
-
-**Features**:
-- **Tabbed Interface**: Description, Comments, Activity
-- **Activity Timeline**: Complete audit trail with icons
-- **Assignment Dropdown**: Assign to users
-- **Status Dropdown**: Workflow-validated status changes (header)
-- **Hamburger Menu**: Priority, Category, Type editing
-- **Edit Button**: Title and description editing
-- **Markdown Comments**: With live preview
-- **Dark Mode**: Comprehensive support
-
-**Visual Indicators**:
-- Priority colors (P1=Red, P2=Orange, P3=Blue, P4=Green, P5=Gray)
-- Status badges (Open=Green, In Progress=Yellow, Closed=Red)
-- Priority border colors on ticket container
-
-### Create Ticket (`CreateTicketView.php`)
-
-**Features**:
-- **Template Selector**: Quick-fill from templates
-- Standard fields: title, description, status, priority, category, type
-- Form validation
-- Discord webhook on creation
-
-## Dark Mode (Fixed)
-
-### Comprehensive Dark Mode CSS
-**Files**: `assets/css/ticket.css`, `assets/css/dashboard.css`
-
-**Colors**:
-```css
-body.dark-mode {
- --bg-primary: #1a202c; /* Main background */
- --bg-secondary: #2d3748; /* Cards, inputs */
- --bg-tertiary: #4a5568; /* Hover states */
- --text-primary: #e2e8f0; /* Main text */
- --text-secondary: #cbd5e0; /* Secondary text */
- --text-muted: #a0aec0; /* Muted text */
- --border-color: #4a5568; /* Borders */
-}
-```
-
-**Fixed Elements**:
-- Timeline boxes (background + text)
-- Bulk actions toolbar
-- Tables and table rows
-- Input fields and textareas
-- Dropdowns and selects
-- Comment boxes
-- Modal dialogs
-- All text elements
-
-**Important**: Used `!important` flags to override any conflicting styles.
+The application uses a retro terminal aesthetic with:
+- **Box-drawing characters**: ╔═╗║╚═╝┌─┐│└─┘
+- **Monospace fonts**: Courier New, Consolas, Monaco
+- **Terminal colors**: Green (#00ff41), Amber (#ffb000), Cyan (#00ffff)
+- **CRT effects**: Scanlines, subtle flicker
+- **Glow effects**: Text shadows for terminal phosphor look
+- **ASCII art**: Boot sequence, empty states, headers
## Configuration
@@ -549,27 +226,6 @@ DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
**CRITICAL**: `.env` is gitignored! Never commit this file.
-### Apache Configuration
-**Virtual Host**: Apache serving from `/root/code/tinker_tickets`
-
-```apache
-
- ServerName t.lotusguild.org
- DocumentRoot /root/code/tinker_tickets
-
-
- Options -Indexes +FollowSymLinks
- AllowOverride All
- Require all granted
-
- RewriteEngine On
- RewriteBase /
- RewriteRule ^ticket/([0-9]+)$ ticket.php?id=$1 [L,QSA]
- RewriteRule ^ticket/create$ ticket.php?action=create [L,QSA]
-
-
-```
-
## Deployment
### Git Auto-Deploy
@@ -579,17 +235,6 @@ DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
1. Push to `main` branch
2. Auto-deploys to `/root/code/tinker_tickets` on 10.10.10.45
3. `.env` is preserved
-4. Migrations must be run manually
-
-### Running Migrations
-```bash
-cd /root/code/tinker_tickets/migrations
-mysql -h 10.10.10.50 -u tinkertickets -p'pass' ticketing_system < 007_add_ticket_assignment.sql
-mysql -h 10.10.10.50 -u tinkertickets -p'pass' ticketing_system < 008_add_status_workflows.sql
-mysql -h 10.10.10.50 -u tinkertickets -p'pass' ticketing_system < 009_add_ticket_templates.sql
-mysql -h 10.10.10.50 -u tinkertickets -p'pass' ticketing_system < 010_add_bulk_operations.sql
-mysql -h 10.10.10.50 -u tinkertickets -p'pass' ticketing_system < 011_remove_view_tracking.sql
-```
## Development Guidelines
@@ -601,123 +246,45 @@ mysql -h 10.10.10.50 -u tinkertickets -p'pass' ticketing_system < 011_remove_vie
### Error Handling
- APIs return JSON with `{success: bool, error: string}`
-- Debug logging to `/tmp/api_debug.log` (update_ticket.php)
+- Debug logging to `/tmp/api_debug.log`
- User-friendly error messages
### Adding New Features
-1. **Database**: Create migration in `migrations/`
-2. **Model**: Add methods to relevant Model class
-3. **API**: Create API endpoint in `api/` (with auth check)
-4. **Controller**: Update controller to load data
-5. **View**: Add UI elements
-6. **JavaScript**: Add interactivity
-7. **CSS**: Style for light + dark mode
-8. **Test**: Test thoroughly before pushing
-
-## ANSI Art Redesign (Next Priority)
-
-### Goal
-Transform Tinker Tickets into a retro terminal aesthetic using ANSI art and ASCII characters.
-
-### Design Concept
-- **Terminal-style borders**: Use box-drawing characters (┌─┐│└─┘)
-- **Monospace fonts**: Courier New, Consolas, Monaco
-- **ASCII art headers**: Stylized "TINKER TICKETS" banner
-- **Retro color palette**: Green terminal, amber terminal, or custom
-- **Template objects**: Reusable border/box components
-
-### Implementation Approach
-1. **CSS Variables**: Define ANSI color palette
-2. **Border Components**: Create CSS classes for boxes with ASCII borders
-3. **Typography**: Monospace fonts throughout
-4. **Icons**: Replace emoji with ASCII art
-5. **Dashboard**: Terminal-style table with borders
-6. **Tickets**: Box-drawing characters for sections
-7. **Forms**: Terminal-style input boxes
-
-### Reference Colors (Classic Terminal)
-```css
-:root {
- --ansi-black: #000000;
- --ansi-green: #00ff00;
- --ansi-amber: #ffb000;
- --ansi-blue: #0000ff;
- --ansi-cyan: #00ffff;
- --ansi-white: #ffffff;
- --ansi-bg: #000000;
-}
-```
-
-### Example Box Template
-```
-┌─────────────────────────────┐
-│ TICKET #123 │
-├─────────────────────────────┤
-│ Title: Hardware Failure │
-│ Status: [OPEN] │
-│ Priority: P1 (CRITICAL) │
-└─────────────────────────────┘
-```
-
-## Debugging
-
-### Common Issues
-```bash
-# API debug logs
-tail -f /tmp/api_debug.log
-
-# Database connection
-mysql -h 10.10.10.50 -u tinkertickets -p ticketing_system
-
-# JavaScript console
-# Open browser DevTools (F12) → Console tab
-
-# Check dark mode
-# localStorage.getItem('theme')
-```
-
-### Known Behaviors
-- Ticket viewing no longer tracked (011 migration removes view logs)
-- Status can only be changed via header dropdown (removed from hamburger)
-- Bulk actions only visible to admins
-- Templates are optional when creating tickets
-- Workflow validation prevents invalid status transitions
+1. **Model**: Add methods to relevant Model class
+2. **API**: Create API endpoint in `api/` (with auth check)
+3. **Controller**: Update controller to load data
+4. **View**: Add UI elements
+5. **JavaScript**: Add interactivity
+6. **CSS**: Style with terminal aesthetic
+7. **Test**: Test thoroughly before pushing
## Important Notes for AI Assistants
-1. **All 5 features are complete and deployed**
-2. **Dark mode is fixed** with comprehensive CSS
-3. **Next priority is ANSI Art redesign** (major visual overhaul)
-4. **Database at 10.10.10.50**, can't access directly from dev machine
-5. **Auto-deploy is active**, test carefully before pushing
-6. **Session format**: `$_SESSION['user']['user_id']` (not `$_SESSION['user_id']`)
-7. **API auth**: Check `$_SESSION['user']['user_id']` exists
-8. **Admin check**: `$_SESSION['user']['is_admin'] ?? false`
-9. **Config path**: `config/config.php` (not `config/db.php`)
-10. **Migrations**: Must be run manually on database server
+1. **All features are complete and deployed**
+2. **Terminal UI redesign is complete** - maintain the aesthetic
+3. **Database at 10.10.10.50**, can't access directly from dev machine
+4. **Auto-deploy is active**, test carefully before pushing
+5. **Session format**: `$_SESSION['user']['user_id']` (not `$_SESSION['user_id']`)
+6. **API auth**: Check `$_SESSION['user']['user_id']` exists
+7. **Admin check**: `$_SESSION['user']['is_admin'] ?? false`
+8. **Config path**: `config/config.php` (not `config/db.php`)
+9. **Comments table**: `ticket_comments` (not `comments`)
+10. **CSRF**: Required for POST/DELETE requests via `X-CSRF-Token` header
## File Reference Quick Guide
-| File | Purpose | Key Functions |
-|------|---------|---------------|
-| `index.php` | Dashboard router | Database connection, routing |
-| `ticket.php` | Ticket router | View/create ticket routing |
-| `api/update_ticket.php` | Update API | Workflow validation, partial updates |
-| `api/assign_ticket.php` | Assignment API | Assign/unassign tickets |
-| `api/bulk_operation.php` | Bulk ops API | Admin bulk operations |
-| `api/get_template.php` | Template API | Fetch ticket templates |
-| `api/get_users.php` | Users API | Get user list |
-| `models/TicketModel.php` | Ticket data | CRUD, assignment, filtering |
-| `models/WorkflowModel.php` | Workflow rules | Status transition validation |
-| `models/AuditLogModel.php` | Audit logging | Timeline, activity tracking |
-| `models/TemplateModel.php` | Templates | Template CRUD |
-| `models/BulkOperationsModel.php` | Bulk ops | Process bulk operations |
-| `controllers/DashboardController.php` | Dashboard logic | Pagination, filters, assigned column |
-| `controllers/TicketController.php` | Ticket logic | CRUD, timeline, templates |
-| `assets/js/dashboard.js` | Dashboard UI | Filters, bulk actions, templates |
-| `assets/js/ticket.js` | Ticket UI | Status updates, assignment, comments |
-| `assets/css/dashboard.css` | Dashboard styles | Layout, table, bulk toolbar, dark mode |
-| `assets/css/ticket.css` | Ticket styles | Timeline, ticket view, dark mode |
+| File | Purpose |
+|------|---------|
+| `index.php` | Main router for all routes |
+| `api/update_ticket.php` | Ticket updates with workflow validation |
+| `api/ticket_dependencies.php` | Manage ticket dependencies |
+| `models/TicketModel.php` | Ticket CRUD, assignment, filtering |
+| `models/WorkflowModel.php` | Status transition validation |
+| `models/DependencyModel.php` | Ticket dependency management |
+| `controllers/DashboardController.php` | Dashboard logic, stats, filters |
+| `assets/js/dashboard.js` | Dashboard UI, bulk actions, templates |
+| `assets/js/ticket.js` | Ticket UI, comments, assignment |
+| `assets/css/dashboard.css` | Terminal styling, layout, components |
## Repository & Contact
diff --git a/README.md b/README.md
index f55c0d4..f56419a 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,14 @@
# Tinker Tickets
-A feature-rich PHP-based ticketing system designed for tracking and managing data center infrastructure issues with enterprise-grade workflow management.
+A feature-rich PHP-based ticketing system designed for tracking and managing data center infrastructure issues with enterprise-grade workflow management and a retro terminal aesthetic.
## Core Features
### Dashboard & Ticket Management
- **Smart Dashboard**: Sortable columns, advanced filtering by status/priority/category/type
+- **Stats Widgets**: Clickable cards for quick filtering (Open, Critical, Unassigned, Today's tickets)
- **Full-Text Search**: Search across tickets, descriptions, and metadata
+- **Advanced Search**: Date ranges, priority ranges, user filters with saved filter support
- **Ticket Assignment**: Assign tickets to specific users with quick-assign from dashboard
- **Priority Tracking**: P1 (Critical) to P5 (Minimal Impact) with color-coded indicators
- **Custom Categories**: Hardware, Software, Network, Security, General
@@ -57,14 +59,16 @@ A feature-rich PHP-based ticketing system designed for tracking and managing dat
- **Bulk Status**: Change status for multiple tickets
### Admin Pages
+Access all admin pages via the **Admin dropdown** in the dashboard header.
+
| Route | Description |
|-------|-------------|
+| `/admin/templates` | Create and edit ticket templates |
+| `/admin/workflow` | Visual workflow transition designer |
| `/admin/recurring-tickets` | Manage recurring ticket schedules |
| `/admin/custom-fields` | Define custom fields per category |
-| `/admin/workflow` | Visual workflow transition designer |
-| `/admin/templates` | Create and edit ticket templates |
-| `/admin/audit-log` | Browse all audit log entries |
| `/admin/user-activity` | View per-user activity statistics |
+| `/admin/audit-log` | Browse all audit log entries |
### Notifications
- **Discord Integration**: Webhook notifications for ticket creation and updates
@@ -86,9 +90,10 @@ A feature-rich PHP-based ticketing system designed for tracking and managing dat
- **Architecture**: MVC pattern with models, views, controllers
### Frontend
-- **HTML5/CSS3**: Semantic markup with modern CSS
+- **HTML5/CSS3**: Semantic markup with retro terminal styling
- **JavaScript**: Vanilla JS with Fetch API for AJAX
- **Markdown**: Custom markdown parser with toolbar
+- **Terminal UI**: Box-drawing characters, monospace fonts, CRT effects
### Database Tables
| Table | Purpose |
@@ -137,7 +142,7 @@ DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
### 2. Database Setup
-The database schema is managed through migrations. For a fresh install, run all migrations in order using the migration runner.
+The database schema should already be configured. For a fresh install, contact the system administrator for database setup instructions.
### 3. Cron Jobs
@@ -188,7 +193,6 @@ tinker_tickets/
├── uploads/ # File upload storage
├── views/ # View templates
│ └── admin/ # Admin panel views
-├── migrations/ # Database migrations
├── index.php # Main router
└── .env # Environment configuration
```
diff --git a/api/ticket_dependencies.php b/api/ticket_dependencies.php
index 89eeb71..0bd0c39 100644
--- a/api/ticket_dependencies.php
+++ b/api/ticket_dependencies.php
@@ -1,18 +1,34 @@
false,
+ 'error' => 'Fatal: ' . $error['message'],
+ 'file' => basename($error['file']),
+ 'line' => $error['line']
+ ]);
+ }
+});
+
ini_set('display_errors', 0);
error_reporting(E_ALL);
-// Custom error handler to return JSON errors
+// Custom error handler
set_error_handler(function($errno, $errstr, $errfile, $errline) {
+ ob_end_clean();
http_response_code(500);
header('Content-Type: application/json');
echo json_encode([
@@ -26,6 +42,7 @@ set_error_handler(function($errno, $errstr, $errfile, $errline) {
// Custom exception handler
set_exception_handler(function($e) {
+ ob_end_clean();
http_response_code(500);
header('Content-Type: application/json');
echo json_encode([
@@ -81,6 +98,12 @@ if ($conn->connect_error) {
ResponseHelper::serverError('Database connection failed');
}
+// Check if ticket_dependencies table exists
+$tableCheck = $conn->query("SHOW TABLES LIKE 'ticket_dependencies'");
+if ($tableCheck->num_rows === 0) {
+ ResponseHelper::serverError('Ticket dependencies feature not available. The ticket_dependencies table does not exist. Please run the migration.');
+}
+
try {
$dependencyModel = new DependencyModel($conn);
$auditLog = new AuditLogModel($conn);
diff --git a/assets/css/dashboard.css b/assets/css/dashboard.css
index 9bf7d28..9cb5c63 100644
--- a/assets/css/dashboard.css
+++ b/assets/css/dashboard.css
@@ -3167,3 +3167,79 @@ tr:hover .quick-actions {
background: rgba(0, 255, 65, 0.1);
color: var(--terminal-amber);
}
+
+/* ===== ADMIN DROPDOWN ===== */
+.admin-dropdown {
+ position: relative;
+ display: inline-block;
+}
+
+.admin-dropdown .admin-badge {
+ cursor: pointer;
+ padding: 0.3rem 0.6rem;
+}
+
+.admin-dropdown-content {
+ display: none;
+ position: absolute;
+ top: 100%;
+ right: 0;
+ background: var(--bg-primary);
+ border: 2px solid var(--priority-1);
+ min-width: 180px;
+ z-index: 1000;
+ box-shadow: 0 0 15px rgba(255, 77, 77, 0.3);
+}
+
+.admin-dropdown-content.show {
+ display: block;
+}
+
+.admin-dropdown-content a {
+ display: block;
+ padding: 0.6rem 1rem;
+ color: var(--terminal-green);
+ text-decoration: none;
+ font-family: var(--font-mono);
+ font-size: 0.85rem;
+ transition: all 0.2s ease;
+ border-bottom: 1px solid var(--bg-tertiary);
+}
+
+.admin-dropdown-content a:last-child {
+ border-bottom: none;
+}
+
+.admin-dropdown-content a:hover {
+ background: rgba(255, 77, 77, 0.1);
+ color: var(--priority-1);
+ text-shadow: var(--glow-red);
+}
+
+/* ===== CLICKABLE STAT CARDS ===== */
+.stat-card:hover {
+ transform: translateY(-2px);
+}
+
+.stat-card:active {
+ transform: translateY(0);
+}
+
+/* ===== TABLE OVERFLOW FIX ===== */
+.ascii-content {
+ overflow-x: auto;
+}
+
+/* Reduce column widths for better fit */
+table th,
+table td {
+ padding: 8px 10px;
+ font-size: 0.85rem;
+}
+
+/* Make title column wrap if needed */
+table td:nth-child(4) {
+ max-width: 180px;
+ overflow: hidden;
+ text-overflow: ellipsis;
+}
diff --git a/index.php b/index.php
index 73b90f0..97ad2df 100644
--- a/index.php
+++ b/index.php
@@ -224,7 +224,6 @@ switch (true) {
(SELECT COUNT(*) FROM tickets t WHERE t.assigned_to = u.user_id AND DATE(t.created_at) BETWEEN ? AND ?) as tickets_assigned,
(SELECT MAX(al.created_at) FROM audit_log al WHERE al.user_id = u.user_id) as last_activity
FROM users u
- WHERE u.is_active = 1
ORDER BY tickets_created DESC, tickets_resolved DESC";
$stmt = $conn->prepare($sql);
diff --git a/migrations/run_migrations.php b/migrations/run_migrations.php
deleted file mode 100644
index 786683f..0000000
--- a/migrations/run_migrations.php
+++ /dev/null
@@ -1,107 +0,0 @@
-connect_error) {
- die("Database connection failed: " . $conn->connect_error . "\n");
-}
-
-echo "Connected to database: {$envVars['DB_NAME']}\n\n";
-
-// Get all migration files
-$migrationFiles = glob(__DIR__ . '/*.sql');
-sort($migrationFiles);
-
-// Filter out rollback script
-$migrationFiles = array_filter($migrationFiles, function($file) {
- return !strpos($file, 'rollback');
-});
-
-if (empty($migrationFiles)) {
- echo "No migration files found.\n";
- exit(0);
-}
-
-echo "Found " . count($migrationFiles) . " migration(s):\n";
-foreach ($migrationFiles as $file) {
- echo " - " . basename($file) . "\n";
-}
-echo "\n";
-
-// Execute each migration
-$successCount = 0;
-$errorCount = 0;
-
-foreach ($migrationFiles as $file) {
- $filename = basename($file);
- echo "Executing: $filename... ";
-
- $sql = file_get_contents($file);
-
- // Split SQL into individual statements
- // This handles multi-statement migrations
- if ($conn->multi_query($sql)) {
- do {
- // Store first result set
- if ($result = $conn->store_result()) {
- $result->free();
- }
- // Check for errors
- if ($conn->errno) {
- echo "FAILED\n";
- echo " Error: " . $conn->error . "\n";
- $errorCount++;
- break;
- }
- } while ($conn->more_results() && $conn->next_result());
-
- // If we got through all results without error
- if (!$conn->errno) {
- echo "OK\n";
- $successCount++;
- }
- } else {
- echo "FAILED\n";
- echo " Error: " . $conn->error . "\n";
- $errorCount++;
- }
-}
-
-echo "\n";
-echo "Migration Summary:\n";
-echo " Success: $successCount\n";
-echo " Errors: $errorCount\n";
-
-if ($errorCount > 0) {
- echo "\nSome migrations failed. Please review errors above.\n";
- exit(1);
-} else {
- echo "\nAll migrations completed successfully!\n";
- exit(0);
-}
-
-$conn->close();
diff --git a/views/DashboardView.php b/views/DashboardView.php
index 69942ca..6e41ede 100644
--- a/views/DashboardView.php
+++ b/views/DashboardView.php
@@ -79,7 +79,17 @@
👤
- Admin
+
@@ -667,5 +677,47 @@
+