# giprojectongit/laqris-hackathon architecture

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

- Interactive diagram: https://gitdiagram.com/giprojectongit/laqris-hackathon
- Repository: https://github.com/giprojectongit/laqris-hackathon

## Overview

LaQris is a pre-payment QRIS security verification service. A user submits a scan through the browser; the backend coordinates physical/digital QRIS analysis, merchant identity checks, reputation assessment, and returns a risk/trust result. Users can also review merchant history and submit feedback or disputes. The graph reflects the documented product capabilities and sampled backend/frontend code; detailed route wiring for some features was not excerpted, so those relationships are documented rather than inferred from module names.

Main entry points: [`LaQris/backend/main.py`](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py) (Scan endpoint), [`LaQris/backend/database.py`](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/database.py) (SQLite persistence), [`LaQris/frontend/js/app.js`](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/frontend/js/app.js) (Frontend interactions), [`LaQris/backend/engine.py`](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py) (EMRS reputation scoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User experience"]
  node_pages["LaQris pages"]
  node_frontend_logic["Frontend interactions<br/>[app.js]"]
end

subgraph group_verification["QRIS verification"]
  node_scan_orchestration["Scan endpoint<br/>[main.py]"]
  node_vision["Physical detection and OCR<br/>[engine.py]"]
  node_qr_decode["QR decode and parsing<br/>[engine.py]"]
  node_identity["Merchant identity match<br/>[engine.py]"]
  node_risk["Current QR risk<br/>[engine.py]"]
end

subgraph group_reputation["Merchant risk"]
  node_emrs["EMRS reputation scoring<br/>[engine.py]"]
  node_feedback["Feedback and complaints<br/>[main.py]"]
  node_disputes["Merchant disputes<br/>[main.py]"]
  node_merchant_views["Merchant and scan history<br/>[main.py]"]
end

subgraph group_platform["Service and persistence"]
  node_api["API and routing<br/>[main.py]"]
  node_auth["Authentication<br/>[main.py]"]
  node_schemas["API data schemas<br/>[schemas.py]"]
  node_entities["Merchant and session entities<br/>[models.py]"]
  node_database[("SQLite persistence<br/>[database.py]")]
end

node_user(("Browser user"))
node_payment_app(("Payment application"))

node_user -->|"uses"| node_pages
node_pages -->|"loads"| node_frontend_logic
node_frontend_logic -->|"requests API"| node_api
node_api -->|"serves"| node_pages
node_api -->|"handles auth"| node_auth
node_api -->|"routes scans"| node_scan_orchestration
node_scan_orchestration -->|"analyzes image"| node_vision
node_scan_orchestration -->|"verifies payload"| node_qr_decode
node_scan_orchestration -->|"checks identity"| node_identity
node_scan_orchestration -->|"assesses risk"| node_risk
node_scan_orchestration -->|"gets reputation"| node_emrs
node_scan_orchestration -->|"records session"| node_database
node_scan_orchestration -->|"returns typed data"| node_schemas
node_frontend_logic -->|"submits feedback"| node_feedback
node_api -->|"processes feedback"| node_feedback
node_api -->|"handles disputes"| node_disputes
node_api -->|"serves history"| node_merchant_views
node_emrs -->|"reads reputation data"| node_database
node_feedback -.->|"updates records"| node_database
node_disputes -.->|"stores disputes"| node_database
node_merchant_views -->|"reads merchant data"| node_database
node_database -->|"maps records"| node_entities
node_emrs -->|"uses merchant reports"| node_entities
node_payment_app -->|"integrates verification"| node_api
node_frontend_logic -->|"presents result"| node_risk

click node_pages "https://github.com/giprojectongit/laqris-hackathon/tree/main/LaQris/frontend"
click node_frontend_logic "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/frontend/js/app.js"
click node_api "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py"
click node_auth "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py"
click node_scan_orchestration "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py"
click node_vision "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py"
click node_qr_decode "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py"
click node_identity "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py"
click node_risk "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py"
click node_emrs "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py"
click node_feedback "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py"
click node_disputes "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py"
click node_merchant_views "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py"
click node_schemas "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/schemas.py"
click node_entities "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/models.py"
click node_database "https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/database.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_pages,node_frontend_logic,node_user toneBlue
class node_scan_orchestration,node_vision,node_qr_decode,node_identity,node_risk toneAmber
class node_emrs,node_feedback,node_disputes,node_merchant_views toneMint
class node_api,node_auth,node_schemas,node_entities,node_database toneRose
class node_payment_app toneIndigo
```

## Components

### User experience

- [LaQris pages](https://github.com/giprojectongit/laqris-hackathon/tree/main/LaQris/frontend): `LaQris/frontend`
- [Frontend interactions](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/frontend/js/app.js): `LaQris/frontend/js/app.js`

### QRIS verification

- [Scan endpoint](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py): `LaQris/backend/main.py`
- [Physical detection and OCR](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py): `LaQris/backend/engine.py`
- [QR decode and parsing](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py): `LaQris/backend/engine.py`
- [Merchant identity match](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py): `LaQris/backend/engine.py`
- [Current QR risk](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py): `LaQris/backend/engine.py`

### Merchant risk

- [EMRS reputation scoring](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/engine.py): `LaQris/backend/engine.py`
- [Feedback and complaints](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py): `LaQris/backend/main.py`
- [Merchant disputes](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py): `LaQris/backend/main.py`
- [Merchant and scan history](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py): `LaQris/backend/main.py`

### Service and persistence

- [API and routing](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py): `LaQris/backend/main.py`
- [Authentication](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/main.py): `LaQris/backend/main.py`
- [API data schemas](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/schemas.py): `LaQris/backend/schemas.py`
- [Merchant and session entities](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/models.py): `LaQris/backend/models.py`
- [SQLite persistence](https://github.com/giprojectongit/laqris-hackathon/blob/main/LaQris/backend/database.py): `LaQris/backend/database.py`

### Other components

- **Browser user**
- **Payment application**

## Connections

- Browser user → LaQris pages: uses (evidence: `README.md`)
- LaQris pages → Frontend interactions: loads (evidence: `LaQris/frontend/js/app.js`)
- Frontend interactions → API and routing: requests API (evidence: `LaQris/frontend/js/app.js`)
- API and routing → LaQris pages: serves (evidence: `README.md`)
- API and routing → Authentication: handles auth (evidence: `README.md`)
- API and routing → Scan endpoint: routes scans (evidence: `LaQris/backend/main.py`)
- Scan endpoint → Physical detection and OCR: analyzes image (evidence: `README.md`)
- Scan endpoint → QR decode and parsing: verifies payload (evidence: `README.md`)
- Scan endpoint → Merchant identity match: checks identity (evidence: `README.md`)
- Scan endpoint → Current QR risk: assesses risk (evidence: `README.md`)
- Scan endpoint → EMRS reputation scoring: gets reputation (evidence: `LaQris/backend/engine.py`)
- Scan endpoint → SQLite persistence: records session (evidence: `LaQris/backend/main.py`)
- Scan endpoint → API data schemas: returns typed data (evidence: `LaQris/backend/main.py`)
- Frontend interactions → Feedback and complaints: submits feedback (evidence: `LaQris/frontend/js/app.js`)
- API and routing → Feedback and complaints: processes feedback (evidence: `README.md`)
- API and routing → Merchant disputes: handles disputes (evidence: `LaQris/backend/main.py`)
- API and routing → Merchant and scan history: serves history (evidence: `LaQris/backend/main.py`)
- EMRS reputation scoring → SQLite persistence: reads reputation data (evidence: `LaQris/backend/engine.py`)
- Feedback and complaints → SQLite persistence: updates records (evidence: `LaQris/backend/main.py`)
- Merchant disputes → SQLite persistence: stores disputes (evidence: `LaQris/backend/main.py`)
- Merchant and scan history → SQLite persistence: reads merchant data (evidence: `LaQris/backend/main.py`)
- SQLite persistence → Merchant and session entities: maps records (evidence: `LaQris/backend/database.py`)
- EMRS reputation scoring → Merchant and session entities: uses merchant reports (evidence: `LaQris/backend/engine.py`)
- Payment application → API and routing: integrates verification (evidence: `README.md`)
- Frontend interactions → Current QR risk: presents result (evidence: `README.md`)
