Skip to content

jonathanrao99/Hydraa-PMS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

16 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›๏ธ Hydraa-PMS

React TypeScript Vite Tailwind CSS License

Manage petitions like a pro! ๐Ÿš€

Comprehensive Petition Management System for Hyderabad Disaster Response and Asset Protection Agency


๐ŸŽฏ What's This?

A modern, full-featured web application for managing petitions and complaints within the Hyderabad Disaster Response and Asset Protection Agency (HYDRAA). Think of it as your digital command center for efficient petition processing! ๐Ÿ“‹

โœจ What You Get

  • ๐Ÿ” Multi-role authentication (Reception, Officer, Commissioner, Admin)
  • ๐Ÿ“ Streamlined petition creation and management
  • ๐ŸŽฏ Role-based dashboards with real-time statistics
  • ๐Ÿ“Š Advanced analytics and reporting
  • ๐Ÿ”„ Workflow automation from submission to decision
  • ๐Ÿ“ฑ Responsive design for all devices
  • โšก Lightning-fast performance with Vite

๐Ÿ–ผ๏ธ Screenshots

๐Ÿ” Login Interface

Login Page Secure authentication with role-based access

๐Ÿ“Š Reception Dashboard

Reception Dashboard Overview of petitions and recent activities

๐Ÿ“ Create New Petition

Create Petition Intuitive form for petition submission

๐Ÿ‘ฎ Officer Dashboard

Officer Dashboard Enquiry officer's workspace with assigned petitions

๐Ÿ” Officer Enquiry

Officer Enquiry Detailed feedback submission interface

๐Ÿ›๏ธ Commissioner Dashboard

Commissioner Dashboard High-level overview and decision management

๐Ÿ“‹ Commissioner Assigned Petitions

Commissioner Assigned Track petitions under investigation

๐Ÿ“ˆ Commissioner Analytics

Commissioner Analytics Comprehensive data visualization

๐Ÿ‘ฅ User Management

User Management Admin interface for user management


๐Ÿš€ Quick Start

# 1. Clone it
git clone https://github.com/jonathanrao99/Hydraa-PMS.git
cd Hydraa-PMS

# 2. Install dependencies
npm install

# 3. Start development server
npm run dev

That's it! ๐ŸŽ‰


๐ŸŽฎ How to Use

๐Ÿ” Login Credentials

For testing, use these accounts:

  • Reception: reception@hydraa.gov.in (any password)
  • Enquiry Officer: officer@hydraa.gov.in (any password)
  • Commissioner: commissioner@hydraa.gov.in (any password)
  • Admin: admin@hydraa.gov.in (any password)

๐Ÿ“‹ User Roles & Permissions

๐Ÿข Reception Staff

  • Create new petitions
  • View all petitions
  • Manage petition status
  • Dashboard with statistics

๐Ÿ” Enquiry Officers

  • View assigned petitions
  • Submit investigation reports
  • Upload evidence and findings
  • Track investigation progress

๐Ÿ›๏ธ Commissioner (HOD)

  • Assign petitions to officers
  • Review investigation reports
  • Make final decisions
  • Access analytics dashboard

๐Ÿ‘จโ€๐Ÿ’ผ Administrator

  • Manage user accounts
  • System configuration
  • View all petitions
  • Access system analytics

๐Ÿ› ๏ธ What's Inside

Hydraa-PMS/
โ”œโ”€โ”€ ๐Ÿ“ src/
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ components/          # Reusable UI components
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ auth/           # Authentication components
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ common/         # Shared components
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ layout/         # Layout components
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ petition/       # Petition-specific components
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ“ ui/             # Base UI components (shadcn/ui)
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ contexts/           # React contexts
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ hooks/              # Custom React hooks
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ lib/                # Utilities and constants
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ pages/              # Page components
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ admin/          # Admin pages
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ commissioner/   # Commissioner pages
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ dashboard/      # Dashboard pages
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ officer/        # Officer pages
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ“ reception/      # Reception pages
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ services/           # API services
โ”‚   โ””โ”€โ”€ ๐Ÿ“ types/              # TypeScript type definitions
โ”œโ”€โ”€ ๐Ÿ“ public/                 # Static assets
โ”œโ”€โ”€ โš™๏ธ package.json            # Dependencies and scripts
โ”œโ”€โ”€ ๐ŸŽจ tailwind.config.ts      # Tailwind configuration
โ”œโ”€โ”€ โšก vite.config.ts          # Vite configuration
โ””โ”€โ”€ ๐Ÿ“‹ README.md               # This file

๐Ÿ› ๏ธ Development

Available Scripts

# Development
npm run dev              # Start development server
npm run build            # Build for production
npm run preview          # Preview production build

# Code Quality
npm run lint             # Run ESLint
npm run lint:fix         # Fix ESLint issues
npm run type-check       # TypeScript type checking
npm run format           # Format code with Prettier
npm run format:check     # Check code formatting

Tech Stack

  • Frontend: React 18 + TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS + shadcn/ui
  • Routing: React Router DOM
  • Forms: React Hook Form + Zod
  • State Management: React Context + TanStack Query
  • Charts: Recharts
  • Icons: Lucide React

๐Ÿ› Troubleshooting

Problem: ModuleNotFoundError: No module named 'react' Solution: npm install

Problem: Build fails with TypeScript errors Solution: npm run type-check to identify issues

Problem: Styling not working Solution: Ensure Tailwind CSS is properly configured

Problem: Login not working Solution: Check browser console for errors, ensure all dependencies are installed


๐Ÿค Contributing

  1. Fork it ๐Ÿด
  2. Create a branch ๐ŸŒฟ
  3. Make changes โœ๏ธ
  4. Submit PR ๐Ÿš€

Ideas welcome! ๐Ÿ’ก


โš ๏ธ Disclaimer

For demonstration purposes! This is a prototype application showcasing modern web development practices. In production, implement proper security measures, database integration, and API endpoints.


๐ŸŒŸ Star the Repository

If you find this project helpful, please give it a โญ on GitHub!

GitHub stars

๐Ÿ“ž Connect & Support

GitHub LinkedIn Buy Me a Coffee


Made with โค๏ธ and โ˜• by Jonathan Thota

Managing petitions, one click at a time! ๐Ÿ“‹

Releases

No releases published

Packages

 
 
 

Contributors

Languages