AidChain - Disaster Response & Aid Distribution Platform

A blockchain-powered platform for transparent and efficient disaster relief coordination and aid distribution.

Overview

AidChain leverages blockchain technology to bring transparency, accountability, and efficiency to disaster response efforts. By utilizing the Stellar network, the platform enables real-time tracking of aid distribution, donor verification, and ensures that resources reach those who need them most.

Key Features

• Transparent Aid Tracking: Real-time monitoring of aid distribution from donor to beneficiary using blockchain ledger
• Smart Contract Automation: Automated distribution triggers based on verified disaster events and recipient verification
• Donor Dashboard: Complete visibility into where donations go and their impact
• Beneficiary Management: Secure verification and registration system for aid recipients
• Multi-Asset Support: Handle various forms of aid including monetary donations, supplies, and services
• Geolocation Integration: Map-based visualization of disaster zones and distribution centers
• Mobile-First Design: Accessible interface for field workers and beneficiaries in affected areas

Technology Stack

Backend

• NestJS: Enterprise-grade Node.js framework for building scalable server-side applications
• TypeScript: Type-safe development
• PostgreSQL: Primary database for application data
• Redis: Caching and session management

Frontend

• React: Modern UI library for building interactive user interfaces
• TypeScript: Type-safe frontend development
• Tailwind CSS: Utility-first styling
• React Query: Data fetching and state management

Blockchain

• Stellar: Fast, low-cost blockchain network for asset transfers
• Stellar SDK: Integration with Stellar network
• Soroban: Smart contract platform on Stellar (optional for advanced logic)

Additional Technologies

• Docker: Containerization for consistent deployment
• JWT: Secure authentication
• WebSocket: Real-time updates
• Google Maps API: Geolocation services

Getting Started

Prerequisites

• Node.js (v18 or higher)
• PostgreSQL (v14 or higher)
• Redis (v6 or higher)
• Docker (optional)
• Stellar account (testnet for development)

Installation

# Clone the repository
git clone https://github.com/Servora/aidchain.git
cd aidchain

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

Environment Setup

Create a .env file in the backend directory:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/aidchain
REDIS_URL=redis://localhost:6379

# Stellar Network
STELLAR_NETWORK=testnet
STELLAR_HORIZON_URL=https://horizon-testnet.stellar.org
STELLAR_DISTRIBUTION_SECRET=YOUR_SECRET_KEY

# JWT
JWT_SECRET=your-secret-key
JWT_EXPIRATION=7d

# API Keys
GOOGLE_MAPS_API_KEY=your-api-key

Create a .env file in the frontend directory:

REACT_APP_API_URL=http://localhost:3000
REACT_APP_STELLAR_NETWORK=testnet
REACT_APP_GOOGLE_MAPS_API_KEY=your-api-key

Running the Application

# Start backend server
cd backend
npm run start:dev

# Start frontend development server
cd frontend
npm start

The backend will run on http://localhost:3000 and the frontend on http://localhost:3001.

Docker Deployment

# Build and run with Docker Compose
docker-compose up -d

Project Structure

aidchain/
├── backend/
│   ├── src/
│   │   ├── auth/
│   │   ├── donors/
│   │   ├── beneficiaries/
│   │   ├── distributions/
│   │   ├── stellar/
│   │   ├── common/
│   │   └── main.ts
│   ├── test/
│   └── package.json
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── services/
│   │   ├── hooks/
│   │   ├── utils/
│   │   └── App.tsx
│   └── package.json
├── docker-compose.yml
└── README.md

Core Modules

Backend Modules

• Auth Module: User authentication and authorization
• Donors Module: Donor registration and donation management
• Beneficiaries Module: Recipient verification and registration
• Distributions Module: Aid distribution coordination and tracking
• Stellar Module: Blockchain integration and transaction handling
• Analytics Module: Reporting and impact metrics

Frontend Components

• Dashboard: Overview of active disasters and distribution status
• Donation Portal: Interface for donors to contribute
• Distribution Map: Geographic visualization of aid delivery
• Beneficiary Portal: Registration and aid claim interface
• Admin Panel: Platform management and verification tools

API Documentation

API documentation is available at http://localhost:3000/api/docs when running the backend server.

Testing

# Backend unit tests
cd backend
npm run test

# Backend e2e tests
npm run test:e2e

# Frontend tests
cd frontend
npm test

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Security

• All sensitive data is encrypted
• Stellar keys are stored securely using environment variables
• API endpoints are protected with JWT authentication
• Regular security audits recommended for production deployment

License

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

Roadmap

• Mobile application (React Native)
• AI-powered disaster prediction
• Integration with IoT sensors for real-time disaster monitoring
• Multi-language support
• Offline-first capabilities for disaster zones
• Integration with traditional banking systems

Acknowledgments

• Stellar Development Foundation for blockchain infrastructure
• Open-source community for various tools and libraries
• Disaster relief organizations for domain expertise

---