# hadiafatimaa/women-safety-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/hadiafatimaa/women-safety-management-system
- Repository: https://github.com/hadiafatimaa/women-safety-management-system

## Overview

Women Safety Management System is a Java Servlet web app for user accounts and safety workflows. Users register or log in, then manage contacts and profile, submit incidents and daily journal entries, or send an SOS with location; session data supports the frontend, while administrators can inspect system activity. The README lists maps and live-location alerts, but their implementation and external alert dispatch are not shown in the sampled source. Edges reflect explicit README statements or shown calls; unsampled servlet wiring is omitted.

Main entry points: [`src/main/webapp`](https://github.com/hadiafatimaa/women-safety-management-system/tree/main/src/main/webapp) (App pages), [`src/main/java/com/womensafety/db/DBConnection.java`](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/db/DBConnection.java) (Database connection), [`src/main/java/com/womensafety/servlets/SOS.java`](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/SOS.java) (SOS alerts), [`src/main/java/com/womensafety/servlets/Journal.java`](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Journal.java) (Daily journal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_pages["App pages"]
  node_maps["Location maps<br/>[maps.html]"]
end

subgraph group_accounts["Accounts and sessions"]
  node_login["Login<br/>[Login.java]"]
  node_register["Registration<br/>[Register.java]"]
  node_logout["Logout<br/>[Logout.java]"]
  node_session["Session profile<br/>[GetSession.java]"]
  node_profile["Profile updates<br/>[UpdateProfile.java]"]
end

subgraph group_safety["Safety workflows"]
  node_contacts["Emergency contacts<br/>[Contact.java]"]
  node_incidents["Incident reports<br/>[Incident.java]"]
  node_sos["SOS alerts<br/>[SOS.java]"]
  node_journals["Daily journal<br/>[Journal.java]"]
  node_journal_file["Journal backup<br/>[JournalEntry.java]"]
  node_sos_file["SOS log<br/>[SosLog.java]"]
end

subgraph group_persistence["Persistence"]
  node_db_access["Database connection<br/>[DBConnection.java]"]
  node_mysql[("MySQL")]
  node_file_base["File storage base<br/>[AppFile.java]"]
  node_chat_history["Chat history<br/>[ChatHistory.java]"]
end

subgraph group_admin["Administration"]
  node_admin_ops["Admin operations<br/>[Admin.java]"]
end

node_user(("User"))
node_admin_actor(("Administrator"))

node_user -->|"uses"| node_pages
node_pages -.->|"authenticates via"| node_login
node_pages -.->|"registers via"| node_register
node_pages -.->|"logs out via"| node_logout
node_pages -.->|"loads session via"| node_session
node_pages -.->|"updates via"| node_profile
node_pages -.->|"manages via"| node_contacts
node_pages -.->|"reports via"| node_incidents
node_pages -.->|"sends via"| node_sos
node_pages -.->|"writes via"| node_journals
node_pages -->|"views"| node_maps
node_login -->|"queries"| node_db_access
node_register -->|"writes"| node_db_access
node_session -->|"queries"| node_db_access
node_profile -->|"uses"| node_db_access
node_contacts -->|"reads and writes"| node_db_access
node_incidents -->|"reads and writes"| node_db_access
node_sos -->|"writes"| node_db_access
node_sos -->|"logs alert"| node_sos_file
node_journals -->|"reads and writes"| node_db_access
node_journals -->|"backs up entry"| node_journal_file
node_db_access -->|"connects to"| node_mysql
node_sos_file -->|"extends"| node_file_base
node_journal_file -->|"extends"| node_file_base
node_chat_history -->|"extends"| node_file_base
node_admin_actor -->|"manages"| node_admin_ops
node_admin_ops -->|"queries"| node_db_access

click node_pages "https://github.com/hadiafatimaa/women-safety-management-system/tree/main/src/main/webapp"
click node_login "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Login.java"
click node_register "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Register.java"
click node_logout "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Logout.java"
click node_session "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/GetSession.java"
click node_profile "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/UpdateProfile.java"
click node_contacts "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Contact.java"
click node_incidents "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Incident.java"
click node_sos "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/SOS.java"
click node_journals "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Journal.java"
click node_journal_file "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/JournalEntry.java"
click node_sos_file "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/SosLog.java"
click node_admin_ops "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Admin.java"
click node_db_access "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/db/DBConnection.java"
click node_file_base "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/AppFile.java"
click node_chat_history "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/ChatHistory.java"
click node_maps "https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/webapp/maps.html"

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_maps,node_user toneBlue
class node_login,node_register,node_logout,node_session,node_profile toneAmber
class node_contacts,node_incidents,node_sos,node_journals,node_journal_file,node_sos_file toneMint
class node_db_access,node_mysql,node_file_base,node_chat_history toneRose
class node_admin_ops,node_admin_actor toneIndigo
```

## Components

### Web interface

- [App pages](https://github.com/hadiafatimaa/women-safety-management-system/tree/main/src/main/webapp): `src/main/webapp`
- [Location maps](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/webapp/maps.html): `src/main/webapp/maps.html`

### Accounts and sessions

- [Login](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Login.java): `src/main/java/com/womensafety/servlets/Login.java`
- [Registration](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Register.java): `src/main/java/com/womensafety/servlets/Register.java`
- [Logout](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Logout.java): `src/main/java/com/womensafety/servlets/Logout.java`
- [Session profile](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/GetSession.java): `src/main/java/com/womensafety/servlets/GetSession.java`
- [Profile updates](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/UpdateProfile.java): `src/main/java/com/womensafety/servlets/UpdateProfile.java`

### Safety workflows

- [Emergency contacts](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Contact.java): `src/main/java/com/womensafety/servlets/Contact.java`
- [Incident reports](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Incident.java): `src/main/java/com/womensafety/servlets/Incident.java`
- [SOS alerts](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/SOS.java): `src/main/java/com/womensafety/servlets/SOS.java`
- [Daily journal](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Journal.java): `src/main/java/com/womensafety/servlets/Journal.java`
- [Journal backup](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/JournalEntry.java): `src/main/java/com/womensafety/filehandler/JournalEntry.java`
- [SOS log](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/SosLog.java): `src/main/java/com/womensafety/filehandler/SosLog.java`

### Persistence

- [Database connection](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/db/DBConnection.java): `src/main/java/com/womensafety/db/DBConnection.java`
- **MySQL**
- [File storage base](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/AppFile.java): `src/main/java/com/womensafety/filehandler/AppFile.java`
- [Chat history](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/filehandler/ChatHistory.java): `src/main/java/com/womensafety/filehandler/ChatHistory.java`

### Administration

- [Admin operations](https://github.com/hadiafatimaa/women-safety-management-system/blob/main/src/main/java/com/womensafety/servlets/Admin.java): `src/main/java/com/womensafety/servlets/Admin.java`

### Other components

- **User**
- **Administrator**

## Connections

- User → App pages: uses (evidence: `README.md`)
- App pages → Login: authenticates via
- App pages → Registration: registers via
- App pages → Logout: logs out via
- App pages → Session profile: loads session via
- App pages → Profile updates: updates via
- App pages → Emergency contacts: manages via
- App pages → Incident reports: reports via
- App pages → SOS alerts: sends via
- App pages → Daily journal: writes via
- App pages → Location maps: views (evidence: `README.md`)
- Login → Database connection: queries (evidence: `src/main/java/com/womensafety/servlets/Login.java`)
- Registration → Database connection: writes (evidence: `src/main/java/com/womensafety/servlets/Register.java`)
- Session profile → Database connection: queries (evidence: `src/main/java/com/womensafety/servlets/GetSession.java`)
- Profile updates → Database connection: uses (evidence: `src/main/java/com/womensafety/servlets/UpdateProfile.java`)
- Emergency contacts → Database connection: reads and writes (evidence: `src/main/java/com/womensafety/servlets/Contact.java`)
- Incident reports → Database connection: reads and writes (evidence: `src/main/java/com/womensafety/servlets/Incident.java`)
- SOS alerts → Database connection: writes (evidence: `src/main/java/com/womensafety/servlets/SOS.java`)
- SOS alerts → SOS log: logs alert (evidence: `src/main/java/com/womensafety/servlets/SOS.java`)
- Daily journal → Database connection: reads and writes (evidence: `src/main/java/com/womensafety/servlets/Journal.java`)
- Daily journal → Journal backup: backs up entry (evidence: `src/main/java/com/womensafety/servlets/Journal.java`)
- Database connection → MySQL: connects to (evidence: `src/main/java/com/womensafety/db/DBConnection.java`)
- SOS log → File storage base: extends (evidence: `src/main/java/com/womensafety/filehandler/SosLog.java`)
- Journal backup → File storage base: extends (evidence: `src/main/java/com/womensafety/filehandler/JournalEntry.java`)
- Chat history → File storage base: extends (evidence: `src/main/java/com/womensafety/filehandler/ChatHistory.java`)
- Administrator → Admin operations: manages (evidence: `README.md`)
- Admin operations → Database connection: queries (evidence: `src/main/java/com/womensafety/servlets/Admin.java`)
