blazordevlab/hrcloud repository overview

⁠🌐 HR Cloud

HR Cloud is an enterprise-grade human resources management system designed to streamline collaboration between employers, suppliers, and HR teams. It provides an integrated, closed-loop solution for attendance tracking, work hours management, and automated billing.

🎯 Live Demo⁠

⁠✨ Key Features

⁠👥 Multi-Party Collaboration

• Employer Portal: Manage workforce requirements and review billing statements
• Supplier Management: Track employee assignments and service delivery
• HR Administration: Centralized control over all HR operations

⁠⏰ Attendance & Time Management

• Real-time Attendance Tracking: Integrated device support for clock-in/out
• Daily Attendance Records: Automated daily attendance compilation
• Work Hours Calculation: Intelligent shift-based hour tracking
• Multiple Shift Support: Flexible shift scheduling and management

⁠💰 Billing & Financial Management

• Monthly Billing Statements: Automated invoice generation
• Work Hour Integration: Billing directly tied to attendance data
• Multi-organization Support: Handle multiple clients simultaneously
• Audit Trail: Complete financial transaction history

⁠📊 Advanced HR Features

• Employee Lifecycle Management: From application to employment history
• Employment Change Requests: Streamlined approval workflows
• Supplement Requests: Handle overtime and special payments
• Document Management: Centralized document storage and retrieval
• Employment Demand Planning: Forecast and manage workforce needs

⁠🔒 Security & Compliance

• Role-Based Access Control: Granular permission management
• Multi-tenant Architecture: Complete data isolation
• Audit Logging: Track all system activities
• Login Audits: Monitor user access patterns
• Interface Logs: API and integration monitoring

⁠📈 Analytics & Reporting

• Interactive Dashboard: Real-time business insights
• Customizable Reports: Export to Excel and other formats
• Visual Analytics: Built-in charts and data visualization
• Audit Trail Reports: Comprehensive compliance reporting

⁠🏗️ Architecture

HR Cloud is built on Clean Architecture principles, ensuring maintainability, testability, and scalability:

📦 src
 ├── 🎯 Domain          # Business entities and domain logic
 ├── 💼 Application     # Business rules and use cases
 ├── 🔧 Infrastructure  # External services and data access
 ├── 🖥️ Server.UI       # Blazor Server presentation layer
 └── 🗄️ Migrators       # Database migration tools

⁠Technology Stack

• Frontend: Blazor Server with MudBlazor UI components
• Backend: .NET 10, ASP.NET Core
• Architecture: Clean Architecture, CQRS, MediatR
• ORM: Entity Framework Core 10
• Database: SQL Server / PostgreSQL / SQLite
• Caching: FusionCache
• Background Jobs: Hangfire
• Real-time: SignalR
• Authentication: ASP.NET Core Identity
• Validation: FluentValidation
• Mapping: AutoMapper
• Excel Export: ClosedXML
• Charts: ApexCharts
• Email: FluentEmail with Razor templates

⁠🚀 Quick Start

⁠Prerequisites

• .NET 10 SDK⁠
• Docker⁠ (optional)
• SQL Server / PostgreSQL / SQLite

⁠Option 1: Docker Compose (Recommended)

# Clone the repository
git clone https://github.com/yourusername/CrewHub.git
cd CrewHub

# Start with Docker Compose
docker-compose up -d

# Access the application at http://localhost:5000

⁠Option 2: Local Development

# Clone the repository
git clone https://github.com/yourusername/CrewHub.git
cd CrewHub

# Restore dependencies
dotnet restore

# Update database connection string in appsettings.json
# src/Server.UI/appsettings.json

# Run database migrations
dotnet ef database update --project src/Infrastructure

# Run the application
cd src/Server.UI
dotnet run

# Access the application at https://localhost:7296

⁠🔧 Configuration

⁠Database Configuration

Edit src/Server.UI/appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=HRCloud;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

⁠Supported Databases

• SQL Server (default)
• PostgreSQL - Use Migrators.PostgreSQL
• SQLite - Use Migrators.SqLite

⁠Email Configuration

Configure SMTP settings in appsettings.json for:

• User activation emails
• Password recovery
• Welcome notifications
• 2FA authenticator codes

⁠📚 Core Modules

⁠🔐 Default Credentials

After initial setup, use these credentials to access the system:

Username: administrator
Password: [Set during first run]

⁠🐳 Docker Deployment

⁠Build Docker Image

docker build -t hrcloud:latest .

⁠Run with Docker

docker run -d \
  -p 5000:8080 \
  -e ConnectionStrings__DefaultConnection="your-connection-string" \
  --name hrcloud \
  hrcloud:latest

⁠Production Deployment

The project includes GitHub Actions workflow for automated Docker builds:

• Automatic builds on push to main branch
• Docker Hub integration
• Multi-platform support

⁠🧪 Testing

# Run all tests
dotnet test

# Run with coverage
dotnet test /p:CollectCoverage=true

⁠📖 Documentation

• API Documentation: Available at /swagger when running in development mode
• User Guide: Check the /docs folder for detailed user manuals
• Architecture Guide: See Architecture.md⁠
• Deployment Guide: See Deployment.md⁠

⁠🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

⁠📝 License

This project is licensed under the MIT License - see the LICENSE⁠ file for details.

⁠🌟 Features Roadmap

• Mobile App (iOS/Android)
• AI-powered workforce analytics
• Biometric attendance integration
• Multi-language support
• Advanced reporting engine
• Integration with popular payroll systems
• REST API for third-party integrations
• Real-time notifications

⁠📧 Contact & Support

• Demo: https://hrcloud.blazorserver.com/⁠
• Issues: GitHub Issues⁠
• Discussions: GitHub Discussions⁠

⁠🙏 Acknowledgments

Built with ❤️ using:

• Blazor⁠
• MudBlazor⁠
• Clean Architecture⁠
• Entity Framework Core⁠