🧑‍💻 Task Tracker – Learnathon Project

---

📖 Table of Contents

• 🚀 Features
• 👥 Team
• 🛠 Tech Stack
• ⚙️ Installation
• 📄 Configuration
• 🗄 Database Setup
• 📊 Diagrams
• SonarCloud Analysis
• 🚀 CI/CD Pipeline
• 📞 Contact

---

🛠️ Tech Stack

• Backend: ASP.NET 8 (C#)
• Frontend: React 18.2
• Architecture: Clean Architecture
• CI/CD: GitHub Actions
• Code Quality: SonarCloud
• Documentation: Swagger

---

🧱 Clean Architecture Overview

This project strictly adheres to Clean Architecture principles, emphasizing:

Layered Structure

• 🟢 Core Layer: Contains enterprise-wide business entities, validation rules, and domain logic.
• 🟡 Application Layer: Implements use cases, DTOs, and interfaces (abstractions for external services).
• 🔵 Infrastructure Layer: Handles external concerns - database operations, API integrations, and framework-specific implementations.
• 🟣 Presentation Layer: React-based UI that consumes the backend API.

Key Principles

• 🚀 Dependency Rule: Inner layers never depend on outer layers (Core → Application → Infrastructure → Presentation).
• 🧪 Testability: Clear separation enables unit testing (Core/Application) and integration testing (Infrastructure).
• 🔗 Dependency Injection: Leverages .NET's DI to invert dependencies between layers.
• 🌐 Decoupled Frontend: React app communicates via API contracts, enabling independent scaling.

Why It Matters: This architecture ensures long-term maintainability, flexibility to change tech stacks, and team collaboration efficiency.

---

📂 Project Structure

📦 src

├─ 🏗️ Employee.API # Presentation Layer (ASP.NET Web API).

├─ 🧠 Employee.Core # Core Layer (Entities, Domain Services).

├─ 🛠️ Employee.Application # Application Layer (Use Cases, DTOs, Interfaces).

└─ 📦 Employee.Infrastructure # Infrastructure Layer (EF Core, Repositories).

---

🚀 Features

• Role-Based Access Control 👨💼👩💻
• Task Management System ✅📅
• Leave Application Workflow 🏖️📩
• Real-time Caching with Redis ⚡🔴
• Salary Management System 💰📈
• Comprehensive Reporting 📊📑

---

👥 Team & Mentorship

Team Members

Role	Name	GitHub Profile
Team Leader	Nazmus Sakib
Developer	Md. Mubasshir Naib
Developer	Saikat Hossain Shohag

Mentor

Role	Name	GitHub Profile
Mentor	Sakib Mahmood

---

🛠 Tech Stack

Backend

Frontend

UI Template Courtesy:
Professional dashboard template provided by Vivasoft

DevOps

---

⚙️ Installation

Backend Setup

# Clone repository
git clone https://github.com/Learnathon-By-Geeky-Solutions/dev-4545.git
cd dev-4545/Employee.API

# Restore dependencies
dotnet restore

# Configure database (update connection string in appsettings.json)
dotnet ef database update --project Employee.Infrastructure

# Run the API
dotnet run

Frontend Setup

cd frontend/EmpUI

# Install dependencies
npm install

# Start development server
npm run dev

---

📄 Configuration

Update appsettings.json with your environment values:

{
  "ConnectionStrings": {
    "DefaultConnection": "Your Connection String",
    "RedisURL": "Your Redis URL"
  },
  "Jwt": {
    "Key": "your_super_secure_key_here",
    "Issuer": "your Issuer",
    "Audience": "Your Audience"
  },
  "Cors": {
    "url": "Your frontend URL" 
  }
}

---

🗄 Database Setup

View ER Diagram

---

📊 Diagrams

Diagram Type	Link
UML Diagram	View UML Diagram
Activity Diagram	View Activity Diagram

---

SonarCloud Analysis 📊🔍

Key metrics for code quality:

Metric 🎯	Status 📈	Icon 🌟
Quality Gate ✅		🏆
Bugs 🐞		🚫
Vulnerabilities 🔓		🛡️
Code Smells 👃		🧹
Coverage 📏		📊

---

🚀 CI/CD Pipeline

graph LR
A[Code Commit] --> B[Run Tests]
B --> C{Passed?}
C -->|Yes| D[Build & Package]
C -->|No| E[Alert Developers]
D --> F[Deploy to Staging]
F --> G[Run Integration Tests]
G --> H{Passed?}
H -->|Yes| I[Deploy to Production]
H -->|No| E

Loading

---

📞 Contact

Team Member	Email Address	GitHub Profile
Nazmus Sakib	📧 sakib.hb7@gmail.com	🐙 arghya-n
Mubasshir Naib	📧 u1904089@student.cuet.ac.bd	🐙 MubasshirNaib
Saikat Hossain Shohag	📧 u1904088@student.cuet.ac.bd	🐙 shohag1102

---

🚀 Powered by Geeky Solutions Learnathon 2024 🚀