# abhirambobba/capstone-2027_p architecture

> Architecture diagram of the GitHub repository abhirambobba/capstone-2027_p, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhirambobba/capstone-2027_p
- Repository: https://github.com/abhirambobba/capstone-2027_p

## Overview

The tree contains several ASTRA-related products: a project/workforce management platform, a Google Meet assistant, and a desktop work-tracking client with ingestion/dashboard services. The principal platform workflow is authenticated dashboard/API use for managing projects, teams, memberships, and tasks, with GitHub and Jira integrations. The Meet bot separately joins meetings, captures conversation, and provides AI-assisted responses. Evidence is sparse for much of the frontend, bot internals, and tracker server, so their links are limited rather than inferred as call chains.

Main entry points: [`backend/app/api/projects.py`](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/projects.py) (Projects API), [`AAA/BOT-CONTAINER/src/session.js`](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/session.js) (Meeting sessions), [`backend/app/main.py`](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/main.py) (API application), [`backend/app/repositories`](https://github.com/abhirambobba/capstone-2027_p/tree/main/backend/app/repositories) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["ASTRA Platform"]
  node_dashboard["Dashboard UI"]
  node_frontendproxy["Backend proxy<br/>[route.ts]"]
end

subgraph group_backend["Management API"]
  node_apiapp["API application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_projects["Projects API<br/>[projects.py]"]
  node_memberships["Teams and memberships<br/>[memberships.py]"]
  node_tasks["Tasks API<br/>[tasks.py]"]
  node_projectservice["Project services<br/>[project_service.py]"]
  node_membershipservice["Membership services"]
  node_taskservice["Task services<br/>[task_service.py]"]
  node_github["GitHub integration"]
  node_jira["Jira integration"]
  node_repos["Repositories"]
  node_dynamodb[("DynamoDB<br/>[dynamodb.py]")]
end

subgraph group_meetbot["Meet Assistant"]
  node_botserver["Bot HTTP service<br/>[server.js]"]
  node_sessions["Meeting sessions<br/>[session.js]"]
  node_meetcapture["Meet capture"]
  node_botcontext["Conversation context<br/>[context.js]"]
  node_botllm["Gemini interface<br/>[llm.js]"]
  node_botdb[("Bot persistence<br/>[db.js]")]
end

subgraph group_tracker["Work Tracker"]
  node_trackerclient["Desktop client<br/>[main.rs]"]
  node_trackerplatform["Activity capture<br/>[platform.rs]"]
  node_trackeringest["Telemetry ingestion"]
  node_trackerdashboard["Tracker dashboard<br/>[dashboard_api.py]"]
end

node_user(("Platform user"))
node_botuser(("Meeting participant"))
node_trackeruser(("Employee"))

node_user -->|"uses"| node_dashboard
node_dashboard -.->|"requests"| node_frontendproxy
node_frontendproxy -.->|"proxies requests"| node_apiapp
node_apiapp -->|"routes to"| node_projects
node_apiapp -->|"routes to"| node_memberships
node_apiapp -->|"routes to"| node_tasks
node_projects -->|"calls"| node_projectservice
node_memberships -->|"calls"| node_membershipservice
node_tasks -->|"calls"| node_taskservice
node_projects -->|"uses"| node_github
node_projects -->|"configures"| node_repos
node_membershipservice -.->|"uses"| node_repos
node_taskservice -.->|"uses"| node_repos
node_repos -.->|"reads and writes"| node_dynamodb
node_projects -->|"requires identity"| node_auth
node_memberships -->|"requires identity"| node_auth
node_tasks -->|"requires identity"| node_auth
node_botuser -.->|"summons bot"| node_botserver
node_botserver -->|"manages sessions"| node_sessions
node_sessions -->|"uses Meet modules"| node_meetcapture
node_sessions -->|"uses context"| node_botcontext
node_sessions -->|"calls"| node_botllm
node_sessions -->|"uses persistence"| node_botdb
node_trackeruser -.->|"uses"| node_trackerclient
node_trackerclient -->|"captures activity"| node_trackerplatform
node_trackerclient -->|"sends telemetry"| node_trackeringest
node_trackeringest -.->|"supplies data"| node_trackerdashboard

click node_dashboard "https://github.com/abhirambobba/capstone-2027_p/tree/main/frontend/src/app/dashboard"
click node_frontendproxy "https://github.com/abhirambobba/capstone-2027_p/blob/main/frontend/src/app/api/backend/%5B...path%5D/route.ts"
click node_apiapp "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/main.py"
click node_auth "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/core/auth.py"
click node_projects "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/projects.py"
click node_memberships "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/memberships.py"
click node_tasks "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/tasks.py"
click node_projectservice "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/project_service.py"
click node_membershipservice "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/membership_service.py"
click node_taskservice "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/task_service.py"
click node_github "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/github_app_service.py"
click node_jira "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/jira_oauth_service.py"
click node_repos "https://github.com/abhirambobba/capstone-2027_p/tree/main/backend/app/repositories"
click node_dynamodb "https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/core/dynamodb.py"
click node_botserver "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/server.js"
click node_sessions "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/session.js"
click node_meetcapture "https://github.com/abhirambobba/capstone-2027_p/tree/main/AAA/BOT-CONTAINER/src/meet"
click node_botcontext "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/context.js"
click node_botllm "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/llm.js"
click node_botdb "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/db.js"
click node_trackerclient "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/client-rust/src/main.rs"
click node_trackerplatform "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/client-rust/src/platform.rs"
click node_trackeringest "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/server-python/src/ingestion_worker.py"
click node_trackerdashboard "https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/server-python/src/dashboard_api.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_dashboard,node_frontendproxy,node_user toneBlue
class node_apiapp,node_auth,node_projects,node_memberships,node_tasks,node_projectservice,node_membershipservice,node_taskservice,node_github,node_jira,node_repos,node_dynamodb toneAmber
class node_botserver,node_sessions,node_meetcapture,node_botcontext,node_botllm,node_botdb toneMint
class node_trackerclient,node_trackerplatform,node_trackeringest,node_trackerdashboard toneRose
class node_botuser,node_trackeruser toneIndigo
```

## Components

### ASTRA Platform

- [Dashboard UI](https://github.com/abhirambobba/capstone-2027_p/tree/main/frontend/src/app/dashboard): `frontend/src/app/dashboard`
- [Backend proxy](https://github.com/abhirambobba/capstone-2027_p/blob/main/frontend/src/app/api/backend/%5B...path%5D/route.ts): `frontend/src/app/api/backend/[...path]/route.ts`

### Management API

- [API application](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/core/auth.py): `backend/app/core/auth.py`
- [Projects API](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/projects.py): `backend/app/api/projects.py`
- [Teams and memberships](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/memberships.py): `backend/app/api/memberships.py`
- [Tasks API](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/api/tasks.py): `backend/app/api/tasks.py`
- [Project services](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/project_service.py): `backend/app/services/project_service.py`
- [Membership services](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/membership_service.py): `backend/app/services/membership_service.py`
- [Task services](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/task_service.py): `backend/app/services/task_service.py`
- [GitHub integration](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/github_app_service.py): `backend/app/services/github_app_service.py`
- [Jira integration](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/services/jira_oauth_service.py): `backend/app/services/jira_oauth_service.py`
- [Repositories](https://github.com/abhirambobba/capstone-2027_p/tree/main/backend/app/repositories): `backend/app/repositories`
- [DynamoDB](https://github.com/abhirambobba/capstone-2027_p/blob/main/backend/app/core/dynamodb.py): `backend/app/core/dynamodb.py`

### Meet Assistant

- [Bot HTTP service](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/server.js): `AAA/BOT-CONTAINER/src/server.js`
- [Meeting sessions](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/session.js): `AAA/BOT-CONTAINER/src/session.js`
- [Meet capture](https://github.com/abhirambobba/capstone-2027_p/tree/main/AAA/BOT-CONTAINER/src/meet): `AAA/BOT-CONTAINER/src/meet`
- [Conversation context](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/context.js): `AAA/BOT-CONTAINER/src/context.js`
- [Gemini interface](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/llm.js): `AAA/BOT-CONTAINER/src/llm.js`
- [Bot persistence](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/BOT-CONTAINER/src/db.js): `AAA/BOT-CONTAINER/src/db.js`

### Work Tracker

- [Desktop client](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/client-rust/src/main.rs): `AAA/Work_Tracker/client-rust/src/main.rs`
- [Activity capture](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/client-rust/src/platform.rs): `AAA/Work_Tracker/client-rust/src/platform.rs`
- [Telemetry ingestion](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/server-python/src/ingestion_worker.py): `AAA/Work_Tracker/server-python/src/ingestion_worker.py`
- [Tracker dashboard](https://github.com/abhirambobba/capstone-2027_p/blob/main/AAA/Work_Tracker/server-python/src/dashboard_api.py): `AAA/Work_Tracker/server-python/src/dashboard_api.py`

### Other components

- **Platform user**
- **Meeting participant**
- **Employee**

## Connections

- Platform user → Dashboard UI: uses
- Dashboard UI → Backend proxy: requests
- Backend proxy → API application: proxies requests
- API application → Projects API: routes to (evidence: `backend/app/main.py`)
- API application → Teams and memberships: routes to (evidence: `backend/app/main.py`)
- API application → Tasks API: routes to (evidence: `backend/app/main.py`)
- Projects API → Project services: calls (evidence: `backend/app/api/projects.py`)
- Teams and memberships → Membership services: calls (evidence: `backend/app/api/memberships.py`)
- Tasks API → Task services: calls (evidence: `backend/app/api/tasks.py`)
- Projects API → GitHub integration: uses (evidence: `backend/app/api/projects.py`)
- Projects API → Repositories: configures (evidence: `backend/app/api/projects.py`)
- Membership services → Repositories: uses
- Task services → Repositories: uses
- Repositories → DynamoDB: reads and writes
- Projects API → Authentication: requires identity (evidence: `backend/app/api/projects.py`)
- Teams and memberships → Authentication: requires identity (evidence: `backend/app/api/memberships.py`)
- Tasks API → Authentication: requires identity (evidence: `backend/app/api/tasks.py`)
- Meeting participant → Bot HTTP service: summons bot
- Bot HTTP service → Meeting sessions: manages sessions (evidence: `AAA/BOT-CONTAINER/src/server.js`)
- Meeting sessions → Meet capture: uses Meet modules (evidence: `AAA/BOT-CONTAINER/src/session.js`)
- Meeting sessions → Conversation context: uses context (evidence: `AAA/BOT-CONTAINER/src/session.js`)
- Meeting sessions → Gemini interface: calls (evidence: `AAA/BOT-CONTAINER/src/session.js`)
- Meeting sessions → Bot persistence: uses persistence (evidence: `AAA/BOT-CONTAINER/src/session.js`)
- Employee → Desktop client: uses
- Desktop client → Activity capture: captures activity (evidence: `AAA/Work_Tracker/client-rust/src/main.rs`)
- Desktop client → Telemetry ingestion: sends telemetry (evidence: `AAA/Work_Tracker/client-rust/src/main.rs`)
- Telemetry ingestion → Tracker dashboard: supplies data
