# ellucian-developer/experience-intelligent-interview-prep architecture

> Architecture diagram of the GitHub repository ellucian-developer/experience-intelligent-interview-prep, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ellucian-developer/experience-intelligent-interview-prep
- Repository: https://github.com/ellucian-developer/experience-intelligent-interview-prep

## Overview

##### Project Type & Purpose
- This is a full-stack integration and workflow automation project that combines Ellucian products (Banner, Ethos, Maestro, Insights) with OpenAI capabilities.
- The solution provides students with a tool to prepare for interviews (including AI-driven interview tips and coaching) while integrating with Banner custom tables and workflow systems for advisor notifications and approval processes.

##### Analyzing the Major Components from the File Structure & README
a. Banner Extensibility
– Files under “banner-extensibility” (e.g., x-iip-result.json) are used for configuring custom tables in Banner via Integration API.
b. Data Connect Pipelines
– The “data-connect” directory holds JSON definitions for various API pipelines (get-student-advisor, get-program, get-generate-company-info, get-generate-interview-tips, post-generate-interview-response, post-iip-results).
– These pipelines serve as the backend connectors between the Extension, Banner custom tables, OpenAI interactions, and Ethos.
c. Extension (Frontend)
– The “extension” directory is a React-based front-end application with cards, pages, hooks, i18n, and utility modules.
– It is used to present the interview preparation experience (launch card, interview pages, chat interface) and triggers pipelines.
d. Intelligent Processes
– Located under “intelligent-processes”, the YAML and JSON files here define workflows, external tasks, and actions (e.g., “Request Intelligent Interview Prep”, “Get Students Advisor”) used by Maestro to drive process automation.
e. Insights
– The “insights” folder includes a CSV dataset that is used for ingestion and visualization of interview prep results, driving the reporting aspect in Insights Administration.
f. Additional Tools and Configurations
– Configuration files such as .eslintrc.json, webpack.config.js, and Babel configuration indicate a modern JavaScript toolchain used in the extension.

## Diagram (Mermaid)

```mermaid
flowchart TD
    EE["Experience Extension (React UI)"]:::frontend
    DCP["Data Connect Pipelines (Orchestrates API Calls)"]:::middleware
    Banner["Banner Integration & Custom Table"]:::backend
    IP["Intelligent Processes (Maestro Workflows, External Tasks, Actions)"]:::workflow
    Insights["Insights (Data Ingestion & Visualization)"]:::analytics
    OpenAI["External Service: OpenAI"]:::external
    Ethos["External Service: Ethos Authentication"]:::external

    EE -->|"API_Call"| DCP
    DCP -->|"Banner_API"| Banner
    DCP -->|"AI_Request"| OpenAI
    DCP -->|"Token_Exchange"| Ethos
    DCP -->|"Workflow_Trigger"| IP
    Banner -->|"Data_Ingestion"| Insights

    click EE "https://github.com/ellucian-developer/experience-intelligent-interview-prep/tree/main/extension/"
    click DCP "https://github.com/ellucian-developer/experience-intelligent-interview-prep/tree/main/data-connect/"
    click Banner "https://github.com/ellucian-developer/experience-intelligent-interview-prep/blob/main/banner-extensibility/x-iip-result.json"
    click IP "https://github.com/ellucian-developer/experience-intelligent-interview-prep/tree/main/intelligent-processes/"
    click Insights "https://github.com/ellucian-developer/experience-intelligent-interview-prep/blob/main/insights/XSIPRES-dataset.csv"

    classDef frontend fill:#AED6F1,stroke:#1F618D,stroke-width:2px;
    classDef middleware fill:#ABEBC6,stroke:#229954,stroke-width:2px;
    classDef backend fill:#FAD7A0,stroke:#D35400,stroke-width:2px;
    classDef workflow fill:#D7BDE2,stroke:#8E44AD,stroke-width:2px;
    classDef analytics fill:#F5B7B1,stroke:#C0392B,stroke-width:2px;
    classDef external fill:#E8DAEF,stroke:#8E44AD,stroke-width:2px;
```
