# incognito10100/someproject architecture

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

- Interactive diagram: https://gitdiagram.com/incognito10100/someproject
- Repository: https://github.com/incognito10100/someproject

## Overview

1. **Overall shape**
This is a **Next.js App Router** application with both UI pages and API route handlers in the same repo. The architecture is split into:
- `app/**/page.tsx` for routed screens
- `app/api/**/route.ts` for server-side endpoints
- `components/*` for reusable client/server UI pieces
- `lib/*` for shared infrastructure and data access
- `prisma/*` for the database schema

2. **Core domain model**
The app appears centered on a productivity / learning workflow built around **journals, tasks, chains, circles, streaks, reviews, and leaderboard/activity tracking**. Those are not just pages; they are separate domain subsystems with their own API routes and UI surfaces.

3. **Frontend shell and navigation**
`app/layout.tsx`, `app/globals.css`, `components/Sidebar.tsx`, and `components/SessionProvider.tsx` define the global shell. The shell likely handles authenticated navigation, session context, and responsive layout, while pages such as `dashboard`, `journal`, `tasks`, `review-queue`, `library`, `chain`, `circles`, `login`, and `register` are the top-level user entry points.

4. **Authentication and session boundary**
Authentication is implemented with **NextAuth** via `app/api/auth/[...nextauth]/route.ts`, plus a custom registration endpoint at `app/api/auth/register/route.ts`. Shared auth logic lives in `lib/auth.ts`, and `types/next-auth.d.ts` extends session/user typing. `proxy.ts` suggests route protection or request gating at the edge/middleware layer. This creates the main boundary between public pages and authenticated app areas.

5. **Primary server/data layer**
`lib/prisma.ts` indicates **Prisma** is the main database access layer, with the schema defined in `prisma/schema.prisma`. Most domain state is presumably persisted there. The app likely reads and writes through API routes rather than direct client-to-database access, keeping the browser isolated from the persistence layer.

6. **Journal and review workflow**
Journaling is a first-class subsystem:
- `app/journal/page.tsx`
- `app/api/journals/route.ts`
- `app/api/journals/[id]/route.ts`
- `components/JournalEditor.tsx`

A review flow sits on top of that:
- `app/review-queue/page.tsx`
- `app/api/review/journal/[id]/route.ts`
- `app/api/review/submission/[id]/route.ts`
- `components/ReviewClient.tsx`

This suggests a pipeline where users create journal entries, then certain entries or submissions enter a moderation/review state before becoming fully accepted or scored.

7. **Tasks and completion pipeline**
Tasks are handled as another domain stream:
- `app/tasks/page.tsx`
- `app/api/tasks/submit/route.ts`
- `components/TaskList.tsx`

There is also admin-facing task management at `app/api/admin/tasks/route.ts`. The separation implies users submit task evidence or completions through the public task endpoint, while administrators can define or oversee tasks through admin APIs.

8. **Chains, circles, and content relationships**
The app includes **chains** and **circles** as distinct organizational/grouping concepts:
- chain UI: `app/chain/page.tsx`, `components/ChainView.tsx`, `components/QuickSeedChain.tsx`
- chain APIs: `app/api/chains/[id]/links/route.ts`
- circle APIs: `app/api/admin/circles/route.ts`, `app/circles/page.tsx`

The presence of chain links implies a graph-like structure or ordered relationship model. `QuickSeedChain` suggests users can create or bootstrap chain content quickly, while `ChainView` likely renders linked items and relationships.

9. **Progress and gamification services**
Progress tracking is separated into its own subsystem:
- `app/api/streaks/route.ts`
- `lib/streaks.ts`
- `app/api/leaderboard/route.ts`
- `app/dashboard/page.tsx`
- `components/ActivityGraph.tsx`
- `app/api/activity/route.ts`

This points to derived metrics computed from user activity, such as streak counts, ranking, and trend visualization. The `dashboard` page likely aggregates these signals into a user summary.

10. **Notifications and scheduled automation**
There are dedicated APIs for background-driven behavior:
- `app/api/notifications/route.ts`
- `app/api/cron/scheduler/route.ts`

The cron scheduler route suggests periodic jobs or server-triggered maintenance, likely used to update streaks, trigger notifications, or advance review/task states without manual user interaction.

11. **Admin subsystem**
Admin capabilities are separated from the main user flow:
- `app/admin/page.tsx`
- `components/AdminClient.tsx`
- `app/api/admin/*` for chains, circles, library, tasks, and users/roles

This is a clear administrative boundary for managing content, permissions, and operational data. The route structure shows that role management is explicit (`app/api/admin/users/role/route.ts`), which likely ties into NextAuth session roles.

12. **External services and deployment**
`lib/supabase.ts` indicates the app integrates with **Supabase** for some external backend service or storage capability, alongside Prisma-managed persistence. Deployment is configured for **Vercel** (`vercel.json`), and the repo is standard Next.js/TypeScript tooling with ESLint, Prettier, and PostCSS. `createAdmin.js` and `hashtest.js` look like utility scripts for setup or verification rather than runtime subsystems.

Main entry points: [`app/layout.tsx`](https://github.com/incognito10100/someproject/blob/main/app/layout.tsx) (App shell), [`lib/prisma.ts`](https://github.com/incognito10100/someproject/blob/main/lib/prisma.ts) (Prisma), [`components/JournalEditor.tsx`](https://github.com/incognito10100/someproject/blob/main/components/JournalEditor.tsx) (Domain clients), [`app/dashboard/page.tsx`](https://github.com/incognito10100/someproject/blob/main/app/dashboard/page.tsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_app["Next.js app"]
  node_node_layout["App shell<br/>nextjs layout<br/>[layout.tsx]"]
  node_node_home["Home<br/>landing page<br/>[page.tsx]"]
  node_node_auth_pages["Auth pages<br/>auth UI<br/>[page.tsx]"]
  node_node_session(("Session provider<br/>client context"))
  node_node_sidebar["Sidebar<br/>nav component<br/>[Sidebar.tsx]"]
end

subgraph group_group_core["Core workflows"]
  node_node_journal["Journal<br/>[page.tsx]"]
  node_node_review["Review queue<br/>review workflow<br/>[page.tsx]"]
  node_node_tasks["Tasks<br/>task workflow<br/>[page.tsx]"]
  node_node_chain["Chains<br/>relationship graph<br/>[page.tsx]"]
  node_node_circles["Circles<br/>grouping model<br/>[page.tsx]"]
  node_node_library["Library<br/>[page.tsx]"]
  node_node_dashboard["Dashboard<br/>summary view<br/>[page.tsx]"]
  node_node_activity["Activity API<br/>metrics endpoint<br/>[route.ts]"]
  node_node_journal_api["Journal API<br/>api routes<br/>[route.ts]"]
  node_node_review_api["Review APIs<br/>api routes<br/>[route.ts]"]
  node_node_tasks_api["Tasks API<br/>api routes<br/>[route.ts]"]
  node_node_chain_api["Chain links<br/>api routes<br/>[route.ts]"]
  node_node_components_misc["Domain clients<br/>ui components<br/>[JournalEditor.tsx]"]
end

subgraph group_group_admin["Admin surface"]
  node_node_admin_ui["Admin console<br/>admin UI<br/>[page.tsx]"]
  node_node_admin_api["Admin APIs<br/>admin endpoints<br/>[route.ts]"]
end

subgraph group_group_data["Data and services"]
  node_node_streaks(("Streaks<br/>progress service<br/>[streaks.ts]"))
  node_node_prisma[("Prisma<br/>database layer<br/>[prisma.ts]")]
  node_node_auth(("Auth core<br/>nextauth integration<br/>[auth.ts]"))
  node_node_schema["DB schema<br/>prisma schema<br/>[schema.prisma]"]
  node_node_supabase[("Supabase<br/>external service<br/>[supabase.ts]")]
  node_node_auth_routes["Auth routes<br/>api routes<br/>[route.ts]"]
  node_node_cron["Cron scheduler<br/>automation endpoint<br/>[route.ts]"]
  node_node_notifications["Notifications<br/>notification endpoint<br/>[route.ts]"]
end

node_node_home -->|"uses shell"| node_node_layout
node_node_auth_pages -->|"uses shell"| node_node_layout
node_node_dashboard -->|"uses shell"| node_node_layout
node_node_journal -->|"uses shell"| node_node_layout
node_node_review -->|"uses shell"| node_node_layout
node_node_tasks -->|"uses shell"| node_node_layout
node_node_chain -->|"uses shell"| node_node_layout
node_node_circles -->|"uses shell"| node_node_layout
node_node_library -->|"uses shell"| node_node_layout
node_node_admin_ui -->|"uses shell"| node_node_layout
node_node_layout -->|"renders nav"| node_node_sidebar
node_node_layout -->|"provides session"| node_node_session
node_node_auth_routes -->|"configures"| node_node_auth
node_node_auth_pages -->|"authenticates via"| node_node_auth_routes
node_node_admin_ui -->|"controls"| node_node_admin_api
node_node_dashboard -->|"loads metrics"| node_node_activity
node_node_dashboard -->|"shows streaks"| node_node_streaks
node_node_journal -->|"reads/writes"| node_node_journal_api
node_node_review -->|"reviews via"| node_node_review_api
node_node_tasks -->|"submits tasks"| node_node_tasks_api
node_node_chain -->|"loads links"| node_node_chain_api
node_node_activity -->|"queries data"| node_node_prisma
node_node_journal_api -->|"persists"| node_node_prisma
node_node_review_api -->|"persists"| node_node_prisma
node_node_tasks_api -->|"persists"| node_node_prisma
node_node_chain_api -->|"persists"| node_node_prisma
node_node_admin_api -->|"administers"| node_node_prisma
node_node_streaks -->|"reads history"| node_node_prisma
node_node_cron -->|"updates"| node_node_streaks
node_node_cron -->|"triggers"| node_node_notifications
node_node_prisma -->|"implements"| node_node_schema
node_node_prisma -.->|"integrates with"| node_node_supabase
node_node_components_misc -->|"supports"| node_node_journal_api
node_node_components_misc -->|"supports"| node_node_review_api
node_node_components_misc -->|"supports"| node_node_tasks_api
node_node_components_misc -->|"supports"| node_node_chain_api

click node_node_layout "https://github.com/incognito10100/someproject/blob/main/app/layout.tsx"
click node_node_home "https://github.com/incognito10100/someproject/blob/main/app/page.tsx"
click node_node_auth_pages "https://github.com/incognito10100/someproject/blob/main/app/login/page.tsx"
click node_node_session "https://github.com/incognito10100/someproject/blob/main/components/SessionProvider.tsx"
click node_node_sidebar "https://github.com/incognito10100/someproject/blob/main/components/Sidebar.tsx"
click node_node_journal "https://github.com/incognito10100/someproject/blob/main/app/journal/page.tsx"
click node_node_review "https://github.com/incognito10100/someproject/blob/main/app/review-queue/page.tsx"
click node_node_tasks "https://github.com/incognito10100/someproject/blob/main/app/tasks/page.tsx"
click node_node_chain "https://github.com/incognito10100/someproject/blob/main/app/chain/page.tsx"
click node_node_circles "https://github.com/incognito10100/someproject/blob/main/app/circles/page.tsx"
click node_node_library "https://github.com/incognito10100/someproject/blob/main/app/library/page.tsx"
click node_node_dashboard "https://github.com/incognito10100/someproject/blob/main/app/dashboard/page.tsx"
click node_node_activity "https://github.com/incognito10100/someproject/blob/main/app/api/activity/route.ts"
click node_node_streaks "https://github.com/incognito10100/someproject/blob/main/lib/streaks.ts"
click node_node_prisma "https://github.com/incognito10100/someproject/blob/main/lib/prisma.ts"
click node_node_auth "https://github.com/incognito10100/someproject/blob/main/lib/auth.ts"
click node_node_schema "https://github.com/incognito10100/someproject/blob/main/prisma/schema.prisma"
click node_node_supabase "https://github.com/incognito10100/someproject/blob/main/lib/supabase.ts"
click node_node_admin_ui "https://github.com/incognito10100/someproject/blob/main/app/admin/page.tsx"
click node_node_admin_api "https://github.com/incognito10100/someproject/blob/main/app/api/admin/chains/route.ts"
click node_node_auth_routes "https://github.com/incognito10100/someproject/blob/main/app/api/auth/[...nextauth]/route.ts"
click node_node_journal_api "https://github.com/incognito10100/someproject/blob/main/app/api/journals/route.ts"
click node_node_review_api "https://github.com/incognito10100/someproject/blob/main/app/api/review/journal/[id]/route.ts"
click node_node_tasks_api "https://github.com/incognito10100/someproject/blob/main/app/api/tasks/submit/route.ts"
click node_node_chain_api "https://github.com/incognito10100/someproject/blob/main/app/api/chains/[id]/links/route.ts"
click node_node_cron "https://github.com/incognito10100/someproject/blob/main/app/api/cron/scheduler/route.ts"
click node_node_notifications "https://github.com/incognito10100/someproject/blob/main/app/api/notifications/route.ts"
click node_node_components_misc "https://github.com/incognito10100/someproject/blob/main/components/JournalEditor.tsx"

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_node_layout,node_node_home,node_node_auth_pages,node_node_session,node_node_sidebar toneBlue
class node_node_journal,node_node_review,node_node_tasks,node_node_chain,node_node_circles,node_node_library,node_node_dashboard,node_node_activity,node_node_journal_api,node_node_review_api,node_node_tasks_api,node_node_chain_api,node_node_components_misc toneAmber
class node_node_admin_ui,node_node_admin_api toneMint
class node_node_streaks,node_node_prisma,node_node_auth,node_node_schema,node_node_supabase,node_node_auth_routes,node_node_cron,node_node_notifications toneRose
```

## Components

### Next.js app

Routed UI screens, shared shell, and server route handlers.

- [App shell](https://github.com/incognito10100/someproject/blob/main/app/layout.tsx): nextjs layout · Global app layout, styles, and authenticated navigation shell. · `app/layout.tsx`
- [Home](https://github.com/incognito10100/someproject/blob/main/app/page.tsx): landing page · Public entry page for the app. · `app/page.tsx`
- [Auth pages](https://github.com/incognito10100/someproject/blob/main/app/login/page.tsx): auth UI · Login and registration screens. · `app/login/page.tsx`
- [Session provider](https://github.com/incognito10100/someproject/blob/main/components/SessionProvider.tsx): client context · Client-side session context shared across the app. · `components/SessionProvider.tsx`
- [Sidebar](https://github.com/incognito10100/someproject/blob/main/components/Sidebar.tsx): nav component · Primary in-app navigation shell. · `components/Sidebar.tsx`

### Core workflows

Primary user-facing product loops and domain surfaces.

- [Journal](https://github.com/incognito10100/someproject/blob/main/app/journal/page.tsx): journal workflow · Journal entry authoring and persistence flow. · `app/journal/page.tsx`
- [Review queue](https://github.com/incognito10100/someproject/blob/main/app/review-queue/page.tsx): review workflow · Review and submission handling for journal content. · `app/review-queue/page.tsx`
- [Tasks](https://github.com/incognito10100/someproject/blob/main/app/tasks/page.tsx): task workflow · Task listing and completion submission flow. · `app/tasks/page.tsx`
- [Chains](https://github.com/incognito10100/someproject/blob/main/app/chain/page.tsx): relationship graph · Linked content and ordered chain views. · `app/chain/page.tsx`
- [Circles](https://github.com/incognito10100/someproject/blob/main/app/circles/page.tsx): grouping model · Circle-based grouping and community surface. · `app/circles/page.tsx`
- [Library](https://github.com/incognito10100/someproject/blob/main/app/library/page.tsx): content library · Shared library browsing and management surface. · `app/library/page.tsx`
- [Dashboard](https://github.com/incognito10100/someproject/blob/main/app/dashboard/page.tsx): summary view · Aggregated activity, streak, and leaderboard overview. · `app/dashboard/page.tsx`
- [Activity API](https://github.com/incognito10100/someproject/blob/main/app/api/activity/route.ts): metrics endpoint · Activity feed and graph data for progress visuals. · `app/api/activity/route.ts`
- [Journal API](https://github.com/incognito10100/someproject/blob/main/app/api/journals/route.ts): api routes · Journal CRUD endpoints. · `app/api/journals/route.ts`
- [Review APIs](https://github.com/incognito10100/someproject/blob/main/app/api/review/journal/[id]/route.ts): api routes · Review journal and submission endpoints. · `app/api/review/journal/[id]/route.ts`
- [Tasks API](https://github.com/incognito10100/someproject/blob/main/app/api/tasks/submit/route.ts): api routes · Task submission endpoint. · `app/api/tasks/submit/route.ts`
- [Chain links](https://github.com/incognito10100/someproject/blob/main/app/api/chains/[id]/links/route.ts): api routes · Chain link management endpoint. · `app/api/chains/[id]/links/route.ts`
- [Domain clients](https://github.com/incognito10100/someproject/blob/main/components/JournalEditor.tsx): ui components · Reusable workflow components for journal, review, tasks, chains, and metrics. · `components/JournalEditor.tsx`

### Admin surface

Administrative views and control endpoints.

- [Admin console](https://github.com/incognito10100/someproject/blob/main/app/admin/page.tsx): admin UI · Administrative control page and client. · `app/admin/page.tsx`
- [Admin APIs](https://github.com/incognito10100/someproject/blob/main/app/api/admin/chains/route.ts): admin endpoints · Administrative control routes for chains, circles, library, tasks, and roles. · `app/api/admin/chains/route.ts`

### Data and services

Persistence, auth, and external integrations.

- [Streaks](https://github.com/incognito10100/someproject/blob/main/lib/streaks.ts): progress service · Streak calculation and persistence helpers. · `lib/streaks.ts`
- [Prisma](https://github.com/incognito10100/someproject/blob/main/lib/prisma.ts): database layer · Primary database access layer for app data. · `lib/prisma.ts`
- [Auth core](https://github.com/incognito10100/someproject/blob/main/lib/auth.ts): nextauth integration · NextAuth configuration and shared auth logic. · `lib/auth.ts`
- [DB schema](https://github.com/incognito10100/someproject/blob/main/prisma/schema.prisma): prisma schema · Database model definitions and relationships. · `prisma/schema.prisma`
- [Supabase](https://github.com/incognito10100/someproject/blob/main/lib/supabase.ts): external service · Additional backend/storage integration. · `lib/supabase.ts`
- [Auth routes](https://github.com/incognito10100/someproject/blob/main/app/api/auth/[...nextauth]/route.ts): api routes · NextAuth and registration endpoints. · `app/api/auth/[...nextauth]/route.ts`
- [Cron scheduler](https://github.com/incognito10100/someproject/blob/main/app/api/cron/scheduler/route.ts): automation endpoint · Scheduled job entrypoint for background updates. · `app/api/cron/scheduler/route.ts`
- [Notifications](https://github.com/incognito10100/someproject/blob/main/app/api/notifications/route.ts): notification endpoint · Notification delivery and retrieval endpoint. · `app/api/notifications/route.ts`

## Connections

- Home → App shell: uses shell
- Auth pages → App shell: uses shell
- Dashboard → App shell: uses shell
- Journal → App shell: uses shell
- Review queue → App shell: uses shell
- Tasks → App shell: uses shell
- Chains → App shell: uses shell
- Circles → App shell: uses shell
- Library → App shell: uses shell
- Admin console → App shell: uses shell
- App shell → Sidebar: renders nav
- App shell → Session provider: provides session
- Auth routes → Auth core: configures
- Auth pages → Auth routes: authenticates via
- Admin console → Admin APIs: controls
- Dashboard → Activity API: loads metrics
- Dashboard → Streaks: shows streaks
- Journal → Journal API: reads/writes
- Review queue → Review APIs: reviews via
- Tasks → Tasks API: submits tasks
- Chains → Chain links: loads links
- Activity API → Prisma: queries data
- Journal API → Prisma: persists
- Review APIs → Prisma: persists
- Tasks API → Prisma: persists
- Chain links → Prisma: persists
- Admin APIs → Prisma: administers
- Streaks → Prisma: reads history
- Cron scheduler → Streaks: updates
- Cron scheduler → Notifications: triggers
- Prisma → DB schema: implements
- Prisma → Supabase: integrates with
- Domain clients → Journal API: supports
- Domain clients → Review APIs: supports
- Domain clients → Tasks API: supports
- Domain clients → Chain links: supports
