# mmrnayan/jssdm-app architecture

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

- Interactive diagram: https://gitdiagram.com/mmrnayan/jssdm-app
- Repository: https://github.com/mmrnayan/jssdm-app

## Overview

The documented primary product is JSSDM Staff Suite: staff writers use a cross-platform writing assistant for compliant service documents. The README describes editing, rule enforcement, templates, references, offline storage, and bilingual writing, but the tree contains no Dart application sources, so those runtime relationships are documented capabilities rather than inspected implementation flows. The repository also contains a separate abbreviation-converter app; its review component and API interactions are visible in the supplied excerpt. Native launchers are sampled, but do not expose the Flutter product internals.

Main entry points: [`jssdm_app`](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app) (Flutter staff suite), [`abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx`](https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx) (Correction review), [`jssdm_app/windows/runner/win32_window.cpp`](https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/windows/runner/win32_window.cpp) (Windows window host), [`jssdm_app/linux/runner/main.cc`](https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/linux/runner/main.cc) (Linux launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_jssdm["JSSDM writing suite"]
  node_suite["Flutter staff suite"]
  node_editor["Smart editor"]
  node_compliance["Compliance checks"]
  node_templates["Writing templates"]
  node_references["Abbreviation references"]
  node_localdb[("Offline SQLite")]
  node_bilingual["Bangla and English"]
end

subgraph group_platform["Native launchers"]
  node_linux["Linux launcher<br/>[main.cc]"]
  node_windows["Windows launcher<br/>[main.cpp]"]
  node_winwindow["Windows window host<br/>[win32_window.cpp]"]
end

subgraph group_abbrev["Abbreviation review"]
  node_review["Correction review<br/>[ReviewMode.tsx]"]
  node_status["Dataset status"]
  node_proposals["Proposal API<br/>[route.ts]"]
  node_learning["Learning API<br/>[route.ts]"]
end

node_writer(("Staff writer"))

node_writer -->|"uses"| node_suite
node_suite -->|"provides editing"| node_editor
node_suite -->|"checks compliance"| node_compliance
node_suite -->|"provides templates"| node_templates
node_suite -->|"provides lookup"| node_references
node_suite -->|"stores locally"| node_localdb
node_suite -->|"supports writing"| node_bilingual
node_linux -->|"starts Flutter app"| node_suite
node_windows -->|"creates window"| node_winwindow
node_winwindow -.->|"hosts Flutter view"| node_suite
node_review -->|"renders when unavailable"| node_status
node_review -->|"submits decisions"| node_proposals
node_review -->|"loads evidence"| node_learning

click node_suite "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_editor "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_compliance "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_templates "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_references "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_localdb "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_bilingual "https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app"
click node_linux "https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/linux/runner/main.cc"
click node_windows "https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/windows/runner/main.cpp"
click node_winwindow "https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/windows/runner/win32_window.cpp"
click node_review "https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx"
click node_status "https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/components/DatasetStatusPanel.tsx"
click node_proposals "https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/app/api/agent/proposals/route.ts"
click node_learning "https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/app/api/learning/route.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_suite,node_editor,node_compliance,node_templates,node_references,node_localdb,node_bilingual toneBlue
class node_linux,node_windows,node_winwindow toneAmber
class node_review,node_status,node_proposals,node_learning toneMint
class node_writer toneIndigo
```

## Components

### JSSDM writing suite

- [Flutter staff suite](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`
- [Smart editor](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`
- [Compliance checks](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`
- [Writing templates](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`
- [Abbreviation references](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`
- [Offline SQLite](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`
- [Bangla and English](https://github.com/mmrnayan/jssdm-app/tree/main/jssdm_app): `jssdm_app`

### Native launchers

- [Linux launcher](https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/linux/runner/main.cc): `jssdm_app/linux/runner/main.cc`
- [Windows launcher](https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/windows/runner/main.cpp): `jssdm_app/windows/runner/main.cpp`
- [Windows window host](https://github.com/mmrnayan/jssdm-app/blob/main/jssdm_app/windows/runner/win32_window.cpp): `jssdm_app/windows/runner/win32_window.cpp`

### Abbreviation review

- [Correction review](https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx): `abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx`
- [Dataset status](https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/components/DatasetStatusPanel.tsx): `abbre/abb/service-abbreviation-converter/src/components/DatasetStatusPanel.tsx`
- [Proposal API](https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/app/api/agent/proposals/route.ts): `abbre/abb/service-abbreviation-converter/src/app/api/agent/proposals/route.ts`
- [Learning API](https://github.com/mmrnayan/jssdm-app/blob/main/abbre/abb/service-abbreviation-converter/src/app/api/learning/route.ts): `abbre/abb/service-abbreviation-converter/src/app/api/learning/route.ts`

### Other components

- **Staff writer**

## Connections

- Staff writer → Flutter staff suite: uses
- Flutter staff suite → Smart editor: provides editing
- Flutter staff suite → Compliance checks: checks compliance
- Flutter staff suite → Writing templates: provides templates
- Flutter staff suite → Abbreviation references: provides lookup
- Flutter staff suite → Offline SQLite: stores locally
- Flutter staff suite → Bangla and English: supports writing
- Linux launcher → Flutter staff suite: starts Flutter app (evidence: `jssdm_app/linux/runner/main.cc`)
- Windows launcher → Windows window host: creates window (evidence: `jssdm_app/windows/runner/main.cpp`)
- Windows window host → Flutter staff suite: hosts Flutter view (evidence: `jssdm_app/windows/runner/win32_window.cpp`)
- Correction review → Dataset status: renders when unavailable (evidence: `abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx`)
- Correction review → Proposal API: submits decisions (evidence: `abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx`)
- Correction review → Learning API: loads evidence (evidence: `abbre/abb/service-abbreviation-converter/src/components/ReviewMode.tsx`)
