https://github.com/eurekaclinical/eurekaclinical-user-webapp
User interface and web client proxy for managing user accounts
https://github.com/eurekaclinical/eurekaclinical-user-webapp
webapp
Last synced: 5 months ago
JSON representation
User interface and web client proxy for managing user accounts
- Host: GitHub
- URL: https://github.com/eurekaclinical/eurekaclinical-user-webapp
- Owner: eurekaclinical
- License: apache-2.0
- Created: 2016-09-19T00:37:21.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2020-12-03T15:16:35.000Z (over 5 years ago)
- Last Synced: 2025-07-12T03:32:47.588Z (12 months ago)
- Topics: webapp
- Language: Java
- Homepage: http://eurekaclinical.org
- Size: 469 KB
- Stars: 0
- Watchers: 4
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Eureka! Clinical User Webapp
[Georgia Clinical and Translational Science Alliance (Georgia CTSA)](http://www.georgiactsa.org), [Emory University](http://www.emory.edu), Atlanta, GA
## What does it do?
It provides web pages for users to manage their user profiles and change their password. It also implements a proxy servlet and router for web clients to access the web services provided by eurekaclinical-user-service.
Latest release: [](https://maven-badges.herokuapp.com/maven-central/org.eurekaclinical/eurekaclinical-user-webapp)
## Version 2.0
Version 2.0 removes all of the servlets and turns this project into an API gateway for the Eureka! Clinical User Web Client.
## Version 1.0
Initial release.
## Build requirements
* [Oracle Java JDK 8](http://www.oracle.com/technetwork/java/javase/overview/index.html)
* [Maven 3.2.5 or greater](https://maven.apache.org)
## Runtime requirements
* [Oracle Java JRE 8](http://www.oracle.com/technetwork/java/javase/overview/index.html)
* [Tomcat 7](https://tomcat.apache.org)
* Also running
* The [eurekaclinical-user-service](https://github.com/eurekaclinical/eurekaclinical-user-service) war
* The [cas-server](https://github.com/eurekaclinical/cas) war
## Proxied REST APIs
You can call all of [eurekaclinical-user-service](https://github.com/eurekaclinical/eurekaclinical-user-service)'s REST APIs through the proxy. Replace `/protected/api` with `/proxy-resource`. The point of doing this is for web clients -- you can deploy the webapp on the same server as web client, and deploy the service on a separate server.
## Building it
The project uses the maven build tool. Typically, you build it by invoking `mvn clean install` at the command line. For simple file changes, not additions or deletions, you can usually use `mvn install`. See https://github.com/eurekaclinical/dev-wiki/wiki/Building-Eureka!-Clinical-projects for more details.
## Performing system tests
You can run this project in an embedded tomcat by executing `mvn process-resources cargo:run -Ptomcat` after you have built it. You can use it in conjunction with running [eurekaclinical-user-webclient](https://github.com/eurekaclinical/eurekaclinical-user-webclient). It will be accessible in your web browser at https://localhost:4200/eurekaclinical-user-webapp/. Your username will be `superuser`.
## Installation
### Configuration
This webapp is configured using a properties file located at `/etc/ec-user/application.properties`. It supports the following properties:
* `eurekaclinical.userwebapp.callbackserver`: https://hostname:port
* `eurekaclinical.userwebapp.url`: https://hostname:port/eurekaclinical-user-webapp
* `eurekaclinical.userservice.url`: https://hostname.of.userservice:port/eurekaclinical-user-service
* `cas.url`: https://hostname.of.casserver:port/cas-server
* `eurekaclinical.userwebapp.demomode`: true or false depending on whether to act like a demonstration; default is false.
* `eurekaclinical.userwebapp.ephiprohibited`: true or false depending on whether to display that managing ePHI is prohibited; default is true.
A Tomcat restart is required to detect any changes to the configuration file.
### WAR installation
1) Stop Tomcat.
2) Remove any old copies of the unpacked war from Tomcat's webapps directory.
3) Copy the warfile into the Tomcat webapps directory, renaming it to remove the version. For example, rename `eurekaclinical-user-webapp-1.0.war` to `eurekaclinical-user-webapp.war`.
4) Start Tomcat.
## Maven dependency
```
org.eurekaclinical
eurekaclinical-user-webapp
version
```
## Developer documentation
* [Javadoc for latest development release](http://javadoc.io/doc/org.eurekaclinical/eurekaclinical-user-webapp) [](http://javadoc.io/doc/org.eurekaclinical/eurekaclinical-user-webapp)
## Getting help
Feel free to contact us at help@eurekaclinical.org.