# Digitale Personalakte 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:** Digitale Personalakte
- **Slug:** digitale-personalakte
- **Status:** Available
- **Related Product Pages:**
  - `v2/pages/product_personnelfile.php`
  - Product page: https://www.ordio.com/digitale-personalakte

## Overview

Digitalisiere deine Personalakte und vermeide Fehler & unnötigen Stress bei der Verwaltung deiner Mitarbeitenden. Mit Ordio führst du die digitale Personalakte zentral, sicher und datenschutzkonform. Alle Mitarbeiterdaten, Dokumente und Personalfragebögen an einem Ort – einfach, sicher und zentral.

## Use Cases

### Centralized Employee Data Management

**Scenario:** A multi-location restaurant chain needs to manage employee data across all locations, eliminating paper files and ensuring consistent data quality.

**Process:**

1. HR manager sets up digital employee files for all locations
2. Employee data entered once, accessible across all locations
3. Documents uploaded and stored centrally
4. Automatic data validation prevents duplicate entries
5. Role-based access ensures only authorized personnel see sensitive data
6. Employees can access their own data via mobile app
7. Managers can search and access employee data instantly
8. Complete audit trail maintained for compliance

**Benefits:** Eliminates paper files, ensures data consistency, 5x faster access, centralized management, compliance-ready.

### Automated Employee Onboarding

**Scenario:** A retail chain needs to streamline onboarding for new employees, ensuring all required documents are collected and processed automatically.

**Process:**

1. HR creates employee profile in Ordio
2. System automatically requests required documents (ID, contract, certificates)
3. Employee receives notification with document checklist
4. Employee uploads documents via mobile app or web
5. System automatically categorizes and stores documents
6. Personalfragebogen (employee questionnaire) automatically sent
7. Employee completes questionnaire digitally
8. System validates completeness and notifies HR
9. Onboarding workflow automatically progresses
10. All data stored in digital employee file

**Benefits:** 50% faster onboarding, automatic document collection, reduced errors, consistent process, digital-first approach.

### Compliance and Deadline Management

**Scenario:** A healthcare facility needs to track expiring certificates (health certificates, training records) and ensure compliance with regulations.

**Process:**

1. HR sets up automatic deadline tracking for certificates
2. System identifies all employees with expiring certificates
3. Automatic reminders sent 60 days, 30 days, and 7 days before expiration
4. Employees receive notifications via app/email
5. Employees upload renewed certificates
6. System automatically updates expiration dates
7. Compliance dashboard shows all certificate statuses
8. Automatic alerts for expired certificates
9. Reports generated for audits

**Benefits:** 100% compliance assurance, automatic tracking, prevents expired certificates, reduces administrative burden, audit-ready documentation.

### Integration with Tax Advisor

**Scenario:** A business needs to share employee data with their tax advisor for payroll processing, ensuring seamless data transfer.

**Process:**

1. HR configures tax advisor access in Ordio
2. Tax advisor receives secure access to employee data
3. Employee data automatically synced with tax advisor system
4. Tax advisor can view and export payroll-relevant data
5. Changes made by tax advisor synced back to Ordio
6. Complete audit trail maintained
7. Secure data transfer ensures GDPR compliance

**Benefits:** Seamless integration, automatic data sync, secure access, reduced manual work, GDPR-compliant.

### Employee Self-Service

**Scenario:** Employees need to access their own data, update personal information, and view documents without contacting HR.

**Process:**

1. Employee logs into Ordio app or web interface
2. Navigates to "My Profile" or "My Employee File"
3. Views all personal data and documents
4. Updates personal information (address, contact details)
5. Views employment contract, payslips, certificates
6. Downloads documents as needed
7. Submits document requests
8. Views deadline reminders for expiring documents

**Benefits:** Reduced HR workload, employee empowerment, 24/7 access, self-service capabilities, improved satisfaction.

## Target Audience

### Primary Users

**HR Managers:**

- Daily responsibility for employee data management
- Need centralized, secure employee file management
- Require compliance assurance and audit-ready documentation
- Benefit from automated workflows and deadline management

**HR Administrators:**

- Handle employee onboarding and data entry
- Need efficient document management
- Require automated workflows
- Benefit from reduced manual work

**Compliance Officers:**

- Ensure regulatory compliance
- Need tracking and reporting capabilities
- Require audit trails
- Benefit from automated compliance monitoring

**Operations Managers:**

- Coordinate employee data across locations
- Need visibility into employee status
- Require integration with operational processes
- Benefit from centralized employee management

### Secondary Users

**Employees:**

- Access their own employee data
- Update personal information
- View documents and certificates
- Submit document requests

**Tax Advisors:**

- Access employee data for payroll processing
- Export payroll-relevant data
- View employee files securely

**Business Owners:**

- Need compliance assurance
- Require audit-ready documentation
- Benefit from reduced liability risk

### Industries

**Restaurants & Hospitality:**

- High employee turnover requires efficient onboarding
- Multiple locations need centralized management
- Compliance with health certificates and training records
- Integration with payroll systems

**Healthcare:**

- Professional licenses and certifications tracking
- Health certificates management
- Training records compliance
- Regulatory compliance documentation

**Retail:**

- Multi-location employee management
- Training certificate tracking
- Compliance documentation
- Employee self-service capabilities

**All Industries:**

- Employee contract management
- Document storage and retrieval
- Compliance tracking
- Integration with payroll systems

## Key Functionality

### Core Capabilities

- **Digitale Personalakte:** Centralized digital employee file management for all employee data
- **Zentrale Datenverwaltung:** All employee data in one place, accessible across locations
- **Dokumentenmanagement:** Digital document storage, categorization, and retrieval
- **Personalfragebogen:** Customizable employee questionnaire for onboarding
- **Automatische Fristenverwaltung:** Deadline tracking with automatic reminders for expiring documents
- **Rollenbasierter Zugriff:** Role-based access control ensuring data security
- **DSGVO-konforme Speicherung:** GDPR-compliant data storage on German servers
- **Mobile Zugriff:** Full access via mobile apps (iOS and Android)
- **Steuerberater-Integration:** Secure integration with tax advisors for payroll processing

### Advanced Features

**Automatische Workflows:**

- Define workflows for employee onboarding
- Automatic document requests based on employee type
- Automatic deadline tracking and reminders
- Workflow automation for common HR processes

**Intelligente Dokumentenverknüpfungen:**

- Link documents to employee profiles automatically
- Link documents to processes (onboarding, training, compliance)
- Automatic categorization of uploaded documents
- Version control for document updates

**Fristenmanagement:**

- Set expiration dates for certificates and 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 employee data
- Role-based access control
- Employee self-service for own data
- Manager access to team data
- Admin access to all data
- Tax advisor access with limited permissions

**Revisionssichere Archivierung:**

- Automatic archiving of all employee data
- Complete audit trail
- Version history for all changes
- Compliance-ready documentation
- Long-term storage

**Personalfragebogen:**

- Customizable employee questionnaire
- Digital completion and submission
- Automatic data extraction
- Integration with employee file
- Tax advisor access for review

**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
- Payslips
- Certificates and qualifications

## Technical Implementation

### Files

**Frontend Files:**

- **PHP:** `v2/pages/product_personnelfile.php` (~470 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 employee file components

**CSS:**

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

**Dependencies:**

**Backend Systems:**

- Employee database system
- 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 employee data search
- Version control system
- Role-based access control system
- Tax advisor integration API

**External Integrations:**

- Mobile app backend API
- Email notification service
- Push notification service
- Tax advisor systems (DATEV, etc.)
- Payroll systems

**Frontend Libraries:**

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

### API Endpoints

**Employee File Management:**

- `GET /api/employees/{id}/file` - Get employee file data
- `PUT /api/employees/{id}/file` - Update employee file data
- `GET /api/employees/{id}/documents` - List employee documents
- `POST /api/employees/{id}/documents` - Upload document to employee file
- `GET /api/employees/{id}/documents/{docId}` - Get document details
- `DELETE /api/employees/{id}/documents/{docId}` - Delete document

**Personalfragebogen:**

- `GET /api/employees/{id}/questionnaire` - Get employee questionnaire
- `POST /api/employees/{id}/questionnaire` - Submit employee questionnaire
- `GET /api/questionnaire/templates` - List questionnaire templates
- `POST /api/questionnaire/templates` - Create questionnaire template

**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

**Tax Advisor Integration:**

- `GET /api/tax-advisor/employees` - List employees accessible by tax advisor
- `GET /api/tax-advisor/employees/{id}/data` - Get employee data for tax advisor
- `POST /api/tax-advisor/export` - Export employee data for tax advisor

**Search:**

- `GET /api/employees/search` - Search employees by keyword, location, role
- `GET /api/employees/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: Creating Employee File

1. **Access Employee Management:**

   - HR manager logs into Ordio
   - Navigates to "Mitarbeiter" (Employees) section
   - Clicks "Neuer Mitarbeiter" (New Employee)

2. **Enter Basic Information:**

   - Enters employee name, email, phone number
   - Selects location and role
   - Sets employment start date
   - Saves basic information

3. **System Creates Employee File:**

   - System automatically creates digital employee file
   - Generates employee profile
   - Sets up document storage
   - Configures access permissions
   - Sends welcome email to employee

4. **Upload Initial Documents:**
   - HR uploads employment contract
   - Uploads ID documents
   - Uploads required certificates
   - System automatically categorizes documents

#### Flow 2: Employee Completing Personalfragebogen

1. **Receive Notification:**

   - Employee receives email/app notification
   - Notification includes link to Personalfragebogen
   - Shows deadline for completion

2. **Access Questionnaire:**

   - Employee logs into Ordio app/web
   - Navigates to "Mein Profil" (My Profile)
   - Sees Personalfragebogen section
   - Clicks "Jetzt ausfüllen" (Fill out now)

3. **Complete Questionnaire:**

   - Employee fills out all required fields
   - Uploads additional documents if needed
   - Reviews information
   - Submits questionnaire

4. **System Processing:**
   - System validates completeness
   - Extracts data automatically
   - Updates employee file
   - Notifies HR of completion
   - Tax advisor receives notification (if configured)

#### Flow 3: Managing Expiring Documents

1. **System Identifies Expiring Documents:**

   - System checks all employee documents daily
   - Identifies documents expiring within 60 days
   - Creates deadline entries
   - Schedules reminders

2. **Employee Receives Reminder:**

   - Employee receives notification (60 days before expiration)
   - Notification includes document type and expiration date
   - Link to upload renewed document

3. **Employee Uploads Renewed Document:**

   - Employee navigates to document section
   - Uploads renewed certificate/document
   - System automatically updates expiration date
   - Removes from expiring list

4. **HR Reviews Compliance:**
   - HR views compliance dashboard
   - Sees all expiring documents
   - Reviews employee submissions
   - Approves or requests re-upload

### Detailed Workflows from Helpdesk

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

#### Workflow: Creating Employee Profiles

**Purpose:** Set up new employee in the system with complete master data

**Methods Available:**

1. **Individual Creation:**

   - Manual entry via employee management interface
   - Step-by-step form completion
   - Real-time validation

2. **Bulk Import:**

   - CSV/Excel import function
   - Template-based import
   - Automatic validation

3. **Invitation System:**
   - Send invitation email
   - Employee completes own profile
   - HR reviews and approves

**Steps for Individual Creation:**

1. **Access Employee Management:**

   - Navigate to Mitarbeiter section
   - Click "Neuer Mitarbeiter" or "Add Employee"

2. **Enter Basic Information:**

   - Name, email, phone number
   - Employment start date
   - Location assignment
   - Role/position

3. **Configure Master Data Request:**

   - Before inviting, configure which data employees must provide
   - Go to Einstellungen > Stammdaten
   - Set required fields for employee entry
   - Define data collection workflow

4. **Send Invitation:**

   - System sends invitation email
   - Employee receives link to complete profile
   - Employee fills out required master data

5. **Complete Profile:**
   - Employee provides all required information
   - System validates data
   - HR reviews and approves
   - Employee file created automatically

#### Workflow: Employee Import Function

**Purpose:** Import multiple employees at once via CSV/Excel or DATEV

**Import Formats Supported:**

- DATEV (ASCII Report)
- Custom CSV/Excel file (.csv or .xlsx)

**File Requirements:**

1. **Format:**

   - Must be .csv or .xlsx (Excel) format
   - Column headers (Name, Address, etc.) must be in first row
   - Headers must match Ordio field names

2. **Required Information:**
   - Must include either:
     - Phone number (Telefonnummer), OR
     - Email address (Emailadresse), OR
     - Both
   - Without contact information, employees cannot be imported

**Steps:**

1. **Prepare Import File:**

   - **Option A - DATEV:**
     - Export ASCII Report from DATEV
     - Use DATEV export format
   - **Option B - Custom File:**
     - Create CSV/Excel file
     - Include column headers in first row
     - Fill in employee data:
       - Name, email, phone
       - Employment dates
       - Locations, roles
       - Address and other fields
     - Ensure at least email OR phone number for each employee

2. **Access Import Function:**

   - Go to Mitarbeiter section
   - Click "Import" or "Bulk Import"
   - Select import file
   - Choose format (DATEV or Custom)

3. **Map Fields:**

   - System shows field mapping
   - Map CSV columns to Ordio fields
   - Verify mapping accuracy
   - Adjust mappings if needed

4. **Validate Data:**

   - System validates all entries
   - Shows errors/warnings
   - Highlights missing required fields
   - Fix any issues before proceeding

5. **Execute Import:**

   - Review import preview
   - See how many employees will be imported
   - Confirm import
   - System creates all employee profiles
   - Sends invitations automatically

6. **Review Results:**
   - View import summary
   - Check for any errors
   - Employees receive invitations via email/SMS
   - Employees can complete their profiles via invitation link

**Benefits:**

- Bulk import saves time
- No need to manually enter each employee
- Automatic invitation sending
- Supports DATEV integration

#### Workflow: Deactivating or Deleting Employees

**Purpose:** Handle employee termination and data management

**Deactivation (Recommended):**

1. **Access Employee Profile:**

   - Go to Mitarbeiter section
   - Find employee to deactivate
   - Open employee profile

2. **Deactivate Employee:**

   - Click "Deaktivieren" or "Deactivate"
   - Set deactivation date
   - Add reason/notes

3. **System Behavior:**
   - Employee removed from active employee list
   - Historical data preserved
   - Access to system revoked
   - Can be reactivated later if needed

**Deletion (Permanent):**

1. **Check Prerequisites:**

   - System checks for dependencies:
     - Historical payroll data
     - Time tracking records
     - Shift assignments
     - Documents

2. **Delete Employee:**
   - If safe to delete, confirm deletion
   - Employee permanently removed
   - All associated data deleted
   - Cannot be recovered

**Reactivation:**

1. **Access Deactivated Employees:**

   - Go to Mitarbeiter section
   - Filter for deactivated employees
   - Find employee to reactivate

2. **Reactivate:**
   - Click "Reaktivieren" or "Reactivate"
   - Set reactivation date
   - System restores access
   - Employee appears in active list

#### Workflow: Employment Start Date and Immediate Notification (Sofortmeldung)

**Purpose:** Record employment start and submit required notifications to authorities

**Steps:**

1. **Enter Employment Start Date:**

   - Open employee profile
   - Go to employment information
   - Enter Beschäftigungsbeginn (employment start date)
   - System records date

2. **Configure Immediate Notification:**

   - If required, enable Sofortmeldung
   - System prepares notification data
   - Includes required information:
     - Employee data
     - Employment details
     - Start date

3. **Submit Notification:**

   - System generates notification
   - Submits to relevant authorities automatically
   - Confirms submission
   - Tracks notification status

4. **Track Status:**
   - View notification history
   - See submission confirmations
   - Handle any errors

**Note:** Immediate notifications required for certain employment types per German law. System handles submission automatically when configured.

#### Workflow: Master Data Collection Configuration

**Purpose:** Configure which data employees must provide when joining workspace

**Steps:**

1. **Access Settings:**

   - Go to Workspace-Einstellungen
   - Navigate to Stammdaten section

2. **Configure Required Fields:**

   - Select which fields are mandatory
   - Set field types and validation rules
   - Define collection workflow

3. **Set Collection Method:**

   - Choose how data is collected:
     - During invitation process
     - After login
     - Via Personalfragebogen
     - Manual entry by HR

4. **Save Configuration:**
   - Settings apply to all new employees
   - Existing employees not affected
   - System enforces requirements

**Benefits:**

- Ensures complete employee data
- Standardizes data collection
- Reduces manual follow-up
- Improves data quality

### UI Components

**Employee File Dashboard:**

- **Layout:** Overview cards with detailed views
- **Elements:**
  - Employee profile card
  - Document library
  - Deadline calendar
  - Compliance status
  - Quick actions
- **Interactions:** Click cards for details, upload documents, view deadlines
- **Visual Design:** Clean dashboard with clear organization

**Personalfragebogen Interface:**

- **Layout:** Form-based questionnaire interface
- **Elements:**
  - Multi-step form
  - Field validation
  - Document upload areas
  - Progress indicator
  - Save/submit buttons
- **Interactions:** Form inputs, file uploads, save, submit
- **Visual Design:** User-friendly form with clear instructions

**Document Library:**

- **Layout:** Grid/list view with filters
- **Elements:**
  - Document cards with preview
  - Filter options (type, date, status)
  - Search bar
  - Upload button
  - Bulk actions
- **Interactions:** Click to view, filter, search, upload
- **Visual Design:** Organized document library

**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

## Visual Documentation

### Screenshots

**Employee File Dashboard:**

- **File:** `/v2/img/screenshots/mitarbeiterprofil.png`
- **Alt Text:** "Ordio Mitarbeiterprofil, Personalakte"
- **Caption:** Employee file dashboard showing centralized employee data management

**Personalfragebogen:**

- **File:** `/v2/img/screenshots/personalfragebogen.webp`
- **Alt Text:** "Personalfragebogen interface showing employee questionnaire"
- **Caption:** Personalfragebogen interface for digital employee onboarding

**Document Management:**

- **File:** `/v2/img/screenshots/personalakte-dokumente.webp`
- **Alt Text:** "Document management in digital employee file"
- **Caption:** Document library showing categorized employee documents

### Diagrams

**User Flow Diagram:**

- **File:** `/v2/img/diagrams/personalakte-user-flow.svg`
- **Description:** Flow from employee creation → document upload → Personalfragebogen → compliance tracking
- **Use Case:** Understanding the complete employee file management workflow

**Integration Diagram:**

- **File:** `/v2/img/diagrams/personalakte-integration.svg`
- **Description:** How Digitale Personalakte integrates with Dokumentenmanagement, Lohnabrechnung, and tax advisor systems

## 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
- **Integration updates:** As needed for tax advisor and payroll system integrations
- **Performance optimization:** Ongoing improvements to search speed and data access

### Common Updates

- **New document types:** Add support for new document types based on industry needs
- **Workflow enhancements:** Improve automatic workflow functionality
- **Search improvements:** Enhance search capabilities and speed
- **Mobile app updates:** Improve mobile employee file access and document upload
- **Compliance features:** Add new compliance tracking and reporting features
- **Integration improvements:** Enhance integration with tax advisor and payroll systems
- **Personalfragebogen enhancements:** Add new questionnaire fields and customization options

## Related Documentation

- [Product Pages Inventory](../../pages/product-pages/PRODUCT_PAGES_INVENTORY.md)
- [Product Features Inventory](../PRODUCT_FEATURES_INVENTORY.md)
- [Dokumentenmanagement Documentation](dokumentenmanagement-documentation.md)
- [Lohnabrechnung Documentation](lohnabrechnung-documentation.md)
- [Abwesenheiten Documentation](abwesenheiten-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)