Disaster Assistance Management System (DAMS)

A comprehensive disaster management system built with React and Vite for managing disaster events, donations, and assistance coordination.

Features

• Event Management: Create and manage disaster events
• User Authentication: Role-based access control (admin, recipient, donator)
• Donation System: Track and manage donations and pledges
• Real-time Updates: Live updates for disaster events and donations

Tech Stack

• Frontend: React 19, Vite
• Backend: Node.js, Express
• Database: MySQL
• Authentication: JWT
• Testing: Jest, React Testing Library

Getting Started

Prerequisites

• Node.js (v16 or higher)
• MySQL database
• npm or yarn

Installation

1. Clone the repository:

git clone <repository-url>
cd DAMS

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env

Edit the .env file with your database credentials and JWT secret.

4. Start the development server:

npm run dev

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint

Testing

Run tests with:

npm test

Project Structure

src/
├── components/     # Reusable UI components
├── controllers/    # Backend controllers
├── hooks/         # Custom React hooks
├── pages/         # Page components
├── utils/         # Utility functions
├── App.jsx        # Main app component
├── main.jsx       # Application entry point
└── router.jsx     # Routing configuration

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests
5. Submit a pull request

License

This project is licensed under the MIT License.