# jtschneider/phcremotecontrol architecture

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

## Overview

PHC Remote contains two independent control clients: a native SwiftUI app that connects directly to STM v3, and a Go bridge that serves a browser UI over HTTP/SSE. In each, users browse parsed installation devices and issue device-specific commands; AMD state polling is supported, while many other controls only acknowledge dispatch. The diagram preserves project loading, caching, live control, and browser serving. Some bridge internals are unsampled, so their documented relationships use README evidence rather than implying uninspected call details.

Main entry points: [`Sources/Store/HomeStore.swift`](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Store/HomeStore.swift) (Home state), [`bridge/cmd/phc-bridge/main.go`](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/cmd/phc-bridge/main.go) (Bridge service), [`bridge/internal/controller/controller.go`](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/controller/controller.go) (Control and polling), [`bridge/internal/web/server.go`](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/web/server.go) (HTTP and SSE)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ios["Native iOS client"]
  node_app["App entry"]
  node_views["SwiftUI views<br/>[HomeView.swift]"]
  node_device_card["Device controls<br/>[DeviceCard.swift]"]
  node_store["Home state<br/>[HomeStore.swift]"]
  node_project_cache[("Project cache<br/>[ProjectCache.swift]")]
  node_project_model["Project model<br/>[PHCProject.swift]"]
  node_device_model["Device model<br/>[Device.swift]"]
  node_parser_ios["Project parser"]
  node_client_api["Client interface<br/>[PHCClient.swift]"]
  node_stm_ios["STM client<br/>[STMv3Client.swift]"]
  node_mock_client["Demo client"]
end

subgraph group_bridge["Go bridge"]
  node_bridge_main["Bridge service<br/>[main.go]"]
  node_project_download["Project download<br/>[download.go]"]
  node_parser_go["Project parser<br/>[parser.go]"]
  node_domain["Project domain<br/>[model.go]"]
  node_controller["Control and polling<br/>[controller.go]"]
  node_stm_go["STM transport<br/>[client.go]"]
  node_bridge_cache[("Parsed project cache<br/>[cache.go]")]
  node_web["HTTP and SSE<br/>[server.go]"]
  node_web_pages["Browser pages<br/>[pages.go]"]
end

subgraph group_hardware["PHC hardware"]
  node_stm{{"STM v3"}}
end

node_user(("iPhone/iPad user"))
node_browser(("LAN browser user"))

node_user -->|"uses"| node_views
node_app -->|"installs"| node_store
node_views -->|"sends intents"| node_store
node_views -->|"renders"| node_device_card
node_device_card -->|"dispatches actions"| node_store
node_store -->|"uses"| node_client_api
node_store -->|"loads and saves"| node_project_cache
node_store -->|"holds project"| node_project_model
node_parser_ios -->|"builds"| node_project_model
node_project_model -->|"contains devices"| node_device_model
node_stm_ios -->|"parses download"| node_parser_ios
node_stm_ios -->|"calls XML-RPC"| node_stm
node_mock_client -->|"implements"| node_client_api
node_user -->|"starts"| node_app
node_bridge_main -->|"serves"| node_web
node_bridge_main -->|"composes"| node_controller
node_bridge_main -->|"loads project"| node_project_download
node_bridge_main -->|"configures cache"| node_bridge_cache
node_project_download -->|"reads project"| node_stm_go
node_parser_go -->|"builds model"| node_domain
node_controller -->|"sends commands"| node_stm_go
node_controller -->|"manages state"| node_domain
node_web -->|"routes actions"| node_controller
node_web -->|"serves pages"| node_web_pages
node_browser -->|"HTTP and SSE"| node_web
node_stm_go -->|"uses XML-RPC"| node_stm

click node_app "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/PHCRemoteControlApp.swift"
click node_views "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Views/HomeView.swift"
click node_device_card "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Views/DeviceCard.swift"
click node_store "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Store/HomeStore.swift"
click node_project_cache "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Store/ProjectCache.swift"
click node_project_model "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Models/PHCProject.swift"
click node_device_model "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Models/Device.swift"
click node_parser_ios "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/PHCProjectParser.swift"
click node_client_api "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/PHCClient.swift"
click node_stm_ios "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/STMv3Client.swift"
click node_mock_client "https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/MockPHCClient.swift"
click node_bridge_main "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/cmd/phc-bridge/main.go"
click node_project_download "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/project/download.go"
click node_parser_go "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/project/parser.go"
click node_domain "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/domain/model.go"
click node_controller "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/controller/controller.go"
click node_stm_go "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/stm/client.go"
click node_bridge_cache "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/cache/cache.go"
click node_web "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/web/server.go"
click node_web_pages "https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/web/pages.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_app,node_views,node_device_card,node_store,node_project_cache,node_project_model,node_device_model,node_parser_ios,node_client_api,node_stm_ios,node_mock_client,node_user,node_browser toneBlue
class node_bridge_main,node_project_download,node_parser_go,node_domain,node_controller,node_stm_go,node_bridge_cache,node_web,node_web_pages toneAmber
class node_stm toneMint
```

## Components

### Native iOS client

- [App entry](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/PHCRemoteControlApp.swift): `Sources/PHCRemoteControlApp.swift`
- [SwiftUI views](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Views/HomeView.swift): `Sources/Views/HomeView.swift`
- [Device controls](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Views/DeviceCard.swift): `Sources/Views/DeviceCard.swift`
- [Home state](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Store/HomeStore.swift): `Sources/Store/HomeStore.swift`
- [Project cache](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Store/ProjectCache.swift): `Sources/Store/ProjectCache.swift`
- [Project model](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Models/PHCProject.swift): `Sources/Models/PHCProject.swift`
- [Device model](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Models/Device.swift): `Sources/Models/Device.swift`
- [Project parser](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/PHCProjectParser.swift): `Sources/Client/PHCProjectParser.swift`
- [Client interface](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/PHCClient.swift): `Sources/Client/PHCClient.swift`
- [STM client](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/STMv3Client.swift): `Sources/Client/STMv3Client.swift`
- [Demo client](https://github.com/jtschneider/phcremotecontrol/blob/main/Sources/Client/MockPHCClient.swift): `Sources/Client/MockPHCClient.swift`

### Go bridge

- [Bridge service](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/cmd/phc-bridge/main.go): `bridge/cmd/phc-bridge/main.go`
- [Project download](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/project/download.go): `bridge/internal/project/download.go`
- [Project parser](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/project/parser.go): `bridge/internal/project/parser.go`
- [Project domain](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/domain/model.go): `bridge/internal/domain/model.go`
- [Control and polling](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/controller/controller.go): `bridge/internal/controller/controller.go`
- [STM transport](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/stm/client.go): `bridge/internal/stm/client.go`
- [Parsed project cache](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/cache/cache.go): `bridge/internal/cache/cache.go`
- [HTTP and SSE](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/web/server.go): `bridge/internal/web/server.go`
- [Browser pages](https://github.com/jtschneider/phcremotecontrol/blob/main/bridge/internal/web/pages.go): `bridge/internal/web/pages.go`

### PHC hardware

- **STM v3**

### Other components

- **iPhone/iPad user**
- **LAN browser user**

## Connections

- iPhone/iPad user → SwiftUI views: uses (evidence: `README.md`)
- App entry → Home state: installs (evidence: `Sources/PHCRemoteControlApp.swift`)
- SwiftUI views → Home state: sends intents (evidence: `README.md`)
- SwiftUI views → Device controls: renders (evidence: `Sources/Views/HomeView.swift`)
- Device controls → Home state: dispatches actions (evidence: `Sources/Views/DeviceCard.swift`)
- Home state → Client interface: uses (evidence: `Sources/Store/HomeStore.swift`)
- Home state → Project cache: loads and saves (evidence: `Sources/Store/HomeStore.swift`)
- Home state → Project model: holds project (evidence: `Sources/Store/HomeStore.swift`)
- Project parser → Project model: builds (evidence: `Sources/Client/PHCProjectParser.swift`)
- Project model → Device model: contains devices (evidence: `Sources/Models/PHCProject.swift`)
- STM client → Project parser: parses download (evidence: `Sources/Client/STMv3Client.swift`)
- STM client → STM v3: calls XML-RPC (evidence: `Sources/Client/STMv3Client.swift`)
- Demo client → Client interface: implements (evidence: `Sources/Client/MockPHCClient.swift`)
- iPhone/iPad user → App entry: starts (evidence: `README.md`)
- Bridge service → HTTP and SSE: serves (evidence: `bridge/cmd/phc-bridge/main.go`)
- Bridge service → Control and polling: composes (evidence: `bridge/cmd/phc-bridge/main.go`)
- Bridge service → Project download: loads project (evidence: `bridge/cmd/phc-bridge/main.go`)
- Bridge service → Parsed project cache: configures cache (evidence: `bridge/cmd/phc-bridge/main.go`)
- Project download → STM transport: reads project (evidence: `bridge/internal/project/download.go`)
- Project parser → Project domain: builds model (evidence: `bridge/internal/project/parser.go`)
- Control and polling → STM transport: sends commands (evidence: `README.md`)
- Control and polling → Project domain: manages state (evidence: `README.md`)
- HTTP and SSE → Control and polling: routes actions (evidence: `README.md`)
- HTTP and SSE → Browser pages: serves pages (evidence: `bridge/internal/web/server.go`)
- LAN browser user → HTTP and SSE: HTTP and SSE (evidence: `README.md`)
- STM transport → STM v3: uses XML-RPC (evidence: `README.md`)
