🚀 Resource Management Dashboard

Enterprise-Grade Cloud Resource Management Platform

Trusted by technical teams for centralized resource monitoring and management

⚡ Why Choose This Platform?

📊 Quick Stats

🎨 Features at a Glance

✨ Authentication & Security

JWT tokens, bcrypt hashing, protected admin account & audit logging

👥 Role-Based Access Control

Admin/User roles, permission levels, protected admin account system

📦 Resource Management

18 resource types, CRUD operations, metadata, real-time updates

🎨 Theme & Customization

Dark/Light modes, persistent storage, real-time switching

📱 Mobile Responsiveness

100% responsive design, touch-optimized, all devices (320px+)

📊 Dashboard & Analytics

Real-time insights, resource counts, status breakdown

🏗️ Architecture (3-Tier Design)

┌─────────────────────────────────────────────────────────────────┐
│                       TIER 1: PRESENTATION                      │
│              React 18 + TypeScript + Vite + Tailwind            │
├─────────────────────────────────────────────────────────────────┤
│         Port 5000 | Dashboard, Resources, Users, Settings       │
└────────────────────────┬────────────────────────────────────────┘
                         │ REST API (HTTPS)
┌────────────────────────▼────────────────────────────────────────┐
│                  TIER 2: BUSINESS LOGIC                         │
│             FastAPI + Python + JWT Auth + RBAC                  │
├─────────────────────────────────────────────────────────────────┤
│      Port 8000 | /api/auth, /api/users, /api/resources          │
└────────────────────────┬────────────────────────────────────────┘
                         │ SQLAlchemy ORM
┌────────────────────────▼────────────────────────────────────────┐
│                   TIER 3: DATA STORAGE                          │
│             SQLite (Dev) OR Azure SQL (Prod)                    │
├─────────────────────────────────────────────────────────────────┤
│       Tables: users, resources, themes, audit_logs              │
└─────────────────────────────────────────────────────────────────┘

📦 Tech Stack Overview

🚀 Quick Start

Prerequisites

• Node.js v20+
• Python v3.11+
• Git for version control

5-Minute Setup

# Clone the frontend
git clone https://github.com/Riteshatri/resource-management-frontend.git frontend
cd frontend && npm install && npm run dev

# In another terminal, clone backend
git clone https://github.com/Riteshatri/resource-management-backend.git backend
cd backend && pip install -r requirements.txt && python run.py

# Open http://localhost:5000
# Login: ritesh@apka.bhai

📚 Project Structure

This is a multi-repository setup for scalability and modularity:

Resource-Management-Project/
│
├── 📘 RM-Frontend (React + Vite)
│   ├── src/components
│   ├── src/pages
│   ├── src/lib
│   └── npm run dev
│
├── 🔧 RM-Backend (FastAPI + Python)
│   ├── app/api
│   ├── app/models
│   ├── app/db
│   └── python run.py
│
└── 💾 RM-Database (SQL Scripts)
    ├── schema.sql
    ├── seed.sql
    ├── migrations/
    └── Azure SQL setup guides

🔒 Security & Trust

📈 Performance Metrics

🎯 Project Structure Of Resource Management (RM): 3 Main Repositories

This showcase repository links to THREE specialized sub-repositories. Each handles a specific part of the stack!

📘 Repository 1: RM-Frontend

git clone https://github.com/Riteshatri/resource-management-frontend.git
cd resource-management-frontend
npm install
npm run dev

🔧 Repository 2: RM-Backend

git clone https://github.com/Riteshatri/resource-management-backend.git
cd resource-management-backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python run.py

💾 Repository 3: RM-Database

# 1. Create resource group
az group create --name rmd-prod --location eastus

# 2. Create SQL server
az sql server create \
  --name rmd-sql-$(date +%s) \
  --resource-group rmd-prod \
  --admin-user sqladmin

# 3. Run schema scripts from this repo
# 4. Configure firewall & environment variables
# 5. Done! Connected to cloud database

🔗 How to Use All 3 Repositories Together

Option 1: Local Development (All on your machine)

# Setup Frontend
git clone https://github.com/Riteshatri/resource-management-frontend.git
cd resource-management-frontend
npm install && npm run dev

# Setup Backend (new terminal)
git clone https://github.com/Riteshatri/resource-management-backend.git
cd resource-management-backend
pip install -r requirements.txt && python run.py

# Database setup (use RM-Database scripts)
# SQLite auto-creates for development

# Access: http://localhost:5000

Option 2: Production Deployment (Azure VMs)

# 1. Setup database (from RM-Database repo)
#    └─ Create Azure SQL with provided scripts

# 2. Deploy backend (from RM-Backend repo)
#    └─ Setup on Backend VM

# 3. Deploy frontend (from RM-Frontend repo)
#    └─ Build & deploy on Frontend VM with Nginx

# 4. Connect all three via environment variables

Option 3: Containerized (Docker)

# Each repo includes Dockerfile
# Pull from RM-Frontend, RM-Backend, RM-Database
# Compose them together with docker-compose.yml

📊 Repository Comparison

✨ Complete Feature List

🚀 Deployment Options

📖 Documentation

• 📘 This README - Project overview & links
• 📗 RM-Frontend README - Frontend setup & guide
• 📕 RM-Backend README - Backend setup & API docs
• 📙 RM-Database README - Database setup & schemas
• 🔗 GitHub Wiki - Detailed guides

🏆 Why This Project Stands Out

✨ Complete Stack Example

• Frontend to Database
• Production-ready code
• Best practices throughout

✨ Learning Resource

• Well-commented code
• Setup guides for each repo
• Real-world patterns

✨ Scalable Architecture

• 3-tier design
• Modular repositories
• Easy to extend

✨ Enterprise Features

• Authentication & Authorization
• Database management
• Production deployment
• Security best practices

✨ Fully Responsive

• Mobile-first design
• Works on all devices
• Touch-optimized controls

🤝 Getting Help

Need help?

1. Check the README in each sub-repository
2. Check the GitHub Wiki
3. Review API documentation in RM-Backend
4. Check database setup in RM-Database

Each repository contains:

• Setup instructions
• Troubleshooting guide
• Quick start commands
• Detailed documentation

📄 License

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

🎯 Next Steps

Choose Your Journey:

1. 👉 Start with Frontend → If you want to learn React
2. 👉 Start with Backend → If you want to learn FastAPI
3. 👉 Start with Database → If you want to learn SQL & Azure
4. 👉 Setup Complete Stack If you want everything working locally

v1.0.0 • Last Updated: November 26, 2025 • Status: ✅ Production Ready