WolfCare is an online application that manages the health portfolio of the patient and provides doctor’s assistance through an online portal. A virtual doctor appointment booking system overrides the problems of booking an appointment manually. It is convenient, helps in better resource management and aids in syncing of calender schedules. This project provides a platform for the users to create an account, search for doctors at a given location, view the doctor's background and book appointments. Additionally, we have included a symptoms check where users can add theor test report values and view the results of a medical condition.
EnhancedWolfCare.1.mp4
Execution screenshots can be found here
WolfCare targets uses who would like to check the presence of any medical conditions and book an appointment with a doctor.
Note: All the requirements of the project are listed in the requirements.txt file with their required versions. The INSTALL.md guides on how to download the required applications.
-
- npm and node (version 16.X or 16.17.1) should be installed.
- Make sure the database server (mysql) is on. Consider using XAMPP.
- Download Python3.
- pytest for testing the application server.
- Clone the Github repository in your local system.
- This project uses xampp, so make sure to install xampp in your system.
- Run the xampp application, and start the
ApacheandMySQLby clicking on the start button.
-
Backend: flask (2.2.2), flask_cors (3.0.10), json, asyncio, mysql (2.2.9), pytest (7.2.0), pdoc (0.10.0).
Frontend: axios (1.0.0), antd (4.23.4), jsdoc (3.6.11), react-select (5.4.0), react-tag-input (6.8.1), reactstrap (9.1.4), jest.
-
Backend: Documentation
- Create virtual environment
python -m venv <name_of_virtualenv>- Activate Python Virtual environment
<name_of_virtualenv>\Scripts\activate.bat for Windows users. source <name_of_virtualenv>/bin/activate for linux users.- Install dependencies
pip install -r requirements.txt-
Make sure the database is imported from
database/wolfcare.sqlonto the mysql server. -
Run the below command from the main directory to start the backend application server.
python -m src.backend.app- The backend flask application will be up and running at
localhost:5001
Frontend: Documentation
-
After cloning the repository, move to the directory
src\frontendwhere our frontend code is located. -
Install all the dependencies using npm. Command to run:
npm install. This will fetch the dependecies from package.json file, and install them. -
Start the server by using the command
npm start. This will run the server on port3000, and the website can be accessed by going tohttp://localhost:3000/. -
If credentials of a registered user are available, use them, or register a new user and interact with the website.
-
Backend
- Run the below command from the main directory. This should run all the test cases for app.py.
pytestFrontend
-
Move to the directory
src\frontendwhere our frontend tests are located. -
Run the tests using the command
npm test -- --coverage --watchAll=false. This will run all the tests across the frontend code.
-
Try the following troubleshooting steps. If none of them work, contact the repository owner/file an issue.
Backend
- We have added the print statements in all of the backend functions to know execution of the codes.
- In case of error the print statements will let us know about the issue of code break.
- The api responses the status code, valid message and response header which they can share back for troubleshooting.
Frontend
- Since frontend is build using JavaScript, React and Redux, check for console logs under developer tools to identify any failures.
- Consider installing and using React developer tools and Redux developer tools to track the request through the system.
.
├── .github
| ├── ISSUE_TEMPLATE
| | ├── bug_report.md # Template for bug report
| | ├── feature_request.md # Template for feature request
| ├── workflows
| | ├── frontendGitActions.yml # GitActions workflow for frontend
| | ├── backendGitActions.yml # GitActions workflow for frontend
├── .vscode
| ├── extensions.json # Recommended extensions for vscode
| ├── settings.json # Workspace settings for vscode
├── database
| ├── wolfcare.sql # Database for project
├── docs
| ├── Rubrics
| | ├── proj1rubric.md # Project rubric
| ├── backend # Documentation for backend
| ├── frontendDocs/wolfcare/0.1.0 # Documentation for frontend
| ├── README.md # Readme file for docs folder
├── src
| ├── backend
| | ├── __init__.py # Init file for backend
| | ├── app.py # File containing backend APIs
| | ├── dbconfig.py # DB configuration for backend
| | ├── utils.py # Utilities for backend
| ├── frontend
| | ├── public # Folder containing assets and images
| | ├── src
| | | ├── api # Folder containing API calling frontend code
| | | ├── __tests__ # Folder containing unit tests for frontend
| | | ├── app # Folder containing redux store configuration
| | | ├── components # Folder containing frontend react components
| | | ├── containers # Folder containing containers to connect components with redux store
| | | ├── reducers # Folder containing reducers
| | | ├── axiox.js # API client generation
| | | ├── index.css # CSS configuration for frontend
| | | ├── index.js # Entry point for frontend
| | | ├── setupTests.js # Setup jest configuration for unit testing
| | | ├── wolfcare.jsx # Root react component
| | ├── .eslintignore # Ignore configuration for eslint
| | ├── .eslintrc.js # eslint configuration
| | ├── package.json # Package configuration and dependency closure
| ├── README.md # Readme file for src folder
├── test
| ├── README.md # Readme file for test folder
| ├── __init__.py # Init file for test folder
| ├── test_app.py # Tests for backend
├── .gitattributes # File for git attributes
├── .gitignore # File for git ignore
├── CITATION.cff # File for citations
├── CODE_OF_CONDUCT.md # Code of conduct for repository
├── CONTRIBUTING.md # Details about contributing to the repository
├── INSTALL.md # Details about prerequisite installation
├── LICENSE # MIT License details
├── README.md # Readme file for repository
├── requirements.txt # Details of dependency packages
└── setup.py # Setup file for the module
- WolfCare v1.0.0: Initial v0.1 release
- WolfCare v1.0.1: First major release
- EnhancedWolfCare v0.1.0: Initial v0.1 release
- EnhancedWolfCare v1.0.0: First major release
- Roadmap for this project can be found here.
- All the communication was handled through a private chat channel and online meets. Some screenshots of discussions can be found here.
We do our best to answer all tickets in a timely manner, but sometimes we accumulate a backlog and may take awhile to respond. Please be patient—we will get back to you as soon as we can!
Please do contact any of us:
- Akash Gupta(agupta57@ncsu.edu)
- Arun Srinivasan P(apartha4@ncsu.edu)
- Nagaraj Madamshetti(nmadams@ncsu.edu)
- Nitesh Mishra(nmishra4@ncsu.edu)
- Sumit Singh(ssingh57@ncsu.edu)
- We are using MIT license
- Copyright (c) 2022 Group 22
Thanks goes to these wonderful people.
- Thanks goes to the owners of repository SE-Group-25-WolfCare for prompting the idea and laying the groundwork.
- Thanks also goes to Mr. Jugu Dannie Sundar, whose rule builder has helped us significantly in this project.