# oracle/weblogic-remote-console architecture

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

- Interactive diagram: https://gitdiagram.com/oracle/weblogic-remote-console
- Repository: https://github.com/oracle/weblogic-remote-console

## Overview

WebLogic Remote Console is a desktop/web administration GUI for remote WebLogic domains. Users launch the console, select or configure a domain connection, then browse resources and perform configuration, deployment, lifecycle, and monitoring work through REST-backed management pages. The map separates Electron desktop support, the React console, backend connection/project handling, and repository-driven management definitions. README documents the product workflow and capabilities; source excerpts and the source index support only selected internal calls, so unverified cross-layer links are dashed.

Main entry points: [`electron/app/main.js`](https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/main.js) (Desktop Launcher), [`frontend/src/components/app.tsx`](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/components/app.tsx) (Console Application), [`frontend/src/wrc/resource/resource.tsx`](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/resource.tsx) (Resource Pages), [`server/src/main/java/weblogic/remoteconsole/server/providers/ProjectManager.java`](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/providers/ProjectManager.java) (Project Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Runtime"]
  node_electron["Desktop Launcher<br/>[main.js]"]
  node_window["Window Management"]
  node_preferences["User Preferences<br/>[user-prefs-json.js]"]
  node_logging["Desktop Logging<br/>[console-logger.js]"]
end

subgraph group_ui["Console Interface"]
  node_frontend["Console Application<br/>[app.tsx]"]
  node_nav["Resource Navigation<br/>[nav-tree.tsx]"]
  node_resource["Resource Pages<br/>[resource.tsx]"]
  node_forms["Configuration Forms<br/>[form.tsx]"]
  node_tables["Resource Tables<br/>[tablebuilder.tsx]"]
  node_integration["Data Integration<br/>[databus.ts]"]
end

subgraph group_backend["Backend Services"]
  node_project["Project Management"]
  node_connections["Domain Connections"]
  node_restclient["WebLogic REST Client"]
  node_persistence[("Feature Persistence")]
end

subgraph group_domain["Management Domain"]
  node_definitions["Management Definitions"]
  node_dashboard["Filtering Dashboards"]
  node_changes["Change Operations"]
  node_capabilities["Admin Capabilities"]
end

node_operator(("Administrator"))
node_weblogic{{"WebLogic Domain"}}

node_operator -->|"launches"| node_electron
node_operator -->|"uses console"| node_frontend
node_electron -->|"reads preferences"| node_preferences
node_electron -->|"logs through"| node_logging
node_electron -->|"manages windows"| node_window
node_frontend -->|"renders"| node_nav
node_nav -.->|"opens resources"| node_resource
node_resource -.->|"renders forms"| node_forms
node_resource -.->|"renders tables"| node_tables
node_frontend -.->|"uses data bus"| node_integration
node_frontend -.->|"manages projects"| node_project
node_project -->|"persists project data"| node_persistence
node_project -.->|"configures providers"| node_connections
node_connections -->|"issues REST requests"| node_restclient
node_connections -->|"connects to domain"| node_weblogic
node_resource -.->|"manages via REST"| node_weblogic
node_definitions -.->|"defines pages"| node_capabilities
node_dashboard -->|"customizes page definitions"| node_definitions
node_changes -->|"handles change actions"| node_capabilities
node_operator -->|"configures and monitors"| node_capabilities

click node_electron "https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/main.js"
click node_window "https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/js/window-management.js"
click node_preferences "https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/js/user-prefs-json.js"
click node_logging "https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/js/console-logger.js"
click node_frontend "https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/components/app.tsx"
click node_nav "https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/nav-tree/nav-tree.tsx"
click node_resource "https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/resource.tsx"
click node_forms "https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/form/form.tsx"
click node_tables "https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/table/tablebuilder.tsx"
click node_integration "https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/integration/databus.ts"
click node_project "https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/providers/ProjectManager.java"
click node_connections "https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/connection/ConnectionManager.java"
click node_restclient "https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/utils/WebLogicRestClient.java"
click node_definitions "https://github.com/oracle/weblogic-remote-console/tree/main/server/src/main/java/weblogic/remoteconsole/common/repodef"
click node_dashboard "https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/repo/FilteringDashboardDefManager.java"
click node_changes "https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/webapp/ChangeManagerResource.java"
click node_persistence "https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/PersistenceManager.java"
click node_capabilities "https://github.com/oracle/weblogic-remote-console/tree/main/server/src/main/java/weblogic/remoteconsole/server"

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_electron,node_window,node_preferences,node_logging toneBlue
class node_frontend,node_nav,node_resource,node_forms,node_tables,node_integration toneAmber
class node_project,node_connections,node_restclient,node_persistence toneMint
class node_definitions,node_dashboard,node_changes,node_capabilities toneRose
class node_operator,node_weblogic toneIndigo
```

## Components

### Desktop Runtime

- [Desktop Launcher](https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/main.js): `electron/app/main.js`
- [Window Management](https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/js/window-management.js): `electron/app/js/window-management.js`
- [User Preferences](https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/js/user-prefs-json.js): `electron/app/js/user-prefs-json.js`
- [Desktop Logging](https://github.com/oracle/weblogic-remote-console/blob/main/electron/app/js/console-logger.js): `electron/app/js/console-logger.js`

### Console Interface

- [Console Application](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/components/app.tsx): `frontend/src/components/app.tsx`
- [Resource Navigation](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/nav-tree/nav-tree.tsx): `frontend/src/wrc/nav-tree/nav-tree.tsx`
- [Resource Pages](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/resource.tsx): `frontend/src/wrc/resource/resource.tsx`
- [Configuration Forms](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/form/form.tsx): `frontend/src/wrc/resource/form/form.tsx`
- [Resource Tables](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/resource/table/tablebuilder.tsx): `frontend/src/wrc/resource/table/tablebuilder.tsx`
- [Data Integration](https://github.com/oracle/weblogic-remote-console/blob/main/frontend/src/wrc/integration/databus.ts): `frontend/src/wrc/integration/databus.ts`

### Backend Services

- [Project Management](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/providers/ProjectManager.java): `server/src/main/java/weblogic/remoteconsole/server/providers/ProjectManager.java`
- [Domain Connections](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/connection/ConnectionManager.java): `server/src/main/java/weblogic/remoteconsole/server/connection/ConnectionManager.java`
- [WebLogic REST Client](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/utils/WebLogicRestClient.java): `server/src/main/java/weblogic/remoteconsole/server/utils/WebLogicRestClient.java`
- [Feature Persistence](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/PersistenceManager.java): `server/src/main/java/weblogic/remoteconsole/server/PersistenceManager.java`

### Management Domain

- [Management Definitions](https://github.com/oracle/weblogic-remote-console/tree/main/server/src/main/java/weblogic/remoteconsole/common/repodef): `server/src/main/java/weblogic/remoteconsole/common/repodef`
- [Filtering Dashboards](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/repo/FilteringDashboardDefManager.java): `server/src/main/java/weblogic/remoteconsole/server/repo/FilteringDashboardDefManager.java`
- [Change Operations](https://github.com/oracle/weblogic-remote-console/blob/main/server/src/main/java/weblogic/remoteconsole/server/webapp/ChangeManagerResource.java): `server/src/main/java/weblogic/remoteconsole/server/webapp/ChangeManagerResource.java`
- [Admin Capabilities](https://github.com/oracle/weblogic-remote-console/tree/main/server/src/main/java/weblogic/remoteconsole/server): `server/src/main/java/weblogic/remoteconsole/server`

### Other components

- **Administrator**
- **WebLogic Domain**

## Connections

- Administrator → Desktop Launcher: launches
- Administrator → Console Application: uses console
- Desktop Launcher → User Preferences: reads preferences (evidence: `electron/app/main.js`)
- Desktop Launcher → Desktop Logging: logs through (evidence: `electron/app/main.js`)
- Desktop Launcher → Window Management: manages windows (evidence: `electron/app/main.js`)
- Console Application → Resource Navigation: renders (evidence: `frontend/src/components/app.tsx`)
- Resource Navigation → Resource Pages: opens resources
- Resource Pages → Configuration Forms: renders forms
- Resource Pages → Resource Tables: renders tables
- Console Application → Data Integration: uses data bus
- Console Application → Project Management: manages projects
- Project Management → Feature Persistence: persists project data (evidence: `server/src/main/java/weblogic/remoteconsole/server/providers/ProjectManager.java`)
- Project Management → Domain Connections: configures providers
- Domain Connections → WebLogic REST Client: issues REST requests (evidence: `server/src/main/java/weblogic/remoteconsole/server/connection/ConnectionManager.java`)
- Domain Connections → WebLogic Domain: connects to domain
- Resource Pages → WebLogic Domain: manages via REST
- Management Definitions → Admin Capabilities: defines pages (evidence: `server/src/main/java/weblogic/remoteconsole/common/repodef/LocalizedConstants.java`)
- Filtering Dashboards → Management Definitions: customizes page definitions (evidence: `server/src/main/java/weblogic/remoteconsole/server/repo/FilteringDashboardDefManager.java`)
- Change Operations → Admin Capabilities: handles change actions (evidence: `server/src/main/java/weblogic/remoteconsole/server/webapp/ChangeManagerResource.java`)
- Administrator → Admin Capabilities: configures and monitors
