npm package: 10tcl
Description: CRUD over express and mongodb
Author: Fernando Becker
Latest version: 0.0.10
Deprecated: bad ideas, bad implementation, shutting this down, starting a new one

## What is it?

10tcl is a CRUD plugin that will add default routes to your express app, that read and store data in your mongodb.

## How is it?

It works! ...mostly.
Right now I could not recommend it. Give it a few months before serious usage.
It has some limitations and misconceptions, and it is not getting better soon.

## Install

    $ npm install 10tcl

## Config

A config file must contain:
    
    module.exports = {
        // used as title for your pages
        brand: 'Day of the Tentacle IS HERE!',
        // used to assemble the connection string to your mongodb instance
        db: { 
            usr: 'Purple',
            pwd: 'Tentacle',
            srv: 'ds044356.mongolab.com:49842',
            db:  'day_of_the_tentacle',
            par: 'auto_reconnect'
        },
        // static admin user to allow first login
        admin: { usr: 'admin', pwd: 'ElGranSecreto', name: 'Admin', role: 'admin'}
        // __dirname of your root
        root: root, 
        // if not informed it defaults to 'root/models', 'root/controllers' and 'root/views'
        pathToCtrls: '/app/controllers',
        pathToModels: '/app/models',
        pathToViews: '/app/views',
        pathToValidator: 'app/models/validator'
    }
    
## Use

    // __dirname will be the root to locate folders indicated in pathTo... properties
    var app = require('10tcl').attack(__dirname, '/config/yourConfigFile')
    app.listen(yourPortHere)

10tcl attack results in an express app configured with routes based on your models and controllers.

### Database

app.db contains a connection to your database.
It was done by using Mongoskin and the credentials on the config object.

### Controllers

Every .js file under your controllers folder was required, receiving (app, base, config).

An example of controller file would be:

    module.exports = function(app, base, config){

        function hello(req, res){
            res.send('hello world')
        }

        app.get('/hello', base.auth, hello )

        // will be used to create a menu
        return {name: 'hello', label: 'Hello World'}

    }

### Models

Every .js file under your models folder was required as well, no arguments.
Each binded to app.db by the model.name property, so now app.db[modelNameHere] points to a collection capable of restfull crud.

An example of model would be:

    module.exports = {
        // model and db collection name
        name: 'victims',
        // Title for pages and menu
        label: 'Victims',
        // used with mustache to format list and drop down descriptions 
        format: 'Victim {{name}} {{lastName}}',
        // fields to format and forms (see next topic)
        fields: [
            { name: 'name', label: 'Nome', type: 'string', checks: ['hasValue'] },
            { name: 'lastName', label: 'Sobrenome', type: 'string' }
        ],
        // create route '<your-site>.com/victims' pointing to 10tcl CRUD
        routeTo10tcl: true,
        // read the entire collection into the app, changes it before persisting
        keepInCache: true,
        // restrict access to users with one of these roles
        onlyFor: ['admin'],
        // used if you run 'node myApp.js mock'
        mock: [
            {name: 'Mussum', _id: '508e0077d42bd6182f000001'},
            {name: 'Zacarias', _id: '508e0077d42bd6182f000002'},
            {name: 'Dedé', lastname: 'Santana', _id: '508e0077d42bd6182f000003'},
            {name: 'Didi', lastname: 'Mocó', _id: '508e0077d42bd6182f000004'}
        ]
    }

### Field types

10tcl understands: string, number, email, tel, date, html, text, reference (type: 'reference', to: 'criminal')
Each will result in a different html element and layout.
A field type different from the above will result in a regular input field.

### Validation

10tcl modelValidator provides type associated checks, that are automatically executed on POST/PUT transactions.
Other than that, a field can contain a property checks: ['hasValue', ...]
Each string in checks array will trigger the correspondent function of the modelValidator.
Defining pathToValidator, you can implement your own validator that will be required instead of the 10tcl one.

### Users

User and Profile are pre-loaded models that provide access control.
The config property "admin" provides a proto user for the first login.

### i18n

Nop... sorry.
And I'm outputting static texts in PT-BR.
Not happy with any package I've tried.
Want to keep texts in a cached db for online editing and translation.

### CRUD

The views are made with bootstrap, jquery, and some home-made binding (Angular was just making me angry).
In mobile they are much simpler, made with jquerymobile and jquery.
The decision between mobile and desktop is made by reading request headers.