# felusion099/university-collab-network architecture

> Architecture diagram of the GitHub repository felusion099/university-collab-network, 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/felusion099/university-collab-network
- Repository: https://github.com/felusion099/university-collab-network

## Overview

This is a university collaboration platform with a React campus UI and an Express/Prisma API backed by PostgreSQL. Its principal live-mode workflow takes a signed-in user from UI actions through AppContext and the API client to routed backend operations and persistent data; API DTOs are adapted for the UI. The product also supports discovery, projects and join requests, messaging, events, communities, research, and collaboration spaces, alongside a demo mode. Relationships in unsampled areas are included only where the README documents them.

Main entry points: [`apps/api/src/services`](https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/services) (Domain services), [`apps/web/src/services/api/live.ts`](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/live.ts) (Live API layer), [`apps/web/src/App.tsx`](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/App.tsx) (Application views), [`apps/web/src/context/AuthContext.tsx`](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/context/AuthContext.tsx) (Auth session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Campus UI"]
  node_app["Application views<br/>[App.tsx]"]
  node_authui["Authentication UI<br/>[LoginPage.tsx]"]
  node_authcontext["Auth session<br/>[AuthContext.tsx]"]
  node_appcontext["App state/actions<br/>[AppContext.tsx]"]
  node_mock["Demo data<br/>[mockData.ts]"]
  node_live["Live API layer<br/>[live.ts]"]
  node_adapters["DTO adapters<br/>[adapters.ts]"]
  node_client["HTTP client<br/>[client.ts]"]
end

subgraph group_api["API runtime"]
  node_apiapp["Express application<br/>[app.ts]"]
  node_routes["API routes<br/>[index.ts]"]
  node_controllers["Request controllers"]
  node_services["Domain services"]
  node_authservice["Auth service<br/>[auth.service.ts]"]
end

subgraph group_domains["Collaboration features"]
  node_projects["Projects and requests"]
  node_research["Research teams"]
  node_spaces["Collaboration spaces"]
  node_communications["Messaging and notices"]
  node_discovery["Discovery and events"]
end

subgraph group_data["Data and contracts"]
  node_repos["Repositories"]
  node_usersrepo["User repository<br/>[user.repository.ts]"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_contracts["Shared API types"]
end

node_user(("Campus user"))
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_authui
node_authui -.->|"signs in"| node_authcontext
node_authcontext -->|"refreshes profile"| node_live
node_authcontext -->|"seeds demo"| node_mock
node_app -->|"provides state"| node_appcontext
node_appcontext -->|"dispatches actions"| node_live
node_appcontext -->|"uses demo mode"| node_mock
node_live -->|"sends requests"| node_client
node_live -->|"maps DTOs"| node_adapters
node_client -->|"calls API"| node_apiapp
node_apiapp -->|"mounts routes"| node_routes
node_routes -->|"routes requests"| node_controllers
node_controllers -->|"delegates"| node_services
node_authservice -->|"creates users"| node_usersrepo
node_authservice -->|"generates username"| node_services
node_projects -.->|"manages requests"| node_services
node_research -->|"manages teams"| node_services
node_spaces -.->|"manages spaces"| node_services
node_communications -.->|"supports messaging"| node_services
node_discovery -.->|"supports discovery"| node_services
node_services -.->|"accesses data"| node_repos
node_usersrepo -->|"queries through"| node_prisma
node_prisma -.->|"persists data"| node_postgres
node_live -->|"uses types"| node_contracts
node_controllers -->|"uses request types"| node_contracts

click node_app "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/App.tsx"
click node_authui "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/components/auth/LoginPage.tsx"
click node_authcontext "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/context/AuthContext.tsx"
click node_appcontext "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/context/AppContext.tsx"
click node_mock "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/data/mockData.ts"
click node_live "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/live.ts"
click node_adapters "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/adapters.ts"
click node_client "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/client.ts"
click node_apiapp "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/app.ts"
click node_routes "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/routes/index.ts"
click node_controllers "https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/controllers"
click node_services "https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/services"
click node_authservice "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/services/auth.service.ts"
click node_projects "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/controllers/joinRequest.controller.ts"
click node_research "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/controllers/researchTeam.controller.ts"
click node_spaces "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/controllers/space.controller.ts"
click node_communications "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/services/conversation.service.ts"
click node_discovery "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/services/discover.service.ts"
click node_repos "https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/repositories"
click node_usersrepo "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/repositories/user.repository.ts"
click node_prisma "https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/repositories/prisma.ts"
click node_contracts "https://github.com/felusion099/university-collab-network/tree/combined-platform/packages/shared-types/src"

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_authui,node_authcontext,node_appcontext,node_mock,node_live,node_adapters,node_client,node_user toneBlue
class node_apiapp,node_routes,node_controllers,node_services,node_authservice,node_postgres toneAmber
class node_projects,node_research,node_spaces,node_communications,node_discovery toneMint
class node_repos,node_usersrepo,node_prisma,node_contracts toneRose
```

## Components

### Campus UI

- [Application views](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Authentication UI](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/components/auth/LoginPage.tsx): `apps/web/src/components/auth/LoginPage.tsx`
- [Auth session](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/context/AuthContext.tsx): `apps/web/src/context/AuthContext.tsx`
- [App state/actions](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/context/AppContext.tsx): `apps/web/src/context/AppContext.tsx`
- [Demo data](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/data/mockData.ts): `apps/web/src/data/mockData.ts`
- [Live API layer](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/live.ts): `apps/web/src/services/api/live.ts`
- [DTO adapters](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/adapters.ts): `apps/web/src/services/api/adapters.ts`
- [HTTP client](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/web/src/services/api/client.ts): `apps/web/src/services/api/client.ts`

### API runtime

- [Express application](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/app.ts): `apps/api/src/app.ts`
- [API routes](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/routes/index.ts): `apps/api/src/routes/index.ts`
- [Request controllers](https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/controllers): `apps/api/src/controllers`
- [Domain services](https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/services): `apps/api/src/services`
- [Auth service](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/services/auth.service.ts): `apps/api/src/services/auth.service.ts`

### Collaboration features

- [Projects and requests](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/controllers/joinRequest.controller.ts): `apps/api/src/controllers/joinRequest.controller.ts`
- [Research teams](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/controllers/researchTeam.controller.ts): `apps/api/src/controllers/researchTeam.controller.ts`
- [Collaboration spaces](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/controllers/space.controller.ts): `apps/api/src/controllers/space.controller.ts`
- [Messaging and notices](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/services/conversation.service.ts): `apps/api/src/services/conversation.service.ts`
- [Discovery and events](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/services/discover.service.ts): `apps/api/src/services/discover.service.ts`

### Data and contracts

- [Repositories](https://github.com/felusion099/university-collab-network/tree/combined-platform/apps/api/src/repositories): `apps/api/src/repositories`
- [User repository](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/repositories/user.repository.ts): `apps/api/src/repositories/user.repository.ts`
- [Prisma client](https://github.com/felusion099/university-collab-network/blob/combined-platform/apps/api/src/repositories/prisma.ts): `apps/api/src/repositories/prisma.ts`
- [Shared API types](https://github.com/felusion099/university-collab-network/tree/combined-platform/packages/shared-types/src): `packages/shared-types/src`

### Other components

- **Campus user**
- **PostgreSQL**

## Connections

- Campus user → Application views: uses (evidence: `README.md`)
- Application views → Authentication UI: renders (evidence: `apps/web/src/App.tsx`)
- Authentication UI → Auth session: signs in
- Auth session → Live API layer: refreshes profile (evidence: `apps/web/src/context/AuthContext.tsx`)
- Auth session → Demo data: seeds demo (evidence: `apps/web/src/context/AuthContext.tsx`)
- Application views → App state/actions: provides state (evidence: `apps/web/src/App.tsx`)
- App state/actions → Live API layer: dispatches actions (evidence: `apps/web/src/context/AppContext.tsx`)
- App state/actions → Demo data: uses demo mode (evidence: `apps/web/src/context/AppContext.tsx`)
- Live API layer → HTTP client: sends requests (evidence: `README.md`)
- Live API layer → DTO adapters: maps DTOs (evidence: `apps/web/src/services/api/live.ts`)
- HTTP client → Express application: calls API (evidence: `README.md`)
- Express application → API routes: mounts routes (evidence: `apps/api/src/app.ts`)
- API routes → Request controllers: routes requests
- Request controllers → Domain services: delegates (evidence: `apps/api/src/controllers/researchTeam.controller.ts`)
- Auth service → User repository: creates users (evidence: `apps/api/src/services/auth.service.ts`)
- Auth service → Domain services: generates username (evidence: `apps/api/src/services/auth.service.ts`)
- Projects and requests → Domain services: manages requests (evidence: `apps/api/src/controllers/joinRequest.controller.ts`)
- Research teams → Domain services: manages teams (evidence: `apps/api/src/controllers/researchTeam.controller.ts`)
- Collaboration spaces → Domain services: manages spaces
- Messaging and notices → Domain services: supports messaging
- Discovery and events → Domain services: supports discovery
- Domain services → Repositories: accesses data (evidence: `apps/api/src/services/auth.service.ts`)
- User repository → Prisma client: queries through (evidence: `apps/api/src/repositories/user.repository.ts`)
- Prisma client → PostgreSQL: persists data
- Live API layer → Shared API types: uses types (evidence: `apps/web/src/services/api/live.ts`)
- Request controllers → Shared API types: uses request types (evidence: `apps/api/src/controllers/researchTeam.controller.ts`)
