Employee Management#

• Complete Employee Profiles: Store detailed information including personal data, birth information, residence details, and notes
• Document Management: Upload and manage employee documents with secure cloud storage
• Qualification Tracking: Track various employee qualifications with detailed scoring systems
• Search & Filter: Advanced search functionality across all employee fields
• Employment Status: Track and filter employees by employment status

Qualification System#

• Multiple Qualification Types: Support for various job roles including:
  • Tubista (Pipe Fitter)
  • Saldatore (Welder) - with technique and material specifications
  • Carpentiere (Carpenter)
  • Impiegato (Employee)
  • Capo Tecnico (Technical Manager)
  • Manovale (Laborer)
  • Aiutante (Helper)
  • Accoppiatorista (Coupler)
  • Montatore (Assembler)
• Scoring System: 0-5 point scoring system for qualification assessment
• Qualification Overview: Dedicated section to view all qualifications across the organization

Security & Permissions#

• Firebase Authentication: Secure email/password authentication
• Role-based Access Control: Read/write permissions management
• Secure Document Storage: Firebase Storage integration for document management

User Experience#

• Responsive Design: Mobile-friendly interface using HeroUI components
• Dark/Light Theme: Automatic theme switching support
• Italian Localization: Complete Italian language interface
• Toast Notifications: User-friendly feedback system
• Loading States: Smooth loading indicators and state management

Firestore Collections#

{
  id: string (auto-generated)
  name: string | null
  surname: string | null
  email: string | null
  phone: string | null
  gender: "male" | "female" | "other" | null
  taxCode: string | null
  employed: "yes" | "no" | null
  birthdate: string | null (ISO date)
  birthplaceCity: string | null
  birthplaceProvincia: string | null
  birthplaceNation: string | null
  birthplaceZipcode: number | null
  livingplaceAddress: string | null
  livingplaceCity: string | null
  livingplaceProvincia: string | null
  livingplaceNation: string | null
  livingplaceZipcode: number | null
  notes: string | null
  documents: string[] | null
  qualifications: {
    [qualificationType]: Array<{
      score?: number
      technique?: string
      material?: string
    }>
  } | null
}

{
  write: string[] // Array of user UIDs with write permissions
}

Firebase Storage Structure#

/employees/documents/
  ├── uuid_filename1.pdf
  ├── uuid_filename2.jpg
  └── ...

Authentication#

• Email/password authentication via Firebase Auth
• Persistent login sessions with localStorage
• Automatic redirect handling for authenticated/unauthenticated users

Authorization Levels#

• Read Access: All authenticated users can view data
• Write Access: Only users listed in settings/permissions.write array can:
  • Add new employees
  • Edit existing employees
  • Delete employees
  • Upload/delete documents

Getting Started#

1. Login: Use the authentication page to log in with your credentials
2. Home: Overview of the system features and navigation guide
3. Employees: Browse, search, and manage employee records
4. Qualifications: View employees organized by their qualifications

Managing Employees#

1. View All Employees: Navigate to “Risorse” (Resources)
2. Search: Use the search bar to find specific employees
3. Filter: Filter by employment status (Employed/Unemployed/All)
4. Add New Employee: Click “Aggiungi” (Add) button (requires write permissions)
5. Edit Employee: Click on an employee row, then “Modifica” (Edit)

Managing Qualifications#

1. Add Qualifications: In employee edit mode, use the + button in qualifications section
2. Score Qualifications: Use the 0-5 scale scoring system
3. Specialized Qualifications: For welders, specify technique and material
4. View by Qualification: Use the “Qualifiche” (Qualifications) section

Document Management#

1. Upload Documents: In employee edit mode, use the + button in documents section
2. View Documents: Click the external link icon to open documents
3. Delete Documents: Use the delete icon in edit mode

Required Fields#

The following fields are required for all employees:

• Name (nome)
• Surname (cognome)
• Phone (telefono)
• Email
• Gender (genere)
• Tax Code (codice fiscale)
• Employment Status (assunto)
• Birth Nation (nazione di nascita)
• Residence Nation (nazione di residenza)
• Residence Province (provincia di residenza)

Customization#

• Qualification Types: Modify qualificationsList in app/context.tsx
• Required Fields: Update attributesEmployees.requiredKeys in app/context.tsx
• Search Fields: Modify attributesEmployees.searchKeys in app/context.tsx
• UI Text: All text strings are centralized in the text object in app/context.tsx

Vercel (Recommended)#

1. Connect your GitHub repository to Vercel
2. Add environment variables in Vercel dashboard
3. Deploy automatically on push to main branch

Manual Deployment#

npm run build
npm start

Environment Variables#

Ensure all Firebase configuration variables are set in your deployment environment.

Common Issues#

1. Firebase Connection Issues

   • Verify all environment variables are correctly set
   • Check Firebase project configuration
   • Ensure Firebase services (Auth, Firestore, Storage) are enabled

2. Permission Denied Errors

   • Verify user UID is in the settings/permissions.write array
   • Check Firebase security rules are properly configured

3. Build Errors

   • Ensure Node.js version 18+
   • Clear .next folder and reinstall dependencies
   • Check for TypeScript errors

4. Authentication Issues

   • Verify Firebase Auth domain configuration
   • Check network connectivity
   • Clear browser localStorage if login persists incorrectly

Performance Optimization#

• Images are optimized using Next.js Image component
• Firebase queries include proper indexing
• Large lists use pagination
• Document uploads include progress indicators