# williechen/rust_ai_ring architecture

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

## Overview

This repository contains three distinct Rust applications: a desktop pet companion and management console, a member-based chat service, and an analytics/reporting application. Their user-facing flows pass through UI or HTTP entry points into application/domain behavior and persistence. The excerpts show pet UI actions and state modeling, chat history and authentication paths, and analytics report-search behavior; broader dashboard, file-management, and chat features are represented from the tree but their internal wiring was not sampled, so those links are omitted.

Main entry points: [`pet_apps/pet_ui/src/main.rs`](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/main.rs) (Pet console), [`chat_apps/chat_server/src/http.rs`](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/http.rs) (HTTP routing), [`analytics_apps/analytics_server/src/lib.rs`](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_server/src/lib.rs) (Analytics server), [`analytics_apps/analytics_application/src/daily_report.rs`](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_application/src/daily_report.rs) (Report workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pet["Pet companion"]
  node_pet_console["Pet console<br/>[main.rs]"]
  node_pet_bridge["Desktop bridge<br/>[bridge.rs]"]
  node_pet_control["Activity controls"]
  node_pet_settings["Settings editor<br/>[settings_editor.rs]"]
  node_pet_files["File management<br/>[file_browser.rs]"]
  node_pet_lifecycle["Pet lifecycle<br/>[lifecycle.rs]"]
  node_pet_profile["Pet state and profile<br/>[profile.rs]"]
  node_pet_cleanup["Cleanup rules<br/>[cleanup.rs]"]
  node_pet_store[("Pet persistence<br/>[lib.rs]")]
end

subgraph group_chat["Chat service"]
  node_chat_ui["Chat interface<br/>[lib.rs]"]
  node_chat_history_ui["History request<br/>[service.rs]"]
  node_chat_http["HTTP routing<br/>[http.rs]"]
  node_chat_auth["Session authentication<br/>[auth_session.rs]"]
  node_chat_member_actions["Member self-service<br/>[member_self.rs]"]
  node_chat_ws["WebSocket messaging<br/>[ws.rs]"]
  node_chat_app_history["History application<br/>[service.rs]"]
  node_chat_repos["Chat repositories<br/>[repository.rs]"]
  node_chat_sessions[("Session storage<br/>[member_session.rs]")]
end

subgraph group_analytics["Analytics reporting"]
  node_analytics_server["Analytics server<br/>[lib.rs]"]
  node_analytics_ui["Dashboard navigation<br/>[navigation.rs]"]
  node_analytics_reports["Report workflows<br/>[daily_report.rs]"]
  node_analytics_csv["CSV export<br/>[report_csv.rs]"]
  node_analytics_daily[("Daily report queries<br/>[daily_report.rs]")]
  node_analytics_search["Search text handling<br/>[search_text.rs]"]
  node_analytics_domain["Event and account rules<br/>[event_type.rs]"]
end

subgraph group_shared["Shared runtime"]
end

node_pet_user(("Pet user"))
node_chat_member(("Chat member"))
node_analytics_user(("Analyst"))

node_pet_user -->|"uses"| node_pet_console
node_pet_console -->|"invokes"| node_pet_bridge
node_pet_console -->|"loads"| node_pet_control
node_pet_console -->|"loads"| node_pet_settings
node_pet_console -->|"loads"| node_pet_files
node_pet_console -->|"creates pets"| node_pet_lifecycle
node_pet_console -->|"reads"| node_pet_profile
node_pet_control -.->|"changes state"| node_pet_profile
node_pet_lifecycle -.->|"persists pets"| node_pet_store
node_pet_cleanup -.->|"cleans records"| node_pet_store
node_chat_member -->|"uses"| node_chat_ui
node_chat_ui -.->|"requests history"| node_chat_history_ui
node_chat_history_ui -->|"fetches API"| node_chat_http
node_chat_member -.->|"sends requests"| node_chat_http
node_chat_http -->|"routes through"| node_chat_auth
node_chat_http -->|"routes through"| node_chat_member_actions
node_chat_http -->|"routes through"| node_chat_ws
node_chat_auth -->|"looks up sessions"| node_chat_sessions
node_chat_app_history -->|"reads rooms and messages"| node_chat_repos
node_analytics_user -.->|"views reports"| node_analytics_ui
node_analytics_ui -.->|"requests views"| node_analytics_server
node_analytics_server -.->|"dispatches reports"| node_analytics_reports
node_analytics_reports -.->|"queries daily data"| node_analytics_daily
node_analytics_reports -.->|"formats export"| node_analytics_csv
node_analytics_daily -->|"uses pattern"| node_analytics_search
node_analytics_server -.->|"validates events"| node_analytics_domain

click node_pet_console "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/main.rs"
click node_pet_bridge "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/bridge.rs"
click node_pet_control "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/control_activity.rs"
click node_pet_settings "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/settings_editor.rs"
click node_pet_files "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_server/src/file_browser.rs"
click node_pet_lifecycle "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_application/src/lifecycle.rs"
click node_pet_profile "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_domain/src/profile.rs"
click node_pet_cleanup "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_domain/src/cleanup.rs"
click node_pet_store "https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_persistence/src/lib.rs"
click node_chat_ui "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_ui/src/lib.rs"
click node_chat_history_ui "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_ui/src/msg/msg2001/service.rs"
click node_chat_http "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/http.rs"
click node_chat_auth "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/auth_session.rs"
click node_chat_member_actions "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/member_self.rs"
click node_chat_ws "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/ws.rs"
click node_chat_app_history "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_application/src/msg/msg2001/service.rs"
click node_chat_repos "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_application/src/repository.rs"
click node_chat_sessions "https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_persistence/src/member_session.rs"
click node_analytics_server "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_server/src/lib.rs"
click node_analytics_ui "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_ui/src/navigation.rs"
click node_analytics_reports "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_application/src/daily_report.rs"
click node_analytics_csv "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_application/src/report_csv.rs"
click node_analytics_daily "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_persistence/src/daily_report.rs"
click node_analytics_search "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_persistence/src/search_text.rs"
click node_analytics_domain "https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_domain/src/event_type.rs"

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_pet_console,node_pet_bridge,node_pet_control,node_pet_settings,node_pet_files,node_pet_lifecycle,node_pet_profile,node_pet_cleanup,node_pet_store,node_pet_user toneBlue
class node_chat_ui,node_chat_history_ui,node_chat_http,node_chat_auth,node_chat_member_actions,node_chat_ws,node_chat_app_history,node_chat_repos,node_chat_sessions toneAmber
class node_analytics_server,node_analytics_ui,node_analytics_reports,node_analytics_csv,node_analytics_daily,node_analytics_search,node_analytics_domain toneMint
class node_chat_member,node_analytics_user toneIndigo
```

## Components

### Pet companion

- [Pet console](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/main.rs): `pet_apps/pet_ui/src/main.rs`
- [Desktop bridge](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/bridge.rs): `pet_apps/pet_ui/src/bridge.rs`
- [Activity controls](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/control_activity.rs): `pet_apps/pet_ui/src/control_activity.rs`
- [Settings editor](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_ui/src/settings_editor.rs): `pet_apps/pet_ui/src/settings_editor.rs`
- [File management](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_server/src/file_browser.rs): `pet_apps/pet_server/src/file_browser.rs`
- [Pet lifecycle](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_application/src/lifecycle.rs): `pet_apps/pet_application/src/lifecycle.rs`
- [Pet state and profile](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_domain/src/profile.rs): `pet_apps/pet_domain/src/profile.rs`
- [Cleanup rules](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_domain/src/cleanup.rs): `pet_apps/pet_domain/src/cleanup.rs`
- [Pet persistence](https://github.com/williechen/rust_ai_ring/blob/main/pet_apps/pet_persistence/src/lib.rs): `pet_apps/pet_persistence/src/lib.rs`

### Chat service

- [Chat interface](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_ui/src/lib.rs): `chat_apps/chat_ui/src/lib.rs`
- [History request](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_ui/src/msg/msg2001/service.rs): `chat_apps/chat_ui/src/msg/msg2001/service.rs`
- [HTTP routing](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/http.rs): `chat_apps/chat_server/src/http.rs`
- [Session authentication](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/auth_session.rs): `chat_apps/chat_server/src/auth_session.rs`
- [Member self-service](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/member_self.rs): `chat_apps/chat_server/src/member_self.rs`
- [WebSocket messaging](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_server/src/ws.rs): `chat_apps/chat_server/src/ws.rs`
- [History application](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_application/src/msg/msg2001/service.rs): `chat_apps/chat_application/src/msg/msg2001/service.rs`
- [Chat repositories](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_application/src/repository.rs): `chat_apps/chat_application/src/repository.rs`
- [Session storage](https://github.com/williechen/rust_ai_ring/blob/main/chat_apps/chat_persistence/src/member_session.rs): `chat_apps/chat_persistence/src/member_session.rs`

### Analytics reporting

- [Analytics server](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_server/src/lib.rs): `analytics_apps/analytics_server/src/lib.rs`
- [Dashboard navigation](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_ui/src/navigation.rs): `analytics_apps/analytics_ui/src/navigation.rs`
- [Report workflows](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_application/src/daily_report.rs): `analytics_apps/analytics_application/src/daily_report.rs`
- [CSV export](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_application/src/report_csv.rs): `analytics_apps/analytics_application/src/report_csv.rs`
- [Daily report queries](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_persistence/src/daily_report.rs): `analytics_apps/analytics_persistence/src/daily_report.rs`
- [Search text handling](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_persistence/src/search_text.rs): `analytics_apps/analytics_persistence/src/search_text.rs`
- [Event and account rules](https://github.com/williechen/rust_ai_ring/blob/main/analytics_apps/analytics_domain/src/event_type.rs): `analytics_apps/analytics_domain/src/event_type.rs`

### Other components

- **Pet user**
- **Chat member**
- **Analyst**

## Connections

- Pet user → Pet console: uses (evidence: `pet_apps/pet_ui/src/main.rs`)
- Pet console → Desktop bridge: invokes (evidence: `pet_apps/pet_ui/src/main.rs`)
- Pet console → Activity controls: loads (evidence: `pet_apps/pet_ui/src/main.rs`)
- Pet console → Settings editor: loads (evidence: `pet_apps/pet_ui/src/main.rs`)
- Pet console → File management: loads (evidence: `pet_apps/pet_ui/src/main.rs`)
- Pet console → Pet lifecycle: creates pets (evidence: `pet_apps/pet_ui/src/main.rs`)
- Pet console → Pet state and profile: reads
- Activity controls → Pet state and profile: changes state
- Pet lifecycle → Pet persistence: persists pets
- Cleanup rules → Pet persistence: cleans records
- Chat member → Chat interface: uses
- Chat interface → History request: requests history
- History request → HTTP routing: fetches API (evidence: `chat_apps/chat_ui/src/msg/msg2001/service.rs`)
- Chat member → HTTP routing: sends requests
- HTTP routing → Session authentication: routes through (evidence: `chat_apps/chat_server/src/http.rs`)
- HTTP routing → Member self-service: routes through (evidence: `chat_apps/chat_server/src/http.rs`)
- HTTP routing → WebSocket messaging: routes through (evidence: `chat_apps/chat_server/src/http.rs`)
- Session authentication → Session storage: looks up sessions (evidence: `chat_apps/chat_server/src/auth_session.rs`)
- History application → Chat repositories: reads rooms and messages (evidence: `chat_apps/chat_application/src/msg/msg2001/service.rs`)
- Analyst → Dashboard navigation: views reports
- Dashboard navigation → Analytics server: requests views
- Analytics server → Report workflows: dispatches reports
- Report workflows → Daily report queries: queries daily data
- Report workflows → CSV export: formats export
- Daily report queries → Search text handling: uses pattern (evidence: `analytics_apps/analytics_persistence/src/daily_report.rs`)
- Analytics server → Event and account rules: validates events
