# axiss-groups/studentkare architecture

> Architecture diagram of the GitHub repository axiss-groups/studentkare, 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/axiss-groups/studentkare
- Repository: https://github.com/axiss-groups/studentkare

## Overview

Studentkare is a student-owned health-records and campus-care platform with a React web/native client and a FastAPI service. The main user-to-result path is entering through a client route, using a care feature, and reaching backend APIs; the sampled code also shows API startup and clinical, billing, workflow, and telemetry subsystems. The README gives the product scope but few feature-flow details, and many listed modules were not sampled, so only documented or indexed relationships are drawn.

Main entry points: [`backend/app/main.py`](https://github.com/axiss-groups/studentkare/blob/main/backend/app/main.py) (API application), [`backend/services/billing.py`](https://github.com/axiss-groups/studentkare/blob/main/backend/services/billing.py) (Billing service), [`backend/services/clinical_api.py`](https://github.com/axiss-groups/studentkare/blob/main/backend/services/clinical_api.py) (Clinical API), [`backend/services/activity_telemetry.py`](https://github.com/axiss-groups/studentkare/blob/main/backend/services/activity_telemetry.py) (Activity telemetry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client apps"]
  node_web_app["Web application<br/>[App.tsx]"]
  node_native_app["Native application<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_knowledge_panel["Knowledge manager"]
end

subgraph group_care["Care and AI"]
  node_clinical_api["Clinical API<br/>[clinical_api.py]"]
  node_preventive["Preventive care<br/>[preventive_care.py]"]
  node_care_models["Workflow models<br/>[workflow_models.py]"]
  node_rag_engine["Agentic RAG"]
  node_ai_constitution["AI constitution<br/>[constitution.ts]"]
  node_claims_billing["Billing service<br/>[billing.py]"]
  node_billing_models["Billing models<br/>[billing_models.py]"]
end

subgraph group_backend["Backend services"]
  node_backend_entry["API application<br/>[main.py]"]
  node_workflow_api["Workflow API<br/>[workflow_api.py]"]
  node_workflow_auth["Workflow authorization<br/>[workflow_auth.py]"]
  node_activity_telemetry["Activity telemetry"]
  node_ops_feed["Operations feed<br/>[ops_feed.py]"]
  node_integration_config["Integration config"]
  node_slack_notifier["Slack notifications<br/>[slack_notifier.py]"]
end

subgraph group_platform["Platform foundations"]
  node_db_sql[("SQL database layer<br/>[db_sql.py]")]
  node_frontend_storage["Cross-platform storage"]
  node_consent["Consent engine<br/>[consent_engine.py]"]
  node_backend_telemetry["Backend telemetry<br/>[telemetry.py]"]
  node_demo_seed["Demo data seeding<br/>[demo_seed.py]"]
end

node_user(("Student or staff"))

node_user -->|"uses"| node_web_app
node_user -->|"uses"| node_native_app
node_web_app -->|"uses"| node_api_client
node_web_app -.->|"routes requests"| node_backend_entry
node_native_app -.->|"uses"| node_api_client
node_knowledge_panel -.->|"publishes source"| node_backend_entry
node_backend_entry -->|"mounts router"| node_clinical_api
node_backend_entry -->|"mounts router"| node_workflow_api
node_backend_entry -->|"imports service"| node_preventive
node_backend_entry -->|"imports service"| node_claims_billing
node_backend_entry -->|"imports service"| node_activity_telemetry
node_backend_entry -->|"initializes"| node_backend_telemetry
node_backend_entry -->|"seeds data"| node_demo_seed
node_clinical_api -->|"records activity"| node_activity_telemetry
node_clinical_api -->|"uses models"| node_care_models
node_clinical_api -->|"uses authorization"| node_workflow_auth
node_claims_billing -->|"uses models"| node_billing_models
node_claims_billing -->|"uses feed"| node_ops_feed
node_claims_billing -->|"uses authorization"| node_workflow_auth
node_activity_telemetry -->|"persists via"| node_db_sql
node_activity_telemetry -->|"uses models"| node_care_models
node_backend_telemetry -->|"uses database"| node_db_sql
node_db_sql -->|"maps models"| node_billing_models
node_rag_engine -->|"checks rules"| node_ai_constitution
node_knowledge_panel -->|"loads resources"| node_api_client
node_integration_config -.->|"configures integrations"| node_claims_billing
node_slack_notifier -.->|"alerts on errors"| node_backend_telemetry

click node_web_app "https://github.com/axiss-groups/studentkare/blob/main/src/App.tsx"
click node_native_app "https://github.com/axiss-groups/studentkare/blob/main/src/native/App.tsx"
click node_api_client "https://github.com/axiss-groups/studentkare/blob/main/src/data/api.ts"
click node_knowledge_panel "https://github.com/axiss-groups/studentkare/blob/main/src/screens/workspace/KnowledgeManagerPanel.tsx"
click node_clinical_api "https://github.com/axiss-groups/studentkare/blob/main/backend/services/clinical_api.py"
click node_preventive "https://github.com/axiss-groups/studentkare/blob/main/backend/services/preventive_care.py"
click node_care_models "https://github.com/axiss-groups/studentkare/blob/main/backend/core/workflow_models.py"
click node_rag_engine "https://github.com/axiss-groups/studentkare/blob/main/src/ai/engines/agenticRAGEngine.ts"
click node_ai_constitution "https://github.com/axiss-groups/studentkare/blob/main/src/ai/core/constitution.ts"
click node_claims_billing "https://github.com/axiss-groups/studentkare/blob/main/backend/services/billing.py"
click node_billing_models "https://github.com/axiss-groups/studentkare/blob/main/backend/core/billing_models.py"
click node_backend_entry "https://github.com/axiss-groups/studentkare/blob/main/backend/app/main.py"
click node_workflow_api "https://github.com/axiss-groups/studentkare/blob/main/backend/services/workflow_api.py"
click node_workflow_auth "https://github.com/axiss-groups/studentkare/blob/main/backend/services/workflow_auth.py"
click node_activity_telemetry "https://github.com/axiss-groups/studentkare/blob/main/backend/services/activity_telemetry.py"
click node_ops_feed "https://github.com/axiss-groups/studentkare/blob/main/backend/services/ops_feed.py"
click node_integration_config "https://github.com/axiss-groups/studentkare/blob/main/backend/services/integration_config.py"
click node_slack_notifier "https://github.com/axiss-groups/studentkare/blob/main/backend/services/slack_notifier.py"
click node_db_sql "https://github.com/axiss-groups/studentkare/blob/main/backend/services/db_sql.py"
click node_frontend_storage "https://github.com/axiss-groups/studentkare/blob/main/src/core/storage/CrossPlatformStorage.ts"
click node_consent "https://github.com/axiss-groups/studentkare/blob/main/backend/core/consent_engine.py"
click node_backend_telemetry "https://github.com/axiss-groups/studentkare/blob/main/backend/core/telemetry.py"
click node_demo_seed "https://github.com/axiss-groups/studentkare/blob/main/backend/services/demo_seed.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_web_app,node_native_app,node_api_client,node_knowledge_panel toneBlue
class node_clinical_api,node_preventive,node_care_models,node_rag_engine,node_ai_constitution,node_claims_billing,node_billing_models toneAmber
class node_backend_entry,node_workflow_api,node_workflow_auth,node_activity_telemetry,node_ops_feed,node_integration_config,node_slack_notifier toneMint
class node_db_sql,node_frontend_storage,node_consent,node_backend_telemetry,node_demo_seed toneRose
class node_user toneIndigo
```

## Components

### Client apps

- [Web application](https://github.com/axiss-groups/studentkare/blob/main/src/App.tsx): `src/App.tsx`
- [Native application](https://github.com/axiss-groups/studentkare/blob/main/src/native/App.tsx): `src/native/App.tsx`
- [API client](https://github.com/axiss-groups/studentkare/blob/main/src/data/api.ts): `src/data/api.ts`
- [Knowledge manager](https://github.com/axiss-groups/studentkare/blob/main/src/screens/workspace/KnowledgeManagerPanel.tsx): `src/screens/workspace/KnowledgeManagerPanel.tsx`

### Care and AI

- [Clinical API](https://github.com/axiss-groups/studentkare/blob/main/backend/services/clinical_api.py): `backend/services/clinical_api.py`
- [Preventive care](https://github.com/axiss-groups/studentkare/blob/main/backend/services/preventive_care.py): `backend/services/preventive_care.py`
- [Workflow models](https://github.com/axiss-groups/studentkare/blob/main/backend/core/workflow_models.py): `backend/core/workflow_models.py`
- [Agentic RAG](https://github.com/axiss-groups/studentkare/blob/main/src/ai/engines/agenticRAGEngine.ts): `src/ai/engines/agenticRAGEngine.ts`
- [AI constitution](https://github.com/axiss-groups/studentkare/blob/main/src/ai/core/constitution.ts): `src/ai/core/constitution.ts`
- [Billing service](https://github.com/axiss-groups/studentkare/blob/main/backend/services/billing.py): `backend/services/billing.py`
- [Billing models](https://github.com/axiss-groups/studentkare/blob/main/backend/core/billing_models.py): `backend/core/billing_models.py`

### Backend services

- [API application](https://github.com/axiss-groups/studentkare/blob/main/backend/app/main.py): `backend/app/main.py`
- [Workflow API](https://github.com/axiss-groups/studentkare/blob/main/backend/services/workflow_api.py): `backend/services/workflow_api.py`
- [Workflow authorization](https://github.com/axiss-groups/studentkare/blob/main/backend/services/workflow_auth.py): `backend/services/workflow_auth.py`
- [Activity telemetry](https://github.com/axiss-groups/studentkare/blob/main/backend/services/activity_telemetry.py): `backend/services/activity_telemetry.py`
- [Operations feed](https://github.com/axiss-groups/studentkare/blob/main/backend/services/ops_feed.py): `backend/services/ops_feed.py`
- [Integration config](https://github.com/axiss-groups/studentkare/blob/main/backend/services/integration_config.py): `backend/services/integration_config.py`
- [Slack notifications](https://github.com/axiss-groups/studentkare/blob/main/backend/services/slack_notifier.py): `backend/services/slack_notifier.py`

### Platform foundations

- [SQL database layer](https://github.com/axiss-groups/studentkare/blob/main/backend/services/db_sql.py): `backend/services/db_sql.py`
- [Cross-platform storage](https://github.com/axiss-groups/studentkare/blob/main/src/core/storage/CrossPlatformStorage.ts): `src/core/storage/CrossPlatformStorage.ts`
- [Consent engine](https://github.com/axiss-groups/studentkare/blob/main/backend/core/consent_engine.py): `backend/core/consent_engine.py`
- [Backend telemetry](https://github.com/axiss-groups/studentkare/blob/main/backend/core/telemetry.py): `backend/core/telemetry.py`
- [Demo data seeding](https://github.com/axiss-groups/studentkare/blob/main/backend/services/demo_seed.py): `backend/services/demo_seed.py`

### Other components

- **Student or staff**

## Connections

- Student or staff → Web application: uses (evidence: `README.md`)
- Student or staff → Native application: uses (evidence: `README.md`)
- Web application → API client: uses (evidence: `src/App.tsx`)
- Web application → API application: routes requests
- Native application → API client: uses
- Knowledge manager → API application: publishes source
- API application → Clinical API: mounts router (evidence: `backend/app/main.py`)
- API application → Workflow API: mounts router (evidence: `backend/app/main.py`)
- API application → Preventive care: imports service (evidence: `backend/app/main.py`)
- API application → Billing service: imports service (evidence: `backend/app/main.py`)
- API application → Activity telemetry: imports service (evidence: `backend/app/main.py`)
- API application → Backend telemetry: initializes (evidence: `backend/app/main.py`)
- API application → Demo data seeding: seeds data (evidence: `backend/app/main.py`)
- Clinical API → Activity telemetry: records activity (evidence: `backend/services/clinical_api.py`)
- Clinical API → Workflow models: uses models (evidence: `backend/services/clinical_api.py`)
- Clinical API → Workflow authorization: uses authorization (evidence: `backend/services/clinical_api.py`)
- Billing service → Billing models: uses models (evidence: `backend/services/billing.py`)
- Billing service → Operations feed: uses feed (evidence: `backend/services/billing.py`)
- Billing service → Workflow authorization: uses authorization (evidence: `backend/services/billing.py`)
- Activity telemetry → SQL database layer: persists via (evidence: `backend/services/activity_telemetry.py`)
- Activity telemetry → Workflow models: uses models (evidence: `backend/services/activity_telemetry.py`)
- Backend telemetry → SQL database layer: uses database (evidence: `backend/core/telemetry.py`)
- SQL database layer → Billing models: maps models (evidence: `backend/services/db_sql.py`)
- Agentic RAG → AI constitution: checks rules (evidence: `src/ai/engines/agenticRAGEngine.ts`)
- Knowledge manager → API client: loads resources (evidence: `src/screens/workspace/KnowledgeManagerPanel.tsx`)
- Integration config → Billing service: configures integrations
- Slack notifications → Backend telemetry: alerts on errors
