# eduardolsoares/weaver architecture

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

- Interactive diagram: https://gitdiagram.com/eduardolsoares/weaver
- Repository: https://github.com/eduardolsoares/weaver

## Overview

Weaver is a cross-platform Compose app for signing in, managing database-design projects, and editing a visual schema graph that can be generated as SQL. The desktop entry point restores credentials and supplies authentication and project operations to the shared app; users then move from login to project management and into the graph editor. The README confirms Web and Desktop targets. Graph-editor model relationships are supported by the SOURCE INDEX, but unsampled project, screen, and use-case implementations are represented only where their wiring is visible.

Main entry points: [`shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt) (Graph state), [`desktopApp/src/main/kotlin/ceub/weaver/main.kt`](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/main.kt) (Desktop entry), [`shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt`](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt) (Graph node), [`shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt`](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt) (Graph canvas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App flow"]
  node_desktop["Desktop entry<br/>[main.kt]"]
  node_web["Web entry<br/>[main.kt]"]
  node_app["App routing<br/>[App.kt]"]
end

subgraph group_auth["Authentication"]
  node_login["Login screen<br/>[LoginScreen.kt]"]
  node_googleauth["Google auth flow<br/>[GoogleAuth.kt]"]
  node_usecase["Google login use case"]
  node_authrepo["Auth repository"]
  node_oauth["OAuth client"]
  node_tokenstore[("Token storage<br/>[TokenStorage.kt]")]
end

subgraph group_projects["Project management"]
  node_mainui["Project screen<br/>[MainScreen.kt]"]
  node_projectapi["Project API"]
end

subgraph group_editor["Schema editor"]
  node_home["Home screen<br/>[HomeScreen.kt]"]
  node_jvmhome["Desktop editor view<br/>[HomeScreen.jvm.kt]"]
  node_parser["SQL generator<br/>[NodeParser.kt]"]
end

subgraph group_graph["Graph engine"]
  node_graphui["Graph canvas<br/>[NodeGraph.kt]"]
  node_graphmodel["Graph state<br/>[Graph.kt]"]
  node_node["Graph node<br/>[Node.kt]"]
  node_definition["Node definition<br/>[NodeDefinition.kt]"]
  node_connection["Graph connection<br/>[Connection.kt]"]
  node_ports["Port definitions<br/>[PortDefinition.kt]"]
  node_portkind["Port kinds<br/>[PortKind.kt]"]
  node_events["Graph events<br/>[GraphEvent.kt]"]
  node_properties["Property definitions"]
  node_stringprop["String property<br/>[StringProperty.kt]"]
end

node_user(("User"))
node_google["Google OAuth"]
node_backend["Project backend"]

node_user -->|"launches"| node_desktop
node_user -.->|"opens"| node_web
node_desktop -->|"renders"| node_app
node_web -->|"renders"| node_app
node_app -->|"shows"| node_login
node_app -->|"shows"| node_mainui
node_app -->|"shows"| node_home
node_desktop -->|"loads and clears"| node_tokenstore
node_desktop -->|"invokes project operations"| node_projectapi
node_desktop -->|"configures"| node_oauth
node_desktop -->|"starts login flow"| node_googleauth
node_googleauth -->|"uses"| node_usecase
node_authrepo -->|"uses"| node_tokenstore
node_authrepo -->|"uses"| node_oauth
node_oauth -->|"requests tokens"| node_google
node_mainui -->|"receives operations"| node_projectapi
node_projectapi -.->|"requests project data"| node_backend
node_home -->|"uses platform view"| node_jvmhome
node_jvmhome -->|"renders and edits"| node_graphui
node_jvmhome -->|"generates SQL"| node_parser
node_parser -->|"reads graph"| node_graphmodel
node_parser -->|"reads links"| node_connection
node_parser -->|"reads nodes"| node_node
node_graphui -->|"updates"| node_graphmodel
node_graphui -->|"handles"| node_events
node_graphui -->|"renders"| node_node
node_graphmodel -->|"creates and stores"| node_node
node_graphmodel -->|"stores links"| node_connection
node_graphmodel -->|"emits"| node_events
node_graphmodel -->|"uses"| node_definition
node_graphmodel -->|"validates"| node_ports
node_node -->|"uses"| node_definition
node_node -->|"exposes links"| node_connection
node_node -->|"validates values"| node_properties
node_definition -->|"declares"| node_ports
node_ports -->|"specifies direction"| node_portkind
node_definition -->|"declares"| node_properties
node_graphui -->|"supports"| node_stringprop
node_stringprop -.->|"implements"| node_properties

click node_desktop "https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/main.kt"
click node_web "https://github.com/eduardolsoares/weaver/blob/main/webApp/src/webMain/kotlin/ceub/weaver/main.kt"
click node_app "https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/App.kt"
click node_login "https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/LoginScreen.kt"
click node_googleauth "https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/GoogleAuth.kt"
click node_usecase "https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/domain/usecase/GoogleLoginUseCase.kt"
click node_authrepo "https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/repository/GoogleAuthRepositoryImpl.kt"
click node_oauth "https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/remote/GoogleOAuthClient.kt"
click node_tokenstore "https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/local/TokenStorage.kt"
click node_mainui "https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/ui/mainScreen/MainScreen.kt"
click node_projectapi "https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/remote/ProjectApiService.kt"
click node_home "https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/HomeScreen.kt"
click node_jvmhome "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/ceub/weaver/HomeScreen.jvm.kt"
click node_parser "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/ceub/weaver/NodeParser.kt"
click node_graphui "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt"
click node_graphmodel "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt"
click node_node "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt"
click node_definition "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/NodeDefinition.kt"
click node_connection "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Connection.kt"
click node_ports "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortDefinition.kt"
click node_portkind "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortKind.kt"
click node_events "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/GraphEvent.kt"
click node_properties "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/PropertyDefinition.kt"
click node_stringprop "https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/StringProperty.kt"

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_desktop,node_web,node_app,node_user toneBlue
class node_login,node_googleauth,node_usecase,node_authrepo,node_oauth,node_tokenstore toneAmber
class node_mainui,node_projectapi toneMint
class node_home,node_jvmhome,node_parser toneRose
class node_graphui,node_graphmodel,node_node,node_definition,node_connection,node_ports,node_portkind,node_events,node_properties,node_stringprop,node_google,node_backend toneIndigo
```

## Components

### App flow

- [Desktop entry](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/main.kt): `desktopApp/src/main/kotlin/ceub/weaver/main.kt`
- [Web entry](https://github.com/eduardolsoares/weaver/blob/main/webApp/src/webMain/kotlin/ceub/weaver/main.kt): `webApp/src/webMain/kotlin/ceub/weaver/main.kt`
- [App routing](https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/App.kt): `shared/src/commonMain/kotlin/ceub/weaver/App.kt`

### Authentication

- [Login screen](https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/LoginScreen.kt): `shared/src/commonMain/kotlin/ceub/weaver/LoginScreen.kt`
- [Google auth flow](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/GoogleAuth.kt): `desktopApp/src/main/kotlin/ceub/weaver/GoogleAuth.kt`
- [Google login use case](https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/domain/usecase/GoogleLoginUseCase.kt): `shared/src/commonMain/kotlin/ceub/weaver/domain/usecase/GoogleLoginUseCase.kt`
- [Auth repository](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/repository/GoogleAuthRepositoryImpl.kt): `desktopApp/src/main/kotlin/ceub/weaver/data/repository/GoogleAuthRepositoryImpl.kt`
- [OAuth client](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/remote/GoogleOAuthClient.kt): `desktopApp/src/main/kotlin/ceub/weaver/data/remote/GoogleOAuthClient.kt`
- [Token storage](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/local/TokenStorage.kt): `desktopApp/src/main/kotlin/ceub/weaver/data/local/TokenStorage.kt`

### Project management

- [Project screen](https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/ui/mainScreen/MainScreen.kt): `shared/src/commonMain/kotlin/ceub/weaver/ui/mainScreen/MainScreen.kt`
- [Project API](https://github.com/eduardolsoares/weaver/blob/main/desktopApp/src/main/kotlin/ceub/weaver/data/remote/ProjectApiService.kt): `desktopApp/src/main/kotlin/ceub/weaver/data/remote/ProjectApiService.kt`

### Schema editor

- [Home screen](https://github.com/eduardolsoares/weaver/blob/main/shared/src/commonMain/kotlin/ceub/weaver/HomeScreen.kt): `shared/src/commonMain/kotlin/ceub/weaver/HomeScreen.kt`
- [Desktop editor view](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/ceub/weaver/HomeScreen.jvm.kt): `shared/src/jvmMain/kotlin/ceub/weaver/HomeScreen.jvm.kt`
- [SQL generator](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/ceub/weaver/NodeParser.kt): `shared/src/jvmMain/kotlin/ceub/weaver/NodeParser.kt`

### Graph engine

- [Graph canvas](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt`
- [Graph state](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`
- [Graph node](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt`
- [Node definition](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/NodeDefinition.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/NodeDefinition.kt`
- [Graph connection](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Connection.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Connection.kt`
- [Port definitions](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortDefinition.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortDefinition.kt`
- [Port kinds](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortKind.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortKind.kt`
- [Graph events](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/GraphEvent.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/GraphEvent.kt`
- [Property definitions](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/PropertyDefinition.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/PropertyDefinition.kt`
- [String property](https://github.com/eduardolsoares/weaver/blob/main/shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/StringProperty.kt): `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/StringProperty.kt`

### Other components

- **User**
- **Google OAuth**
- **Project backend**

## Connections

- User → Desktop entry: launches (evidence: `desktopApp/src/main/kotlin/ceub/weaver/main.kt`)
- User → Web entry: opens (evidence: `README.md`)
- Desktop entry → App routing: renders (evidence: `desktopApp/src/main/kotlin/ceub/weaver/main.kt`)
- Web entry → App routing: renders (evidence: `webApp/src/webMain/kotlin/ceub/weaver/main.kt`)
- App routing → Login screen: shows (evidence: `shared/src/commonMain/kotlin/ceub/weaver/App.kt`)
- App routing → Project screen: shows (evidence: `shared/src/commonMain/kotlin/ceub/weaver/App.kt`)
- App routing → Home screen: shows (evidence: `shared/src/commonMain/kotlin/ceub/weaver/App.kt`)
- Desktop entry → Token storage: loads and clears (evidence: `desktopApp/src/main/kotlin/ceub/weaver/main.kt`)
- Desktop entry → Project API: invokes project operations (evidence: `desktopApp/src/main/kotlin/ceub/weaver/main.kt`)
- Desktop entry → OAuth client: configures (evidence: `desktopApp/src/main/kotlin/ceub/weaver/main.kt`)
- Desktop entry → Google auth flow: starts login flow (evidence: `desktopApp/src/main/kotlin/ceub/weaver/main.kt`)
- Google auth flow → Google login use case: uses (evidence: `desktopApp/src/main/kotlin/ceub/weaver/GoogleAuth.kt`)
- Auth repository → Token storage: uses (evidence: `desktopApp/src/main/kotlin/ceub/weaver/data/repository/GoogleAuthRepositoryImpl.kt`)
- Auth repository → OAuth client: uses (evidence: `desktopApp/src/main/kotlin/ceub/weaver/data/repository/GoogleAuthRepositoryImpl.kt`)
- OAuth client → Google OAuth: requests tokens (evidence: `desktopApp/src/main/kotlin/ceub/weaver/data/remote/GoogleOAuthClient.kt`)
- Project screen → Project API: receives operations
- Project API → Project backend: requests project data
- Home screen → Desktop editor view: uses platform view (evidence: `shared/src/jvmMain/kotlin/ceub/weaver/HomeScreen.jvm.kt`)
- Desktop editor view → Graph canvas: renders and edits (evidence: `shared/src/jvmMain/kotlin/ceub/weaver/HomeScreen.jvm.kt`)
- Desktop editor view → SQL generator: generates SQL (evidence: `shared/src/jvmMain/kotlin/ceub/weaver/HomeScreen.jvm.kt`)
- SQL generator → Graph state: reads graph (evidence: `shared/src/jvmMain/kotlin/ceub/weaver/NodeParser.kt`)
- SQL generator → Graph connection: reads links (evidence: `shared/src/jvmMain/kotlin/ceub/weaver/NodeParser.kt`)
- SQL generator → Graph node: reads nodes (evidence: `shared/src/jvmMain/kotlin/ceub/weaver/NodeParser.kt`)
- Graph canvas → Graph state: updates (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt`)
- Graph canvas → Graph events: handles (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt`)
- Graph canvas → Graph node: renders (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt`)
- Graph state → Graph node: creates and stores (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`)
- Graph state → Graph connection: stores links (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`)
- Graph state → Graph events: emits (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`)
- Graph state → Node definition: uses (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`)
- Graph state → Port definitions: validates (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Graph.kt`)
- Graph node → Node definition: uses (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt`)
- Graph node → Graph connection: exposes links (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt`)
- Graph node → Property definitions: validates values (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/Node.kt`)
- Node definition → Port definitions: declares (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/NodeDefinition.kt`)
- Port definitions → Port kinds: specifies direction (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/PortDefinition.kt`)
- Node definition → Property definitions: declares (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/NodeDefinition.kt`)
- Graph canvas → String property: supports (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/compose/NodeGraph.kt`)
- String property → Property definitions: implements (evidence: `shared/src/jvmMain/kotlin/com/martmists/compose/grapheditor/data/property/StringProperty.kt`)
