# adinaninacerdine/saf_import architecture

> Architecture diagram of the GitHub repository adinaninacerdine/saf_import, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adinaninacerdine/saf_import
- Repository: https://github.com/adinaninacerdine/saf_import

## Overview

MCTV imports money-transfer transactions from MoneyGram, RIA, and Western Union files, then exposes review, agent management, history, and reporting in a React interface. The central workflow is upload and parsing, staging with duplicate checks and agent association, administrator validation into the primary transaction table, and follow-up review or reports. The graph also preserves the distinct global-agency and unknown-agent workflows. Edges are limited to README statements and the supplied excerpts or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`Frontend/src/App.js`](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/App.js) (App and upload), [`backend/server.js`](https://github.com/adinaninacerdine/saf_import/blob/main/backend/server.js) (Express API), [`backend/validation-routes.js`](https://github.com/adinaninacerdine/saf_import/blob/main/backend/validation-routes.js) (Validation routes), [`backend/import-handler.js`](https://github.com/adinaninacerdine/saf_import/blob/main/backend/import-handler.js) (File import and staging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["App and upload<br/>[App.js]"]
  node_validation_ui["Import validation<br/>[ValidationPage.js]"]
  node_history_ui["Import history<br/>[HistoryPage.js]"]
  node_reports_ui["Reports<br/>[ReportsPage.js]"]
  node_global_ui["Global assignments"]
  node_unknown_ui["Unknown agents"]
end

subgraph group_api["API workflows"]
  node_server["Express API<br/>[server.js]"]
  node_importer["File import and staging<br/>[import-handler.js]"]
  node_validation_api["Validation routes"]
  node_reports_api["Report routes<br/>[reports-routes.js]"]
end

subgraph group_agents["Agent management"]
  node_global_api["Global agency routes"]
  node_unknown_api["Unknown agent routes"]
  node_dedup["Agent deduplication"]
end

subgraph group_data["Transaction data"]
  node_sql[("SQL Server")]
  node_staging[("Pending transactions")]
  node_transactions[("Imported transactions")]
end

node_user(("MCTV user"))

node_user -->|"uses"| node_app
node_app -->|"shows"| node_validation_ui
node_app -->|"shows"| node_history_ui
node_app -->|"shows"| node_reports_ui
node_app -->|"shows"| node_global_ui
node_app -->|"shows"| node_unknown_ui
node_app -->|"uploads to"| node_server
node_validation_ui -->|"requests"| node_validation_api
node_history_ui -->|"requests history"| node_server
node_reports_ui -->|"requests"| node_reports_api
node_global_ui -->|"assigns agents"| node_global_api
node_unknown_ui -->|"manages agents"| node_unknown_api
node_server -->|"initializes"| node_importer
node_server -->|"routes requests"| node_validation_api
node_server -->|"routes requests"| node_reports_api
node_server -->|"routes requests"| node_global_api
node_server -->|"routes requests"| node_unknown_api
node_importer -->|"writes pending"| node_staging
node_importer -->|"resolves agents"| node_dedup
node_importer -->|"checks duplicates"| node_sql
node_validation_api -->|"reads and updates"| node_staging
node_validation_api -->|"moves validated"| node_transactions
node_validation_api -->|"queries"| node_sql
node_reports_api -->|"queries transactions"| node_sql
node_global_api -->|"reads and writes mappings"| node_sql
node_unknown_api -->|"links agent codes"| node_dedup
node_unknown_api -->|"queries agents"| node_sql
node_dedup -->|"maintains agent mappings"| node_sql

click node_app "https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/App.js"
click node_validation_ui "https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/ValidationPage.js"
click node_history_ui "https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/HistoryPage.js"
click node_reports_ui "https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/ReportsPage.js"
click node_global_ui "https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/GlobalAgencyLinkingPage.js"
click node_unknown_ui "https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/UnknownAgentsPage.js"
click node_server "https://github.com/adinaninacerdine/saf_import/blob/main/backend/server.js"
click node_importer "https://github.com/adinaninacerdine/saf_import/blob/main/backend/import-handler.js"
click node_validation_api "https://github.com/adinaninacerdine/saf_import/blob/main/backend/validation-routes.js"
click node_reports_api "https://github.com/adinaninacerdine/saf_import/blob/main/backend/reports-routes.js"
click node_global_api "https://github.com/adinaninacerdine/saf_import/blob/main/backend/global-agency-routes.js"
click node_unknown_api "https://github.com/adinaninacerdine/saf_import/blob/main/backend/unknown-agents-routes.js"
click node_dedup "https://github.com/adinaninacerdine/saf_import/blob/main/backend/agent-deduplication.js"

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_app,node_validation_ui,node_history_ui,node_reports_ui,node_global_ui,node_unknown_ui,node_user toneBlue
class node_server,node_importer,node_validation_api,node_reports_api toneAmber
class node_global_api,node_unknown_api,node_dedup toneMint
class node_sql,node_staging,node_transactions toneRose
```

## Components

### Web application

- [App and upload](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/App.js): `Frontend/src/App.js`
- [Import validation](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/ValidationPage.js): `Frontend/src/ValidationPage.js`
- [Import history](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/HistoryPage.js): `Frontend/src/HistoryPage.js`
- [Reports](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/ReportsPage.js): `Frontend/src/ReportsPage.js`
- [Global assignments](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/GlobalAgencyLinkingPage.js): `Frontend/src/GlobalAgencyLinkingPage.js`
- [Unknown agents](https://github.com/adinaninacerdine/saf_import/blob/main/Frontend/src/UnknownAgentsPage.js): `Frontend/src/UnknownAgentsPage.js`

### API workflows

- [Express API](https://github.com/adinaninacerdine/saf_import/blob/main/backend/server.js): `backend/server.js`
- [File import and staging](https://github.com/adinaninacerdine/saf_import/blob/main/backend/import-handler.js): `backend/import-handler.js`
- [Validation routes](https://github.com/adinaninacerdine/saf_import/blob/main/backend/validation-routes.js): `backend/validation-routes.js`
- [Report routes](https://github.com/adinaninacerdine/saf_import/blob/main/backend/reports-routes.js): `backend/reports-routes.js`

### Agent management

- [Global agency routes](https://github.com/adinaninacerdine/saf_import/blob/main/backend/global-agency-routes.js): `backend/global-agency-routes.js`
- [Unknown agent routes](https://github.com/adinaninacerdine/saf_import/blob/main/backend/unknown-agents-routes.js): `backend/unknown-agents-routes.js`
- [Agent deduplication](https://github.com/adinaninacerdine/saf_import/blob/main/backend/agent-deduplication.js): `backend/agent-deduplication.js`

### Transaction data

- **SQL Server**
- **Pending transactions**
- **Imported transactions**

### Other components

- **MCTV user**

## Connections

- MCTV user → App and upload: uses (evidence: `README.md`)
- App and upload → Import validation: shows (evidence: `Frontend/src/App.js`)
- App and upload → Import history: shows (evidence: `Frontend/src/App.js`)
- App and upload → Reports: shows (evidence: `Frontend/src/App.js`)
- App and upload → Global assignments: shows (evidence: `Frontend/src/App.js`)
- App and upload → Unknown agents: shows (evidence: `Frontend/src/App.js`)
- App and upload → Express API: uploads to (evidence: `README.md`)
- Import validation → Validation routes: requests (evidence: `Frontend/src/ValidationPage.js`)
- Import history → Express API: requests history (evidence: `README.md`)
- Reports → Report routes: requests (evidence: `Frontend/src/ReportsPage.js`)
- Global assignments → Global agency routes: assigns agents (evidence: `README.md`)
- Unknown agents → Unknown agent routes: manages agents (evidence: `README.md`)
- Express API → File import and staging: initializes (evidence: `backend/server.js`)
- Express API → Validation routes: routes requests (evidence: `backend/server.js`)
- Express API → Report routes: routes requests (evidence: `backend/server.js`)
- Express API → Global agency routes: routes requests (evidence: `backend/server.js`)
- Express API → Unknown agent routes: routes requests (evidence: `backend/server.js`)
- File import and staging → Pending transactions: writes pending (evidence: `backend/import-handler.js`)
- File import and staging → Agent deduplication: resolves agents (evidence: `backend/import-handler.js`)
- File import and staging → SQL Server: checks duplicates (evidence: `backend/import-handler.js`)
- Validation routes → Pending transactions: reads and updates (evidence: `backend/validation-routes.js`)
- Validation routes → Imported transactions: moves validated (evidence: `backend/validation-routes.js`)
- Validation routes → SQL Server: queries (evidence: `backend/validation-routes.js`)
- Report routes → SQL Server: queries transactions (evidence: `backend/reports-routes.js`)
- Global agency routes → SQL Server: reads and writes mappings (evidence: `backend/global-agency-routes.js`)
- Unknown agent routes → Agent deduplication: links agent codes (evidence: `backend/unknown-agents-routes.js`)
- Unknown agent routes → SQL Server: queries agents (evidence: `backend/unknown-agents-routes.js`)
- Agent deduplication → SQL Server: maintains agent mappings (evidence: `README.md`)
