# capooo2224/measure-manage architecture

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

- Interactive diagram: https://gitdiagram.com/capooo2224/measure-manage
- Repository: https://github.com/capooo2224/measure-manage

## Overview

Measure-Manage is a face-recognition attendance tracker with a desktop session workflow and a separate web registration workflow. An operator selects a group, configures attendance and grace timers, starts a session, and the engine processes webcam frames to log recognized students as present or late; the operator can dismiss remaining students as absent or export the session CSV. Registration adds student images and manages group folders used by recognition. The excerpts show the main GUI-to-engine calls and registration writes; details of some engine internals and the HTML template are not sampled.

Main entry points: [`app_14.py`](https://github.com/capooo2224/measure-manage/blob/main/app_14.py) (Tracker engine), [`gui_11.py`](https://github.com/capooo2224/measure-manage/blob/main/gui_11.py) (Attendance GUI), [`registration2.py`](https://github.com/capooo2224/measure-manage/blob/main/registration2.py) (Registration routes), [`Expected_faces_db`](https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db) (Group folders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop attendance"]
  node_gui["Attendance GUI<br/>[gui_11.py]"]
end

subgraph group_recognition["Face recognition"]
  node_engine["Tracker engine<br/>[app_14.py]"]
end

subgraph group_registration["Student registration"]
  node_registrationapp["Registration routes<br/>[registration2.py]"]
  node_registrationform["Registration form<br/>[registration.html]"]
  node_styles["Page styles<br/>[styles.css]"]
end

subgraph group_records["Attendance data"]
  node_groupfolders[("Group folders")]
  node_csvlogs[("Session CSV logs")]
  node_studentimages[("Student images")]
end

node_operator(("Operator"))
node_webcam["Webcam"]
node_registrar(("Registrar"))

node_operator -->|"uses"| node_gui
node_gui -->|"controls sessions"| node_engine
node_gui -->|"requests frames"| node_engine
node_gui -->|"exports CSV"| node_engine
node_engine -->|"captures frames"| node_webcam
node_engine -->|"loads group faces"| node_groupfolders
node_engine -->|"writes attendance"| node_csvlogs
node_registrar -->|"submits registration"| node_registrationapp
node_registrationapp -->|"renders form"| node_registrationform
node_registrationapp -->|"lists groups"| node_groupfolders
node_registrationapp -->|"saves uploaded images"| node_studentimages

click node_gui "https://github.com/capooo2224/measure-manage/blob/main/gui_11.py"
click node_engine "https://github.com/capooo2224/measure-manage/blob/main/app_14.py"
click node_groupfolders "https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db"
click node_csvlogs "https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db"
click node_registrationapp "https://github.com/capooo2224/measure-manage/blob/main/registration2.py"
click node_registrationform "https://github.com/capooo2224/measure-manage/blob/main/templates/registration.html"
click node_studentimages "https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db"
click node_styles "https://github.com/capooo2224/measure-manage/blob/main/static/styles.css"

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_gui toneBlue
class node_engine toneAmber
class node_registrationapp,node_registrationform,node_styles toneMint
class node_groupfolders,node_csvlogs,node_studentimages toneRose
class node_operator,node_webcam,node_registrar toneIndigo
```

## Components

### Desktop attendance

- [Attendance GUI](https://github.com/capooo2224/measure-manage/blob/main/gui_11.py): `gui_11.py`

### Face recognition

- [Tracker engine](https://github.com/capooo2224/measure-manage/blob/main/app_14.py): `app_14.py`

### Student registration

- [Registration routes](https://github.com/capooo2224/measure-manage/blob/main/registration2.py): `registration2.py`
- [Registration form](https://github.com/capooo2224/measure-manage/blob/main/templates/registration.html): `templates/registration.html`
- [Page styles](https://github.com/capooo2224/measure-manage/blob/main/static/styles.css): `static/styles.css`

### Attendance data

- [Group folders](https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db): `Expected_faces_db`
- [Session CSV logs](https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db): `Expected_faces_db`
- [Student images](https://github.com/capooo2224/measure-manage/tree/main/Expected_faces_db): `Expected_faces_db`

### Other components

- **Operator**
- **Webcam**
- **Registrar**

## Connections

- Operator → Attendance GUI: uses (evidence: `gui_11.py`)
- Attendance GUI → Tracker engine: controls sessions (evidence: `gui_11.py`)
- Attendance GUI → Tracker engine: requests frames (evidence: `gui_11.py`)
- Attendance GUI → Tracker engine: exports CSV (evidence: `gui_11.py`)
- Tracker engine → Webcam: captures frames (evidence: `app_14.py`)
- Tracker engine → Group folders: loads group faces (evidence: `app_14.py`)
- Tracker engine → Session CSV logs: writes attendance (evidence: `app_14.py`)
- Registrar → Registration routes: submits registration (evidence: `registration2.py`)
- Registration routes → Registration form: renders form (evidence: `registration2.py`)
- Registration routes → Group folders: lists groups (evidence: `registration2.py`)
- Registration routes → Student images: saves uploaded images (evidence: `registration2.py`)