Skip to content
Ashif E.K edited this page Jul 4, 2026 · 1 revision

πŸš€ WorkPilot AI

Enterprise AI Workplace Management Platform

A modern, scalable, AI-powered workplace management system built using a microservices architecture to streamline HR, IT, employee services, and organizational workflows.


Overview

WorkPilot AI is designed as an enterprise SaaS platform that centralizes workplace operations into a single intelligent ecosystem.

The platform combines Human Resources, IT Support, Asset Management, Leave Management, Attendance, Procurement, Notifications, Analytics, and AI Assistants while maintaining a scalable microservice architecture suitable for production environments.


πŸ— System Overview

flowchart LR

A[Employees]
B[Admin]
C[HR]
D[IT Team]

A --> G
B --> G
C --> G
D --> G

G(API Gateway)

G --> Auth
G --> HRS
G --> ITS
G --> Notify
G --> AI

Auth[Authentication Service]
HRS[HR Service]
ITS[IT Service]
Notify[Notification Service]
AI[AI Services]

Auth --> DB[(PostgreSQL)]
HRS --> DB
ITS --> DB
Notify --> DB
AI --> DB
Loading

πŸ“š Documentation Roadmap

Section Description
πŸš€ Project Overview Vision, goals and business problem
πŸ— Architecture High-level system architecture
βš™οΈ Installation Local development setup
🌳 Git Workflow Branching strategy and PR workflow
πŸ” Authentication JWT, RBAC and security
πŸ—„ Database ER diagrams and schema
πŸ“‘ API Documentation Service endpoints
πŸ§ͺ Development Standards Coding conventions
🐳 Deployment Docker, CI/CD and Production
🀝 Contributing Contribution guidelines

🏒 Platform Modules

mindmap
  root((WorkPilot AI))
    Authentication
      Register
      Login
      RBAC
      JWT
    HR
      Leave
      Attendance
      Employees
      Payroll
    IT
      Helpdesk
      Assets
      Tickets
    Notifications
      Email
      Push
      In-App
    AI
      Chatbot
      Smart Search
      Analytics
Loading

πŸ› High Level Architecture

                    Internet
                        β”‚
                        β–Ό
                 API Gateway
                        β”‚
     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
     β–Ό                  β–Ό                    β–Ό
 Authentication      HR Service         IT Service
     β–Ό                  β–Ό                    β–Ό
 Notification      AI Services        Future Services
            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β–Ό
                   PostgreSQL

⚑ Technology Stack

Layer Technologies
Frontend React, TypeScript, Tailwind CSS
Backend FastAPI
Database PostgreSQL
ORM SQLAlchemy
Authentication JWT + OAuth2
Cache Redis
Async Tasks Celery
Messaging RabbitMQ (planned)
API Docs OpenAPI / Swagger
Containerization Docker
CI/CD GitHub Actions
Cloud AWS (planned)

πŸ“ Repository Structure

work-pilot/
β”‚
β”œβ”€β”€ auth-service/
β”œβ”€β”€ hr-service/
β”œβ”€β”€ it-service/
β”œβ”€β”€ notification-service/
β”œβ”€β”€ ai-service/
β”‚
β”œβ”€β”€ frontend/
β”‚
β”œβ”€β”€ infrastructure/
β”‚   β”œβ”€β”€ docker/
β”‚   β”œβ”€β”€ nginx/
β”‚   └── scripts/
β”‚
β”œβ”€β”€ docs/
└── wiki/

πŸ‘₯ Team

Member Responsibility
Ashif E.K Backend Development
Ashika K.S Backend Development
Nimshi C.P Backend Development

🎯 Development Principles

  • Scalable Microservice Architecture
  • Clean Architecture
  • SOLID Principles
  • Domain-Driven Design (DDD)
  • RESTful APIs
  • Security First
  • Testable Code
  • Production Ready
  • CI/CD Automation

πŸ“ˆ Development Workflow

gitGraph
    commit id: "main"

    branch develop
    checkout develop

    commit id: "Sprint"

    branch feature/auth
    checkout feature/auth
    commit id: "Register"
    commit id: "JWT"

    checkout develop
    merge feature/auth

    branch feature/hr
    checkout feature/hr
    commit id: "Leave"

    checkout develop
    merge feature/hr

    checkout main
    merge develop
Loading

πŸš€ Current Project Status

Module Status
Authentication 🟑 In Progress
HR Service ⏳ Planned
IT Service ⏳ Planned
Notification Service ⏳ Planned
AI Service ⏳ Planned
Frontend ⏳ Planned

πŸ“– Wiki Navigation

  • Project Overview
  • System Architecture
  • Authentication
  • Database Design
  • API Documentation
  • Development Workflow
  • Deployment Guide
  • Coding Standards
  • Contributing

WorkPilot AI is being developed as a production-grade enterprise platform following modern software engineering principles, emphasizing scalability, maintainability, security, and clean architecture.