# 🇪🇹 Ethiopian Vital Events Management System (EVEMS)
A comprehensive, enterprise-grade web application for managing vital records (births, deaths, marriages, divorces) in Ethiopia with advanced statistical reporting, predictive analytics, and professional certificate generation.
---
## 📋 Table of Contents
- Overview
- Key Features
- Technology Stack
- System Architecture
- Installation
- User Roles
- API Documentation
- Screenshots
- Contributing
- License
---
## 🌟 Overview
The Ethiopian Vital Events Management System (EVEMS) is a modern, full-stack web application designed to digitize and streamline the management of vital records across Ethiopia. The system supports multi-role access, automated workflows, advanced analytics, and professional report generation.
### **Why EVEMS?**
- 🚀 **Modern Architecture** - Built with React and Flask for performance and scalability
- 🔐 **Secure** - JWT authentication, role-based access control, and audit trails
- 📊 **Data-Driven** - Real-time analytics, predictive modeling, and professional reporting
- 🇪🇹 **Ethiopia-Focused** - Support for all 12 Ethiopian regions with localized features
- 📱 **Responsive** - Works seamlessly on desktop, tablet, and mobile devices
- ♿ **Accessible** - WCAG 2.1 compliant with keyboard navigation support
---
## ✨ Key Features
### 📝 **Record Management**
#### **Birth Records**
- Complete birth registration with parent information
- Photo upload for birth certificates
- Automatic certificate number generation
- Father and mother details tracking
- Birth location and hospital information
#### **Death Records**
- Comprehensive death record registration
- Cause of death documentation
- Next of kin information
- Death certificate generation
- Medical examiner details
#### **Marriage Records**
- Bride and groom information management
- Witness details tracking
- Marriage certificate generation
- Marriage type classification
- Photo upload support
#### **Divorce Records**
- Divorce pet …