NsPortal

Features

Installation

Requirements

• Node.js (for npm)
• bower npm install -g bower
• python3.4 (for Windows you can install miniconda3.4)

Verify that node is in your PATH

Installation Process

Front

• npm install
• bower install
• npm install grunt
• npm install -g grunt-cli

optional but recommended :

• grunt build

Back

Install those packages with pip or conda :

• pyodbc (for SQL Server database) or psycopg2 (for PostrgreSQL database)
• sqlalchemy
• pyjwt

#####Config File

Run the setup install :

• python setup.py install

Technolgies && Usage

Front

npm bower

• Grunt : grunt build build the code :
  1. compile less files to app/styles/main.css (+ map file in dev mode)
  2. build html files with JST (app/build/templates.js)
  3. build js files : requirejs optimisation, minify and uglify (app/buil/prod.js)

• grunt release : launch grunt build then change entry file in the index for production mode (prod.js)

• grunt dev : launch grunt build then change entry file in the index for development mode

RequireJS Backbone Underscore MarionetteJs

• Rename the config.js.default to config.js then add your specifications (url of the REST server)
• If you setted a reverse proxy, don't forget to include "/portal-core/" in your URL-Rewrite part (example: http://127.0.0.1:6544/portal-core/{R:1})
• Don't forget to remove "bin" folders from hidden segments on IIS (Filtering demands -> Hidden sengments)

Back

Pyramid SQLAlchemy

You have to configure the development.ini which can be found in the Back folder. You have to enter the siteName parameter which the site name of the local site (### Site name). Run pserve development.ini command in order to launch a Pyramid server.

If pserve fails because it doesn't find the development.ini file, try a python setup.py develop to avoid targeting the wrong egg.

If you want to avoid Numpy errors fired when launching the server, make sure you have no lib referencing it then restart the whole installation thing.

Database configuaration

Quality && Test

Style Guide

Test

Workflow && Contribution

Natural Solutions (NS) is based upon the collaborative development process of Git/GitHub.

If you want to contribute on this project, please create a new pull request :

1. Fork the repository into your own GitHub repository in order to work on this one,
2. Then create a new branch first,
3. Finally, send a pull request to the main repository when the task is ready for review.
4. When the pull request received at least one validation comment from an owner member of the repository, it will be merge to this one.

Thank you!

Demo

Commercial Support

We have programs for companies that require additional level of assistance through training or commercial support, need special licensing or want additional levels of capabilities. Please visit the Natural Solutions Website for more information about the portal or contact us by email at [email protected].

License

Copyright (c) 2015 Natural Solutions Licensed under the MIT license.