# workvaibhavk/gppreportgenerator architecture

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

## Overview

This is a client-side micro-project report generator. Users can start a manual report workflow, or use the AI-assisted route to obtain a prompt, paste generated JSON, and validate it; the manual workflow collects project details, students, report content, and images before offering PDF generation. The sampled code shows the form page coordinating these stages and the PDF component constructing student reports. The certificate-only option is advertised on the home page, but its destination is absent from the supplied tree. AI-to-report integration details are only partly sampled.

Main entry points: [`app/project-form/page.tsx`](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/project-form/page.tsx) (Manual workflow), [`app/ai-assisted/page.tsx`](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/ai-assisted/page.tsx) (AI-assisted input), [`app/page.tsx`](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/page.tsx) (Route chooser), [`components/Generate.tsx`](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Generate.tsx) (PDF generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry routes"]
  node_home["Route chooser<br/>[page.tsx]"]
  node_layout["App layout<br/>[layout.tsx]"]
  node_styles["Global styles<br/>[globals.css]"]
end

subgraph group_manual["Manual report"]
  node_manual_route["Manual workflow<br/>[page.tsx]"]
  node_project_details["Project details<br/>[Details.tsx]"]
  node_student_details["Student details<br/>[StdDetails.tsx]"]
  node_report_content["Report content<br/>[Content.tsx]"]
  node_project_images["Project images<br/>[Image.tsx]"]
  node_pdf_generation["PDF generation<br/>[Generate.tsx]"]
  node_step_navigation["Step navigator<br/>[Navigator.tsx]"]
  node_manual_navbar["Form navbar<br/>[Navbar.tsx]"]
end

subgraph group_assist["AI-assisted input"]
  node_ai_route["AI-assisted input<br/>[page.tsx]"]
  node_prompt_file["AI prompt"]
end

node_visitor(("Visitor"))
node_claude(("Claude"))
node_pdf_file["Report PDF"]

node_visitor -->|"opens"| node_home
node_home -->|"links to"| node_manual_route
node_home -->|"links to"| node_ai_route
node_layout -->|"loads"| node_styles
node_visitor -->|"opens"| node_manual_route
node_manual_route -->|"renders"| node_manual_navbar
node_manual_route -->|"renders"| node_step_navigation
node_manual_route -->|"renders"| node_project_details
node_manual_route -->|"renders"| node_student_details
node_manual_route -->|"renders"| node_report_content
node_manual_route -->|"renders"| node_project_images
node_manual_route -->|"renders"| node_pdf_generation
node_pdf_generation -->|"generates"| node_pdf_file
node_visitor -->|"opens"| node_ai_route
node_claude -->|"supplies JSON"| node_ai_route
node_ai_route -.->|"offers download"| node_prompt_file
node_ai_route -.->|"feeds report data"| node_pdf_generation

click node_home "https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/page.tsx"
click node_layout "https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/layout.tsx"
click node_styles "https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/globals.css"
click node_manual_route "https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/project-form/page.tsx"
click node_project_details "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Details.tsx"
click node_student_details "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/StdDetails.tsx"
click node_report_content "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Content.tsx"
click node_project_images "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Image.tsx"
click node_pdf_generation "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Generate.tsx"
click node_step_navigation "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Navigator.tsx"
click node_manual_navbar "https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Navbar.tsx"
click node_ai_route "https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/ai-assisted/page.tsx"
click node_prompt_file "https://github.com/workvaibhavk/gppreportgenerator/blob/master/public/micro_project_prompt.txt"

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_home,node_layout,node_styles toneBlue
class node_manual_route,node_project_details,node_student_details,node_report_content,node_project_images,node_pdf_generation,node_step_navigation,node_manual_navbar toneAmber
class node_ai_route,node_prompt_file toneMint
class node_visitor,node_claude,node_pdf_file toneIndigo
```

## Components

### Entry routes

- [Route chooser](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/page.tsx): `app/page.tsx`
- [App layout](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/layout.tsx): `app/layout.tsx`
- [Global styles](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/globals.css): `app/globals.css`

### Manual report

- [Manual workflow](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/project-form/page.tsx): `app/project-form/page.tsx`
- [Project details](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Details.tsx): `components/Details.tsx`
- [Student details](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/StdDetails.tsx): `components/StdDetails.tsx`
- [Report content](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Content.tsx): `components/Content.tsx`
- [Project images](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Image.tsx): `components/Image.tsx`
- [PDF generation](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Generate.tsx): `components/Generate.tsx`
- [Step navigator](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Navigator.tsx): `components/Navigator.tsx`
- [Form navbar](https://github.com/workvaibhavk/gppreportgenerator/blob/master/components/Navbar.tsx): `components/Navbar.tsx`

### AI-assisted input

- [AI-assisted input](https://github.com/workvaibhavk/gppreportgenerator/blob/master/app/ai-assisted/page.tsx): `app/ai-assisted/page.tsx`
- [AI prompt](https://github.com/workvaibhavk/gppreportgenerator/blob/master/public/micro_project_prompt.txt): `public/micro_project_prompt.txt`

### Other components

- **Visitor**
- **Claude**
- **Report PDF**

## Connections

- Visitor → Route chooser: opens
- Route chooser → Manual workflow: links to (evidence: `app/page.tsx`)
- Route chooser → AI-assisted input: links to (evidence: `app/page.tsx`)
- App layout → Global styles: loads (evidence: `app/layout.tsx`)
- Visitor → Manual workflow: opens
- Manual workflow → Form navbar: renders (evidence: `app/project-form/page.tsx`)
- Manual workflow → Step navigator: renders (evidence: `app/project-form/page.tsx`)
- Manual workflow → Project details: renders (evidence: `app/project-form/page.tsx`)
- Manual workflow → Student details: renders (evidence: `app/project-form/page.tsx`)
- Manual workflow → Report content: renders (evidence: `app/project-form/page.tsx`)
- Manual workflow → Project images: renders (evidence: `app/project-form/page.tsx`)
- Manual workflow → PDF generation: renders (evidence: `app/project-form/page.tsx`)
- PDF generation → Report PDF: generates (evidence: `components/Generate.tsx`)
- Visitor → AI-assisted input: opens
- Claude → AI-assisted input: supplies JSON (evidence: `app/ai-assisted/page.tsx`)
- AI-assisted input → AI prompt: offers download
- AI-assisted input → PDF generation: feeds report data
