# morpheus0612/personal-space-management architecture

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

- Interactive diagram: https://gitdiagram.com/morpheus0612/personal-space-management
- Repository: https://github.com/morpheus0612/personal-space-management

## Overview

Productivity Nexus is a personal productivity workspace. Users enter through the landing page or dashboard, navigate to finance, workflows, voice, or behavior tools, and those feature screens use the shared API context to reach the backend. The README also documents curated news, but the tree has no clearly dedicated news module. The backend source is indexed as read but no excerpt is provided here, so backend internals and most page-to-endpoint relationships are not asserted; the voice transcription and notes requests are visible in the supplied excerpt.

Main entry points: [`frontend/src/App.js`](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/App.js) (React App Router), [`frontend/src/pages/Dashboard.js`](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Dashboard.js) (Dashboard), [`backend/server.py`](https://github.com/morpheus0612/personal-space-management/blob/main/backend/server.py) (FastAPI Backend), [`frontend/src/pages/VoiceNotes.js`](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/VoiceNotes.js) (Voice Notes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Workspace Navigation"]
  node_landing["Landing Page<br/>[Landing.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.js]"]
end

subgraph group_productivity["Productivity Tools"]
  node_finance["Finance Tracker<br/>[Finance.js]"]
  node_workflows["Workflow Studio<br/>[Workflows.js]"]
  node_voice["Voice Notes<br/>[VoiceNotes.js]"]
  node_behavior["Behavior Insights<br/>[Behavior.js]"]
  node_news["Curated News<br/>[Landing.js]"]
end

subgraph group_platform["Application Platform"]
  node_app["React App Router<br/>[App.js]"]
  node_particle["Particle Background"]
  node_backend["FastAPI Backend<br/>[server.py]"]
end

subgraph group_integrations["External Services"]
  node_mongo[("MongoDB")]
  node_market["Market Data APIs"]
  node_ai["AI Services"]
  node_speech["Speech Services"]
end

node_user(("Workspace User"))

node_user -->|"opens"| node_landing
node_user -->|"opens"| node_dashboard
node_landing -->|"launches"| node_dashboard
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_finance
node_app -->|"routes to"| node_workflows
node_app -->|"routes to"| node_voice
node_app -->|"routes to"| node_behavior
node_app -->|"renders"| node_particle
node_dashboard -->|"links to"| node_finance
node_dashboard -->|"links to"| node_workflows
node_dashboard -->|"links to"| node_voice
node_dashboard -->|"links to"| node_behavior
node_voice -->|"posts audio"| node_backend
node_voice -->|"saves notes"| node_backend
node_finance -.->|"uses API"| node_backend
node_workflows -.->|"uses API"| node_backend
node_behavior -.->|"uses API"| node_backend
node_backend -.->|"persists data"| node_mongo
node_finance -.->|"market data"| node_market
node_behavior -.->|"AI insights"| node_ai
node_voice -.->|"speech processing"| node_speech

click node_landing "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Landing.js"
click node_dashboard "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Dashboard.js"
click node_app "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/App.js"
click node_particle "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/components/ParticleAccelerator.js"
click node_finance "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Finance.js"
click node_workflows "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Workflows.js"
click node_voice "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/VoiceNotes.js"
click node_behavior "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Behavior.js"
click node_news "https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Landing.js"
click node_backend "https://github.com/morpheus0612/personal-space-management/blob/main/backend/server.py"

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_landing,node_dashboard,node_user toneBlue
class node_finance,node_workflows,node_voice,node_behavior,node_news toneAmber
class node_app,node_particle,node_backend toneMint
class node_mongo,node_market,node_ai,node_speech toneRose
```

## Components

### Workspace Navigation

- [Landing Page](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Landing.js): `frontend/src/pages/Landing.js`
- [Dashboard](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Dashboard.js): `frontend/src/pages/Dashboard.js`

### Productivity Tools

- [Finance Tracker](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Finance.js): `frontend/src/pages/Finance.js`
- [Workflow Studio](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Workflows.js): `frontend/src/pages/Workflows.js`
- [Voice Notes](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/VoiceNotes.js): `frontend/src/pages/VoiceNotes.js`
- [Behavior Insights](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Behavior.js): `frontend/src/pages/Behavior.js`
- [Curated News](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/pages/Landing.js): `frontend/src/pages/Landing.js`

### Application Platform

- [React App Router](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Particle Background](https://github.com/morpheus0612/personal-space-management/blob/main/frontend/src/components/ParticleAccelerator.js): `frontend/src/components/ParticleAccelerator.js`
- [FastAPI Backend](https://github.com/morpheus0612/personal-space-management/blob/main/backend/server.py): `backend/server.py`

### External Services

- **MongoDB**
- **Market Data APIs**
- **AI Services**
- **Speech Services**

### Other components

- **Workspace User**

## Connections

- Workspace User → Landing Page: opens
- Workspace User → Dashboard: opens
- Landing Page → Dashboard: launches (evidence: `frontend/src/pages/Landing.js`)
- React App Router → Landing Page: routes to (evidence: `frontend/src/App.js`)
- React App Router → Dashboard: routes to (evidence: `frontend/src/App.js`)
- React App Router → Finance Tracker: routes to (evidence: `frontend/src/App.js`)
- React App Router → Workflow Studio: routes to (evidence: `frontend/src/App.js`)
- React App Router → Voice Notes: routes to (evidence: `frontend/src/App.js`)
- React App Router → Behavior Insights: routes to (evidence: `frontend/src/App.js`)
- React App Router → Particle Background: renders (evidence: `frontend/src/App.js`)
- Dashboard → Finance Tracker: links to (evidence: `frontend/src/pages/Dashboard.js`)
- Dashboard → Workflow Studio: links to (evidence: `frontend/src/pages/Dashboard.js`)
- Dashboard → Voice Notes: links to (evidence: `frontend/src/pages/Dashboard.js`)
- Dashboard → Behavior Insights: links to (evidence: `frontend/src/pages/Dashboard.js`)
- Voice Notes → FastAPI Backend: posts audio (evidence: `frontend/src/pages/VoiceNotes.js`)
- Voice Notes → FastAPI Backend: saves notes (evidence: `frontend/src/pages/VoiceNotes.js`)
- Finance Tracker → FastAPI Backend: uses API
- Workflow Studio → FastAPI Backend: uses API
- Behavior Insights → FastAPI Backend: uses API
- FastAPI Backend → MongoDB: persists data (evidence: `README.md`)
- Finance Tracker → Market Data APIs: market data (evidence: `README.md`)
- Behavior Insights → AI Services: AI insights (evidence: `README.md`)
- Voice Notes → Speech Services: speech processing (evidence: `README.md`)
