/hmda-platform-ui

Front-end for https://github.com/cfpb/hmda-platform

Primary LanguageJavaScriptCreative Commons Zero v1.0 UniversalCC0-1.0

Build Status

HMDA Platform UI

This project is a work in progress.

Information and code contained in this repository should be considered provisional and a work in progress, and not the final implementation for the HMDA Platform UI, unless otherwise indicated.

Introduction to HMDA

For more information on HMDA, checkout the About HMDA page on the CFPB website.

The Platform UI

This repo contains the code for the entirety of the HMDA platform front-end, working directly with the HMDA platform back-end and the HMDA platform authentication. The various parts of the platform UI are:

All pages, expect the home page, require authentication.

  • / - home page
    • provides general information about the HMDA filing process and requirements
  • /institutions - institutions listing
    • displays all institutions for which a filer has access to file
  • /<institutionId>/<filingPeriod>/upload - file upload form for a specific institution and filing period
  • /<institutionId>/<filingPeriod>/syntacticalvalidity - displays the list of all syntactical and validity edits the exist in the uploaded file
  • /<institutionId>/<filingPeriod>/quality - displays the list of all quality edits the exist in the uploaded file and allows for verification
  • /<institutionId>/<filingPeriod>/macro - displays the list of all macro edits the exist in the uploaded file and allows for verification
  • /<institutionId>/<filingPeriod>/summary - displays the Institution Register Summary (IRS), the validation summary (an overall summary of the submission), and allows for signing of the submission.

Dependencies

We use npm and yarn to manage front-end dependencies. You should have npm installed as well as yarn.

See the package.json file for application dependencies.

Installation

$ git clone git@github.com:cfpb/hmda-platform-ui.git
$ cd hmda-platform-ui
$ yarn

Building and viewing

Using the back-end API

Viewing the full application requires the back-end API and authentication. Please follow the instructions found under the "Building and Running" heading of the HMDA platform README.

How to test the front-end

$ npm test

Known issues

This repo is a work in progress.

Getting help

If you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.

Getting involved

CONTRIBUTING

Open source licensing info

  1. TERMS
  2. LICENSE
  3. CFPB Source Code Policy

Credits and references

  1. Projects that inspired you
  1. Related projects