• nodejs https://nodejs.org/en/ (v10)
• DynamoDB
• AWS S3
• Docker, Docker Compose

Configuration for the application is at config/default.js. The following parameters can be set in config files or in env variables:

• LOG_LEVEL: the log level, default is 'debug'
• PORT: the server port, default is 3000
• AUTH_SECRET: The authorization secret used during token verification.
• VALID_ISSUERS: The valid issuer of tokens.
• AUTH0_URL: AUTH0 URL, used to get M2M token
• AUTH0_PROXY_SERVER_URL: AUTH0 proxy server URL, used to get M2M token
• AUTH0_AUDIENCE: AUTH0 audience, used to get M2M token
• TOKEN_CACHE_TIME: AUTH0 token cache time, used to get M2M token
• AUTH0_CLIENT_ID: AUTH0 client id, used to get M2M token
• AUTH0_CLIENT_SECRET: AUTH0 client secret, used to get M2M token
• BUSAPI_URL: Bus API URL
• KAFKA_ERROR_TOPIC: Kafka error topic used by bus API wrapper
• AMAZON.AWS_ACCESS_KEY_ID: The Amazon certificate key to use when connecting. Use local dynamodb you can set fake value
• AMAZON.AWS_SECRET_ACCESS_KEY: The Amazon certificate access key to use when connecting. Use local dynamodb you can set fake value
• AMAZON.AWS_REGION: The Amazon certificate region to use when connecting. Use local dynamodb you can set fake value
• AMAZON.IS_LOCAL_DB: Use Amazon DynamoDB Local or server.
• AMAZON.DYNAMODB_URL: The local url if using Amazon DynamoDB Local
• AMAZON.ATTACHMENT_S3_BUCKET: the AWS S3 bucket to store attachments
• FILE_UPLOAD_SIZE_LIMIT: the file upload size limit in bytes
• CHALLENGES_API_URL: TC challenges API base URL
• GROUPS_API_URL: TC groups API base URL
• COPILOT_RESOURCE_ROLE_IDS: copilot resource role ids allowed to upload attachment
• HEALTH_CHECK_TIMEOUT: health check timeout in milliseconds
• SCOPES: the configurable M2M token scopes, refer config/default.js for more details
• M2M_AUDIT_HANDLE: the audit name used when perform create/update operation using M2M token

Set the following environment variables so that the app can get TC M2M token (use 'set' insted of 'export' for Windows OS):

• export AUTH0_CLIENT_ID=8QovDh27SrDu1XSs68m21A1NBP8isvOt
• export AUTH0_CLIENT_SECRET=3QVxxu20QnagdH-McWhVz0WfsQzA1F8taDdGDI4XphgpEYZPcMTF4lX3aeOIeCzh
• export AUTH0_URL=https://topcoder-dev.auth0.com/oauth/token
• export AUTH0_AUDIENCE=https://m2m.topcoder-dev.com/

Also properly configure AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, ATTACHMENT_S3_BUCKET, IS_LOCAL_DB config parameters.

We can use DynamoDB setup on Docker for testing purpose. Just run docker-compose up in local folder. You can also use your own AWS DynamoDB service for testing purpose.

Go to https://console.aws.amazon.com/ and login. Choose S3 from Service folder and click Create bucket. Following the instruction to create S3 bucket.

For postman verification, please use the mock api under mock-api folder. It provides mock endpoint to fetch challenge resources and groups. Go to mock-api folder and run command npm run start to start the mock-api listening on port 4000

1. Make sure DynamoDB are running as per instructions above.
2. Make sure you have configured all config parameters. Refer Configuration
3. Run npm run create-tables to create tables.

1. Drop/delete tables: npm run drop-tables
2. Creating tables: npm run create-tables
3. Seed/Insert data to tables: npm run seed-tables
4. Initialize database in default environment: npm run init-db
5. View table data in default environment: npm run view-data <ModelName>, ModelName can be Challenge, ChallengeType, ChallengeSetting, AuditLog, Phase, TimelineTemplateor Attachment

• The seed data are located in src/scripts/seed

• Install dependencies npm install
• Run lint npm run lint
• Run lint fix npm run lint:fix
• Create tables npm run create-tables
• Clear and init db npm run init-db
• Start app npm start
• App is running at https://localhost:3000
• Start mock-api, go to mock-api folder and npm start, mock api is running at https://localhost:4000

Refer to the verification document Verification.md

• after uploading attachments, the returned attachment ids should be used to update challenge; finally, attachments have challengeId field linking to their challenge, challenge also have attachments field linking to its attachments, this will speed up challenge CRUDS operations.

• In the app-constants.js Topics field, the used topics are using a test topic, the suggested ones are commented out, because these topics are not created in TC dev Kafka yet.