# matrello/realpopup architecture

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

- Interactive diagram: https://gitdiagram.com/matrello/realpopup
- Repository: https://github.com/matrello/realpopup

## Overview

RealPopup is a Windows desktop replacement for WinPopup, used to browse network recipients, compose and send messages, and receive and manage incoming messages. The main dialog coordinates message presentation and preferences; the protocol handler scans, sends, and processes delivery replies using the RealPopup protocol. Other documented-in-code areas include user profiles, localization, environment settings, network browsing, and logging. The map uses the supplied excerpts and source index; several subsystem connections are left out where their implementation was not shown.

Main entry points: [`RealPopupDlg.cpp`](https://github.com/matrello/realpopup/blob/master/RealPopupDlg.cpp) (Main message window), [`RPProtocolsHandler.cpp`](https://github.com/matrello/realpopup/blob/master/RPProtocolsHandler.cpp) (Protocol handler), [`RPMsgEditCtrl.cpp`](https://github.com/matrello/realpopup/blob/master/RPMsgEditCtrl.cpp) (Message editor), [`PPUsers.cpp`](https://github.com/matrello/realpopup/blob/master/PPUsers.cpp) (User profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop interface"]
  node_main_dialog["Main message window<br/>[RealPopupDlg.cpp]"]
  node_message_editor["Message editor<br/>[RPMsgEditCtrl.cpp]"]
  node_rich_edit["Rich text control<br/>[RichEditCtrlEx.cpp]"]
  node_send_dialog["Send dialog<br/>[DlgCriteria.cpp]"]
  node_command_line["Command line<br/>[CmdLine.cpp]"]
end

subgraph group_messaging["Messaging runtime"]
  node_protocol_handler["Protocol handler"]
  node_realpopup_protocol["RealPopup protocol"]
  node_message_records["Message records<br/>[MsgFile.cpp]"]
end

subgraph group_recipients["Recipients and preferences"]
  node_network_browser["Network browser"]
  node_user_profiles["User profiles<br/>[PPUsers.cpp]"]
  node_criteria_dialog["Search criteria<br/>[DlgCriteria.cpp]"]
  node_environment_settings["Environment settings<br/>[PPEnvironment.cpp]"]
  node_language_settings["Language settings<br/>[PPLanguages.cpp]"]
  node_message_settings["Message settings<br/>[PPMessages.cpp]"]
end

subgraph group_support["Shared services"]
  node_logging["Message logging<br/>[Ddxfile.cpp]"]
  node_tracing["Diagnostics<br/>[ReTracer.cpp]"]
  node_app_state["Application state<br/>[Globals.cpp]"]
end

node_user(("Desktop user"))
node_windows_messenger["Windows Messenger service"]
node_network_peers(("Network peers"))

node_user -->|"uses"| node_main_dialog
node_main_dialog -->|"embeds"| node_message_editor
node_message_editor -->|"extends"| node_rich_edit
node_main_dialog -->|"opens"| node_send_dialog
node_main_dialog -->|"initializes"| node_protocol_handler
node_protocol_handler -->|"sends and pings"| node_realpopup_protocol
node_protocol_handler -->|"controls service"| node_windows_messenger
node_protocol_handler -.->|"sends messages"| node_network_peers
node_protocol_handler -->|"logs messages"| node_message_records
node_main_dialog -->|"uses browser"| node_network_browser
node_main_dialog -->|"configures users"| node_user_profiles
node_main_dialog -->|"opens preferences"| node_environment_settings
node_main_dialog -->|"opens preferences"| node_language_settings
node_main_dialog -->|"opens preferences"| node_message_settings
node_user_profiles -.->|"uses criteria"| node_criteria_dialog
node_command_line -.->|"requests send"| node_protocol_handler
node_protocol_handler -.->|"writes logs"| node_logging
node_main_dialog -.->|"records events"| node_tracing
node_main_dialog -.->|"uses state"| node_app_state

click node_main_dialog "https://github.com/matrello/realpopup/blob/master/RealPopupDlg.cpp"
click node_message_editor "https://github.com/matrello/realpopup/blob/master/RPMsgEditCtrl.cpp"
click node_rich_edit "https://github.com/matrello/realpopup/blob/master/RichEditCtrlEx.cpp"
click node_send_dialog "https://github.com/matrello/realpopup/blob/master/DlgCriteria.cpp"
click node_protocol_handler "https://github.com/matrello/realpopup/blob/master/RPProtocolsHandler.cpp"
click node_realpopup_protocol "https://github.com/matrello/realpopup/blob/master/RPRealPopupProtocol.cpp"
click node_message_records "https://github.com/matrello/realpopup/blob/master/MsgFile.cpp"
click node_network_browser "https://github.com/matrello/realpopup/blob/master/RPNetworkBrowser.cpp"
click node_user_profiles "https://github.com/matrello/realpopup/blob/master/PPUsers.cpp"
click node_criteria_dialog "https://github.com/matrello/realpopup/blob/master/DlgCriteria.cpp"
click node_environment_settings "https://github.com/matrello/realpopup/blob/master/PPEnvironment.cpp"
click node_language_settings "https://github.com/matrello/realpopup/blob/master/PPLanguages.cpp"
click node_message_settings "https://github.com/matrello/realpopup/blob/master/PPMessages.cpp"
click node_command_line "https://github.com/matrello/realpopup/blob/master/CmdLine.cpp"
click node_logging "https://github.com/matrello/realpopup/blob/master/Ddxfile.cpp"
click node_tracing "https://github.com/matrello/realpopup/blob/master/ReTracer.cpp"
click node_app_state "https://github.com/matrello/realpopup/blob/master/Globals.cpp"

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_main_dialog,node_message_editor,node_rich_edit,node_send_dialog,node_command_line,node_user toneBlue
class node_protocol_handler,node_realpopup_protocol,node_message_records toneAmber
class node_network_browser,node_user_profiles,node_criteria_dialog,node_environment_settings,node_language_settings,node_message_settings toneMint
class node_logging,node_tracing,node_app_state toneRose
class node_windows_messenger,node_network_peers toneIndigo
```

## Components

### Desktop interface

- [Main message window](https://github.com/matrello/realpopup/blob/master/RealPopupDlg.cpp): `RealPopupDlg.cpp`
- [Message editor](https://github.com/matrello/realpopup/blob/master/RPMsgEditCtrl.cpp): `RPMsgEditCtrl.cpp`
- [Rich text control](https://github.com/matrello/realpopup/blob/master/RichEditCtrlEx.cpp): `RichEditCtrlEx.cpp`
- [Send dialog](https://github.com/matrello/realpopup/blob/master/DlgCriteria.cpp): `DlgCriteria.cpp`
- [Command line](https://github.com/matrello/realpopup/blob/master/CmdLine.cpp): `CmdLine.cpp`

### Messaging runtime

- [Protocol handler](https://github.com/matrello/realpopup/blob/master/RPProtocolsHandler.cpp): `RPProtocolsHandler.cpp`
- [RealPopup protocol](https://github.com/matrello/realpopup/blob/master/RPRealPopupProtocol.cpp): `RPRealPopupProtocol.cpp`
- [Message records](https://github.com/matrello/realpopup/blob/master/MsgFile.cpp): `MsgFile.cpp`

### Recipients and preferences

- [Network browser](https://github.com/matrello/realpopup/blob/master/RPNetworkBrowser.cpp): `RPNetworkBrowser.cpp`
- [User profiles](https://github.com/matrello/realpopup/blob/master/PPUsers.cpp): `PPUsers.cpp`
- [Search criteria](https://github.com/matrello/realpopup/blob/master/DlgCriteria.cpp): `DlgCriteria.cpp`
- [Environment settings](https://github.com/matrello/realpopup/blob/master/PPEnvironment.cpp): `PPEnvironment.cpp`
- [Language settings](https://github.com/matrello/realpopup/blob/master/PPLanguages.cpp): `PPLanguages.cpp`
- [Message settings](https://github.com/matrello/realpopup/blob/master/PPMessages.cpp): `PPMessages.cpp`

### Shared services

- [Message logging](https://github.com/matrello/realpopup/blob/master/Ddxfile.cpp): `Ddxfile.cpp`
- [Diagnostics](https://github.com/matrello/realpopup/blob/master/ReTracer.cpp): `ReTracer.cpp`
- [Application state](https://github.com/matrello/realpopup/blob/master/Globals.cpp): `Globals.cpp`

### Other components

- **Desktop user**
- **Windows Messenger service**
- **Network peers**

## Connections

- Desktop user → Main message window: uses
- Main message window → Message editor: embeds (evidence: `RealPopupDlg.cpp`)
- Message editor → Rich text control: extends
- Main message window → Send dialog: opens (evidence: `RealPopupDlg.cpp`)
- Main message window → Protocol handler: initializes (evidence: `RealPopupDlg.cpp`)
- Protocol handler → RealPopup protocol: sends and pings (evidence: `RPProtocolsHandler.cpp`)
- Protocol handler → Windows Messenger service: controls service (evidence: `RPProtocolsHandler.cpp`)
- Protocol handler → Network peers: sends messages
- Protocol handler → Message records: logs messages (evidence: `RPProtocolsHandler.cpp`)
- Main message window → Network browser: uses browser (evidence: `RealPopupDlg.cpp`)
- Main message window → User profiles: configures users (evidence: `RealPopupDlg.cpp`)
- Main message window → Environment settings: opens preferences (evidence: `RealPopupDlg.cpp`)
- Main message window → Language settings: opens preferences (evidence: `RealPopupDlg.cpp`)
- Main message window → Message settings: opens preferences (evidence: `RealPopupDlg.cpp`)
- User profiles → Search criteria: uses criteria
- Command line → Protocol handler: requests send
- Protocol handler → Message logging: writes logs
- Main message window → Diagnostics: records events
- Main message window → Application state: uses state
