Update A1 mediator API to version 0.10.0
[portal/ric-dashboard.git] / README.md
index 3e26e99..e70617f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,29 +1,39 @@
 # O-RAN-SC RIC Dashboard Web Application
 
-This webapp is built with Angular 7 and Spring-Boot 2.
+The O-RAN SC RIC Dashboard provides administrative and operator functions
+for a disaggregated radio access network (RAN) controller.
+The web app is built as a single-page app using an Angular 8 front end
+and a Spring-Boot 2 back end.
 
-## Getting started
+## Deployment configuration
 
-### Check prerequisites
+The application expects the following configuration files,
+usually mounted as files from Kubernetes configuration maps:
 
-1. Java development kit (JDK), version 1.8 or later
-2. Maven dependency-management tool, version 3.4 or later
-  
-### Build and launch the web app
+    application.properties (in launch directory)
+    key.properties (on classpath)
+    portal.properties (on classpath)
+
+Sample files are in directory src/main/resources and src/test/resources.
+
+## Development guide
 
-    mvn -Ddocker.skip=true clean install
-    cd webapp-backend
-    mvn spring-boot:run
+This section gives a quickstart guide for developers.
 
-Then open a browser on http://localhost:8080
+### Prerequisites
 
-In addition to the above, you can run the Angular server 
-for debugging the frontend and backend separately:
+1. Java development kit (JDK), version 11 or later
+2. Maven dependency-management tool, version 3.4 or later
+
+### Build and launch the web app
 
-    cd webapp-frontend
-    ./ng serve --proxy-config proxy.conf.json
+Instructions for launching a backend Sprint-Boot server
+are available in the webapp-backend README file.
+After launching, open a browser on http://localhost:8080
 
-Then open a browser on http://localhost:4200
+Instructions for launching a frontend Angular server (only for development)
+are available in the webapp-frontend README file.
+After launching, open a browser on http://localhost:4200
 
 ## License