serenity-discussion-api is a Discussion API Service

The topcoder Discussion API was initially built using the Apigee a127 scaffolding.

Routing is handled by using the swagger config file at api\swagger\swagger.yaml. Routing is done using swagger tools and the a127-magic modules.

Swagger

The documentaiton for the API and resources are in swagger. You can view the swagger config using a127 tools.

Edit swagger config: a127 project edit View

Configuration

Configuration is stored in the /config/*.yaml files. THe node config module is used to load configuration.

Please see the config documentation: https://github.com/lorenwest/node-config/wiki

The "local" config files are all ignored in git.

Configuration:

    app:
        port: 1234 #port to launch
        pg:
            dialect: postgres
            database: serenity_discussions
            username: username
            password: password
            host: host
            port: 5432
        pgURL:

For database connection you can either use the pg object or the pgURL. The pgURL is looked for first and will override the pg.

Models

We are following a similar patterns to access patterns as we do in the serenity-core repo.

Use a model:

Example for Message model

var datasource = require('./datasource');
var Message = datasource.Message;

// Message is now a Sequelize Model

Node.js design guide.

Please follow Joyent's NodeJS design guide: https://www.joyent.com/developers/node/design Please use 2 spaces instead of tabs Please use lodash instead of underscore

Database Migrations

All tables should be setup using db-migrate with migration files in config/schema-migrations

Migration can be run via grunt grunt dbmigrate

Running the server

You can run the server using grunt which will use the local config