A comprehensive full-stack web application designed to streamline and enhance the management of elder care facilities. EverCare provides a complete solution for managing residents, caregivers, medical records, events, and family contributions.
EverCare is a modern elder home management system that facilitates seamless communication and coordination between administrators, caregivers, and family members. The platform offers role-based access control, ensuring that each user type has access to the appropriate features and information.
- Administrators/Owners: Full system access, manage caregivers, residents, and oversee all operations
- Caregivers: Manage assigned residents, update medical records, handle daily care tasks
- Family Members: Track resident information, schedule visits, make contributions, view medical updates
- Secure login system with JWT-based authentication
- Role-based access control (Admin, Caregiver, Family)
- Password reset functionality
- Protected routes for each user type
- Complete resident profile management
- Medical history tracking
- Medication schedules and management
- Deactivated resident records
- Add, update, and remove caregivers
- Assign caregivers to specific residents
- Assign caregivers to events
- Track caregiver schedules and assignments
- Detailed medical record creation and editing
- Medical history tracking with audit trail
- Medication management with dosage and timing
- Role-specific access to medical information
- Create and manage elder home events
- Assign caregivers to events
- Event reports and analytics
- Event scheduling and coordination
- Family visit request system
- Visit scheduling and approval
- Visit history tracking
- Financial contribution tracking
- Non-financial contribution logging
- Contribution reports and analytics
- Admin oversight of all contributions
- Dashboard analytics
- Comprehensive reports generation (PDF)
- Data visualization with charts
- Performance metrics
EverCare/
│
├── backend/ # Node.js/Express backend server
│ ├── config/
│ │ └── db.js # MongoDB connection configuration
│ ├── controllers/ # Business logic controllers
│ │ ├── authController.js
│ │ ├── caregiverController.js
│ │ ├── eventController.js
│ │ ├── medicalRecordController.js
│ │ ├── medicationController.js
│ │ ├── visitRequestController.js
│ │ └── ... (other controllers)
│ ├── middleware/
│ │ └── authMiddleware.js # JWT authentication middleware
│ ├── models/ # MongoDB/Mongoose schemas
│ │ ├── User.js
│ │ ├── Resident.js
│ │ ├── Caregiver.js
│ │ ├── Event.js
│ │ ├── medicalRecord.js
│ │ ├── medication.js
│ │ └── ... (other models)
│ ├── routes/ # API route definitions
│ │ ├── authRoutes.js
│ │ ├── caregiverRoutes.js
│ │ ├── residentRoutes.js
│ │ ├── eventRoutes.js
│ │ └── ... (other routes)
│ ├── uploads/ # File upload directory
│ ├── server.js # Main server entry point
│ ├── hashPassword.js # Password hashing utility
│ ├── resetAdministration.js # Admin reset utilities
│ └── package.json
│
└── frontend/ # React/Vite frontend application
├── public/ # Static assets
├── src/
│ ├── assets/ # Images and resources
│ ├── audio/ # Audio files
│ ├── components/ # Reusable React components
│ │ ├── AdminDashboard.jsx
│ │ ├── AdminLayout.jsx
│ │ ├── CaregiverLayout.jsx
│ │ ├── FamilyLayout.jsx
│ │ ├── Header.jsx
│ │ ├── LoginForm.jsx
│ │ ├── ProtectedRoute.jsx
│ │ └── ... (other components)
│ ├── pages/ # Page components
│ │ ├── ChooseUserPage.jsx
│ │ ├── LoginOwnerPage.jsx
│ │ ├── LoginCaregiverPage.jsx
│ │ ├── LoginFamilyPage.jsx
│ │ ├── AddCaregiver.jsx
│ │ ├── EventCRUD.jsx
│ │ ├── MedicalRecordAdd.jsx
│ │ ├── MedicationAdd.jsx
│ │ ├── financial.jsx
│ │ ├── nonFinancial.jsx
│ │ └── ... (other pages)
│ ├── App.jsx # Main App component with routing
│ ├── main.jsx # React entry point
│ ├── App.css # Global styles
│ └── index.css # Base styles
├── index.html
├── vite.config.js # Vite configuration
├── tailwind.config.js # Tailwind CSS configuration
├── postcss.config.js # PostCSS configuration
└── package.json
- Node.js - JavaScript runtime environment
- Express.js - Web application framework
- MongoDB - NoSQL database
- Mongoose - MongoDB object modeling
- JWT (jsonwebtoken) - Authentication and authorization
- bcryptjs - Password hashing
- express-validator - Request validation
- cors - Cross-origin resource sharing
- express-fileupload - File upload handling
- nodemailer - Email notifications
- node-cron - Task scheduling
- moment-timezone - Date/time handling
- dotenv - Environment variable management
- React 19 - UI library
- Vite - Build tool and dev server
- React Router DOM - Client-side routing
- Axios - HTTP client
- Tailwind CSS - Utility-first CSS framework
- Chart.js & react-chartjs-2 - Data visualization
- jsPDF & jspdf-autotable - PDF generation
- React Icons - Icon library
- React Datepicker - Date selection component
- jwt-decode - JWT token decoding
- Heroicons - SVG icon library
- ESLint - Code linting
- Nodemon - Auto-restart during development
- PostCSS - CSS processing
Ensure you have the following installed:
- Node.js (v14 or higher)
- MongoDB (local installation or MongoDB Atlas account)
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/metharafonseka/EverCare-Elder-Home-Management-System.git cd EverCare-Elder-Home-Management-System -
Set up the Backend
cd backend npm install -
Configure Environment Variables
Create a
.envfile in thebackenddirectory with the following variables:PORT=5000 MONGO_URI=your_mongodb_connection_string JWT_SECRET=your_jwt_secret_key EMAIL_USER=your_email@example.com EMAIL_PASS=your_email_password
-
Set up the Frontend
cd ../frontend npm install
-
Start the Backend Server
cd backend npm start # or for development with auto-reload nodemon server.js
The backend server will run on
http://localhost:5000 -
Start the Frontend Development Server
cd frontend npm run devThe frontend will run on
http://localhost:5173(default Vite port) -
Access the Application
Open your browser and navigate to
http://localhost:5173
(Add screenshots of your application here to showcase the UI)
- JWT-based authentication with secure token storage
- Password hashing using bcryptjs
- Protected API routes with middleware
- Role-based access control
- Input validation and sanitization
- Secure file upload handling
The backend exposes RESTful APIs for all operations. Key endpoints include:
- Auth:
/api/auth/*- User authentication - Residents:
/api/residents/*- Resident management - Caregivers:
/api/caregivers/*- Caregiver operations - Events:
/api/events/*- Event management - Medical Records:
/api/medical-records/*- Medical data - Medications:
/api/medications/*- Medication tracking - Visits:
/api/visit-requests/*- Visit management - Contributions:
/api/financial-contributions/*,/api/non-financial-contributions/* - Statistics:
/api/stats/*- Analytics and reports
Contributions are welcome! If you'd like to contribute to EverCare:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the ISC License.
Methara Fonseka
- GitHub: @metharafonseka
Special thanks to all contributors and the open-source community for the amazing tools and libraries that made this project possible.
EverCare was built with a mission to improve the quality of care and management in elder care facilities. By providing an intuitive, comprehensive platform, we aim to help administrators, caregivers, and families work together more effectively to ensure the best possible care for our elderly residents.
Whether you're managing a small care home or a large facility, EverCare adapts to your needs and helps you focus on what matters most - caring for people.
Thank you for using EverCare! Together, we can make elder care better. ❤️