# harshiniudayakumar/accentra_hack architecture

> Architecture diagram of the GitHub repository harshiniudayakumar/accentra_hack, 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/harshiniudayakumar/accentra_hack
- Repository: https://github.com/harshiniudayakumar/accentra_hack

## Overview

This repository implements a fraud-detection transaction dashboard and backend. A user views recent transactions or submits a transaction; the backend validates it, retrieves customer history, evaluates registered fraud rules, and returns an explainable response for dashboard review. The backend also contains behavioral-feature and anomaly-model code, though the shown service workflow does not establish that it invokes this ML path. Evidence for UI-to-API submission and some backend internals is limited to the excerpts and SOURCE INDEX references.

Main entry points: [`frontend/src/App.jsx`](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/App.jsx) (Dashboard App), [`backend/app/rules/engine.py`](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/engine.py) (Rule Engine), [`backend/app/rules/base.py`](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/base.py) (Rule Interface), [`backend/app/api/routes/transactions.py`](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/api/routes/transactions.py) (Transaction Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard"]
  node_app["Dashboard App<br/>[App.jsx]"]
  node_metrics["Metric Cards<br/>[MetricCards.jsx]"]
  node_table["Transaction Table"]
  node_newtxn["New Transaction"]
  node_review["Review Drawer<br/>[ReviewDrawer.jsx]"]
  node_rulecard["Rule Card<br/>[RuleCard.jsx]"]
end

subgraph group_api["Transaction API"]
  node_api["Transaction Routes<br/>[transactions.py]"]
  node_schema["Transaction Schemas<br/>[transaction.py]"]
  node_service["Transaction Service"]
end

subgraph group_detection["Fraud Detection"]
  node_engine["Rule Engine<br/>[engine.py]"]
  node_base["Rule Interface<br/>[base.py]"]
  node_amount["Amount Rule<br/>[amount.py]"]
  node_location["Location Rule<br/>[location.py]"]
  node_velocity["Velocity Rule<br/>[velocity.py]"]
  node_fusion["Risk Fusion<br/>[risk_fusion.py]"]
end

subgraph group_ml["Anomaly Modeling"]
  node_features["Feature Builder<br/>[feature_builder.py]"]
  node_anomaly["Anomaly Model<br/>[anomaly.py]"]
  node_training["Model Training<br/>[train_model.py]"]
end

subgraph group_data["History Data"]
  node_history[("MySQL History<br/>[connection.py]")]
end

node_operator(("Analyst"))
node_mysql[("MySQL")]

node_operator -->|"uses"| node_app
node_app -->|"renders"| node_metrics
node_app -->|"renders"| node_table
node_app -->|"renders"| node_newtxn
node_app -->|"renders"| node_review
node_review -->|"renders"| node_rulecard
node_app -->|"fetches recent"| node_api
node_api -->|"validates and formats"| node_schema
node_api -->|"delegates"| node_service
node_service -->|"loads history"| node_history
node_history -->|"queries"| node_mysql
node_service -->|"evaluates rules"| node_engine
node_engine -->|"dispatches"| node_amount
node_engine -->|"dispatches"| node_location
node_engine -->|"dispatches"| node_velocity
node_amount -->|"implements"| node_base
node_location -->|"implements"| node_base
node_velocity -->|"implements"| node_base
node_anomaly -->|"extracts features with"| node_features
node_training -->|"builds features with"| node_features
node_features -->|"uses helpers from"| node_base

click node_app "https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/App.jsx"
click node_metrics "https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/MetricCards.jsx"
click node_table "https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/TransactionTable.jsx"
click node_newtxn "https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/NewTransactionModal.jsx"
click node_review "https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/ReviewDrawer.jsx"
click node_rulecard "https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/RuleCard.jsx"
click node_api "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/api/routes/transactions.py"
click node_schema "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/schemas/transaction.py"
click node_service "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/services/transaction_service.py"
click node_engine "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/engine.py"
click node_base "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/base.py"
click node_amount "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/amount.py"
click node_location "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/location.py"
click node_velocity "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/velocity.py"
click node_fusion "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/services/risk_fusion.py"
click node_features "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/ml/feature_builder.py"
click node_anomaly "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/ml/anomaly.py"
click node_training "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/ml/train_model.py"
click node_history "https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/database/connection.py"

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_metrics,node_table,node_newtxn,node_review,node_rulecard toneBlue
class node_api,node_schema,node_service,node_mysql toneAmber
class node_engine,node_base,node_amount,node_location,node_velocity,node_fusion toneMint
class node_features,node_anomaly,node_training toneRose
class node_history,node_operator toneIndigo
```

## Components

### Dashboard

- [Dashboard App](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Metric Cards](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/MetricCards.jsx): `frontend/src/components/MetricCards.jsx`
- [Transaction Table](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/TransactionTable.jsx): `frontend/src/components/TransactionTable.jsx`
- [New Transaction](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/NewTransactionModal.jsx): `frontend/src/components/NewTransactionModal.jsx`
- [Review Drawer](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/ReviewDrawer.jsx): `frontend/src/components/ReviewDrawer.jsx`
- [Rule Card](https://github.com/harshiniudayakumar/accentra_hack/blob/main/frontend/src/components/RuleCard.jsx): `frontend/src/components/RuleCard.jsx`

### Transaction API

- [Transaction Routes](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/api/routes/transactions.py): `backend/app/api/routes/transactions.py`
- [Transaction Schemas](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/schemas/transaction.py): `backend/app/schemas/transaction.py`
- [Transaction Service](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/services/transaction_service.py): `backend/app/services/transaction_service.py`

### Fraud Detection

- [Rule Engine](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/engine.py): `backend/app/rules/engine.py`
- [Rule Interface](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/base.py): `backend/app/rules/base.py`
- [Amount Rule](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/amount.py): `backend/app/rules/amount.py`
- [Location Rule](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/location.py): `backend/app/rules/location.py`
- [Velocity Rule](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/rules/velocity.py): `backend/app/rules/velocity.py`
- [Risk Fusion](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/services/risk_fusion.py): `backend/app/services/risk_fusion.py`

### Anomaly Modeling

- [Feature Builder](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/ml/feature_builder.py): `backend/app/ml/feature_builder.py`
- [Anomaly Model](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/ml/anomaly.py): `backend/app/ml/anomaly.py`
- [Model Training](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/ml/train_model.py): `backend/app/ml/train_model.py`

### History Data

- [MySQL History](https://github.com/harshiniudayakumar/accentra_hack/blob/main/backend/app/database/connection.py): `backend/app/database/connection.py`

### Other components

- **Analyst**
- **MySQL**

## Connections

- Analyst → Dashboard App: uses
- Dashboard App → Metric Cards: renders (evidence: `frontend/src/App.jsx`)
- Dashboard App → Transaction Table: renders (evidence: `frontend/src/App.jsx`)
- Dashboard App → New Transaction: renders (evidence: `frontend/src/App.jsx`)
- Dashboard App → Review Drawer: renders (evidence: `frontend/src/App.jsx`)
- Review Drawer → Rule Card: renders (evidence: `frontend/src/components/ReviewDrawer.jsx`)
- Dashboard App → Transaction Routes: fetches recent (evidence: `frontend/src/App.jsx`)
- Transaction Routes → Transaction Schemas: validates and formats (evidence: `backend/app/api/routes/transactions.py`)
- Transaction Routes → Transaction Service: delegates (evidence: `backend/app/api/routes/transactions.py`)
- Transaction Service → MySQL History: loads history (evidence: `backend/app/services/transaction_service.py`)
- MySQL History → MySQL: queries (evidence: `backend/app/database/connection.py`)
- Transaction Service → Rule Engine: evaluates rules (evidence: `backend/app/services/transaction_service.py`)
- Rule Engine → Amount Rule: dispatches (evidence: `backend/app/rules/engine.py`)
- Rule Engine → Location Rule: dispatches (evidence: `backend/app/rules/engine.py`)
- Rule Engine → Velocity Rule: dispatches (evidence: `backend/app/rules/engine.py`)
- Amount Rule → Rule Interface: implements (evidence: `backend/app/rules/amount.py`)
- Location Rule → Rule Interface: implements (evidence: `backend/app/rules/location.py`)
- Velocity Rule → Rule Interface: implements (evidence: `backend/app/rules/velocity.py`)
- Anomaly Model → Feature Builder: extracts features with (evidence: `backend/app/ml/anomaly.py`)
- Model Training → Feature Builder: builds features with (evidence: `backend/app/ml/train_model.py`)
- Feature Builder → Rule Interface: uses helpers from (evidence: `backend/app/ml/feature_builder.py`)
