# roshan-shadow/project_manerge_system architecture

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

## Overview

This is an Electron desktop project-management cockpit. Users create or select a project, then manage its schedule, requirements, defects, and templates; the dashboard and home views summarize project progress. The renderer talks through a preload bridge to a main-process in-memory data store, with shared operations supporting project creation and snapshots. Desktop-only workspace, repository, and import/export features complement the core workflow. Relationships for unsampled capabilities are included only where the README documents them; source excerpts do not expose every dispatch or IPC handler.

Main entry points: [`src/renderer/core/app.ts`](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/app.ts) (App coordinator), [`src/renderer/core/store.ts`](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/store.ts) (Store API), [`src/main/store.ts`](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/store.ts) (IPC handlers), [`src/shared/storeOps.ts`](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/storeOps.ts) (Domain operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_renderer["Renderer experience"]
  node_app["App coordinator<br/>[app.ts]"]
  node_state["Renderer state<br/>[state.ts]"]
  node_rendererstore["Store API<br/>[store.ts]"]
  node_theme["Theme system<br/>[theme.ts]"]
end

subgraph group_domain["Project workflows"]
  node_home["Project home<br/>[home.ts]"]
  node_dashboard["Dashboard<br/>[dashboard.ts]"]
  node_gantt["Gantt schedule<br/>[gantt.ts]"]
  node_plan["Plan management<br/>[plan.ts]"]
  node_requirements["Requirements<br/>[requirement.ts]"]
  node_bugs["Defect tracking<br/>[bug.ts]"]
  node_templates["Template center<br/>[template.ts]"]
  node_mainpage["Main page<br/>[mainpage.ts]"]
end

subgraph group_bridge["Electron bridge"]
  node_preload["Preload bridge<br/>[preload.ts]"]
  node_main["IPC handlers<br/>[store.ts]"]
  node_memory[("Memory database<br/>[store.ts]")]
end

subgraph group_shared["Shared domain"]
  node_ops["Domain operations<br/>[storeOps.ts]"]
  node_channels["IPC channels<br/>[channels.ts]"]
  node_builtin["Built-in templates<br/>[builtin.ts]"]
end

subgraph group_workspace["Workspace services"]
  node_repo["Project repositories<br/>[repo.ts]"]
  node_settings["Workspace settings<br/>[settings.ts]"]
end

node_user(("Project user"))
node_filesystem[("Workspace files")]

node_user -->|"uses"| node_app
node_app -->|"routes"| node_home
node_app -->|"routes"| node_dashboard
node_app -->|"routes"| node_gantt
node_app -->|"routes"| node_plan
node_app -->|"routes"| node_requirements
node_app -->|"routes"| node_bugs
node_app -->|"routes"| node_templates
node_app -->|"routes"| node_mainpage
node_app -->|"refreshes"| node_state
node_app -->|"initializes"| node_theme
node_home -->|"loads data"| node_rendererstore
node_dashboard -->|"loads data"| node_rendererstore
node_gantt -->|"loads data"| node_rendererstore
node_plan -->|"manages records"| node_rendererstore
node_requirements -->|"manages records"| node_rendererstore
node_bugs -->|"manages records"| node_rendererstore
node_templates -->|"manages templates"| node_rendererstore
node_mainpage -->|"loads data"| node_rendererstore
node_rendererstore -->|"reloads"| node_state
node_rendererstore -->|"invokes API"| node_preload
node_preload -->|"forwards IPC"| node_main
node_main -->|"reads and writes"| node_memory
node_main -->|"uses"| node_channels
node_main -->|"delegates"| node_ops
node_ops -->|"builds from"| node_builtin
node_main -->|"delegates"| node_repo
node_main -->|"delegates"| node_settings
node_repo -->|"reads and writes"| node_filesystem
node_settings -->|"persists settings"| node_filesystem
node_repo -->|"uses archive operations"| node_ops
node_settings -->|"restores data"| node_ops

click node_app "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/app.ts"
click node_home "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/home.ts"
click node_dashboard "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/dashboard.ts"
click node_gantt "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/gantt.ts"
click node_plan "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/plan.ts"
click node_requirements "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/requirement.ts"
click node_bugs "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/bug.ts"
click node_templates "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/template.ts"
click node_mainpage "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/mainpage.ts"
click node_state "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/state.ts"
click node_rendererstore "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/store.ts"
click node_theme "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/theme.ts"
click node_preload "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/preload/preload.ts"
click node_main "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/store.ts"
click node_memory "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/store.ts"
click node_ops "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/storeOps.ts"
click node_channels "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/channels.ts"
click node_builtin "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/builtin.ts"
click node_repo "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/repo.ts"
click node_settings "https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/settings.ts"

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_state,node_rendererstore,node_theme,node_user toneBlue
class node_home,node_dashboard,node_gantt,node_plan,node_requirements,node_bugs,node_templates,node_mainpage,node_filesystem toneAmber
class node_preload,node_main,node_memory toneMint
class node_ops,node_channels,node_builtin toneRose
class node_repo,node_settings toneIndigo
```

## Components

### Renderer experience

- [App coordinator](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/app.ts): `src/renderer/core/app.ts`
- [Renderer state](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/state.ts): `src/renderer/core/state.ts`
- [Store API](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/store.ts): `src/renderer/core/store.ts`
- [Theme system](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/core/theme.ts): `src/renderer/core/theme.ts`

### Project workflows

- [Project home](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/home.ts): `src/renderer/modules/home.ts`
- [Dashboard](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/dashboard.ts): `src/renderer/modules/dashboard.ts`
- [Gantt schedule](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/gantt.ts): `src/renderer/modules/gantt.ts`
- [Plan management](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/plan.ts): `src/renderer/modules/plan.ts`
- [Requirements](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/requirement.ts): `src/renderer/modules/requirement.ts`
- [Defect tracking](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/bug.ts): `src/renderer/modules/bug.ts`
- [Template center](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/template.ts): `src/renderer/modules/template.ts`
- [Main page](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/renderer/modules/mainpage.ts): `src/renderer/modules/mainpage.ts`

### Electron bridge

- [Preload bridge](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/preload/preload.ts): `src/preload/preload.ts`
- [IPC handlers](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/store.ts): `src/main/store.ts`
- [Memory database](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/store.ts): `src/main/store.ts`

### Shared domain

- [Domain operations](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/storeOps.ts): `src/shared/storeOps.ts`
- [IPC channels](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/channels.ts): `src/shared/channels.ts`
- [Built-in templates](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/shared/builtin.ts): `src/shared/builtin.ts`

### Workspace services

- [Project repositories](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/repo.ts): `src/main/repo.ts`
- [Workspace settings](https://github.com/roshan-shadow/project_manerge_system/blob/main/src/main/settings.ts): `src/main/settings.ts`

### Other components

- **Project user**
- **Workspace files**

## Connections

- Project user → App coordinator: uses (evidence: `README.md`)
- App coordinator → Project home: routes (evidence: `src/renderer/core/app.ts`)
- App coordinator → Dashboard: routes (evidence: `src/renderer/core/app.ts`)
- App coordinator → Gantt schedule: routes (evidence: `README.md`)
- App coordinator → Plan management: routes (evidence: `README.md`)
- App coordinator → Requirements: routes (evidence: `README.md`)
- App coordinator → Defect tracking: routes (evidence: `README.md`)
- App coordinator → Template center: routes (evidence: `README.md`)
- App coordinator → Main page: routes (evidence: `src/renderer/core/app.ts`)
- App coordinator → Renderer state: refreshes (evidence: `src/renderer/core/app.ts`)
- App coordinator → Theme system: initializes (evidence: `README.md`)
- Project home → Store API: loads data (evidence: `src/renderer/modules/home.ts`)
- Dashboard → Store API: loads data (evidence: `src/renderer/modules/dashboard.ts`)
- Gantt schedule → Store API: loads data (evidence: `src/renderer/modules/gantt.ts`)
- Plan management → Store API: manages records (evidence: `src/renderer/modules/plan.ts`)
- Requirements → Store API: manages records (evidence: `src/renderer/modules/requirement.ts`)
- Defect tracking → Store API: manages records (evidence: `src/renderer/modules/bug.ts`)
- Template center → Store API: manages templates (evidence: `src/renderer/modules/template.ts`)
- Main page → Store API: loads data (evidence: `src/renderer/modules/mainpage.ts`)
- Store API → Renderer state: reloads (evidence: `src/renderer/core/state.ts`)
- Store API → Preload bridge: invokes API (evidence: `README.md`)
- Preload bridge → IPC handlers: forwards IPC (evidence: `README.md`)
- IPC handlers → Memory database: reads and writes (evidence: `README.md`)
- IPC handlers → IPC channels: uses (evidence: `src/main/store.ts`)
- IPC handlers → Domain operations: delegates (evidence: `src/main/store.ts`)
- Domain operations → Built-in templates: builds from (evidence: `src/shared/storeOps.ts`)
- IPC handlers → Project repositories: delegates (evidence: `src/main/store.ts`)
- IPC handlers → Workspace settings: delegates (evidence: `src/main/store.ts`)
- Project repositories → Workspace files: reads and writes (evidence: `src/main/repo.ts`)
- Workspace settings → Workspace files: persists settings (evidence: `src/main/settings.ts`)
- Project repositories → Domain operations: uses archive operations (evidence: `src/main/repo.ts`)
- Workspace settings → Domain operations: restores data (evidence: `src/main/settings.ts`)
