# kshitijchauhann/plipe architecture

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

- Interactive diagram: https://gitdiagram.com/kshitijchauhann/plipe
- Repository: https://github.com/kshitijchauhann/plipe

## Overview

Plipe is a transcript-ingestion application: signed-in users submit supported files, which become jobs, are processed by a worker, and reach a review-ready state. The sampled source establishes upload validation, file storage, job persistence, worker dispatch, and extraction invocation. The README is only the generic Next.js starter; feature-specific docs are listed in the tree but their contents and several UI/extraction implementations were not sampled, so those relationships are omitted.

Main entry points: [`src/app/api/jobs/route.ts`](https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/route.ts) (Jobs endpoint), [`src/lib/ingest/worker.ts`](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/worker.ts) (Job worker), [`src/lib/ingest/queries.ts`](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/queries.ts) (Job queries), [`src/lib/auth.ts`](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/auth.ts) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_upload_ui["Upload form<br/>[upload-form.tsx]"]
  node_jobs_ui["Job list<br/>[job-list.tsx]"]
end

subgraph group_access["Authentication"]
  node_auth_api["Auth endpoint<br/>[route.ts]"]
  node_auth_service["Auth service<br/>[auth.ts]"]
  node_session["Session lookup<br/>[session.ts]"]
end

subgraph group_pipeline["Ingestion pipeline"]
  node_jobs_api["Jobs endpoint<br/>[route.ts]"]
  node_job_detail["Job detail endpoint<br/>[route.ts]"]
  node_process_api["Process endpoint<br/>[route.ts]"]
  node_storage["Upload storage<br/>[storage.ts]"]
  node_worker["Job worker<br/>[worker.ts]"]
  node_extract["Transcript extraction<br/>[extract.ts]"]
end

subgraph group_persistence["Persistence"]
  node_queries["Job queries<br/>[queries.ts]"]
  node_job_db[("Job records<br/>[jobs.ts]")]
  node_auth_db[("Auth records<br/>[auth.ts]")]
end

node_user(("Signed-in user"))
node_filesystem[("Local file storage")]
node_postgres[("PostgreSQL")]

node_user -->|"submits file"| node_upload_ui
node_user -->|"views jobs"| node_jobs_ui
node_auth_api -->|"delegates"| node_auth_service
node_auth_service -->|"reads/writes"| node_auth_db
node_auth_service -->|"persists via"| node_postgres
node_jobs_api -->|"checks session"| node_session
node_jobs_api -->|"stores upload"| node_storage
node_storage -->|"writes file"| node_filesystem
node_jobs_api -->|"inserts job"| node_job_db
node_jobs_api -->|"persists via"| node_postgres
node_jobs_api -->|"dispatches"| node_worker
node_jobs_api -->|"lists jobs"| node_queries
node_job_detail -->|"checks session"| node_session
node_job_detail -->|"fetches job"| node_queries
node_process_api -->|"checks session"| node_session
node_process_api -->|"dispatches"| node_worker
node_worker -->|"claims/updates"| node_job_db
node_worker -->|"transacts via"| node_postgres
node_worker -->|"runs extraction"| node_extract
node_queries -->|"reads jobs"| node_job_db
node_queries -->|"queries via"| node_postgres

click node_upload_ui "https://github.com/kshitijchauhann/plipe/blob/main/src/components/ingest/upload-form.tsx"
click node_jobs_ui "https://github.com/kshitijchauhann/plipe/blob/main/src/components/ingest/job-list.tsx"
click node_auth_api "https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/auth/%5B...all%5D/route.ts"
click node_auth_service "https://github.com/kshitijchauhann/plipe/blob/main/src/lib/auth.ts"
click node_session "https://github.com/kshitijchauhann/plipe/blob/main/src/lib/session.ts"
click node_jobs_api "https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/route.ts"
click node_job_detail "https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/%5Bid%5D/route.ts"
click node_process_api "https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/process/route.ts"
click node_storage "https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/storage.ts"
click node_worker "https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/worker.ts"
click node_extract "https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/extract.ts"
click node_queries "https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/queries.ts"
click node_job_db "https://github.com/kshitijchauhann/plipe/blob/main/src/db/schema/jobs.ts"
click node_auth_db "https://github.com/kshitijchauhann/plipe/blob/main/src/db/schema/auth.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_upload_ui,node_jobs_ui,node_user toneBlue
class node_auth_api,node_auth_service,node_session,node_filesystem,node_postgres toneAmber
class node_jobs_api,node_job_detail,node_process_api,node_storage,node_worker,node_extract toneMint
class node_queries,node_job_db,node_auth_db toneRose
```

## Components

### User interface

- [Upload form](https://github.com/kshitijchauhann/plipe/blob/main/src/components/ingest/upload-form.tsx): `src/components/ingest/upload-form.tsx`
- [Job list](https://github.com/kshitijchauhann/plipe/blob/main/src/components/ingest/job-list.tsx): `src/components/ingest/job-list.tsx`

### Authentication

- [Auth endpoint](https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/auth/%5B...all%5D/route.ts): `src/app/api/auth/[...all]/route.ts`
- [Auth service](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Session lookup](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/session.ts): `src/lib/session.ts`

### Ingestion pipeline

- [Jobs endpoint](https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/route.ts): `src/app/api/jobs/route.ts`
- [Job detail endpoint](https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/%5Bid%5D/route.ts): `src/app/api/jobs/[id]/route.ts`
- [Process endpoint](https://github.com/kshitijchauhann/plipe/blob/main/src/app/api/jobs/process/route.ts): `src/app/api/jobs/process/route.ts`
- [Upload storage](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/storage.ts): `src/lib/ingest/storage.ts`
- [Job worker](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/worker.ts): `src/lib/ingest/worker.ts`
- [Transcript extraction](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/extract.ts): `src/lib/ingest/extract.ts`

### Persistence

- [Job queries](https://github.com/kshitijchauhann/plipe/blob/main/src/lib/ingest/queries.ts): `src/lib/ingest/queries.ts`
- [Job records](https://github.com/kshitijchauhann/plipe/blob/main/src/db/schema/jobs.ts): `src/db/schema/jobs.ts`
- [Auth records](https://github.com/kshitijchauhann/plipe/blob/main/src/db/schema/auth.ts): `src/db/schema/auth.ts`

### Other components

- **Signed-in user**
- **Local file storage**
- **PostgreSQL**

## Connections

- Signed-in user → Upload form: submits file
- Signed-in user → Job list: views jobs
- Auth endpoint → Auth service: delegates
- Auth service → Auth records: reads/writes
- Auth service → PostgreSQL: persists via
- Jobs endpoint → Session lookup: checks session
- Jobs endpoint → Upload storage: stores upload
- Upload storage → Local file storage: writes file
- Jobs endpoint → Job records: inserts job
- Jobs endpoint → PostgreSQL: persists via
- Jobs endpoint → Job worker: dispatches
- Jobs endpoint → Job queries: lists jobs
- Job detail endpoint → Session lookup: checks session
- Job detail endpoint → Job queries: fetches job
- Process endpoint → Session lookup: checks session
- Process endpoint → Job worker: dispatches
- Job worker → Job records: claims/updates
- Job worker → PostgreSQL: transacts via
- Job worker → Transcript extraction: runs extraction
- Job queries → Job records: reads jobs
- Job queries → PostgreSQL: queries via
