🚀 ResolveX Pro

A multi-tenant SaaS workflow and ticket management platform built with Django, PostgreSQL, and role-based access control (RBAC), inspired by systems like Jira, Zendesk, and enterprise admin platforms.

📌 Overview

ResolveX Pro is a production-style workflow and issue management platform designed for organizations to manage support operations, internal workflows, issue tracking, and team collaboration through a centralized ticketing system.

The platform follows a modern SaaS architecture with:

🏢 Multi-tenancy
🔐 Role-Based Access Control (RBAC)
🎫 Workflow-driven ticket lifecycle
📊 Analytics & observability
📜 Audit logging
📩 Invitation-based onboarding
🔔 Real-time notifications
⚡ Modular service-layer backend architecture

🎯 Problem Statement

Organizations often manage operational issues through:

emails
spreadsheets
chat tools
disconnected systems

This creates:

lack of accountability
delayed issue resolution
poor visibility
inconsistent workflows
no operational auditability

ResolveX Pro solves this by providing a structured workflow platform with centralized ticket management and organization-wide operational visibility.

🧠 Core Features

🏢 Multi-Tenant Organization System

Multiple organizations on same platform
Data isolation per organization
Organization-specific users and workflows

🔐 Authentication & Authorization

JWT Authentication
Secure login/logout
Role-based route protection
Organization-scoped access

👥 Role-Based Access Control (RBAC)

Roles

ADMIN
MANAGER
AGENT
USER

Permission Examples

ticket.create
ticket.assign
ticket.resolve
user.manage
invitation.send

🎫 Ticket Workflow Engine

Ticket Lifecycle

OPEN
↓
ASSIGNED
↓
IN_PROGRESS
↓
RESOLVED
↓
CLOSED

Features

Create tickets
Assign/reassign tickets
Status transitions
Priority handling
Ticket comments
Internal notes
Attachments
Ticket duration tracking

📩 Invitation System

Invite users via email
Role assignment during onboarding
Secure token-based invitation links
Expiration & revoke support

📊 Analytics Dashboard

Tickets by status
Tickets by priority
Agent performance
Resolution time tracking
Open vs closed ratios

📜 Audit Logging

Tracks:

ticket updates
role changes
assignments
organization actions
authentication events

Provides complete operational traceability.

🔔 Notifications

Ticket assignment notifications
Status update alerts
Comment notifications
In-app notification center

⏱ SLA & Escalation (Planned)

Ticket aging
SLA deadlines
Auto-escalation
Priority escalation

🤖 AI-Assisted Features (Planned)

Smart ticket categorization
Priority suggestion
Duplicate ticket detection

🏗️ System Architecture

Frontend (Next.js)
        ↓
REST API / WebSockets
        ↓
Django Backend
 ├── API Layer
 ├── Service Layer
 ├── Workflow Engine
 ├── RBAC System
 ├── Analytics Engine
 └── Notification System
        ↓
PostgreSQL Database

⚙️ Tech Stack

Backend

Django
Django Ninja
PostgreSQL
JWT Authentication
Celery + Redis (planned)
Django Channels (planned)

Frontend

Next.js
React
TypeScript
Tailwind CSS
Framer Motion

📂 Backend Structure

backend/
├── manage.py
├── requirements.txt
├── config/
│   ├── settings.py
│   ├── urls.py
│   ├── asgi.py
│   └── wsgi.py
│
├── app/
│   ├── api/
│   ├── models/
│   ├── schemas/
│   ├── services/
│   ├── core/
│   ├── utils/
│   ├── celeryworkers/
│   ├── websockets/
│   └── tests/

🔐 Authentication Flow

🏢 Organization Registration

Organization owner creates:

organization
admin account
default roles & permissions

👤 User Registration

Users can join organizations using:

organization slug
invitation link

📩 Invitation Workflow

Admins invite:

managers
agents
users

Users complete onboarding through secure invitation links.

📌 Main API Routes

Authentication

POST /api/v1/auth/login/
POST /api/v1/auth/logout/
GET  /api/v1/auth/me/

Organizations

POST /api/v1/setup/create/
GET  /api/v1/organizations/current/

Tickets

POST /api/v1/tickets/
GET  /api/v1/tickets/
GET  /api/v1/tickets/{id}/

POST /api/v1/tickets/{id}/assign/
POST /api/v1/tickets/{id}/start/
POST /api/v1/tickets/{id}/resolve/
POST /api/v1/tickets/{id}/close/

Invitations

POST /api/v1/invitations/
POST /api/v1/invitations/{id}/resend/
POST /api/v1/invitations/{id}/revoke/

Audit Logs

GET /api/v1/audit-logs/

Analytics

GET /api/v1/analytics/overview/

🗄️ Database Design

Core Models

User
Organisation
Ticket
TicketComment
Invitation
AuditLog
Notification
Role
Permission

🚀 Setup Instructions

Clone Repository

git clone <repository-url>
cd resolvex

Backend Setup

cd backend

python -m venv venv

source venv/bin/activate

pip install -r requirements.txt

Database Migration

python manage.py makemigrations
python manage.py migrate

Run Server

python manage.py runserver

Server:

http://127.0.0.1:8000

Author

Archi Shaw

Name		Name	Last commit message	Last commit date
backend		backend
client		client
.gitignore		.gitignore
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation