Welcome to the documentation for CHRIS (Croatian Human Resource Information System) - a comprehensive leave and employee management system.
What is CHRIS?
CHRIS is a modern HRIS application designed to streamline employee leave management, team organization, and HR workflows. Built with React, TypeScript, and Supabase, it offers:
- Multi-language Support: Croatian, English, Russian, and Hindi
- Leave Management: Full workflow from request to approval
- Team Organization: Hierarchical team structure with team leaders
- Contract Management: Track employment contracts and documents
- Email Notifications: Automated notifications via SMTP
- Role-Based Access: Admin, HR Manager, and Employee roles
Quick Start
-
:material-clock-fast:{ .lg .middle } Getting Started
Set up your development environment and run CHRIS locally
:octicons-arrow-right-24: Getting Started
-
:material-account-plus:{ .lg .middle } First Leave Request
Learn how to submit your first leave request as an employee
:octicons-arrow-right-24: First Leave Request
-
:material-cog:{ .lg .middle } Admin Setup
Configure CHRIS for your organization
:octicons-arrow-right-24: Admin Setup Guide
Documentation Structure
This documentation follows the Diátaxis framework:
| Section | Purpose | Best For |
|---|---|---|
| Tutorials | Learning-oriented guides | Beginners starting out |
| How-To Guides | Task-oriented instructions | Accomplishing specific tasks |
| Reference | Technical specifications | Looking up details |
| Explanation | Understanding concepts | Learning how things work |
Key Features
Leave Management
- Submit, approve, and track leave requests
- Multiple leave types (annual, sick, family, etc.)
- Leave balance calculation with carryover support
- Public holiday integration by country
Employee Management
- Employee profiles with contract details
- CV/resume upload and management
- Role-based permissions (Admin, HR Manager, Employee)
- Admin masquerade functionality
Team Organization
- Create and manage teams
- Assign team leaders
- Team-based leave approval workflow
Internationalization
- Four supported languages: 🇭🇷 Croatian, 🇬🇧 English, 🇷🇺 Russian, 🇮🇳 Hindi
- Database-driven translations
- Easy to add new languages
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | React 18, TypeScript, Vite |
| UI Components | shadcn/ui, Tailwind CSS, Radix UI |
| State Management | TanStack Query (React Query) |
| Backend | Supabase (PostgreSQL, Auth, Edge Functions, Storage) |
| Routing | React Router v6 |
| Forms | React Hook Form, Zod validation |
Version
Current Version: 1.0.0
See the Changelog for version history.
Contributing
CHRIS is developed following these standards:
- Accessibility: WCAG 2.1 Level AA compliance
- Changelog: Keep a Changelog format
- Versioning: Semantic Versioning
Support
For issues or feature requests, please visit our GitHub repository.