Introduction

What is HACCPY?

HACCPY is an AI-powered food safety compliance monitoring platform. It helps organizations:

Monitor food safety in real time via cameras and AI detection
Track violations detected by the system (e.g. hygiene, PPE, temperature)
Manage checklists and submissions for compliance workflows
Monitor system health of locations and devices (bridges, tablets)
View enter-leave events for employees at locations

The app name reflects HACCP (Hazard Analysis Critical Control Point), a standard for food safety management.

Multi-Tenant Model

HACCPY is multi-tenant. Each organization (restaurant, facility, group) is a tenant with its own:

Slug — Short URL identifier (e.g. acme, restaurant-xyz)
Data — Locations, cameras, violations, checklists, employees, and settings are scoped to the tenant
Users & roles — Team members are invited per tenant and have roles (e.g. Admin, Manager, Employee)

All URLs are tenant-scoped: /{tenant}/dashboard, /{tenant}/violations, etc. Users with access to multiple tenants can switch tenants (e.g. via a tenant selector or account menu).

Key Concepts

Concept	Description
Tenant	An organization or site group. Data is isolated per tenant.
Location	A physical place (e.g. kitchen, warehouse) where cameras and devices are assigned.
Camera	A camera at a location used for monitoring and violation detection.
Device	Hardware at a location: Bridge (router/gateway) or Tab (tablet). Used for system health and sometimes for checklists.
Violation	A food-safety issue detected by AI (e.g. missing hat, unclean surface). Contains timestamp, location, camera, detections, and tags.
Checklist	A set of items to be completed (e.g. daily opening checklist). Users submit completed checklists.
Enter-Leave Event	A record of an employee entering or leaving a location.
Model	AI/ML model (e.g. for violation detection). Referenced in settings.

Main Areas of the App

Dashboard — Overview stats and charts (e.g. violations over time, by location).
Violations — List and filter AI-detected violations; open detail view with image and tags.
System Health — Locations, devices, CPU/RAM, uptime, and alerts (offline, high CPU/memory).
Checklists — List submissions; open/fill checklists; submit new submissions.
Enter-Leave Events — List events; filter by location, employee, date.
Settings — Configure locations, cameras, team, employees, checklists, models, devices, and global configuration.