X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=README.md;h=a2117a075a2546c50bd22f994910fdae168dad98;hb=d477b85279831f43f77d10acfc1912da1fbe6007;hp=9f1db339f58ddd6615d8f1452170b5cb13392e92;hpb=3b7a5ed3ebdf3bb5a6211c88099fa8dd1a0552c6;p=osm%2FNG-UI.git diff --git a/README.md b/README.md index 9f1db33..a2117a0 100644 --- a/README.md +++ b/README.md @@ -1,68 +1,124 @@ -# Project Title -One Paragraph of project description goes here +## Angular Based OSM NG UI +This project focuses on the implementation of a web GUI to interact with the Northbound API of OSM. + +The project is based on ([Angular](https://angular.io/)), a One framework for Mobile & desktop, app-design framework and development platform for creating efficient and sophisticated single-page web apps. + +## Table of Contents + +* [Community](#community) +* [Getting Started](#getting-started) +* [Prerequisites](#prerequisites) +* [Installation](#installation) +* [Running the application](#running-the-application) +* [Check the lint](#check-the-lint) +* [Supported Browsers](#supported-browsers) +* [Deployment](#deployment) +* [Built With](#built-with) +* [Contributing](#contributing) +* [Versioning](#versioning) +* [License](#license) + +## Community + +Contact [kumaran.m@tataelxsi.co.in](mailto:kumaran.m@tataelxsi.co.in), [rajesh.s@tataelxsi.co.in](mailto:rajesh.s@tataelxsi.co.in), [barath.r@tataelxsi.co.in](mailto:barath.r@tataelxsi.co.in) for architecture and design discussions, requests for help, features request and bug reports on NG UI. ## Getting Started -These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system. +Following instructions in the sections below will get you a copy of the project up and running on your local machine for development and testing purposes. See Deployment section for notes on how to deploy the project on a live system. ### Prerequisites -What things you need to install the software and how to install them +Angular Setup, Install, & Build Guide -``` -Give examples -``` +1. Install Node.js from [here](https://nodejs.org/en/download/) +To check if nodejs is installed on your system, type below command. This will help you see the version of nodejs currently installed on your system. +`node -version` +After downloading Node.js, the node package manager (npm) should automatically be installed. Test it out by doing: +`npm --version` +2. Install Angluar CLI. [More details](https://cli.angular.io/) Angular can be installed Globally (or) Locally, +Install Globally +`npm install -g @angular/cli` +Install Locally +`npm install @angular/cli` +After installation done you can check the version using below command. It will display version details of angular-cli +`ng version` -### Installing +We are done with the installation of Angular -A step by step series of examples that tell you how to get a development env running +### Installation -Say what the step will be +Clone the NG UI from the repository -``` -Give the example -``` +`git clone "https://osm.etsi.org/gerrit/osm/NG-UI"` -And repeat +Install the packages -``` -until finished -``` +`cd NG-UI` -End with an example of getting some data out of the system or using it for a little demo +`npm install` -## Running the tests +### Running the application -Explain how to run the automated tests for this system +The following instructions is for running NG UI locally for development purpose, +On the folder project + +Open `proxy.conf.json` + +Add the below code +```typescript +{ + "/osm/*": { + "target": "https://OSM-NBI-IP:9999", + "secure": false, + "logLevel": "info" + } +} ``` -Give an example -``` +To run the application give the below command + +`npm run proxy` +- To Run the NG-UI page Navigate to + +## Check the lint + +To check the typescript lint run the below command + +`npm run lint` + +## Supported Browsers + +- Edge (42.17134.1098.0) and IE 11 (Windows) +- Firefox (75.0)(Ubunutu) +- Firefox (75.0)(Windows) +- Chrome (81.0.4044.92) (Ubunutu) +- Chrome (81.0.4044.122) (Windows) ## Deployment -Add additional notes about how to deploy this on a live system +To deploy the NG UI use the [Dockerfile](Dockerfile) ## Built With -* [Python](www.python.org/) - The language used +* [Angular Frame work](https://angular.io/) - The languages used are Javascript, Typescript, HTML, and SCSS ## Contributing @@ -75,4 +131,3 @@ We use [SemVer](http://semver.org/) for versioning. For the versions available, ## License This project is licensed under the Apache2 License - see the [LICENSE.md](LICENSE) file for details -