# aurorascharff/next15-filterlist architecture

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

## Overview

This is a Next.js task-list application: users browse tasks by status and refine the list with search and category filters; the page fetches matching tasks and renders them. The layout also presents project information and status/category summaries, with loading placeholders that support the deliberately slow-loading demonstration. Service modules query Prisma for tasks, categories, project details, and aggregates. The graph follows shown calls and README capabilities; some UI wiring is based only on the source index, so uncertain URL-to-filter interactions are not asserted.

Main entry points: [`app/layout.tsx`](https://github.com/aurorascharff/next15-filterlist/blob/main/app/layout.tsx) (App layout), [`app/[tab]/page.tsx`](https://github.com/aurorascharff/next15-filterlist/blob/main/app/%5Btab%5D/page.tsx) (Task results), [`data/services/task.ts`](https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/task.ts) (Task queries), [`db.ts`](https://github.com/aurorascharff/next15-filterlist/blob/main/db.ts) (Prisma client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_layout["App layout<br/>[layout.tsx]"]
  node_task_page["Task results<br/>[page.tsx]"]
  node_project_info["Project information<br/>[ProjectInfo.tsx]"]
  node_loading["Loading states<br/>[Skeleton.tsx]"]
end

subgraph group_controls["Filtering and navigation"]
  node_search["Task search<br/>[Search.tsx]"]
  node_category_filter["Category filter<br/>[CategoryFilter.tsx]"]
  node_status_tabs["Status summaries<br/>[StatusTabs.tsx]"]
  node_nav_tabs["Tab navigation<br/>[NavTab.tsx]"]
end

subgraph group_services["Domain services"]
  node_task_service["Task queries<br/>[task.ts]"]
  node_category_service["Category queries<br/>[category.ts]"]
  node_project_service["Project queries<br/>[project.ts]"]
  node_task_types["Task status model<br/>[task.ts]"]
end

subgraph group_persistence["Persistence"]
  node_prisma_client["Prisma client<br/>[db.ts]"]
  node_database[("Task database<br/>[schema.prisma]")]
end

node_user(("User"))

node_user -->|"opens app"| node_layout
node_layout -->|"renders"| node_project_info
node_layout -->|"renders"| node_search
node_layout -->|"renders"| node_category_filter
node_layout -->|"renders"| node_status_tabs
node_layout -.->|"renders route"| node_task_page
node_layout -->|"requests summary"| node_task_service
node_layout -->|"requests categories"| node_category_service
node_layout -.->|"shows fallback"| node_loading
node_task_page -->|"fetches tasks"| node_task_service
node_task_page -->|"validates status"| node_task_types
node_project_info -->|"loads project"| node_project_service
node_status_tabs -->|"renders tabs"| node_nav_tabs
node_search -.->|"updates query URL"| node_task_page
node_category_filter -.->|"filters URL"| node_task_page
node_task_service -->|"loads category map"| node_category_service
node_task_service -->|"queries tasks"| node_prisma_client
node_category_service -->|"queries categories"| node_prisma_client
node_project_service -->|"queries project"| node_prisma_client
node_prisma_client -.->|"accesses"| node_database

click node_layout "https://github.com/aurorascharff/next15-filterlist/blob/main/app/layout.tsx"
click node_task_page "https://github.com/aurorascharff/next15-filterlist/blob/main/app/%5Btab%5D/page.tsx"
click node_project_info "https://github.com/aurorascharff/next15-filterlist/blob/main/components/ProjectInfo.tsx"
click node_loading "https://github.com/aurorascharff/next15-filterlist/blob/main/components/ui/Skeleton.tsx"
click node_search "https://github.com/aurorascharff/next15-filterlist/blob/main/components/Search.tsx"
click node_category_filter "https://github.com/aurorascharff/next15-filterlist/blob/main/components/CategoryFilter.tsx"
click node_status_tabs "https://github.com/aurorascharff/next15-filterlist/blob/main/components/StatusTabs.tsx"
click node_nav_tabs "https://github.com/aurorascharff/next15-filterlist/blob/main/components/ui/nav-tabs/NavTab.tsx"
click node_task_service "https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/task.ts"
click node_category_service "https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/category.ts"
click node_project_service "https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/project.ts"
click node_task_types "https://github.com/aurorascharff/next15-filterlist/blob/main/types/task.ts"
click node_prisma_client "https://github.com/aurorascharff/next15-filterlist/blob/main/db.ts"
click node_database "https://github.com/aurorascharff/next15-filterlist/blob/main/prisma/schema.prisma"

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_layout,node_task_page,node_project_info,node_loading,node_user toneBlue
class node_search,node_category_filter,node_status_tabs,node_nav_tabs toneAmber
class node_task_service,node_category_service,node_project_service,node_task_types toneMint
class node_prisma_client,node_database toneRose
```

## Components

### App experience

- [App layout](https://github.com/aurorascharff/next15-filterlist/blob/main/app/layout.tsx): `app/layout.tsx`
- [Task results](https://github.com/aurorascharff/next15-filterlist/blob/main/app/%5Btab%5D/page.tsx): `app/[tab]/page.tsx`
- [Project information](https://github.com/aurorascharff/next15-filterlist/blob/main/components/ProjectInfo.tsx): `components/ProjectInfo.tsx`
- [Loading states](https://github.com/aurorascharff/next15-filterlist/blob/main/components/ui/Skeleton.tsx): `components/ui/Skeleton.tsx`

### Filtering and navigation

- [Task search](https://github.com/aurorascharff/next15-filterlist/blob/main/components/Search.tsx): `components/Search.tsx`
- [Category filter](https://github.com/aurorascharff/next15-filterlist/blob/main/components/CategoryFilter.tsx): `components/CategoryFilter.tsx`
- [Status summaries](https://github.com/aurorascharff/next15-filterlist/blob/main/components/StatusTabs.tsx): `components/StatusTabs.tsx`
- [Tab navigation](https://github.com/aurorascharff/next15-filterlist/blob/main/components/ui/nav-tabs/NavTab.tsx): `components/ui/nav-tabs/NavTab.tsx`

### Domain services

- [Task queries](https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/task.ts): `data/services/task.ts`
- [Category queries](https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/category.ts): `data/services/category.ts`
- [Project queries](https://github.com/aurorascharff/next15-filterlist/blob/main/data/services/project.ts): `data/services/project.ts`
- [Task status model](https://github.com/aurorascharff/next15-filterlist/blob/main/types/task.ts): `types/task.ts`

### Persistence

- [Prisma client](https://github.com/aurorascharff/next15-filterlist/blob/main/db.ts): `db.ts`
- [Task database](https://github.com/aurorascharff/next15-filterlist/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **User**

## Connections

- User → App layout: opens app (evidence: `README.md`)
- App layout → Project information: renders (evidence: `app/layout.tsx`)
- App layout → Task search: renders (evidence: `app/layout.tsx`)
- App layout → Category filter: renders (evidence: `app/layout.tsx`)
- App layout → Status summaries: renders (evidence: `app/layout.tsx`)
- App layout → Task results: renders route
- App layout → Task queries: requests summary (evidence: `app/layout.tsx`)
- App layout → Category queries: requests categories (evidence: `app/layout.tsx`)
- App layout → Loading states: shows fallback
- Task results → Task queries: fetches tasks (evidence: `app/[tab]/page.tsx`)
- Task results → Task status model: validates status (evidence: `app/[tab]/page.tsx`)
- Project information → Project queries: loads project (evidence: `components/ProjectInfo.tsx`)
- Status summaries → Tab navigation: renders tabs (evidence: `components/StatusTabs.tsx`)
- Task search → Task results: updates query URL
- Category filter → Task results: filters URL
- Task queries → Category queries: loads category map (evidence: `data/services/task.ts`)
- Task queries → Prisma client: queries tasks (evidence: `data/services/task.ts`)
- Category queries → Prisma client: queries categories (evidence: `data/services/category.ts`)
- Project queries → Prisma client: queries project (evidence: `data/services/project.ts`)
- Prisma client → Task database: accesses
