/effective-octo-robot

A modern web application built with Ruby on Rails 7+, providing a unified portal for Receptionists and Doctors to manage and visualize patient data effectively. The app demonstrates robust authentication, role-based access, and real-time interactions using Turbo Streams, while offering a responsive

Primary LanguageHTML

🏥 Receptionist & Doctor Portal App

A modern web application built with Ruby on Rails 7+, providing a unified portal for Receptionists and Doctors to manage and visualize patient data effectively. The app demonstrates robust authentication, role-based access, and real-time interactions using Turbo Streams, while offering a responsive, dockerized development environment.

🛠 Built With

Tech Stack

Framework & Language
Database
Frontend & Styling
Authentication & Authorization
Other Tools

Key Features

  • 🧾 Single Login Page for all roles (Receptionist, Doctor, Admin, Superadmin)
  • 👩‍💼 Receptionist Portal to register and manage patients (CRUD)
  • 🩺 Doctor Portal to view patients and visualize registration trends with charts
  • 📈 Patient Graph with Chartkick showing number of registrations per day
  • 🧪 Role-Based Access using Cancancan (Superadmin, Admin, Doctor, Receptionist)
  • 📱 Responsive Design with Tailwind CSS
  • 🔐 Secure Authentication with Devise
  • 🧭 Landing Page for enhanced UX
  • 🔄 Turbo Streams for real-time updates
  • 🐳 Dockerized Environment for simplified setup
  • 👀 Conditional Rendering based on roles and permissions

🚀 Live Demo

Demo available soon!

💻 Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

  • Ruby >= 3.1
  • Rails >= 7
  • Docker & Docker Compose
  • Node.js & Yarn (optional if not using Docker)

Setup

Clone the repository:

git clone https://github.com/skyv26/effective-octo-robot.git
cd effective-octo-robot

Install & Run with Docker

docker-compose build
docker-compose up

The app should be running at http://localhost:3000

Install & Run Manually

bundle install
yarn install
rails db:setup
bin/dev

👥 Authors

👨‍💻 Aakash Verma

🔭 Future Features

  • 📝 Patient Notes or Medical History
  • 📆 Appointment Booking & Management
  • 🔔 Notification System for patient registration
  • 📤 Export patient reports (PDF/CSV)
  • 🌐 Deployment on Render/Heroku

🤝 Contributing

Contributions, issues, and feature requests are welcome!

  • Fork the repo
  • Create your feature branch (git checkout -b feature-name)
  • Commit your changes (git commit -m 'Add some feature')
  • Push to the branch (git push origin feature-name)
  • Open a pull request

⭐️ Show your support

If you like this project, please ⭐️ the repository and share your thoughts!

🙏 Acknowledgements

  • Rails Community
  • Hotwire Team
  • Tailwind Labs
  • Devise & Cancancan maintainers
  • Chartkick for awesome visualizations

📝 License

This project is MIT licensed.