nk-xrm

The Massively Modified, Massively Modern Solution for Node.js which enables the collection and customization of desired components via a native extension system in order to create an original (X)Cross-Relational Management System. Users can create a CMS, a CRM, or any other application they can imagine by browsing available plug-ins or creating their own.

Installing nk-xrm via the npmjs.org Install Package

NOTES

• The package - available on npmjs.org - is an installer package; It fetches a source archive from Github.com and decompresses it to the application root - or the directory containing the node-modules directory.

To get started, run the following via terminal/command prompt:

chosen_application_root/> npm install nk-xrm

• --remote_url to override the github.com repository
  i.e. npm install nk-xrm --remote_url="https://github.com/mmod/archive"

• --remote_branch to override the github.com branch
  i.e. npm install nk-xrm --remote_branch="master"

• --archive_name to override the archive's local name
  i.e. npm install nk-xrm --archive_name="nk-xrm-latest"

• --archive_extension to override the archive's extension
  i.e. npmn install nk-xrm --archive_extension=".tar.gz"

• --archive_destination to override the archive's local destination
  i.e. npm install nk-xrm --archive_destination="./"

• --package_destination to override the xrm's desination
  i.e. npm install nk-xrm --package_destination="<(module_root_dir)/../../"

• --ignorable_files to override the list of files to ignore in the source tarball
  i.e. npm install nk-xrm --ignorable_files=['.project', '.gitignore']

We anticipate that the most used override should be --remote_branch. This allows the end user to choose between stable and unstable variants of the xrm package. The examples listed above represent the default values currently set in the installer's source.

If you find yourself having issues with the installer, or simply prefer to do things the old-fashioned way:

chosen_application_root/> git clone https://github.com/mmod/nk-xrm

When finished getting and/or installing nk-xrm, we need to install its dependencies. Before we do that we need to make sure we have some prerequisites in place for the data-tools to install correctly. Whether you wish to build or not build the data-tools, the nodakwaeri wiki @ Github will guide you through ensuring you meet any and all requirements. Once you've gone through the respective documentation, return here in order to complete installation and configuration.

What we need to do now, is to install the dependencies for nk-xrm. Assuming we've ensured we have all prerequisites completed and verified:

chosen_application_root/> npm install .

...will do the trick.

Seed the Database

In the root of your nk-xrm application, you'll find a directory named install containing a file named seed.sql. If you open the file you will see in 2 places exists the string: <REPLACEWITHYOURPASSWORDHASH>. You will need to replace these with - you guessed it - a hashed password.

In order to do this, create a file whatever.js in the root of your application, and add the following code to it (replacing <YourPasswordHere> and <YourSecretHere>) with your actual password and secret, respectively:

var nk = require( 'nk' ),
    nk = new nk(),
    pass = "<YourPasswordHere>",
    secret = "<YourSecretHere>";
    
console.log( nk.hash( { data: pass, salt: key } );

Save the file and execute it using node.js:

chosen_application_root/>node whatever.js

Take the hashed password printed on your console window/terminal as a result of the invoked console.log() method(wherever it came from), and add it to the seed.sql file - replacing the existing <REPLACEWITHYOURPASSWORDHASH> values where they are. Update other fields as desired as well.

Run/Execute the contents of the seed.sql file either in MySQL Workbench, or via your favorite means (in the future nk-mysql will have additional tools which will provide features similar to Microsoft's Migrations, but until then...). You will also want to browse path_to_application/app/models/account and path_to_application/adm/models/account, to update the login members with the proper salt/secret and/or expand upon the authentication system making it more secure and to your liking.

To finish configuring your application, open the config.js file in the root of the nk-xrm application. In this file, notice the url and server members of both the development and production configuration schemas; You probably need to update at least one of them, as well as any mail config (though we can't use it yet, it's there to remind us to build that in!). If you're developing locally and not using a host entry (meaning you're typing localhost into your browser), then the URL should be http://localhost:XXXX 'lest you want problems.

The only other changes you may need to make, are in the database sections of the configuration file.

You're all configured now, moving on.

To use the nk-xrm application:

chosen_application_root/>set NODE_ENV=development
chosen_application_root/>node index.js

or if you are starting the admin application:

chosen_application_root/>set NODE_ENV=development
chosen_application_root/>node index.js admin

chosen_application_root/>NODE_ENV=development node index.js

or if you are starting the admin application:

chosen_application_root/>NODE_ENV=development node index.js admin

To get a feel for the XRM and the design of the nk framework, dig through the adm and app folders. Take note of how the controllers, models, and views are structured and where they are located. This will help you explore and learn about developing with nk.

• An example of a website based interface is viewable from the root URL of the xrm application when it is running.
• An example of a web application 'dash' is available by visiting <base_url>/dash.

NOTE: The extension system is NOT fully implemented, what is present is only a conceptual skeleton for implementation.

The advanced cryptography methods were stripped from this source, so you will want to modify chosen_application_root/app/models/account and chosen_application_root/adm/models/account and update the login members so that they implement a more secure authentication system.

This is a new repository and we have a lot going on. Please bear with us as we update sources and documentation.

Like any MVC Framework, it's up to the developers to supply the Controllers, Models, and Views which make up the application.

Controllers are where we set/get session variables, they're where we invoke data queries, and they are where we place most application or business logic specific to our application.

Properties of a controller object are considered the different actions the controller provides to the application; simply adding a new action to an existing controller will yield a new usable URL: <base_url>/<controller>/<action>. Adding Post to the end of a controller action name will let the framework know that it should be called when a POST is made upon that URL.

Take a look at chosen_application_root/app/controllers/account.js to see some examples.

NOTE: Currently there are no examples for API transactions, however -> responding to API requests will take place directly in the controller. Example coming soon.

Models are where we define data queries, and data properties.

Members of a model file's object are considered models; You could essentially have numerous related models within a single model file. From within a model, we are able to access the database object, and are typically fed a callback to make data processing implicitly asynchronous.

Take a look at chosen_application_root/app/models/account.js to see an example.

Views are where we define what the end user is going to see when the response is set (and we are returning a content type of text/html). This involves preparation of a layout as well as content for the layout.

Each directory under chosen_application_root/app/views (aside from shared), denotes a set of views for each controller's various actions. The shared directory under chosen_application_root/app/views allows developers to create layouts or templates which are available to the entire application.

Take a look at the various files within the chosen_application_root/app/views/ directory to see some examples.

More documentation to come.

Feel free to fork the repository and submit pull requests. Browse any of our other repositories as well MMOD @ Github.

Documentation for getting the development environment setup is coming soon.

You may also contribute by making a donation

Eclipse Luna

Nodeclipse (Eclipse Marketplace, site)

Node.js