ITE Portal Workspace

This workspace contains multiple applications built using Nx, a smart, fast, and extensible build system.

Applications Overview

This workspace contains the following applications:

ITE Portal

The main portal application for the Integrated Tax and Eligibility system.

• Location: /apps/ite-portal
• Documentation: See ITE Portal README for detailed information

Provider Gateway

An application for healthcare providers to interact with the system.

• Location: /apps/provider-gateway
• Documentation: See Provider Gateway README for detailed information

B2C Application

A business-to-consumer application.

• Location: /apps/b2c
• Purpose: Provides services directly to consumers

Pre-requisites

• Node.js (v20+)
• Docker is required for local UI development

Quick Start & Documentation

1. Clone this repo ITE-Portal

2. Clone the following repos into the same parent directory:

   • ITE Portal API
   • Provider Gateway API

   Use the default folder names when cloning (e.g. ite_portal_api)

3. Your directory structure should look like this:

   .
   ├── ite-portal
   ├── ite_portal_api
   └── provider-gateway-api

4. Install dependencies from the root of the ite-portal directory:

   npm install

Environment Variables Setup

This project uses environment variables for configuration. To set up your environment:

1. Copy the example environment files for each application:

   # For ITE Portal
   cp apps/ite-portal/.env.example apps/ite-portal/.env
   
   # For Provider Gateway
   cp apps/provider-gateway/.env.example apps/provider-gateway/.env

2. Edit the .env files with your actual configuration values.

3. These files are automatically excluded from Git to keep sensitive information secure.

4. The environment variables are loaded automatically with the @ngx-env/builder package.

All environment variables with the NX_ prefix will be available in your application code.

Starting the APIs

Both ITE Portal and Provider Gateway require local instances of their respective APIs. To start the APIs, run:

npm run start:api

Starting the Applications

ITE Portal

npx nx serve ite-portal

The application will be available at http://localhost:4200 by default.

Provider Gateway

npx nx serve provider-gateway

The application will be available at http://localhost:4201 by default.

B2C Application

npx nx serve b2c

The application will be available at http://localhost:4202 by default.

Running End-to-End Tests

Each application has its own E2E test suite:

# ITE Portal E2E tests
npx nx e2e ite-portal-e2e

# Provider Gateway E2E tests
npx nx e2e provider-gateway-e2e

# B2C E2E tests
npx nx e2e b2c-e2e

Project Structure

• /apps - Contains all frontend applications
• /libs - Contains shared libraries used across applications, organized by domain and feature:
  • /libs/ite-portal - Feature libraries for the ITE Portal (e.g., clients, claims, users, executive, data-governance, search-dashboard, user-profile, external-resources)
  • /libs/provider-gateway - Feature libraries for the Provider Gateway (e.g., submit-new-bhsd, user-profile, provider-profile, landing-page, submission features)
  • /libs/ui - Shared UI components (e.g., charts, spinners, breadcrumbs)
  • /libs/api - Shared API configuration and utilities
  • /libs/models - Shared TypeScript models
  • /libs/styles - Shared styling and theming
  • /libs/assets - Shared static assets (e.g., images, PDFs)

Initial Local API Setup

See the project dev lead to set up your local environment for API access.

Learn About Nx

For more information about Nx, visit the Nx Documentation.

ITE Portal

This repository contains the ITE Portal application, a comprehensive healthcare data management system.

Features

Text Search Functionality

The submission history page includes a File Name Search feature that allows users to search for submissions by file name. This search:

• Searches file names only: The search looks for the entered text within file names of submissions
• Uses partial matching: Enter any part of a file name to find matching submissions
• Case-insensitive: The search is not case-sensitive
• Real-time results: Results update as you type and press Enter or click Search
• Clear search: Use the Clear button to remove the search and show all submissions

How to Use

1. Enter text in the search field (e.g., "pass", "fail", "2024")
2. Press Enter or click the Search button
3. Results will show submissions with file names containing your search term
4. Use the Clear button to remove the search filter

Note: This search only looks at file names. Provider names are displayed in the results but cannot be searched due to database schema constraints.

Development