Cervo

Gallery

About

Cervo HRM - Human Resource Management SystemCervo HRM is a comprehensive, enterprise-grade Human Resource Management System built with modern technologies.🎯 OverviewCervo HRM is a complete HR management solution featuring:Employee Management - Full CRUD with import/export capabilitiesAttendance Tracking - GPS & IP-based check-in/out with approval workflowLeave Management - Request, approve, and balance trackingPayroll Processing - Automated calculations with payslip generationRole-Based Access Control - Granular permissions per roleAudit Logging - Complete activity trackingMulti-Company Support - Manage multiple organizations✨ FeaturesCore ModulesModuleFeaturesDashboardReal-time statistics, quick actions, recent activityEmployeesDirectory, profiles, contracts, bank accounts, CSV importDepartmentsOrganization structure, head/manager assignmentAttendanceCheck-in/out, GPS tracking, IP validation, admin viewLeaveRequest workflow, approval system, balance trackingPayrollRun management, auto-calculation, payslip generationReportsHeadcount, leave summary, payroll reports, CSV exportNotificationsIn-app alerts, broadcast announcementsAudit LogComplete activity trailSupport TicketsIssue tracking and resolutionRole-Based Access ControlRoleCapabilitiesADMINFull system accessEXECUTIVECompany-level managementHRHR operations, payroll, employeesMANAGERDepartment management, leave approvalUSERPersonal data, leave requests🔑 Demo CredentialsAfter running the seed script, use these accounts:[email protected]@cervo.compassword123Managermanager@[email protected]🚀 Quick StartPrerequisitesNode.js 18+PostgreSQL 15+ or SQLitenpm/yarn/pnpmInstallation# 1. Clone the repositorygit clone <repository-url>cd cervo# 2. Install dependenciesnpm install# 3. Set up environmentcp .env.example .env# Edit .env with your database URL# 4. Initialize databasenpx prisma generatenpx prisma db push# 5. Seed demo datanpm run seed# 6. Start development servernpm run devOpen http://localhost:3000 in your browser.📁 Project Structurecervo/├── prisma/│ ├── schema.prisma # Database schema│ ├── migrations/ # Database migrations│ └── seed.ts # Demo data seeder├── src/│ ├── actions/ # Server Actions (API)│ │ ├── auth.ts # Authentication│ │ ├── employees.ts # Employee management│ │ ├── departments.ts│ │ ├── leave.ts # Leave management│ │ ├── attendance.ts # Attendance tracking│ │ ├── payroll.ts # Payroll processing│ │ ├── notifications.ts│ │ └── reports.ts│ ├── app/ # Next.js App Router│ │ ├── (auth)/ # Login, Register│ │ ├── employees/ # Employee pages│ │ ├── departments/ # Department pages│ │ ├── leave/ # Leave pages│ │ ├── attendance/ # Attendance pages│ │ ├── payroll/ # Payroll pages│ │ └── ...│ ├── components/ # React components│ │ └── ui/ # UI primitives│ └── lib/ # Utilities│ ├── authz.ts # RBAC permissions│ ├── session.ts # JWT session│ └── prisma.ts # Database client└── public/ # Static assets🛠️ Technology StackCategoryTechnologyFrameworkNext.js 16 (App Router)LanguageTypeScript 5DatabasePostgreSQL / SQLiteORMPrisma 7AuthJWT (jose) + bcryptStylingTailwind CSSIconsMaterial Symbols📖 DocumentationDocumentDescriptionINSTALLATION.mdDetailed installation guideCONFIGURATION.mdEnvironment configurationFEATURES.mdComplete feature referenceUSER_GUIDE.mdEnd-user manualAPI_REFERENCE.mdServer Actions APIDEPLOYMENT.mdProduction deployment🔐 Security FeaturesJWT-based session managementPassword hashing with bcryptRole-based access control (RBAC)Audit logging for all actionsProtected routes via middlewareInput validation on all formsPrisma ORM (SQL injection prevention)📊 Database Models18 complete models with proper relations and indexes:Company ←→ Department ←→ Employee ←→ User ↓LeaveType ←→ LeaveBalance ↓LeaveRequest ←→ LeaveApproval ↓AttendanceRecord ←→ AttendanceApproval ↓PayrollRun ←→ PayrollItem ←→ Payslip ↓Notification, AuditLog, Ticket🌐 DeploymentVercel (Recommended)Push to GitHubConnect to VercelSet environment variablesDeployRailway / RenderCreate PostgreSQL databaseSet DATABASE_URL environment variableDeploy with npm run build && npm startDockerFROM node:18-alpineWORKDIR /appCOPY package*.json ./RUN npm ciCOPY . .RUN npx prisma generateRUN npm run buildEXPOSE 3000CMD ["npm", "start"]