https://github.com/kenmwaura1/permit
A Django project for managing a hospital system using Permit.io for authorization. The project includes a RESTful API for managing patients, doctors, and appointments. The API is secured using ABAC (Attribute-Based Access Control) and RBAC (Role-Based Access Control) policies. The project also includes a PDP (Policy Decision Point) microservice
https://github.com/kenmwaura1/permit
django django-rest-framework permit python
Last synced: 2 months ago
JSON representation
A Django project for managing a hospital system using Permit.io for authorization. The project includes a RESTful API for managing patients, doctors, and appointments. The API is secured using ABAC (Attribute-Based Access Control) and RBAC (Role-Based Access Control) policies. The project also includes a PDP (Policy Decision Point) microservice
- Host: GitHub
- URL: https://github.com/kenmwaura1/permit
- Owner: KenMwaura1
- License: mit
- Created: 2024-05-19T16:49:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-23T20:22:27.000Z (3 months ago)
- Last Synced: 2025-08-07T21:07:44.632Z (3 months ago)
- Topics: django, django-rest-framework, permit, python
- Language: Python
- Homepage:
- Size: 72.3 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Hospital System
[](https://opensource.org/licenses/MIT)
## Description
A Django project for managing a hospital system using [Permit.io](https://app.permit.io/) for authorization. The project includes a RESTful API for managing patients, doctors, and appointments. The API is secured using ABAC (Attribute-Based Access Control) and RBAC (Role-Based Access Control) policies. The project also includes a PDP (Policy Decision Point) microservice for evaluating access control policies.
## Features
- ABAC (Attribute-Based Access Control)
- CRUD operations
- RESTful API
- User authentication
- Role-based access control
- ReBAC (Relationship-Based Access Control)
## Installation
1. Clone the repository: `git clone https://github.com/KenMwaura1/permit.git`
2. Cd into the project directory: `cd hsystem`
3. Create a virtual environment
`python3 -m venv venv`
4. Activate virtualenv
`source venv/bin/activate`
For zsh users
`source venv/bin/activate.zsh`
For bash users
`source venv/bin/activate.bash`
For fish users
`source venv/bin/activate.fish`
5. Install the dependencies: `pip install -r requirements.txt`
6. Apply database migrations: `python manage.py migrate` or `python manage.py migrate --run-syncdb` || `python manage.py makemigrations hsystem` || `python manage.py migrate`
7. Start the development server: `python manage.py runserver 5000`
## Run your local PDP Microservice container
If you do not have Docker installed as of yet, click [here](https://docs.docker.com/get-docker/) to install Docker.
### Pull the container
Run the following command to pull the PDP Microservice container:
```bash
docker pull permitio/pdp-v2:latest
```
### Run the container
Remember to replace with the Secret Key you obtained from your dashboard.
```bash
docker run -it -p 7766:7000 --env PDP_DEBUG=True --env PDP_API_KEY= permitio/pdp-v2:latest
```
## Usage
1. Create a superuser: `python manage.py createsuperuser`
2. Access the admin panel: `http://localhost:5000/admin/`
3. Access the API: `http://localhost:5000/api/`
4. Access the documentation: `http://localhost:5000/docs/`
## Test the App
Run the following command in a separate terminal to test whether the app is working as expected:
```bash
curl -X GET http://localhost:5000/patients/1/
```
## Contributing
Contributions are welcome! Please follow the guidelines in [CONTRIBUTING.md](CONTRIBUTING.md).
## License
This project is licensed under the [MIT License](LICENSE).
## Contact
- Author: Kennedy Mwaura
- GitHub: [Your GitHub Profile](https://github.com/KenMwaura1)