# nopleasenorbi/linksphere architecture

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

- Interactive diagram: https://gitdiagram.com/nopleasenorbi/linksphere
- Repository: https://github.com/nopleasenorbi/linksphere

## Overview

LinkSphere syncs Jira issues, users, and related Confluence pages into a Neo4j knowledge graph, then presents project- and user-focused interactive views. Users configure Atlassian credentials, select or refresh projects, and explore graph data through filters, search, and node details. The backend route/controller/model chain and Jira ingestion calls are visible in excerpts; several frontend-to-API links and documented graph interactions are based on the README because the relevant page request code was not excerpted.

Main entry points: [`frontend/src/App.js`](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/App.js) (App router), [`backend/controllers/jiraController.js`](https://github.com/nopleasenorbi/linksphere/blob/main/backend/controllers/jiraController.js) (Jira controller), [`backend/routes/jiraRoutes.js`](https://github.com/nopleasenorbi/linksphere/blob/main/backend/routes/jiraRoutes.js) (Jira routes), [`backend/routes/databaseRoutes.js`](https://github.com/nopleasenorbi/linksphere/blob/main/backend/routes/databaseRoutes.js) (Database routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_app["App router<br/>[App.js]"]
  node_nav["Navigation<br/>[NavigationBar.js]"]
  node_settings["Atlassian settings<br/>[Settings.js]"]
  node_projects["Project list<br/>[Projects.js]"]
  node_projectgraph["Project graph<br/>[Projectgraph.js]"]
  node_users["User list<br/>[Users.js]"]
  node_usergraph["User graph<br/>[UserGraph.js]"]
  node_info["Info pages"]
end

subgraph group_api["Backend API"]
  node_server["Express server<br/>[server.js]"]
  node_jiraroutes["Jira routes<br/>[jiraRoutes.js]"]
  node_dbroutes["Database routes<br/>[databaseRoutes.js]"]
  node_dbcontroller["Database controller"]
end

subgraph group_sync["Atlassian sync"]
  node_jiracontroller["Jira controller<br/>[jiraController.js]"]
  node_credentials[("Credential store<br/>[jiraCredentials.js]")]
  node_client["Atlassian client<br/>[atlassianClient.js]"]
  node_issuefetch["Issue fetcher"]
  node_confluencefetch["Page fetcher"]
  node_transform["Graph transformer"]
  node_postgres[("PostgreSQL")]
end

subgraph group_graph["Graph storage"]
  node_graphmodel["Graph queries and writes<br/>[graphModel.js]"]
  node_neo4j[("Neo4j graph store")]
end

node_user(("Team user"))
node_atlassian["Atlassian APIs"]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_nav
node_app -->|"routes to"| node_info
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_projects
node_app -->|"routes to"| node_projectgraph
node_app -->|"routes to"| node_users
node_app -->|"routes to"| node_usergraph
node_settings -.->|"configures via API"| node_jiraroutes
node_projects -.->|"loads projects"| node_jiraroutes
node_projects -.->|"requests refresh"| node_jiraroutes
node_projectgraph -.->|"loads graph data"| node_dbroutes
node_users -.->|"loads users"| node_dbroutes
node_usergraph -.->|"loads user graph"| node_dbroutes
node_server -->|"mounts"| node_jiraroutes
node_server -->|"mounts"| node_dbroutes
node_jiraroutes -->|"dispatches"| node_jiracontroller
node_dbroutes -->|"dispatches"| node_dbcontroller
node_jiracontroller -->|"reads and saves"| node_credentials
node_jiracontroller -->|"creates"| node_client
node_jiracontroller -->|"fetches issues"| node_issuefetch
node_jiracontroller -->|"fetches pages"| node_confluencefetch
node_jiracontroller -->|"transforms issues"| node_transform
node_jiracontroller -->|"saves graph"| node_graphmodel
node_dbcontroller -->|"queries graph"| node_graphmodel
node_client -.->|"sends requests"| node_atlassian
node_issuefetch -.->|"fetches issues"| node_atlassian
node_confluencefetch -.->|"fetches pages"| node_atlassian
node_credentials -.->|"persists credentials"| node_postgres
node_graphmodel -->|"reads and writes"| node_neo4j

click node_app "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/App.js"
click node_nav "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/components/NavigationBar.js"
click node_settings "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Settings.js"
click node_projects "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Projects.js"
click node_projectgraph "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Projectgraph.js"
click node_users "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Users.js"
click node_usergraph "https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/UserGraph.js"
click node_info "https://github.com/nopleasenorbi/linksphere/tree/main/frontend/src/pages"
click node_server "https://github.com/nopleasenorbi/linksphere/blob/main/backend/server.js"
click node_jiraroutes "https://github.com/nopleasenorbi/linksphere/blob/main/backend/routes/jiraRoutes.js"
click node_dbroutes "https://github.com/nopleasenorbi/linksphere/blob/main/backend/routes/databaseRoutes.js"
click node_jiracontroller "https://github.com/nopleasenorbi/linksphere/blob/main/backend/controllers/jiraController.js"
click node_dbcontroller "https://github.com/nopleasenorbi/linksphere/blob/main/backend/controllers/databaseController.js"
click node_credentials "https://github.com/nopleasenorbi/linksphere/blob/main/backend/models/jiraCredentials.js"
click node_client "https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/atlassianClient.js"
click node_issuefetch "https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/fetchAllProjectIssues.js"
click node_confluencefetch "https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/fetchConfluencePages.js"
click node_transform "https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/transformJiraDataToGraph.js"
click node_graphmodel "https://github.com/nopleasenorbi/linksphere/blob/main/backend/models/graphModel.js"

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_nav,node_settings,node_projects,node_projectgraph,node_users,node_usergraph,node_info,node_user toneBlue
class node_server,node_jiraroutes,node_dbroutes,node_dbcontroller toneAmber
class node_jiracontroller,node_credentials,node_client,node_issuefetch,node_confluencefetch,node_transform,node_postgres,node_atlassian toneMint
class node_graphmodel,node_neo4j toneRose
```

## Components

### Web interface

- [App router](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Navigation](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/components/NavigationBar.js): `frontend/src/components/NavigationBar.js`
- [Atlassian settings](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Settings.js): `frontend/src/pages/Settings.js`
- [Project list](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Projects.js): `frontend/src/pages/Projects.js`
- [Project graph](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Projectgraph.js): `frontend/src/pages/Projectgraph.js`
- [User list](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/Users.js): `frontend/src/pages/Users.js`
- [User graph](https://github.com/nopleasenorbi/linksphere/blob/main/frontend/src/pages/UserGraph.js): `frontend/src/pages/UserGraph.js`
- [Info pages](https://github.com/nopleasenorbi/linksphere/tree/main/frontend/src/pages): `frontend/src/pages`

### Backend API

- [Express server](https://github.com/nopleasenorbi/linksphere/blob/main/backend/server.js): `backend/server.js`
- [Jira routes](https://github.com/nopleasenorbi/linksphere/blob/main/backend/routes/jiraRoutes.js): `backend/routes/jiraRoutes.js`
- [Database routes](https://github.com/nopleasenorbi/linksphere/blob/main/backend/routes/databaseRoutes.js): `backend/routes/databaseRoutes.js`
- [Database controller](https://github.com/nopleasenorbi/linksphere/blob/main/backend/controllers/databaseController.js): `backend/controllers/databaseController.js`

### Atlassian sync

- [Jira controller](https://github.com/nopleasenorbi/linksphere/blob/main/backend/controllers/jiraController.js): `backend/controllers/jiraController.js`
- [Credential store](https://github.com/nopleasenorbi/linksphere/blob/main/backend/models/jiraCredentials.js): `backend/models/jiraCredentials.js`
- [Atlassian client](https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/atlassianClient.js): `backend/utils/atlassianClient.js`
- [Issue fetcher](https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/fetchAllProjectIssues.js): `backend/utils/fetchAllProjectIssues.js`
- [Page fetcher](https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/fetchConfluencePages.js): `backend/utils/fetchConfluencePages.js`
- [Graph transformer](https://github.com/nopleasenorbi/linksphere/blob/main/backend/utils/transformJiraDataToGraph.js): `backend/utils/transformJiraDataToGraph.js`
- **PostgreSQL**

### Graph storage

- [Graph queries and writes](https://github.com/nopleasenorbi/linksphere/blob/main/backend/models/graphModel.js): `backend/models/graphModel.js`
- **Neo4j graph store**

### Other components

- **Team user**
- **Atlassian APIs**

## Connections

- Team user → App router: uses (evidence: `README.md`)
- App router → Navigation: renders (evidence: `frontend/src/App.js`)
- App router → Info pages: routes to (evidence: `frontend/src/App.js`)
- App router → Atlassian settings: routes to (evidence: `frontend/src/App.js`)
- App router → Project list: routes to (evidence: `frontend/src/App.js`)
- App router → Project graph: routes to (evidence: `frontend/src/App.js`)
- App router → User list: routes to (evidence: `frontend/src/App.js`)
- App router → User graph: routes to (evidence: `frontend/src/App.js`)
- Atlassian settings → Jira routes: configures via API (evidence: `README.md`)
- Project list → Jira routes: loads projects (evidence: `README.md`)
- Project list → Jira routes: requests refresh (evidence: `README.md`)
- Project graph → Database routes: loads graph data (evidence: `README.md`)
- User list → Database routes: loads users (evidence: `README.md`)
- User graph → Database routes: loads user graph (evidence: `README.md`)
- Express server → Jira routes: mounts (evidence: `backend/server.js`)
- Express server → Database routes: mounts (evidence: `backend/server.js`)
- Jira routes → Jira controller: dispatches (evidence: `backend/routes/jiraRoutes.js`)
- Database routes → Database controller: dispatches (evidence: `backend/routes/databaseRoutes.js`)
- Jira controller → Credential store: reads and saves (evidence: `backend/controllers/jiraController.js`)
- Jira controller → Atlassian client: creates (evidence: `backend/controllers/jiraController.js`)
- Jira controller → Issue fetcher: fetches issues (evidence: `backend/controllers/jiraController.js`)
- Jira controller → Page fetcher: fetches pages (evidence: `backend/controllers/jiraController.js`)
- Jira controller → Graph transformer: transforms issues (evidence: `backend/controllers/jiraController.js`)
- Jira controller → Graph queries and writes: saves graph (evidence: `backend/controllers/jiraController.js`)
- Database controller → Graph queries and writes: queries graph (evidence: `backend/controllers/databaseController.js`)
- Atlassian client → Atlassian APIs: sends requests
- Issue fetcher → Atlassian APIs: fetches issues
- Page fetcher → Atlassian APIs: fetches pages
- Credential store → PostgreSQL: persists credentials
- Graph queries and writes → Neo4j graph store: reads and writes (evidence: `README.md`)
