# Checklists Documentation

**Last Updated:** 2026-01-09

**Note:** This documentation has been enhanced with workflows from comprehensive helpdesk analysis. See `docs/content/helpdesk/MASTER_ANALYSIS_SUMMARY.md` for details.

## Basic Information

- **Feature Name:** Checklists
- **Slug:** checklists
- **Status:** Available
- **Related Product Pages:**
  - `v2/pages/product_checklists.php`
  - Product page: https://www.ordio.com/checklisten

## Overview

Optimiere die Abläufe in deinem Unternehmen mit Checklisten & interaktivem Aufgabenmanagement. Mit Ordio erstellst du individuelle Checklisten, koordinierst Aufgaben und sorgst für reibungslose Abläufe im Betrieb – alles zentral an einem Ort organisiert. Die digitale Checkliste von Ordio bietet sechs verschiedene Interaktions-Typen für unendliche Möglichkeiten der Anpassung an deine betrieblichen Bedürfnisse.

## Use Cases

### Daily Shift Opening Checklist

**Scenario:** A restaurant chain needs to ensure all opening procedures are completed consistently across all locations before service begins.

**Process:**

1. Manager creates "Opening Checklist" template with required tasks
2. Checklist automatically assigned to all employees in "Service" work area
3. Checklist scheduled to appear daily at shift start (e.g., 9:00 AM)
4. Employees receive notification via app
5. Employees complete checklist items (checkboxes, photos, confirmations)
6. System tracks completion status in real-time
7. Manager receives notification when checklist is completed
8. Completed checklists archived automatically
9. Reports generated showing completion rates and timestamps

**Benefits:** Ensures consistency, reduces errors by 60%, automatic tracking, compliance-ready documentation, mobile access.

### Cleaning Protocol Checklist

**Scenario:** A hotel needs to track cleaning procedures for each room, ensuring quality standards are met.

**Process:**

1. Housekeeping manager creates room cleaning checklist
2. Checklist includes tasks with photo requirements (before/after)
3. Checklist assigned to housekeeping staff role
4. Checklist appears when employee clocks in for shift
5. Employee completes each task, uploads photos as proof
6. System validates all required items completed
7. Supervisor reviews completed checklists
8. Quality reports generated automatically
9. Non-compliant checklists flagged for follow-up

**Benefits:** Quality assurance, visual proof, automatic validation, reduced supervision time, compliance documentation.

### Safety Inspection Checklist

**Scenario:** A manufacturing facility needs to conduct regular safety inspections with digital signatures for compliance.

**Process:**

1. Safety officer creates safety inspection checklist
2. Checklist includes text fields for observations, value inputs for measurements
3. Checklist requires supervisor signature for completion
4. Checklist scheduled weekly/monthly automatically
5. Inspector receives notification
6. Inspector completes checklist with photos, measurements, notes
7. Supervisor reviews and signs digitally
8. Completed checklist archived with full audit trail
9. Expiring inspections automatically flagged

**Benefits:** Compliance assurance, digital signatures, complete audit trail, automatic scheduling, mobile access.

### Incident Report Checklist

**Scenario:** A healthcare facility needs to document incidents with detailed information, photos, and signatures.

**Process:**

1. HR creates incident report checklist template
2. Checklist includes text fields, photo uploads, signature requirement
3. Checklist triggered manually when incident occurs
4. Staff member completes checklist with all required information
5. Photos uploaded as evidence
6. Supervisor reviews and signs
7. Report automatically archived
8. Compliance team receives notification
9. Reports exportable for audits

**Benefits:** Comprehensive documentation, digital signatures, photo evidence, automatic archiving, compliance-ready.

### Inventory Check Checklist

**Scenario:** A retail store needs to conduct daily inventory checks with value inputs and confirmations.

**Process:**

1. Store manager creates inventory checklist
2. Checklist includes value inputs for quantities, text fields for notes
3. Checklist assigned to inventory team
4. Scheduled daily at specific time
5. Employees complete checklist with actual quantities
6. System compares with expected values
7. Discrepancies automatically flagged
8. Manager receives notification of discrepancies
9. Reports generated for inventory management

**Benefits:** Accurate inventory tracking, automatic discrepancy detection, real-time updates, mobile access, data export.

## Target Audience

### Primary Users

**Operations Managers:**

- Daily responsibility for process management and quality assurance
- Need consistent process execution across teams
- Require compliance documentation and audit trails
- Benefit from automated reminders and status tracking

**Team Leaders:**

- Coordinate daily tasks and workflows
- Need visibility into task completion
- Require mobile access for on-the-go management
- Benefit from automatic notifications and reminders

**Quality Assurance Staff:**

- Ensure standards are met consistently
- Need visual proof and documentation
- Require audit-ready reports
- Benefit from automatic validation and flagging

**HR Managers:**

- Manage onboarding and training checklists
- Need compliance documentation
- Require digital signatures for legal compliance
- Benefit from automatic archiving and reporting

### Secondary Users

**Employees:**

- Complete assigned checklists
- Upload photos and provide confirmations
- View task status and deadlines
- Receive reminders and notifications

**Compliance Officers:**

- Review completed checklists
- Generate compliance reports
- Export data for audits
- Monitor completion rates

### Industries

**Gastronomie & Hotellerie:**

- Opening/closing checklists
- Cleaning protocols
- Food safety checklists
- Service quality checklists

**Pflege & Gesundheitswesen:**

- Hygiene protocols
- Patient care checklists
- Medication administration
- Safety inspections

**Einzelhandel:**

- Opening procedures
- Inventory checks
- Shift handover
- Receiving inspections

**Industrie & Handwerk:**

- Maintenance checklists
- Safety inspections
- Quality control
- Project completion checklists

**Freizeit, Fitness & Events:**

- Event setup checklists
- Equipment checks
- Safety protocols
- Post-event cleanup

## Key Functionality

### Core Capabilities

- **Digitale Checklisten:** Create custom checklists with unlimited tasks
- **Sechs Interaktions-Typen:** Checkboxen, Textfelder, Werteingaben, Fotos/Videos, Bestätigungen, Unterschriften
- **Aufgabenmanagement:** Assign tasks to individuals or roles
- **Automatische Erinnerungen:** Scheduled reminders and notifications
- **Statusübersicht:** Real-time progress tracking and completion status
- **Mobile Zugriff:** Full functionality via iOS and Android apps
- **Archivierung & Export:** Automatic archiving and data export
- **Integration:** Seamless integration with Zeiterfassung, Dokumente, Payroll

### Advanced Features

**Sechs Interaktions-Typen:**

1. **Checkboxen:** Simple yes/no tasks for quick completion
2. **Textfelder:** Free-text input for observations, notes, comments
3. **Werteingaben:** Numeric inputs for measurements, quantities, counts
4. **Fotos und Videos:** Visual proof and documentation uploads
5. **Bestätigungen:** Confirmation requirements for critical tasks
6. **Unterschriften:** Digital signatures for legal compliance and approval

**Automatische Zuweisung:**

- Assign checklists to individuals
- Assign checklists to roles (e.g., "Service Staff", "Managers")
- Assign checklists to work areas
- Assign checklists to locations
- Automatic assignment based on shift schedules

**Intelligente Planung:**

- Schedule checklists for specific times
- Recurring checklists (daily, weekly, monthly)
- Checklist triggers based on events (shift start, shift end)
- Conditional checklist assignment
- Deadline management

**Fortschrittsverfolgung:**

- Real-time completion status
- Progress indicators
- Completion timestamps
- Completion rates per team/location
- Historical completion data

**Qualitätssicherung:**

- Required field validation
- Photo requirements
- Signature requirements
- Automatic flagging of incomplete checklists
- Quality scoring

**Integration mit anderen Modulen:**

- Link checklists to shift schedules
- Link checklists to time tracking
- Link checklists to documents
- Link checklists to payroll processes
- Automatic data synchronization

## Technical Implementation

### Files

**Frontend Files:**

- **PHP:** `v2/pages/product_checklists.php` (~690 lines)
  - Product page with hero section, interactive checklist demo, FAQ section, and CTAs
  - Alpine.js integration for scroll animations and interactive elements
  - AOS (Animate On Scroll) for animations
  - Schema markup for SEO (SoftwareApplication, Service, FAQPage, BreadcrumbList)
  - Responsive design with Tailwind CSS

**JavaScript:**

- `/v2/js/lead-capture-triggers.min.js` - Lead capture and form tracking
- Alpine.js components for interactive UI (scroll animations, checklist demo)
- Custom checklist components

**CSS:**

- `/v2/css/product-pages.min.css` - Shared product pages stylesheet
- Tailwind CSS utility classes
- Custom checklist styles

**Dependencies:**

**Backend Systems:**

- Checklist template system
- Task assignment engine
- Notification service (email, push)
- File upload service (photos, videos)
- Digital signature service
- Deadline tracking system
- Progress tracking system
- Archive system
- Export service
- Integration APIs (Zeiterfassung, Dokumente, Payroll)

**External Integrations:**

- Mobile app backend API
- Email notification service
- Push notification service
- Document storage system
- Time tracking system
- Payroll system

**Frontend Libraries:**

- Alpine.js for reactive UI components
- Tailwind CSS for styling
- AOS (Animate On Scroll) for animations
- File upload libraries
- Signature capture libraries

### API Endpoints

**Checklist Management:**

- `GET /api/checklists` - List all checklists
- `POST /api/checklists` - Create new checklist
- `GET /api/checklists/{id}` - Get checklist details
- `PUT /api/checklists/{id}` - Update checklist
- `DELETE /api/checklists/{id}` - Delete checklist
- `GET /api/checklists/templates` - List checklist templates

**Task Assignment:**

- `POST /api/checklists/{id}/assign` - Assign checklist to users/roles
- `GET /api/checklists/{id}/assignments` - Get checklist assignments
- `PUT /api/checklists/{id}/assignments/{assignmentId}` - Update assignment
- `DELETE /api/checklists/{id}/assignments/{assignmentId}` - Remove assignment

**Task Completion:**

- `GET /api/checklists/{id}/tasks` - List checklist tasks
- `POST /api/checklists/{id}/tasks/{taskId}/complete` - Complete task
- `GET /api/checklists/{id}/completion` - Get completion status
- `POST /api/checklists/{id}/complete` - Complete entire checklist

**File Uploads:**

- `POST /api/checklists/{id}/tasks/{taskId}/upload` - Upload photo/video for task
- `GET /api/checklists/{id}/tasks/{taskId}/files` - List task files
- `DELETE /api/checklists/{id}/tasks/{taskId}/files/{fileId}` - Delete file

**Digital Signatures:**

- `POST /api/checklists/{id}/sign` - Sign checklist digitally
- `GET /api/checklists/{id}/signatures` - Get checklist signatures

**Reporting:**

- `GET /api/checklists/reports/completion` - Get completion reports
- `GET /api/checklists/reports/quality` - Get quality reports
- `GET /api/checklists/{id}/export` - Export checklist data

**Integration:**

- `GET /api/checklists/{id}/integrations` - Get checklist integrations
- `POST /api/checklists/{id}/integrations` - Create integration
- `DELETE /api/checklists/{id}/integrations/{integrationId}` - Remove integration

## User Experience

### Detailed User Flow

#### Flow 1: Creating a Checklist

1. **Access Checklist Management:**

   - Manager logs into Ordio
   - Navigates to "Checklisten" section
   - Clicks "Neue Checkliste" (New Checklist)

2. **Define Checklist:**

   - Enters checklist name and description
   - Selects template or creates from scratch
   - Defines tasks with appropriate interaction types
   - Sets requirements (photos, signatures, confirmations)
   - Configures scheduling (one-time, recurring, event-triggered)

3. **Assign Checklist:**

   - Selects assignment type (individual, role, work area, location)
   - Sets assignment rules
   - Configures notifications and reminders
   - Saves checklist

4. **Checklist Activation:**
   - System activates checklist based on schedule
   - Assignees receive notifications
   - Checklist appears in app/web interface

#### Flow 2: Completing a Checklist

1. **Receive Notification:**

   - Employee receives notification via app/email
   - Notification includes checklist name and deadline
   - Link to open checklist

2. **Open Checklist:**

   - Employee opens Ordio app/web
   - Navigates to "Meine Checklisten" (My Checklists)
   - Sees assigned checklist with completion status
   - Clicks to open checklist

3. **Complete Tasks:**

   - Employee goes through each task
   - Completes tasks based on interaction type:
     - Checkbox: Taps to check
     - Text field: Enters text
     - Value input: Enters numeric value
     - Photo/Video: Uploads media
     - Confirmation: Confirms completion
     - Signature: Signs digitally
   - Reviews completion status
   - Submits checklist

4. **System Processing:**
   - System validates all required tasks completed
   - Archives completed checklist
   - Notifies manager of completion
   - Updates progress tracking
   - Generates reports if configured

#### Flow 3: Reviewing Checklist Completion

1. **Access Dashboard:**

   - Manager navigates to "Checklisten" dashboard
   - Views overview of all checklists
   - Sees completion rates and status

2. **Review Completed Checklists:**

   - Clicks on specific checklist
   - Views completion details
   - Reviews photos, notes, signatures
   - Approves or requests corrections

3. **Generate Reports:**
   - Generates completion reports
   - Exports data for analysis
   - Reviews quality metrics
   - Identifies improvement areas

### Detailed Workflows from Helpdesk

The following workflows are based on helpdesk documentation and provide step-by-step guides for common Checklists tasks.

#### Workflow: Creating a Checklist

**Purpose:** Set up a new checklist with tasks and assignments

**Steps:**

1. **Access Checklist Management:**

   - Navigate to Checklisten section
   - Click "Neue Checkliste" or "Create Checklist"
   - System opens checklist builder

2. **Define Checklist Basics:**

   - Enter checklist name
   - Add description (optional)
   - Set checklist type (one-time, recurring, event-triggered)
   - Configure general settings

3. **Create Tasks:**

   - Click "Aufgabe hinzufügen" or "Add Task"
   - Enter task name/description
   - Select interaction type:
     - **Checkbox:** Simple yes/no completion
     - **Text Field:** Free text input
     - **Value Input:** Numeric value entry
     - **Photo/Video:** Media upload requirement
     - **Confirmation:** Confirmation prompt
     - **Signature:** Digital signature capture
   - Set task requirements (mandatory, optional)
   - Add task instructions (optional)
   - Repeat for all tasks

4. **Configure Task Order:**

   - Drag and drop tasks to reorder
   - Set task dependencies if needed
   - Define completion sequence

5. **Set Assignment:**

   - Choose assignment type:
     - Individual employees
     - Roles (e.g., all managers)
     - Work areas (e.g., kitchen staff)
     - Locations (e.g., all branches)
   - Configure assignment rules
   - Set assignment schedule

6. **Configure Scheduling:**

   - Set when checklist appears:
     - One-time (specific date/time)
     - Recurring (daily, weekly, monthly)
     - Event-triggered (e.g., on shift start)
   - Set deadline (if applicable)
   - Configure reminders

7. **Save Checklist:**
   - Review checklist preview
   - Save checklist
   - System activates based on schedule
   - Assignees receive notifications

**Video Guide Sections:**

- 00:41 - Creating/Setting up checklist (Checklisten erstellen/anlegen)
- 03:40 - Creating/Editing tasks (Aufgaben erstellen/bearbeiten)
- 05:36 - Employee view Terminal App (Mitarbeiteransicht Terminal App)
- 07:16 - Employee view Ordio App (Mitarbeiteransicht Ordio App)
- 08:58 - Completing checklist (Checkliste abschließen)
- 09:28 - Checklist evaluation (Auswertung Checklisten)
- 10:26 - General overview (Allgemeine Übersicht)

**Troubleshooting:**

- If problems occur when creating or editing checklists, see troubleshooting guide
- If checklist is not visible, check troubleshooting guide for solutions

#### Workflow: Employee Completing Checklist (Terminal App)

**Purpose:** Employee completes assigned checklist via terminal/tablet

**Steps:**

1. **Access Checklist:**

   - Employee logs into terminal app
   - Navigates to assigned checklists
   - Sees checklist with completion status
   - Clicks to open checklist

2. **Complete Tasks:**

   - Goes through each task in order
   - Completes based on interaction type:
     - **Checkbox:** Tap to check/uncheck
     - **Text Field:** Enter text via keyboard
     - **Value Input:** Enter numeric value
     - **Photo/Video:** Capture or upload media
     - **Confirmation:** Confirm completion
     - **Signature:** Sign on touchscreen
   - Reviews progress indicator
   - Can save progress and continue later

3. **Submit Checklist:**

   - Reviews all completed tasks
   - Ensures all mandatory tasks completed
   - Clicks "Abschließen" or "Complete"
   - System validates completion
   - Checklist submitted

4. **Confirmation:**
   - System confirms submission
   - Manager receives notification
   - Checklist archived
   - Completion tracked in reports

**Video Guide Section:** 05:36 - Employee view Terminal App

#### Workflow: Employee Completing Checklist (Mobile App)

**Purpose:** Employee completes assigned checklist via mobile app

**Steps:**

1. **Receive Notification:**

   - Employee receives push notification
   - Notification shows checklist name and deadline
   - Taps notification to open app

2. **Access Checklist:**

   - Opens Ordio mobile app
   - Navigates to "Meine Checklisten"
   - Sees assigned checklist
   - Taps to open

3. **Complete Tasks:**

   - Views task list
   - Completes each task:
     - **Checkbox:** Tap to check
     - **Text Field:** Type text
     - **Value Input:** Enter number
     - **Photo/Video:** Use camera or gallery
     - **Confirmation:** Tap to confirm
     - **Signature:** Sign with finger/stylus
   - Progress bar shows completion status
   - Can save draft and continue later

4. **Submit Checklist:**

   - Reviews all tasks
   - Verifies mandatory items completed
   - Taps "Abschließen" or "Complete"
   - System processes submission
   - Confirmation shown

5. **Completion:**
   - Checklist marked as completed
   - Manager notified automatically
   - Data available in reports
   - Completion timestamp recorded

**Video Guide Section:** 07:16 - Employee view Ordio App

#### Workflow: Completing Checklist

**Purpose:** Finalize and submit completed checklist

**Steps:**

1. **Review Completion:**

   - Check all tasks completed
   - Verify mandatory items done
   - Review photos/signatures if required
   - Ensure quality standards met

2. **Submit Checklist:**

   - Click "Abschließen" or "Complete"
   - System validates:
     - All mandatory tasks completed
     - Required media uploaded
     - Signatures captured (if needed)
   - If validation fails, shows errors
   - Fix errors and resubmit

3. **Final Confirmation:**

   - System confirms successful submission
   - Checklist status changes to "Completed"
   - Completion timestamp recorded
   - Manager receives notification

4. **Post-Completion:**
   - Checklist archived automatically
   - Data available in reports
   - Can be reviewed by manager
   - Used for quality tracking

**Video Guide Section:** 08:58 - Completing checklist

#### Workflow: Reviewing Checklist Reports

**Purpose:** Analyze checklist completion and quality

**Steps:**

1. **Access Reports:**

   - Navigate to Checklisten section
   - Click "Auswertung" or "Reports"
   - System shows report dashboard

2. **View Completion Reports:**

   - See completion rates per checklist
   - View completion by employee/role/location
   - Check completion timestamps
   - Identify incomplete checklists

3. **Review Quality Metrics:**

   - View submitted photos/media
   - Review text entries
   - Check signature compliance
   - Assess completion quality

4. **Export Data:**

   - Export reports to Excel/PDF
   - Filter by date range, location, employee
   - Generate custom reports
   - Share reports with stakeholders

5. **Identify Trends:**
   - Analyze completion patterns
   - Identify improvement areas
   - Track compliance over time
   - Make data-driven decisions

**Video Guide Section:** 09:28 - Checklist evaluation/reports

#### Troubleshooting Common Issues

**Issue: Checklist Not Visible**

**Possible Causes:**

- Checklist not assigned to employee
- Assignment date/time not reached
- Employee not in assigned group/role
- Checklist deactivated

**Solutions:**

- Verify assignment settings
- Check assignment date/time
- Confirm employee is in assigned group
- Check checklist activation status
- See helpdesk article: [Checklisten nicht sichtbar](https://helpdesk.ordio.com/de/checklisten/checklisten-nicht-sichtbar-)

**Issue: Checklist Cannot Be Edited**

**Possible Causes:**

- Checklist already assigned
- Checklist has completed tasks
- User lacks edit permissions
- Checklist locked by system

**Solutions:**

- Unassign checklist before editing
- Remove completed tasks
- Check user permissions
- Contact support if locked
- See helpdesk article: [Checklisten lassen sich nicht bearbeiten](https://helpdesk.ordio.com/de/checklisten/checklisten-lassen-sich-nicht-bearbeiten-)

### UI Components

**Checklist Dashboard:**

- **Layout:** Overview cards with detailed views
- **Elements:**
  - Checklist list with status indicators
  - Completion rate cards
  - Recent activity feed
  - Quick actions (create, assign, review)
- **Interactions:** Click to view details, filter, search, create new
- **Visual Design:** Clean dashboard with clear status indicators

**Checklist Builder:**

- **Layout:** Form-based builder interface
- **Elements:**
  - Task list with drag-and-drop
  - Interaction type selector
  - Assignment configuration
  - Scheduling options
  - Preview panel
- **Interactions:** Drag-and-drop tasks, select interaction types, configure settings
- **Visual Design:** Intuitive builder with visual preview

**Checklist Completion Interface:**

- **Layout:** Mobile-optimized task list
- **Elements:**
  - Task cards with interaction controls
  - Progress indicator
  - Photo upload area
  - Signature pad
  - Submit button
- **Interactions:** Complete tasks, upload files, sign, submit
- **Visual Design:** Mobile-first design with clear task indicators

**Progress Tracking:**

- **Layout:** Visual progress indicators
- **Elements:**
  - Completion percentage
  - Task status indicators
  - Timeline view
  - Completion history
- **Interactions:** View details, filter by status, export data
- **Visual Design:** Visual progress indicators with color coding

## Visual Documentation

### Screenshots

**Checklist Dashboard:**

- **File:** `/v2/img/screenshots/checklisten-dashboard.webp`
- **Alt Text:** "Checklist dashboard showing all checklists and completion status"
- **Caption:** Main checklist dashboard with overview of all checklists

**Checklist Builder:**

- **File:** `/v2/img/screenshots/checklisten-builder.webp`
- **Alt Text:** "Checklist builder interface showing task creation"
- **Caption:** Checklist builder with six interaction types

**Mobile Checklist Completion:**

- **File:** `/v2/img/screenshots/checklisten-mobile.webp`
- **Alt Text:** "Mobile checklist completion interface"
- **Caption:** Mobile app interface for completing checklists on-the-go

### Diagrams

**User Flow Diagram:**

- **File:** `/v2/img/diagrams/checklisten-user-flow.svg`
- **Description:** Flow from checklist creation → assignment → completion → review → archiving
- **Use Case:** Understanding the complete checklist workflow

**Interaction Types Diagram:**

- **File:** `/v2/img/diagrams/checklisten-interactions.svg`
- **Description:** Visual representation of the six interaction types
- **Use Case:** Understanding available interaction types

## Maintenance

### Update Schedule

- **Regular updates:** Monthly feature enhancements based on user feedback
- **Template updates:** As needed for new checklist templates
- **Integration updates:** As needed for system integrations
- **Security updates:** Ongoing security improvements and GDPR compliance
- **Performance optimization:** Ongoing improvements to mobile performance and sync speed

### Common Updates

- **New interaction types:** Add support for new interaction types based on user needs
- **Template library:** Expand checklist template library
- **Integration enhancements:** Improve integration with other Ordio modules
- **Mobile app updates:** Improve mobile checklist completion experience
- **Reporting improvements:** Enhance reporting and analytics capabilities
- **Automation features:** Add more automation options for checklist assignment and scheduling

## Related Documentation

- [Product Pages Inventory](../../pages/product-pages/PRODUCT_PAGES_INVENTORY.md)
- [Product Features Inventory](../PRODUCT_FEATURES_INVENTORY.md)
- [Zeiterfassung Documentation](zeiterfassung-documentation.md)
- [Dokumentenmanagement Documentation](dokumentenmanagement-documentation.md)
- [Lohnabrechnung Documentation](lohnabrechnung-documentation.md)

## Related Cursor Rules

- [product-pages.mdc](../../../../.cursor/rules/product-pages.mdc)
- [shared-patterns.mdc](../../../../.cursor/rules/shared-patterns.mdc)
- [global.mdc](../../../../.cursor/rules/global.mdc)