# projecttesting18/tracemate18 architecture

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

## Overview

TraceMate is a campus lost-and-found application. Users report lost or found items, and the backend persists records and uses text and image analysis to help identify matches; claims and item collection are also represented in the backend. The graph separates the web interface, backend workflow, AI analysis, and notifications. Some route and persistence details are documented or visible only in excerpts, so edges are limited to shown calls and README statements.

Main entry points: [`server.js`](https://github.com/projecttesting18/tracemate18/blob/main/server.js) (HTTP backend), [`ai-service/app.py`](https://github.com/projecttesting18/tracemate18/blob/main/ai-service/app.py) (AI API), [`src/advanced-cnn/notificationService.js`](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/notificationService.js) (Notification coordinator), [`js/app.js`](https://github.com/projecttesting18/tracemate18/blob/main/js/app.js) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web app"]
  node_webapp["Web interface<br/>[app.js]"]
  node_adminui["Admin interface<br/>[admin.js]"]
  node_authui["Login interface<br/>[auth.js]"]
end

subgraph group_backend["Backend workflow"]
  node_server["HTTP backend<br/>[server.js]"]
  node_records["Accounts and records<br/>[server.js]"]
  node_mongo[("MongoDB")]
end

subgraph group_ai["Matching and AI"]
  node_hybrid["Hybrid matching"]
  node_cnnbridge["Image AI bridge<br/>[cnnBridge.js]"]
  node_nlpbridge["Text AI bridge<br/>[nlpBridge.js]"]
  node_aiapi["AI API<br/>[app.py]"]
  node_cnn["Image features<br/>[cnn_service.py]"]
  node_visualdetails["Fine visual features<br/>[visual_details.py]"]
  node_nlp["Text similarity<br/>[nlp_service.py]"]
  node_visualmatch["Detail comparison"]
end

subgraph group_notify["Notifications"]
  node_notifier["Notification coordinator"]
  node_email["Email delivery<br/>[emailService.js]"]
  node_whatsapp["WhatsApp delivery<br/>[whatsappService.js]"]
end

node_user(("Campus user"))

node_user -->|"reports items"| node_webapp
node_user -->|"signs in"| node_authui
node_user -->|"administers records"| node_adminui
node_webapp -->|"uses backend"| node_server
node_authui -->|"uses backend"| node_server
node_adminui -->|"uses backend"| node_server
node_server -->|"handles requests"| node_records
node_server -->|"persists data"| node_mongo
node_server -->|"uses matching"| node_hybrid
node_server -->|"enriches images"| node_cnnbridge
node_server -->|"uses text analysis"| node_nlpbridge
node_cnnbridge -->|"requests embeddings"| node_aiapi
node_aiapi -->|"calls image analysis"| node_cnn
node_aiapi -->|"calls text similarity"| node_nlp
node_cnn -->|"uses descriptors"| node_visualdetails
node_hybrid -->|"compares details"| node_visualmatch
node_notifier -->|"sends email"| node_email
node_notifier -->|"sends messages"| node_whatsapp

click node_webapp "https://github.com/projecttesting18/tracemate18/blob/main/js/app.js"
click node_adminui "https://github.com/projecttesting18/tracemate18/blob/main/js/admin.js"
click node_authui "https://github.com/projecttesting18/tracemate18/blob/main/js/auth.js"
click node_server "https://github.com/projecttesting18/tracemate18/blob/main/server.js"
click node_records "https://github.com/projecttesting18/tracemate18/blob/main/server.js"
click node_hybrid "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/matchingServiceCompat.js"
click node_cnnbridge "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/cnnBridge.js"
click node_nlpbridge "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/nlpBridge.js"
click node_aiapi "https://github.com/projecttesting18/tracemate18/blob/main/ai-service/app.py"
click node_cnn "https://github.com/projecttesting18/tracemate18/blob/main/ai-service/services/cnn_service.py"
click node_visualdetails "https://github.com/projecttesting18/tracemate18/blob/main/ai-service/services/visual_details.py"
click node_nlp "https://github.com/projecttesting18/tracemate18/blob/main/ai-service/services/nlp_service.py"
click node_visualmatch "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/visualDetailMatching.js"
click node_notifier "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/notificationService.js"
click node_email "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/emailService.js"
click node_whatsapp "https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/whatsappService.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_webapp,node_adminui,node_authui,node_user toneBlue
class node_server,node_records,node_mongo toneAmber
class node_hybrid,node_cnnbridge,node_nlpbridge,node_aiapi,node_cnn,node_visualdetails,node_nlp,node_visualmatch toneMint
class node_notifier,node_email,node_whatsapp toneRose
```

## Components

### Web app

- [Web interface](https://github.com/projecttesting18/tracemate18/blob/main/js/app.js): `js/app.js`
- [Admin interface](https://github.com/projecttesting18/tracemate18/blob/main/js/admin.js): `js/admin.js`
- [Login interface](https://github.com/projecttesting18/tracemate18/blob/main/js/auth.js): `js/auth.js`

### Backend workflow

- [HTTP backend](https://github.com/projecttesting18/tracemate18/blob/main/server.js): `server.js`
- [Accounts and records](https://github.com/projecttesting18/tracemate18/blob/main/server.js): `server.js`
- **MongoDB**

### Matching and AI

- [Hybrid matching](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/matchingServiceCompat.js): `src/advanced-cnn/matchingServiceCompat.js`
- [Image AI bridge](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/cnnBridge.js): `src/advanced-cnn/cnnBridge.js`
- [Text AI bridge](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/nlpBridge.js): `src/advanced-cnn/nlpBridge.js`
- [AI API](https://github.com/projecttesting18/tracemate18/blob/main/ai-service/app.py): `ai-service/app.py`
- [Image features](https://github.com/projecttesting18/tracemate18/blob/main/ai-service/services/cnn_service.py): `ai-service/services/cnn_service.py`
- [Fine visual features](https://github.com/projecttesting18/tracemate18/blob/main/ai-service/services/visual_details.py): `ai-service/services/visual_details.py`
- [Text similarity](https://github.com/projecttesting18/tracemate18/blob/main/ai-service/services/nlp_service.py): `ai-service/services/nlp_service.py`
- [Detail comparison](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/visualDetailMatching.js): `src/advanced-cnn/visualDetailMatching.js`

### Notifications

- [Notification coordinator](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/notificationService.js): `src/advanced-cnn/notificationService.js`
- [Email delivery](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/emailService.js): `src/advanced-cnn/emailService.js`
- [WhatsApp delivery](https://github.com/projecttesting18/tracemate18/blob/main/src/advanced-cnn/whatsappService.js): `src/advanced-cnn/whatsappService.js`

### Other components

- **Campus user**

## Connections

- Campus user → Web interface: reports items (evidence: `README.md`)
- Campus user → Login interface: signs in (evidence: `README.md`)
- Campus user → Admin interface: administers records (evidence: `README.md`)
- Web interface → HTTP backend: uses backend (evidence: `README.md`)
- Login interface → HTTP backend: uses backend (evidence: `README.md`)
- Admin interface → HTTP backend: uses backend (evidence: `README.md`)
- HTTP backend → Accounts and records: handles requests (evidence: `server.js`)
- HTTP backend → MongoDB: persists data (evidence: `README.md`)
- HTTP backend → Hybrid matching: uses matching (evidence: `server.js`)
- HTTP backend → Image AI bridge: enriches images (evidence: `server.js`)
- HTTP backend → Text AI bridge: uses text analysis (evidence: `server.js`)
- Image AI bridge → AI API: requests embeddings (evidence: `src/advanced-cnn/cnnBridge.js`)
- AI API → Image features: calls image analysis (evidence: `ai-service/app.py`)
- AI API → Text similarity: calls text similarity (evidence: `ai-service/app.py`)
- Image features → Fine visual features: uses descriptors (evidence: `ai-service/services/cnn_service.py`)
- Hybrid matching → Detail comparison: compares details (evidence: `src/advanced-cnn/matchingServiceCompat.js`)
- Notification coordinator → Email delivery: sends email (evidence: `src/advanced-cnn/notificationService.js`)
- Notification coordinator → WhatsApp delivery: sends messages (evidence: `src/advanced-cnn/notificationService.js`)
