Giter Club home page Giter Club logo

mamori-i-japan-api's Introduction

mamori-i-japan-api

Build Status Version License

REST API Server for Japanese Exposure Notification App to fight against COVID-19 a.k.a. "まもりあいJapan".

Architecture

Overview and Data Flow Diagram

Overview

Data Flow Diagram

The images made by Miro (read only access).

Technology Stack

Application

Hosting

Amazon Web Services

  • Amazon Route 53
  • Amazon API Gateway
  • AWS Lambda
  • AWS Systems Manager
  • Serverless Framework (to manage and deploy)

Firebase

  • Firebase Authentication
  • Cloud Firestore
  • Cloud Storage

Getting Started

Installation

npm install

Running the Application on Local

Make sure you add the env vars in .env file. Just copy the .env.template file.

And then execute:

# development mode
npm run start

# watch mode
npm run start:dev

# serverless offline mode
npm run sls-offline

# production mode
npm run start:prod

Testing

# unit tests
npm run test

# end-to-end tests
npm run test:e2e

# get the test coverage
npm run test:cov

Deployment

# deploy to DEV environment
npm run deploy:dev

Development

Project Layout (Brief Explaination)

.
├── .env (Make sure to create this file locally and fill the env vars)
├── src
│   ├── main.ts (This entry point is used for local server)
│   ├── lambda-main.ts (This entry point is used for lambda server)
│   ├── auth (module)
│   │   ├── guards
│   │   └── strategies (Implementation of Firebase Auth access token check)
│   └── users (module)
│       ├── users.service.ts (Services can call other services and their own repository)
│       └── user.repository.ts (Repositroy should be called only by its parent service)

As mentioned briefly in the project layout for users, to keep layout clean, we follow this convention:

  1. Controllers: HTTP routes map to handler functions in controllers.
  2. Services: Controllers call their service function.
    A) A user controller must call only a user service, and not any other service if it can be avoided.
    B) A user service can call other services like cats service, etc.
    C) A user service must call only a user repository, and not any other repository if it can be avoided. If a user service wants to modify data in cats repository, it must call corresponding cats service funtion to do it.
  3. Repositories: Repositories have data layer implementation, ex: Firestore in this project. They must be called only by their direct parent service, ex: A user repository is called by a user service.

Demo

Testing Report

Contact

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/mamori-i-japan/mamori-i-japan-api. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Contributors

Code of Conduct

Everyone interacting in the mamori-i-japan-api project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

License

The app is available as open source under the terms of the 2-Clause BSD License.

mamori-i-japan-api's People

Contributors

daisukehirata avatar shogo-mitomo avatar yashmurty avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.