Need help with mamori-i-japan-api?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

155 Stars 14 Forks BSD 2-Clause "Simplified" License 611 Commits 7 Opened issues


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

Services available


Need anything else?

Contributors list


Build Status Version License

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

Table of Contents

  1. Architecture
  2. Technology Stack
  3. Getting Started
  4. Development Guideline
  5. Demo
  6. Test Reports
  7. Contact
  8. Contributing
  9. Code of Conduct
  10. License


Overview and Data Flow Diagram


Data Flow Diagram

The images made by Miro (read only access).

Technology Stack



Amazon Web Services

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


  • Firebase Authentication
  • Cloud Firestore
  • Cloud Storage

Getting Started


npm install

Running the Application on Local

Make sure you add the env vars in

file. Just copy the
# Used by serverless framework to deploy to AWS Lambda.

Used by Firebase Admin SDK. Obtained via serviceAccount.json file in Firebase Console.

FIREBASE_type FIREBASE_project_id FIREBASE_private_key_id FIREBASE_private_key FIREBASE_client_email FIREBASE_client_id FIREBASE_auth_uri FIREBASE_token_uri FIREBASE_auth_provider_x509_cert_url FIREBASE_client_x509_cert_url

Used for getting Firebase Token via Custom token in e2e tests. Obtained in Firebase Console.


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


# unit tests
npm run test

end-to-end tests

npm run test:e2e

get the test coverage

npm run test:cov


# deploy to DEV environment
npm run deploy:dev

Development Guideline

Project Layout (Brief Explanation)

├── .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.controller.ts (Controllers call their services)
│   │   ├── users.service.ts (Services can call other services and their own repository)
│   │   └── user.repository.ts (Repository should be called only by its parent service)
│   └── shared (module with shared business logic)
├── test (Contains the end-to-end (e2e) tests)
├── fdt-generator-webapp (Optional web app to generate firebase access tokens for testing)
└── serverless.yml (Serverless framework config file for infrastructure deployment)

As mentioned briefly in the project layout for

, 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:
    in this project. They must be called only by their direct parent service, ex: A
    user repository
    is called by a
    user service


  • Swagger UI:

Test Reports



Bug reports and pull requests are welcome on GitHub at 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.


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.


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

External links/posts

Links to some external articles and blog posts that talk about the backend in more detail.

In Japanese language (日本語で):

In English:

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.