# Dokumentenmanagement 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:** Dokumentenmanagement - **Slug:** dokumentenmanagement - **Status:** Available - **Related Product Pages:** - `v2/pages/product_documents.php` - Product page: https://www.ordio.com/dokumentenmanagement ## Overview Frage Dokumente automatisch ab - einmal definiert und nie wieder etwas vergessen. Genau auf deine betrieblichen Bedürfnisse zugeschnitten, bestimmst du Ablaufdaten und Fristen und setzt intelligente Dokumentenverknüpfungen zu den unterschiedlichen Arbeitsbereichen. ## Use Cases ### Automated Document Collection for New Employees **Scenario:** A restaurant chain needs to collect and verify all required documents from new employees (ID, driver's license, health certificate, work permit) without manual follow-ups. **Process:** 1. HR manager sets up automatic document rules for new employee onboarding 2. System automatically requests documents when new employee is added 3. Employee receives notification via app/email with list of required documents 4. Employee uploads documents directly in their profile 5. System automatically categorizes and stores documents 6. Manager receives notification when all documents are collected 7. System tracks expiration dates and sends reminders before expiry 8. Documents automatically linked to employee file **Benefits:** Eliminates manual document requests, ensures compliance, reduces onboarding time by 50%, automatic reminders prevent expired documents. ### Compliance Management for Driver's Licenses **Scenario:** A delivery service needs to ensure all drivers have valid licenses and track expiration dates to maintain compliance. **Process:** 1. Manager sets up automatic driver's license check rule (annual renewal) 2. System identifies all employees with driver role 3. Automatically requests driver's license documents annually 4. Employees receive notification 30 days before expiration 5. Employees upload renewed license via mobile app 6. System verifies document and updates expiration date 7. Manager receives dashboard showing all license statuses 8. Automatic alerts for expired or expiring licenses **Benefits:** Ensures 100% compliance, prevents expired licenses, reduces liability risk, automatic tracking and reminders. ### Health Certificate Management for Food Service **Scenario:** A restaurant needs to track health certificates for all kitchen staff, ensuring they're current and compliant with food safety regulations. **Process:** 1. Manager creates rule for health certificates (required for kitchen staff, annual renewal) 2. System automatically links rule to kitchen work area 3. Employees in kitchen receive automatic requests 4. Certificates uploaded and stored securely 5. System tracks expiration dates 6. Automatic reminders sent 60 days, 30 days, and 7 days before expiration 7. Manager views compliance dashboard 8. Expired certificates automatically flagged **Benefits:** Food safety compliance, automatic tracking, prevents expired certificates, reduces manual work, audit-ready documentation. ### Training Certificate Tracking **Scenario:** A healthcare facility needs to track training certificates (safety training, certifications) for all staff with automatic renewal reminders. **Process:** 1. HR sets up document rules for various training certificates 2. Rules linked to job roles (e.g., safety training for all staff, specialized training for nurses) 3. System automatically requests certificates based on role 4. Employees upload certificates via app 5. System tracks expiration dates 6. Automatic renewal reminders sent 7. Manager views training compliance dashboard 8. Reports generated for audits **Benefits:** Training compliance assurance, automatic tracking, reduces administrative burden, audit-ready reports. ### Centralized Document Repository **Scenario:** A multi-location business needs centralized document storage with role-based access, eliminating paper files and improving efficiency. **Process:** 1. All documents uploaded to Ordio (contracts, certificates, training records) 2. Documents automatically categorized and tagged 3. Role-based access ensures only authorized personnel see sensitive documents 4. Employees can access their own documents via app 5. Managers can search and access documents across all locations 6. Documents versioned automatically 7. Full audit trail maintained 8. Export capabilities for compliance reporting **Benefits:** Eliminates paper files, 5x faster document search, centralized access, version control, compliance-ready. ## Target Audience ### Primary Users **HR Managers:** - Daily responsibility for document management and compliance - Need automated document collection and tracking - Require compliance assurance and audit-ready documentation - Benefit from automatic reminders and deadline management **Compliance Officers:** - Ensure regulatory compliance (driver's licenses, health certificates, training) - Need tracking and reporting capabilities - Require audit trails and documentation - Benefit from automated compliance monitoring **Operations Managers:** - Coordinate document requirements across locations - Need visibility into document status - Require integration with operational processes - Benefit from centralized document management **Employees:** - Upload and access their own documents - Receive automatic reminders for expiring documents - View document status and requirements - Benefit from self-service capabilities ### Secondary Users **Business Owners:** - Need compliance assurance - Require audit-ready documentation - Benefit from reduced liability risk **Auditors/Inspectors:** - Need access to compliance documentation - Require complete audit trails - Benefit from organized, searchable documentation ### Industries **Restaurants & Hospitality:** - Health certificates for food handlers - Driver's licenses for delivery staff - Training certificates - Work permits for international staff **Healthcare:** - Professional licenses and certifications - Health certificates - Training records - Compliance documentation **Transportation & Logistics:** - Driver's licenses - Vehicle certifications - Safety training certificates - Compliance documentation **Retail:** - Training certificates - Safety certifications - Work permits - Compliance documentation **All Industries:** - Employee contracts - ID documents - Training records - Compliance documentation ## Key Functionality ### Core Capabilities - **Dokumentenmanagement:** Centralized digital document storage and management for all HR documents - **Automatische Kategorisierung:** Automatic categorization and tagging of documents based on type and content - **Fristenverwaltung:** Deadline management with automatic reminders for expiring documents - **Dokumenten-Suche:** Fast search functionality (5x faster than manual search) across all documents - **Versionierung:** Automatic versioning of documents, maintaining history of all changes - **Zentrale Speicherung:** Centralized storage on German servers with GDPR compliance - **Mobile Zugriff:** Full document access via mobile apps (iOS and Android) - **Integration mit Personalakte:** Seamless integration with digital employee files ### Advanced Features **Automatische Dokumentenabfrage:** - Define rules for when documents should be requested - Trigger options: New employee, annually, semi-annually, quarterly, monthly - Automatic notifications to employees - Link rules to work areas, roles, or employment types - Automatic follow-up reminders **Intelligente Dokumentenverknüpfungen:** - Link documents to work areas - Link documents to employment types - Link documents to processes (onboarding, training, compliance) - Automatic routing based on employee role **Fristenmanagement:** - Set expiration dates for documents - Automatic reminders (60 days, 30 days, 7 days before expiration) - Dashboard showing all expiring documents - Automatic flagging of expired documents - Compliance alerts **Rollenbasierter Zugriff:** - Define who can view/edit/delete documents - Role-based access control - Employee self-service for own documents - Manager access to team documents - Admin access to all documents **Revisionssichere Archivierung:** - Automatic archiving of all documents - Complete audit trail - Version history - Compliance-ready documentation - Long-term storage **Document Types Supported:** - Employment contracts - ID documents (passport, ID card) - Driver's licenses - Health certificates - Training certificates - Work permits - Safety certifications - Professional licenses - Additional agreements - Safety briefings ## Technical Implementation ### File Structure **Frontend Files:** - **PHP:** `v2/pages/product_documents.php` (~690 lines) - Product page with hero section, feature showcase, FAQ section, and CTAs - Alpine.js integration for interactive elements - 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 - Custom document upload components **CSS:** - `/v2/css/product-pages.min.css` - Shared product pages stylesheet - Tailwind CSS utility classes - Custom document management styles **Dependencies:** **Backend Systems:** - Document storage system (German servers, GDPR-compliant) - File upload and processing service - Document categorization engine - Deadline tracking and reminder system - Notification service (email, push) - Search engine for document search - Version control system - Employee database integration - Role-based access control system **External Integrations:** - Mobile app backend API - Email notification service - Push notification service - Digital employee file system - Work area/role management system **Frontend Libraries:** - Alpine.js for reactive UI components - Tailwind CSS for styling - AOS (Animate On Scroll) for animations - File upload libraries ### API Endpoints **Document Management:** - `GET /api/documents` - List documents with filters (employee, type, status, expiration) - `POST /api/documents` - Upload new document - `GET /api/documents/{id}` - Get document details - `PUT /api/documents/{id}` - Update document metadata - `DELETE /api/documents/{id}` - Delete document - `GET /api/documents/{id}/download` - Download document **Document Rules:** - `GET /api/document-rules` - List all document rules - `POST /api/document-rules` - Create new document rule - `PUT /api/document-rules/{id}` - Update document rule - `DELETE /api/document-rules/{id}` - Delete document rule - `POST /api/document-rules/{id}/trigger` - Manually trigger rule **Deadline Management:** - `GET /api/deadlines` - List upcoming deadlines - `GET /api/deadlines/expiring` - List expiring documents - `GET /api/deadlines/expired` - List expired documents - `POST /api/deadlines/{id}/remind` - Send reminder for deadline **Search:** - `GET /api/documents/search` - Search documents by keyword, type, employee - `GET /api/documents/search/advanced` - Advanced search with multiple filters **Compliance:** - `GET /api/compliance/status` - Get compliance status for employees - `GET /api/compliance/reports` - Generate compliance reports - `GET /api/compliance/export` - Export compliance data ## User Experience ### Detailed User Flow #### Flow 1: Setting Up Automatic Document Rules 1. **Access Document Management:** - HR manager logs into Ordio - Navigates to "Dokumentenmanagement" section - Clicks "Document Rules" or "Automatische Regeln" 2. **Create Rule:** - Clicks "Create New Rule" - Selects document type (e.g., Driver's License) - Sets trigger (e.g., "Annually", "On new employee", "Semi-annually") - Links to work area or role (e.g., "Delivery Staff") - Sets reminder schedule (e.g., 60 days, 30 days, 7 days before expiration) - Saves rule 3. **Rule Activation:** - System automatically identifies affected employees - Sends notifications to employees - Creates deadline tracking entries - Sets up automatic reminders #### Flow 2: Employee Uploading Document 1. **Receive Notification:** - Employee receives notification via app/email - Notification lists required documents - Shows deadline information 2. **Upload Document:** - Employee opens Ordio app or web interface - Navigates to "My Documents" section - Sees list of required documents - Clicks "Upload" for specific document - Selects file from device - Adds optional notes - Submits upload 3. **Document Processing:** - System automatically categorizes document - Extracts metadata (if possible) - Stores document securely - Updates employee document status - Notifies manager of new upload - Sets expiration date tracking (if applicable) #### Flow 3: Manager Reviewing Compliance 1. **Access Compliance Dashboard:** - Manager navigates to "Dokumentenmanagement" - Views compliance dashboard - Sees overview of document statuses 2. **Review Status:** - Views expiring documents (sorted by expiration date) - Views expired documents requiring attention - Views missing documents - Filters by employee, document type, location 3. **Take Action:** - Reviews individual documents - Approves or requests re-upload - Sends manual reminders if needed - Generates compliance reports - Exports data for audits ### Detailed Workflows from Helpdesk The following workflows are based on helpdesk documentation and provide step-by-step guides for common Dokumentenmanagement tasks. #### Workflow: Creating Intelligent Document Rules **Purpose:** Set up automatic document collection rules that eliminate manual document requests **Benefits:** - **No Manual Requests:** No need to individually request documents from employees - all employees linked to the rule are automatically notified via app to submit the document - **Automatic Blocking:** For urgent documents (e.g., work permit), you can configure that employees are blocked in the workspace if they don't submit the document - **Custom Validity Dates:** When administrator verification is enabled, you can set individual validity dates during the verification process **Steps:** 1. **Access Document Rules:** - Navigate to Dokumentenmanagement section - Click "Intelligente Dokumentenregeln" or "Intelligent Document Rules" - System opens rule configuration interface 2. **Create New Rule:** - Click "Neue Regel" or "Create New Rule" - System shows rule creation form 3. **Select Document Type:** - Choose document type from dropdown: - Driver's License (Führerschein) - Health Certificate (Gesundheitszeugnis) - Work Permit (Arbeitserlaubnis) - ID Document (Ausweis) - Training Certificate (Schulungsnachweis) - Other custom document types - Document type determines default settings 4. **Configure Trigger:** - Set when document should be requested: - **On New Employee:** Automatically request when employee is added - **Annually:** Request every year (e.g., for driver's license renewal) - **Semi-annually:** Request every 6 months - **Quarterly:** Request every 3 months - **Custom:** Set specific date range - Set initial request date (if applicable) 5. **Link to Work Area:** - Select work area(s) or role(s) that require this document: - All employees - Specific work areas (e.g., "Delivery", "Kitchen") - Specific roles (e.g., "Manager", "Driver") - Specific locations - All employees linked to selected work areas/roles will receive automatic notification 6. **Configure Blocking (Optional):** - For urgent documents (e.g., Arbeitserlaubnis): - Enable "Block employee if document not submitted" - Employee will be blocked in workspace until document is submitted - Useful for compliance-critical documents 7. **Configure Verification:** - Enable administrator verification if required - During verification, set individual validity dates - Customize validity period per document 8. **Save Rule:** - Review all settings - Save rule - System automatically notifies all linked employees via app - Employees receive notification to submit document - Rule applies to all employees in selected areas/roles - Can select multiple areas/roles 9. **Set Expiration Tracking:** - Enable expiration date tracking (if applicable) - Set expiration period (e.g., 1 year, 2 years) - Configure automatic reminders: - 60 days before expiration - 30 days before expiration - 7 days before expiration - On expiration date - System automatically sends reminders 10. **Configure Reminder Schedule:** - Set reminder frequency: - One-time reminder - Multiple reminders (e.g., 60, 30, 7 days before) - Escalation reminders (if not uploaded) - Set reminder recipients: - Employee only - Employee and manager - Manager only 11. **Set Document Requirements:** - Define if document is mandatory or optional - Set document format requirements (if applicable) - Add instructions for employees (optional) - Configure approval workflow (if needed) 12. **Review Rule Preview:** - System shows rule summary: - Document type - Trigger conditions - Affected employees/work areas - Reminder schedule - Verify rule configuration 13. **Save Rule:** - Click "Speichern" or "Save" - System activates rule - Identifies affected employees - Sends initial document requests (if trigger met) - Sets up expiration tracking - Configures automatic reminders **Rule Activation:** - System automatically identifies employees matching rule criteria - Sends document request notifications - Creates deadline tracking entries - Sets up reminder schedule - Links documents to employee files automatically **Video Guide:** Helpdesk provides video tutorial showing complete rule creation process **Example Use Cases:** 1. **Driver's License for Delivery Staff:** - Document Type: Driver's License - Trigger: Annually - Work Area: "Delivery" - Reminders: 60, 30, 7 days before expiration - Result: All delivery staff automatically reminded to renew license 2. **Health Certificate for Food Service:** - Document Type: Health Certificate - Trigger: On New Employee - Work Area: "Kitchen", "Service" - Reminders: 30 days before expiration - Result: New kitchen/service staff automatically requested to provide health certificate 3. **Work Permit for International Employees:** - Document Type: Work Permit - Trigger: Annually - Role: All employees - Reminders: 90, 60, 30 days before expiration - Result: All employees with work permits automatically tracked and reminded **Benefits of Intelligent Rules:** - **Time Savings:** No manual document requests - **Compliance:** Automatic tracking prevents expired documents - **Efficiency:** Documents automatically linked to relevant work areas - **Proactive:** Reminders sent before expiration - **Scalability:** Rules apply to all matching employees automatically ### UI Components **Document Library:** - **Layout:** Grid/list view with filters and search - **Elements:** - Document cards with preview - Filter options (type, employee, status, expiration) - Search bar - Upload button - Bulk actions - **Interactions:** Click to view, filter, search, upload, bulk actions - **Visual Design:** Clean document library with clear organization **Document Upload Interface:** - **Layout:** Drag-and-drop upload area with form - **Elements:** - Drag-and-drop zone - File selector button - Document type selector - Notes field - Upload progress indicator - Preview of selected file - **Interactions:** Drag-and-drop, file selection, form submission - **Visual Design:** User-friendly upload interface with clear feedback **Deadline Calendar:** - **Layout:** Calendar view with deadline indicators - **Elements:** - Monthly/weekly calendar - Color-coded deadline indicators - Expiring documents list - Expired documents alerts - **Interactions:** Navigate calendar, click deadlines for details - **Visual Design:** Intuitive calendar with clear visual indicators **Compliance Dashboard:** - **Layout:** Overview cards with detailed views - **Elements:** - Compliance score/percentage - Expiring documents count - Expired documents count - Missing documents count - Employee compliance list - Document type compliance breakdown - **Interactions:** Click cards for details, filter, export reports - **Visual Design:** Dashboard with clear metrics and visual indicators **Document Rule Configuration:** - **Layout:** Form-based rule creation interface - **Elements:** - Document type selector - Trigger options (when to request) - Work area/role selector - Reminder schedule configuration - Rule preview - Save/cancel buttons - **Interactions:** Form inputs, preview, save - **Visual Design:** Clear form with logical grouping ## Visual Documentation ### Screenshots **Document Library:** - **File:** `/v2/img/screenshots/dokumentenmanagement-library.webp` - **Alt Text:** "Dokumentenmanagement library showing categorized documents and search" - **Caption:** Main document library with categorized documents and search functionality **Document Upload:** - **File:** `/v2/img/screenshots/dokumentenmanagement-upload.webp` - **Alt Text:** "Dokumentenmanagement upload interface with drag-and-drop functionality" - **Caption:** Document upload interface with drag-and-drop and file selection **Deadline Management:** - **File:** `/v2/img/screenshots/dokumentenmanagement-deadlines.webp` - **Alt Text:** "Dokumentenmanagement deadline calendar showing upcoming document deadlines" - **Caption:** Deadline calendar with expiring documents and reminder schedule ### Diagrams **User Flow Diagram:** - **File:** `/v2/img/diagrams/dokumentenmanagement-user-flow.svg` - **Description:** Flow from document rule creation → automatic request → employee upload → compliance tracking - **Use Case:** Understanding the complete document management workflow **Integration Diagram:** - **File:** `/v2/img/diagrams/dokumentenmanagement-integration.svg` - **Description:** How Dokumentenmanagement integrates with Digitale Personalakte, Abwesenheiten, and other features ## Maintenance ### Update Schedule - **Regular updates:** Monthly feature enhancements based on user feedback - **Compliance updates:** As needed for new document requirements or regulations - **Security updates:** Ongoing security improvements and GDPR compliance - **Performance optimization:** Ongoing improvements to search speed and upload performance - **Integration updates:** As needed for system integrations ### Common Updates - **New document types:** Add support for new document types based on industry needs - **Rule enhancements:** Improve automatic rule functionality and triggers - **Search improvements:** Enhance search capabilities and speed - **Mobile app updates:** Improve mobile document upload and viewing - **Compliance features:** Add new compliance tracking and reporting features - **Integration improvements:** Enhance integration with employee files and other systems ## Related Documentation - [Product Pages Inventory](../../pages/product-pages/PRODUCT_PAGES_INVENTORY.md) - [Product Features Inventory](../PRODUCT_FEATURES_INVENTORY.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)