# lbenitesanchez/gestion-jurados-proyecto-empresarial_copia architecture

> Architecture diagram of the GitHub repository lbenitesanchez/gestion-jurados-proyecto-empresarial_copia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia
- Repository: https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia

## Overview

1. **Overall shape**
   - This is a **React + TypeScript frontend** built with **Vite**, plus a small **Node/Netlify API layer** for local development and deployment flexibility.
   - The application domain is **jury management for academic projects**: ingest professor preferences, consolidate them, form juries, validate assignments, and generate outputs such as reports and emails.

2. **Two-stage product model**
   - The UI is split into **Stage 1** and **Stage 2**, which appear to represent the main workflow boundaries.
   - **Stage 1** focuses on intake, normalization, and analysis of raw data from Google Forms/Sheets.
   - **Stage 2** focuses on operational management: professor profiles, work management, jury assignment, reporting, and settings.

3. **Presentation layer**
   - `src/App.tsx` and `src/main.tsx` bootstrap the app.
   - `src/components/layout` contains the application shell and navigation (`AppShell`, `Sidebar`), which likely frame all dashboards.
   - `src/components/common` provides reusable UI building blocks such as metric cards, section cards, and status badges.

4. **Stage 1 subsystem: data intake and consolidation**
   - `src/components/stage1` contains the interfaces for the ingestion and analysis flow:
     - `FileUploader` for importing files,
     - `FiltersBar` for narrowing datasets,
     - `SummaryCards` and `ProfessorWorkMatrix` for analytics,
     - `WorkTable` and `WorkDetailPanel` for work-level inspection,
     - `Stage1Dashboard` as the container view.
   - This stage is where raw response data is turned into structured operational information.

5. **Stage 2 subsystem: assignment operations**
   - `src/components/stage2` contains the downstream management workflow:
     - `JuryAssignmentPanel` for forming juries,
     - `ProfessorProfiles` and `WorkManagement` for entity administration,
     - `ReportsView` for output generation,
     - `SettingsView` for operational controls,
     - `HomeDashboard` and `Stage2Dashboard` as top-level views.
   - This stage is where validated assignments are edited, locked, reviewed, and exported.

6. **Domain and processing services**
   - `src/services` is the main application/service boundary and likely contains most non-UI logic.
   - The services split naturally into:
     - **domain logic**: `juryAggregationService`, `juryAssignmentService`, `rulesEngineService`,
     - **data ingestion/parsing**: `fileParserService`,
     - **integration adapters**: `googleSheetsService`, `openaiAgentService`, `emailService`,
     - **delivery/output**: `exportService`,
     - **state/governance**: `storageService`, `auditLogService`.
   - This suggests a clean separation between UI, business rules, and external integrations.

7. **External system integrations**
   - **Google Sheets** is the data source for Google Forms responses and work lists.
   - **OpenAI** is used for assisted jury formation or recommendation support.
   - **Email/SMTP** is used for controlled distribution of notifications, with test-vs-production safeguards.
   - Export/report generation is part of the operational output pipeline.

8. **Data model and shared types**
   - `src/types/domain.ts` defines the core domain entities used across UI and services.
   - `src/utils/text.ts` likely provides normalization or text-cleaning helpers used during parsing and matching.
   - `src/data/mockData.ts` supports local development/demo states when live integrations are unavailable.

9. **Runtime and deployment boundaries**
   - Local development runs the frontend on **Vite** and an API on **Node** (`server/index.mjs`), matching the README ports `5173` and `8787`.
   - There is also a **Netlify Function** entry point at `netlify/functions/api.mjs`, indicating a serverless deployment path for API endpoints.
   - `netlify.toml` and the README indicate the frontend is deployable as static assets, while the API can be hosted either as Netlify Functions or a separate backend.

10. **Configuration and secrets**
   - `.env.example` shows the system depends on runtime secrets for OpenAI, Google Sheets, and SMTP.
   - This means the architecture has a clear split between:
     - **client-visible UI logic**, and
     - **server-side/integration-sensitive operations** that require credentials and controlled sending.
   - The README’s warning about not committing credentials indicates those integrations are operationally important to the system.

11. **Operational flow**
   - The likely end-to-end flow is:
     - ingest responses from Google Sheets or uploaded files,
     - parse and normalize the data,
     - compute summaries and professor-work coverage,
     - generate or refine jury assignments,
     - allow manual correction and locking,
     - store/audit changes,
     - export reports and optionally email results.
   - The architecture is centered on this workflow rather than on generic CRUD.

12. **Documentation and support material**
   - `docs/manual-coordinadora.md` suggests the repo includes user-facing operational guidance, which is important for a workflow-heavy administrative tool.
   - This reinforces that the system is designed for coordinators and staff rather than end students.

13. **How to draw the architecture**
   - A good diagram would show:
     - a **React frontend** with Stage 1 and Stage 2 views,
     - a **shared service layer** for parsing, rules, aggregation, assignment, and integrations,
     - external systems: **Google Sheets**, **OpenAI**, **SMTP/email**, and **file/export output**,
     - a **Node/Netlify API boundary** with local dev and deployable serverless endpoints,
     - and an **audit/storage layer** for traceability and controlled changes.

Main entry points: [`src/components/stage1/Stage1Dashboard.tsx`](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/Stage1Dashboard.tsx) (Stage 1), [`src/components/stage2/Stage2Dashboard.tsx`](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/Stage2Dashboard.tsx) (Stage 2), [`src/components/layout/AppShell.tsx`](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/layout/AppShell.tsx) (App Shell), [`src/services/fileParserService.ts`](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/fileParserService.ts) (Parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_src_main["main<br/>app bootstrap<br/>[main.tsx]"]
  node_src_app["App<br/>root shell<br/>[App.tsx]"]
  node_app_shell["App Shell<br/>layout<br/>[AppShell.tsx]"]
  node_sidebar["Sidebar<br/>navigation<br/>[Sidebar.tsx]"]
  node_common_ui["Common UI<br/>shared components<br/>[MetricCard.tsx]"]
end

subgraph group_stage1["Stage 1"]
  node_stage1_dash["Stage 1<br/>workflow view"]
  node_file_uploader["File Upload<br/>ingest UI<br/>[FileUploader.tsx]"]
  node_filters_bar["Filters<br/>analysis UI<br/>[FiltersBar.tsx]"]
  node_summary_cards["Summary<br/>analytics UI<br/>[SummaryCards.tsx]"]
  node_work_matrix["Matrix<br/>analysis view"]
  node_work_table["Work Table<br/>review table<br/>[WorkTable.tsx]"]
  node_work_detail["Work Detail<br/>detail panel"]
end

subgraph group_stage2["Stage 2"]
  node_stage2_dash["Stage 2<br/>workflow view"]
  node_home_dash["Home<br/>dashboard<br/>[HomeDashboard.tsx]"]
  node_jury_panel["Jury Assign<br/>assignment UI"]
  node_profiles["Profiles<br/>admin UI"]
  node_work_mgmt["Work Mgmt<br/>admin UI<br/>[WorkManagement.tsx]"]
  node_reports["Reports<br/>output view<br/>[ReportsView.tsx]"]
  node_settings["Settings<br/>controls<br/>[SettingsView.tsx]"]
end

subgraph group_services["Services"]
  node_file_parser["Parser<br/>ingestion service"]
  node_sheets["Sheets<br/>integration"]
  node_agg["Aggregation<br/>domain service"]
  node_rules["Rules Engine<br/>domain service"]
  node_assign["Assignment<br/>domain service"]
  node_openai["OpenAI<br/>ai adapter"]
  node_storage["Storage<br/>state service<br/>[storageService.ts]"]
  node_audit["Audit Log<br/>governance service<br/>[auditLogService.ts]"]
  node_exporter["Export<br/>delivery service<br/>[exportService.ts]"]
  node_email["Email<br/>integration<br/>[emailService.ts]"]
  node_api_node["Node API<br/>runtime boundary<br/>[index.mjs]"]
  node_api_fn["Netlify API<br/>serverless boundary<br/>[api.mjs]"]
  node_mock_data["Mock Data<br/>demo data<br/>[mockData.ts]"]
  node_domain_types["Domain Types<br/>shared schema<br/>[domain.ts]"]
  node_text_utils["Text Utils<br/>normalization helper<br/>[text.ts]"]
end

node_src_main -->|"bootstraps"| node_src_app
node_src_app -->|"wraps"| node_app_shell
node_app_shell -->|"navigates"| node_sidebar
node_app_shell -->|"shows"| node_stage1_dash
node_app_shell -->|"shows"| node_stage2_dash
node_app_shell -->|"uses"| node_common_ui
node_stage1_dash -->|"contains"| node_file_uploader
node_stage1_dash -->|"contains"| node_filters_bar
node_stage1_dash -->|"contains"| node_summary_cards
node_stage1_dash -->|"contains"| node_work_matrix
node_stage1_dash -->|"contains"| node_work_table
node_stage1_dash -->|"contains"| node_work_detail
node_stage2_dash -->|"contains"| node_home_dash
node_stage2_dash -->|"contains"| node_jury_panel
node_stage2_dash -->|"contains"| node_profiles
node_stage2_dash -->|"contains"| node_work_mgmt
node_stage2_dash -->|"contains"| node_reports
node_stage2_dash -->|"contains"| node_settings
node_file_uploader -->|"parses via"| node_file_parser
node_file_parser -->|"normalizes"| node_text_utils
node_file_parser -->|"produces"| node_domain_types
node_sheets -->|"feeds"| node_file_parser
node_file_parser -->|"loads"| node_agg
node_agg -->|"evaluates"| node_rules
node_rules -->|"governs"| node_assign
node_assign -.->|"augments with"| node_openai
node_assign -->|"persists"| node_storage
node_storage -->|"logs"| node_audit
node_assign -->|"exports"| node_exporter
node_exporter -->|"distributes"| node_email
node_api_node -->|"serves"| node_sheets
node_api_node -->|"serves"| node_email
node_api_node -->|"serves"| node_openai
node_api_fn -->|"serves"| node_sheets
node_api_fn -->|"serves"| node_email
node_api_fn -->|"serves"| node_openai
node_mock_data -.->|"supports"| node_stage1_dash

click node_src_main "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/main.tsx"
click node_src_app "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/App.tsx"
click node_app_shell "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/layout/AppShell.tsx"
click node_sidebar "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/layout/Sidebar.tsx"
click node_common_ui "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/common/MetricCard.tsx"
click node_stage1_dash "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/Stage1Dashboard.tsx"
click node_file_uploader "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/FileUploader.tsx"
click node_filters_bar "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/FiltersBar.tsx"
click node_summary_cards "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/SummaryCards.tsx"
click node_work_matrix "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/ProfessorWorkMatrix.tsx"
click node_work_table "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/WorkTable.tsx"
click node_work_detail "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/WorkDetailPanel.tsx"
click node_stage2_dash "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/Stage2Dashboard.tsx"
click node_home_dash "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/HomeDashboard.tsx"
click node_jury_panel "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/JuryAssignmentPanel.tsx"
click node_profiles "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/ProfessorProfiles.tsx"
click node_work_mgmt "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/WorkManagement.tsx"
click node_reports "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/ReportsView.tsx"
click node_settings "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/SettingsView.tsx"
click node_file_parser "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/fileParserService.ts"
click node_sheets "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/googleSheetsService.ts"
click node_agg "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/juryAggregationService.ts"
click node_rules "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/rulesEngineService.ts"
click node_assign "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/juryAssignmentService.ts"
click node_openai "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/openaiAgentService.ts"
click node_storage "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/storageService.ts"
click node_audit "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/auditLogService.ts"
click node_exporter "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/exportService.ts"
click node_email "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/emailService.ts"
click node_api_node "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/server/index.mjs"
click node_api_fn "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/netlify/functions/api.mjs"
click node_mock_data "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/data/mockData.ts"
click node_domain_types "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/types/domain.ts"
click node_text_utils "https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/utils/text.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_src_main,node_src_app,node_app_shell,node_sidebar,node_common_ui toneBlue
class node_stage1_dash,node_file_uploader,node_filters_bar,node_summary_cards,node_work_matrix,node_work_table,node_work_detail toneAmber
class node_stage2_dash,node_home_dash,node_jury_panel,node_profiles,node_work_mgmt,node_reports,node_settings toneMint
class node_file_parser,node_sheets,node_agg,node_rules,node_assign,node_openai,node_storage,node_audit,node_exporter,node_email,node_api_node,node_api_fn,node_mock_data,node_domain_types,node_text_utils toneRose
```

## Components

### Frontend

React/Vite UI for the two-stage workflow

- [main](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/main.tsx): app bootstrap · Vite entry that mounts the React app · `src/main.tsx`
- [App](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/App.tsx): root shell · Top-level app composition and routing · `src/App.tsx`
- [App Shell](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/layout/AppShell.tsx): layout · Global frame and navigation container · `src/components/layout/AppShell.tsx`
- [Sidebar](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/layout/Sidebar.tsx): navigation · Primary navigation between workflow stages · `src/components/layout/Sidebar.tsx`
- [Common UI](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/common/MetricCard.tsx): shared components · Reusable cards and status elements · `src/components/common/MetricCard.tsx`

### Stage 1

Intake, normalization, and analysis

- [Stage 1](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/Stage1Dashboard.tsx): workflow view · Intake and consolidation dashboard · `src/components/stage1/Stage1Dashboard.tsx`
- [File Upload](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/FileUploader.tsx): ingest UI · Imports source files into the workflow · `src/components/stage1/FileUploader.tsx`
- [Filters](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/FiltersBar.tsx): analysis UI · Narrows the dataset for review · `src/components/stage1/FiltersBar.tsx`
- [Summary](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/SummaryCards.tsx): analytics UI · High-level intake and coverage metrics · `src/components/stage1/SummaryCards.tsx`
- [Matrix](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/ProfessorWorkMatrix.tsx): analysis view · Professor-work coverage matrix · `src/components/stage1/ProfessorWorkMatrix.tsx`
- [Work Table](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/WorkTable.tsx): review table · Inspectable list of works and responses · `src/components/stage1/WorkTable.tsx`
- [Work Detail](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage1/WorkDetailPanel.tsx): detail panel · Focused inspection of a selected work · `src/components/stage1/WorkDetailPanel.tsx`

### Stage 2

Operations, assignments, and outputs

- [Stage 2](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/Stage2Dashboard.tsx): workflow view · Operations dashboard for assignments and outputs · `src/components/stage2/Stage2Dashboard.tsx`
- [Home](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/HomeDashboard.tsx): dashboard · Stage 2 landing dashboard · `src/components/stage2/HomeDashboard.tsx`
- [Jury Assign](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/JuryAssignmentPanel.tsx): assignment UI · Forms and adjusts jury compositions · `src/components/stage2/JuryAssignmentPanel.tsx`
- [Profiles](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/ProfessorProfiles.tsx): admin UI · Professor profile management · `src/components/stage2/ProfessorProfiles.tsx`
- [Work Mgmt](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/WorkManagement.tsx): admin UI · Operational control of works and status · `src/components/stage2/WorkManagement.tsx`
- [Reports](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/ReportsView.tsx): output view · Report generation and review · `src/components/stage2/ReportsView.tsx`
- [Settings](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/components/stage2/SettingsView.tsx): controls · Operational settings and safeguards · `src/components/stage2/SettingsView.tsx`

### Services

Business rules, integrations, storage, and delivery

- [Parser](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/fileParserService.ts): ingestion service · Normalizes uploaded and sourced input data · `src/services/fileParserService.ts`
- [Sheets](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/googleSheetsService.ts): integration · Google Sheets data source adapter · `src/services/googleSheetsService.ts`
- [Aggregation](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/juryAggregationService.ts): domain service · Consolidates professor and work data · `src/services/juryAggregationService.ts`
- [Rules Engine](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/rulesEngineService.ts): domain service · Applies assignment and validation rules · `src/services/rulesEngineService.ts`
- [Assignment](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/juryAssignmentService.ts): domain service · Builds and refines jury assignments · `src/services/juryAssignmentService.ts`
- [OpenAI](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/openaiAgentService.ts): ai adapter · Assisted recommendation and generation support · `src/services/openaiAgentService.ts`
- [Storage](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/storageService.ts): state service · Persists workflow state and locks · `src/services/storageService.ts`
- [Audit Log](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/auditLogService.ts): governance service · Tracks changes for traceability · `src/services/auditLogService.ts`
- [Export](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/exportService.ts): delivery service · Produces reports and downloadable outputs · `src/services/exportService.ts`
- [Email](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/services/emailService.ts): integration · Notification and distribution adapter · `src/services/emailService.ts`
- [Node API](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/server/index.mjs): runtime boundary · Local server entry for API access · `server/index.mjs`
- [Netlify API](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/netlify/functions/api.mjs): serverless boundary · Deployable function entry point · `netlify/functions/api.mjs`
- [Mock Data](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/data/mockData.ts): demo data · Local development fallback dataset · `src/data/mockData.ts`
- [Domain Types](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/types/domain.ts): shared schema · Core entities shared across UI and services · `src/types/domain.ts`
- [Text Utils](https://github.com/lbenitesanchez/gestion-jurados-proyecto-empresarial_copia/blob/main/src/utils/text.ts): normalization helper · Text cleaning and matching helpers · `src/utils/text.ts`

## Connections

- main → App: bootstraps · Mounts the root application
- App → App Shell: wraps · Places the app inside the global shell
- App Shell → Sidebar: navigates · Provides stage navigation
- App Shell → Stage 1: shows · Routes to Stage 1 workflow
- App Shell → Stage 2: shows · Routes to Stage 2 workflow
- App Shell → Common UI: uses · Shares common presentation pieces
- Stage 1 → File Upload: contains · Entry point for intake
- Stage 1 → Filters: contains · Dataset filtering controls
- Stage 1 → Summary: contains · Headline metrics and status
- Stage 1 → Matrix: contains · Coverage analysis view
- Stage 1 → Work Table: contains · Work inspection table
- Stage 1 → Work Detail: contains · Selected work detail panel
- Stage 2 → Home: contains · Stage 2 landing view
- Stage 2 → Jury Assign: contains · Assignment editing workspace
- Stage 2 → Profiles: contains · Professor administration
- Stage 2 → Work Mgmt: contains · Work administration
- Stage 2 → Reports: contains · Report generation view
- Stage 2 → Settings: contains · Operational controls
- File Upload → Parser: parses via · Uploads are normalized into domain data
- Parser → Text Utils: normalizes · Uses text cleanup and matching helpers
- Parser → Domain Types: produces · Outputs structured domain entities
- Sheets → Parser: feeds · Sheets data is parsed into the same model
- Parser → Aggregation: loads · Parsed inputs flow into consolidation
- Aggregation → Rules Engine: evaluates · Applies business constraints and validations
- Rules Engine → Assignment: governs · Validated data drives assignments
- Assignment → OpenAI: augments with · Optional AI-assisted recommendations
- Assignment → Storage: persists · Saves assignments and locks
- Storage → Audit Log: logs · Records state-changing actions
- Assignment → Export: exports · Produces operational outputs
- Export → Email: distributes · Sends results and notifications
- Node API → Sheets: serves · Local backend access to integrations
- Node API → Email: serves · Local backend access to notifications
- Node API → OpenAI: serves · Local backend access to AI integration
- Netlify API → Sheets: serves · Serverless access to integrations
- Netlify API → Email: serves · Serverless access to notifications
- Netlify API → OpenAI: serves · Serverless access to AI integration
- Mock Data → Stage 1: supports · Fallback data for local UI
