Skip to content

v1.0.0

Compare
Choose a tag to compare
@reginafcompton reginafcompton released this 02 Jul 19:00
· 41 commits to master since this release

Welcome to the Master Client Index 1.0.0!

The Master Client Index (MCI) provides an API for storing, sharing, and managing clients in a Data Trust ecosystem. Clients include all sorts of people, e.g., individuals who completed a program-intake form, students, patients, etc.

API: Core endpoints

v1.0.0 exposes endpoints that:

  • GET all users (i.e. clients)
  • GET a single user
  • POST to create user(s) and, in doing so, generate an associated unique identifier (MCI ID)
  • POST to remove PII for a user

API: Helper endpoints

v1.0.0 also exposes endpoints that can GET and POST data related to users, including:

  • gender
  • address
  • disposition
  • education_level
  • employment_status
  • ethnicity

In addition, the health endpoint provides a way to check the status of the MCI.

Auth

The MCI wraps endpoints in an auth decorator @token_required(Config.get_oauth2_provider()), which requires the request to include an up-to-date token in the header.

Modularity

The MCI cooperates with two other services: the mci-database and the mci-matching-service. The mci-database contains the data models and migrations for the MCI clients, and the mci-matching-service contains the logic that calculates a match score for POST'd individuals (who may already exist in the MCI database). This isolation of application concerns allows for customization on a per instance basis.