Overview

Bloodhound is an internal report-building and signoff system used to document incidents, manage approvals, and distribute finalized reports.

The system supports:

Draft → Approval → Finalize workflow
Evidence collection (photos/video)
Employee signoff flows
Internal vs public report visibility
Core Workflow
Create Report (new_report.php)
Enter report details and narrative
Add evidence files (optional)
Save as Draft
Approval Process
Level 4 (Corporate) → requires Owner approval
Level 5 (Owner) → can approve and finalize directly
Finalize & Send
Report is locked
Emails are sent to selected recipients
Signoff process begins
Employee Signoff
Employees complete assigned acknowledgment/warning flows
Status updates tracked in reports index
Key Features
Reports Index
Central dashboard of all reports
Filtering by store and key fields
Auto-refresh capability
Hover preview of report content (formatted, scrollable)
Report Editor
Rich text formatting:
Bold, italic, underline
Text colors
Lists
Timeline-style structured entries
Evidence Handling
Supports image and video uploads
Files stored per-report in dedicated folders
Integrated with gallery viewing system
Signoff Flows
Acknowledgement
Warning
Warning + Breakage
Warning + Meals
Combination flows executed in required sequence
Internal Visibility Control
“Prepared By” can be masked publicly
Owner code unlock reveals internal details
Owner code:
4-character alphanumeric
Auto-unlock on entry
System Structure

Typical structure:

 /bloodhound/ald/
    /admin/
        new_report.php
        edit_report.php
        reports_index.php
    /reports/
    /data/
    config.php
Configuration

Key settings in config.php:

$APP_BASE_URL
Must match deployment path
Email settings
Used for report delivery and notifications
Server Requirements
Web server must have write access to:
/reports
/data
PHP environment with:
file upload support enabled
sufficient upload size limits for evidence files
Evidence Uploads

Supported file types:

Images: jpg, jpeg, png, gif, webp
Video: mp4, mov, avi, m4v

Behavior:

Files are stored per report
Additional files can be added during editing
Accessible via report and gallery links
Important Notes
Draft reports are editable; finalized reports are locked
Owner approval is required for Level 4 submissions
Email recipients are selectable but at least one is required
System is designed for incremental overlay updates (no full rebuilds)
Deployment Notes
System is updated using overlay packages
Only modified files are replaced
Existing data and reports remain intact
Summary

Bloodhound provides a controlled, structured workflow for:

documenting incidents
managing approvals
collecting employee acknowledgments
maintaining a clear, auditable record
8.4.0 note: Report fields now support live links. Use the Link toolbar button to turn highlighted text into a URL, or paste/type a full http(s) or www URL and it will display as a clickable link after saving.

