https://github.com/janubhav/medicords
A web app that securely stores medical history in a paperless, tamper-proof format using blockchain technology.
https://github.com/janubhav/medicords
aptos aptos-move aptos-sdk flask flask-api move python quart react reactjs redis redis-stack
Last synced: 3 months ago
JSON representation
A web app that securely stores medical history in a paperless, tamper-proof format using blockchain technology.
- Host: GitHub
- URL: https://github.com/janubhav/medicords
- Owner: jAnubhav
- Created: 2025-04-05T15:11:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-18T06:50:34.000Z (11 months ago)
- Last Synced: 2026-01-25T01:55:10.085Z (4 months ago)
- Topics: aptos, aptos-move, aptos-sdk, flask, flask-api, move, python, quart, react, reactjs, redis, redis-stack
- Language: JavaScript
- Homepage:
- Size: 1.23 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🏥 Medicords – Your Health, Your Privacy in Your Hands (Secured by Blockchain)
## 🌐 Introduction
**Medicords** (short for *Medical Records*) is a secure and decentralized platform to manage medical histories on the **Aptos blockchain**. It eliminates reliance on fragile paper-based systems, prevents tampering or unauthorized access, and empowers users with full control over their health data.
## 👥 User Roles
### 🧑⚕️ Patients
- **Login at**: `/patients/login`
- **Functionality**:
- Register using **Aadhar ID** for unique and secure identification.
- **View your complete medical history** anytime through your personal dashboard.
- Access medical records securely with permissioned and blockchain-verified access.
### 🏥 Hospitals
- **Login at**: `/hospitals/login`
- **Functionality**:
- Register using **National Identification Number (NIN)**.
- **Add new medical records** for any registered patient.
- Manage and track medical entries for multiple patients.
- All submissions are permanently recorded on the blockchain, ensuring no tampering or deletion.
## 🔐 Key Features
1. **Blockchain Security** for tamper-proof data integrity.
2. **Permissioned Access** to health records anytime, anywhere.
3. **Cost-Effective Storage** for hospitals and clinics.
## 📸 Sample Interfaces
**Hospital Dashboard**
**Tech Stack Overview**
---
## ⚙️ Tech Stack
| Layer | Technology |
|------------------|-----------------------------|
| **Blockchain** | Aptos (Rust-based) |
| **Smart Contracts** | Move Programming Language |
| **Backend/API** | Python (Quart Framework) |
| **Blockchain SDK** | aptos-sdk for Python |
| **Frontend** | ReactJS |
| **Data Storage** | RedisDB (Key-Value Store) |
---
## 🚀 Getting Started
### Clone the Repository
```bash
git clone https://github.com/jAnubhav/Medicords
cd Medicords
```
### Backend Setup
📁 All backend-related files including smart contracts are in the backend/ directory.
Before running any Python commands, always navigate to the backend folder:
```bash
cd backend
```
a. Install Python Dependencies
```bash
pip install -r requirements.txt
```
> 🧰 **Included in `requirements.txt`:**
>
> - `aptos-sdk` – Interact with the Aptos blockchain
> - `quart` – Async Python web framework
> - `quart-cors` – CORS support for Quart
> - `redis` – Communication with RedisDB
> - `bcrypt` – Secure password hashing
> - `pyjwt` – JSON Web Token handling
b. Create Configuration File
In the backend folder, create a file named private_data.py:
```python
key = "Your Aptos Private Key"
secret_key = "Your Secret Key"
host = "Your Redis Host"
port = 6379 # Replace with your Redis port
password = "Your Redis Password"
```
c. Pre-Warm Aptos Accounts (Run Once)
a. Open controller.py:
1. Comment line 108
2. Uncomment line 106
Then run:
```bash
python controller.py
```
Once completed, revert the changes in controller.py and run again:
```bash
python controller.py
```
This process pre-creates Aptos accounts and stores them in Redis for faster user onboarding.
d. Start Backend Server
```bash
py main.py
```
💻 Frontend Setup
```bash
cd frontend
npm install
npm start
```
This launches the ReactJS app that interacts with the Quart backend.
📂 Folder Structure
```bash
Medicords/
├── backend/
│ ├── contracts/ # Move smart contracts
│ ├── controller.py # Account management service
│ ├── main.py # Quart backend entrypoint
│ ├── private_data.py # Local secrets (not versioned)
│ └── ...
├── frontend/ # React frontend
└── sample/ # Dashboard & tech stack images
```
📌 Notes
1. Ensure your Aptos wallet is funded and configured for the desired network (devnet/testnet).
2. Keep private_data.py secure and out of version control.
3. Smart contracts are written in Move and located under backend/contracts/.
🤝 Contributing
Pull requests and feature contributions are welcome. Please open an issue first to discuss major changes.