# suwahadi/project-ops-manager architecture

> Architecture diagram of the GitHub repository suwahadi/project-ops-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suwahadi/project-ops-manager
- Repository: https://github.com/suwahadi/project-ops-manager

## Overview

Ops Manager is a single-user web application for tracking expiring web-development assets, clients, projects, invoices, and finances. The user workflow enters through authenticated web routes, which dispatch to domain services and persist in PostgreSQL; background jobs separately send reminders, synchronize domain expiry via RDAP, and capture project screenshots. The README documents capabilities whose route or service internals were not sampled, so those components are retained, but uncertain connections are omitted. The main entry point and several domain services are only partially excerpted.

Main entry points: [`internal/web/handlers/app.go`](https://github.com/suwahadi/project-ops-manager/blob/main/internal/web/handlers/app.go) (Route handlers), [`internal/db/sqlc/db.go`](https://github.com/suwahadi/project-ops-manager/blob/main/internal/db/sqlc/db.go) (PostgreSQL queries), [`internal/reminder/dispatcher.go`](https://github.com/suwahadi/project-ops-manager/blob/main/internal/reminder/dispatcher.go) (Reminder dispatcher), [`internal/screenshot/worker.go`](https://github.com/suwahadi/project-ops-manager/blob/main/internal/screenshot/worker.go) (Screenshot worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web["HTTP server<br/>[server.go]"]
  node_handlers["Route handlers<br/>[app.go]"]
  node_auth["Authentication<br/>[service.go]"]
end

subgraph group_assets["Asset lifecycle"]
  node_assets["Asset management<br/>[service.go]"]
  node_types["Asset types<br/>[service.go]"]
  node_rdap["RDAP sync<br/>[service.go]"]
end

subgraph group_business["Business operations"]
  node_clients["Client management<br/>[client.go]"]
  node_projects["Projects<br/>[project.go]"]
  node_invoices["Invoices<br/>[service.go]"]
  node_finance["Finance reports<br/>[service.go]"]
  node_settings["Settings<br/>[settings.go]"]
end

subgraph group_background["Background services"]
  node_reminders["Reminder dispatcher<br/>[dispatcher.go]"]
  node_email["Email sender<br/>[email.go]"]
  node_telegram["Telegram sender<br/>[telegram.go]"]
  node_jobs["Job runner<br/>[runner.go]"]
  node_screenshots["Screenshot worker<br/>[worker.go]"]
  node_rdapclient["RDAP client<br/>[client.go]"]
end

subgraph group_storage["Persistence and files"]
  node_postgres[("PostgreSQL queries<br/>[db.go]")]
  node_documents["Document storage<br/>[document.go]"]
end

node_user(("Single user"))
node_chromium["Headless Chromium"]

node_user -->|"uses"| node_web
node_web -->|"routes to"| node_handlers
node_handlers -->|"uses"| node_auth
node_handlers -->|"uses"| node_assets
node_handlers -->|"uses"| node_types
node_handlers -->|"uses"| node_clients
node_handlers -->|"uses"| node_projects
node_handlers -->|"uses"| node_invoices
node_handlers -->|"uses"| node_finance
node_handlers -->|"uses"| node_settings
node_handlers -->|"uses"| node_rdap
node_auth -->|"queries"| node_postgres
node_assets -->|"queries"| node_postgres
node_types -->|"queries"| node_postgres
node_clients -->|"queries"| node_postgres
node_projects -->|"queries"| node_postgres
node_invoices -->|"queries"| node_postgres
node_finance -->|"queries"| node_postgres
node_settings -->|"queries"| node_postgres
node_rdap -->|"queries"| node_postgres
node_reminders -->|"loads settings"| node_settings
node_reminders -->|"reads and logs"| node_postgres
node_reminders -->|"checks status"| node_assets
node_reminders -->|"sends email"| node_email
node_reminders -->|"sends Telegram"| node_telegram
node_screenshots -->|"queries"| node_postgres
node_screenshots -.->|"stores screenshots"| node_documents
node_rdapclient -.->|"fetches domain data"| node_rdap
node_jobs -.->|"schedules"| node_reminders
node_jobs -.->|"schedules"| node_screenshots
node_jobs -.->|"schedules"| node_rdap
node_screenshots -.->|"captures pages"| node_chromium

click node_web "https://github.com/suwahadi/project-ops-manager/blob/main/internal/web/server.go"
click node_handlers "https://github.com/suwahadi/project-ops-manager/blob/main/internal/web/handlers/app.go"
click node_auth "https://github.com/suwahadi/project-ops-manager/blob/main/internal/auth/service.go"
click node_assets "https://github.com/suwahadi/project-ops-manager/blob/main/internal/asset/service.go"
click node_types "https://github.com/suwahadi/project-ops-manager/blob/main/internal/assettype/service.go"
click node_rdap "https://github.com/suwahadi/project-ops-manager/blob/main/internal/rdap/service.go"
click node_clients "https://github.com/suwahadi/project-ops-manager/blob/main/internal/client/client.go"
click node_projects "https://github.com/suwahadi/project-ops-manager/blob/main/internal/project/project.go"
click node_invoices "https://github.com/suwahadi/project-ops-manager/blob/main/internal/invoice/service.go"
click node_finance "https://github.com/suwahadi/project-ops-manager/blob/main/internal/finance/service.go"
click node_settings "https://github.com/suwahadi/project-ops-manager/blob/main/internal/settings/settings.go"
click node_reminders "https://github.com/suwahadi/project-ops-manager/blob/main/internal/reminder/dispatcher.go"
click node_email "https://github.com/suwahadi/project-ops-manager/blob/main/internal/notify/email/email.go"
click node_telegram "https://github.com/suwahadi/project-ops-manager/blob/main/internal/notify/telegram/telegram.go"
click node_jobs "https://github.com/suwahadi/project-ops-manager/blob/main/internal/jobs/runner.go"
click node_screenshots "https://github.com/suwahadi/project-ops-manager/blob/main/internal/screenshot/worker.go"
click node_rdapclient "https://github.com/suwahadi/project-ops-manager/blob/main/internal/rdap/client.go"
click node_postgres "https://github.com/suwahadi/project-ops-manager/blob/main/internal/db/sqlc/db.go"
click node_documents "https://github.com/suwahadi/project-ops-manager/blob/main/internal/document/document.go"

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_web,node_handlers,node_auth,node_user toneBlue
class node_assets,node_types,node_rdap toneAmber
class node_clients,node_projects,node_invoices,node_finance,node_settings toneMint
class node_reminders,node_email,node_telegram,node_jobs,node_screenshots,node_rdapclient toneRose
class node_postgres,node_documents,node_chromium toneIndigo
```

## Components

### Web application

- [HTTP server](https://github.com/suwahadi/project-ops-manager/blob/main/internal/web/server.go): `internal/web/server.go`
- [Route handlers](https://github.com/suwahadi/project-ops-manager/blob/main/internal/web/handlers/app.go): `internal/web/handlers/app.go`
- [Authentication](https://github.com/suwahadi/project-ops-manager/blob/main/internal/auth/service.go): `internal/auth/service.go`

### Asset lifecycle

- [Asset management](https://github.com/suwahadi/project-ops-manager/blob/main/internal/asset/service.go): `internal/asset/service.go`
- [Asset types](https://github.com/suwahadi/project-ops-manager/blob/main/internal/assettype/service.go): `internal/assettype/service.go`
- [RDAP sync](https://github.com/suwahadi/project-ops-manager/blob/main/internal/rdap/service.go): `internal/rdap/service.go`

### Business operations

- [Client management](https://github.com/suwahadi/project-ops-manager/blob/main/internal/client/client.go): `internal/client/client.go`
- [Projects](https://github.com/suwahadi/project-ops-manager/blob/main/internal/project/project.go): `internal/project/project.go`
- [Invoices](https://github.com/suwahadi/project-ops-manager/blob/main/internal/invoice/service.go): `internal/invoice/service.go`
- [Finance reports](https://github.com/suwahadi/project-ops-manager/blob/main/internal/finance/service.go): `internal/finance/service.go`
- [Settings](https://github.com/suwahadi/project-ops-manager/blob/main/internal/settings/settings.go): `internal/settings/settings.go`

### Background services

- [Reminder dispatcher](https://github.com/suwahadi/project-ops-manager/blob/main/internal/reminder/dispatcher.go): `internal/reminder/dispatcher.go`
- [Email sender](https://github.com/suwahadi/project-ops-manager/blob/main/internal/notify/email/email.go): `internal/notify/email/email.go`
- [Telegram sender](https://github.com/suwahadi/project-ops-manager/blob/main/internal/notify/telegram/telegram.go): `internal/notify/telegram/telegram.go`
- [Job runner](https://github.com/suwahadi/project-ops-manager/blob/main/internal/jobs/runner.go): `internal/jobs/runner.go`
- [Screenshot worker](https://github.com/suwahadi/project-ops-manager/blob/main/internal/screenshot/worker.go): `internal/screenshot/worker.go`
- [RDAP client](https://github.com/suwahadi/project-ops-manager/blob/main/internal/rdap/client.go): `internal/rdap/client.go`

### Persistence and files

- [PostgreSQL queries](https://github.com/suwahadi/project-ops-manager/blob/main/internal/db/sqlc/db.go): `internal/db/sqlc/db.go`
- [Document storage](https://github.com/suwahadi/project-ops-manager/blob/main/internal/document/document.go): `internal/document/document.go`

### Other components

- **Single user**
- **Headless Chromium**

## Connections

- Single user → HTTP server: uses (evidence: `README.md`)
- HTTP server → Route handlers: routes to (evidence: `internal/web/server.go`)
- Route handlers → Authentication: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Asset management: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Asset types: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Client management: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Projects: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Invoices: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Finance reports: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → Settings: uses (evidence: `internal/web/handlers/app.go`)
- Route handlers → RDAP sync: uses (evidence: `internal/web/handlers/app.go`)
- Authentication → PostgreSQL queries: queries (evidence: `internal/auth/service.go`)
- Asset management → PostgreSQL queries: queries (evidence: `internal/asset/service.go`)
- Asset types → PostgreSQL queries: queries (evidence: `internal/assettype/service.go`)
- Client management → PostgreSQL queries: queries (evidence: `internal/client/client.go`)
- Projects → PostgreSQL queries: queries (evidence: `internal/project/project.go`)
- Invoices → PostgreSQL queries: queries (evidence: `internal/invoice/service.go`)
- Finance reports → PostgreSQL queries: queries (evidence: `internal/finance/service.go`)
- Settings → PostgreSQL queries: queries (evidence: `internal/settings/settings.go`)
- RDAP sync → PostgreSQL queries: queries (evidence: `internal/rdap/service.go`)
- Reminder dispatcher → Settings: loads settings (evidence: `internal/reminder/dispatcher.go`)
- Reminder dispatcher → PostgreSQL queries: reads and logs (evidence: `internal/reminder/dispatcher.go`)
- Reminder dispatcher → Asset management: checks status (evidence: `internal/reminder/dispatcher.go`)
- Reminder dispatcher → Email sender: sends email (evidence: `internal/reminder/dispatcher.go`)
- Reminder dispatcher → Telegram sender: sends Telegram (evidence: `internal/reminder/dispatcher.go`)
- Screenshot worker → PostgreSQL queries: queries (evidence: `internal/screenshot/worker.go`)
- Screenshot worker → Document storage: stores screenshots
- RDAP client → RDAP sync: fetches domain data
- Job runner → Reminder dispatcher: schedules
- Job runner → Screenshot worker: schedules
- Job runner → RDAP sync: schedules
- Screenshot worker → Headless Chromium: captures pages
