Circle CI: https://app.circleci.com/pipelines/github/CPSECapstone/feather-femr
fEMR is a fast EMR solution for remote clinics who depend on speed and ease of use rather than complex features. Check out Team fEMR's website for more information and a live demo.
-
Make sure your Java and sbt environment variables are set.
-
Fork the repository to your GitHub account.
-
Clone the repository.
git clone https://github.com/yourusername/femr.git
-
See the wiki page Git Configuration for further information regarding how to contribute to fEMR.
- After downloading MySQL, run the installer to install MySQL.
- Proceed through the installer and make a note of the username and password you set.
- It is recommended to install MySQL Workbench, the official GUI for your MySQL database.
- Run MySQL Workbench and you should see your MySQL database running as localhost. Select your database and create a new schema by clicking one of the icons on the top toolbar. Name it whatever you want, but make note of it for later.
- Navigate to the Session tab in the lower left corner. Take note of your Host and Port. The default should be localhost and 3306.
- Open IntelliJ and close any active projects.
- A project selector window will pop up, click Configure and then Plugins.
- Search for Scala plugin and install.
- Back on the project selector window, click Import Project.
- Navigate to where you cloned fEMR, and click Open.
- Select 'Import project from external model'
- Select 'SBT'
- Click Next
- Ensure the Project SDK is java version 1.8, click Finish.
- Create a file named application.dev.conf in the conf folder, copy and paste the information from application.example.conf in it. Change the db.default fields to match your database address, username, and password that you noted before. Change the same fields in application.conf as well.
Example with database named femr, database located at localhost with port 3306, username and password both root:
db.default.url="jdbc:mysql://127.0.0.1:3306/femr?characterEncoding=UTF-8"
db.default.username="root"
db.default.password=“root”- Quit IntelliJ, navigate to where you cloned fEMR, and run the following command to clean and compile the project. It is normal to have a few errors.
sbt clean compile test- Open up the fEMR project in IntelliJ again. Under Run, select Edit configurations. Create a new sbt Task and name it whatever you want. Under the “Tasks” field, enter the word “run”. Then, under Environment variables, add the following environment variables using your absolute filepath to the file: [config.file // /absolute/location/to/conf/application.dev.conf] [user.dir // /absolute/location/to/femr]
- Run the program from IntelliJ. Open a browser and navigate to localhost:9000. If everything was configured correctly, then you will be greeted with a login screen. Enter admin as the username and password, and you can then create new user credentials to login with.
- Contact [email protected] with any issues configuring IntelliJ.
- It is very important for the administrator to backup local data to the remote database.
- A cronjob can be set up before a kit is deployed to automatically display a message once a week.
- In the command line, type
crontab -e - A text editor should appear.
- Add the following line to this file:
0 11 * * 5 <path to fEMR project home directory>/util/WeeklyReminder.sh - This will display a reminder pop up at 11:00AM every Friday.
- fEMR is not HIPAA compliant (... yet).
- fEMR is not meant to diagnose, treat, cure or prevent disease.
- fEMR may attempt to establish a secure remote connection when internet access becomes available. This behavior is configurable and turned off by default.
Email: [email protected]