An open API service indexing awesome lists of open source software.

https://github.com/ideacrew/ite-portal


https://github.com/ideacrew/ite-portal

angular

Last synced: 5 months ago
JSON representation

Awesome Lists containing this project

README

          

# ITE Portal Workspace

This workspace contains multiple applications built using [Nx](https://nx.dev), 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](/apps/ite-portal/README.md) for detailed information

### Provider Gateway

An application for healthcare providers to interact with the system.

- **Location**: `/apps/provider-gateway`
- **Documentation**: See [Provider Gateway README](/apps/provider-gateway/README.md) for detailed information

### B2C Application

A business-to-consumer application.

- **Location**: `/apps/b2c`
- **Purpose**: Provides services directly to consumers

## Pre-requisites

- [Node.js](https://nodejs.org/en/) (v20+)
- [Docker](https://docs.docker.com/desktop/install/mac-install/) is required for local UI development

## Quick Start & Documentation

1. Clone this repo [ITE-Portal](https://github.com/ideacrew/ite-portal)

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

- [ITE Portal API](https://github.com/ideacrew/ite_portal_api)
- [Provider Gateway API](https://github.com/ideacrew/provider-gateway-api)

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

3. Your directory structure should look like this:

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

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

```bash
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:

```bash
# 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:

```bash
npm run start:api
```

## Starting the Applications

### ITE Portal

```bash
npx nx serve ite-portal
```

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

### Provider Gateway

```bash
npx nx serve provider-gateway
```

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

### B2C Application

```bash
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:

```bash
# 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](https://nx.dev/angular).

# 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