# saasdevsuite/biznow-app architecture

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

- Interactive diagram: https://gitdiagram.com/saasdevsuite/biznow-app
- Repository: https://github.com/saasdevsuite/biznow-app

## Overview

This repository is presented as a SaaS starter, with implemented subscription administration and a substantial news-monitoring and analytics workflow. Users browse news dashboards and subscription features; news can be scraped, processed and categorized, stored, queried, charted, and exported. The graph also includes authentication, billing, and scheduler capabilities. Edges reflect sampled code, SOURCE INDEX references, or README statements; some broader feature wiring is not shown in the excerpts.

Main entry points: [`src/prisma.ts`](https://github.com/saasdevsuite/biznow-app/blob/master/src/prisma.ts) (Application database), [`src/actions/news/operations.ts`](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/news/operations.ts) (News processing), [`src/contexts/news-context.tsx`](https://github.com/saasdevsuite/biznow-app/blob/master/src/contexts/news-context.tsx) (News dashboard state), [`src/actions/news/query.ts`](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/news/query.ts) (News queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_dashboard["News dashboard<br/>[page.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_signup["Signup API<br/>[route.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_email["Email service<br/>[email-service.ts]"]
end

subgraph group_billing["Plans and billing"]
  node_plans["Plan queries<br/>[query.ts]"]
  node_subscriptions["Subscription operations<br/>[operations.ts]"]
  node_invoices["Invoice queries<br/>[query.ts]"]
end

subgraph group_news["News analytics"]
  node_news_state["News dashboard state<br/>[news-context.tsx]"]
  node_news_queries["News queries<br/>[query.ts]"]
  node_news_processing["News processing<br/>[operations.ts]"]
  node_scraper["News scraper<br/>[scraper.ts]"]
  node_categorizer["Categorization<br/>[categorization.ts]"]
  node_sentiment["Sentiment analysis"]
  node_keyword["Keyword finder<br/>[keyword-finder.ts]"]
  node_groq["Groq client<br/>[groqClient.ts]"]
  node_charts["News charts<br/>[line-chart.tsx]"]
  node_pdf["PDF export<br/>[pdf-export.ts]"]
  node_scheduler_api["Scheduler API<br/>[route.ts]"]
  node_cron["News scheduler<br/>[cron.ts]"]
end

subgraph group_platform["Persistence and services"]
  node_database[("Application database<br/>[prisma.ts]")]
end

node_user(("User"))
node_resend["Resend email"]

node_user -->|"views"| node_dashboard
node_dashboard -.->|"uses"| node_news_state
node_news_state -->|"fetches"| node_news_queries
node_news_state -->|"exports"| node_pdf
node_news_state -->|"renders data"| node_charts
node_news_queries -->|"processes news"| node_news_processing
node_news_queries -->|"reads and caches"| node_database
node_news_processing -->|"uses"| node_categorizer
node_news_processing -->|"uses"| node_sentiment
node_news_processing -->|"uses"| node_keyword
node_news_processing -->|"calls"| node_groq
node_scraper -.->|"stores news"| node_database
node_scheduler_api -->|"starts or stops"| node_cron
node_cron -->|"uses"| node_scraper
node_cron -->|"uses"| node_news_queries
node_signup -->|"creates account"| node_database
node_signup -->|"sends verification"| node_email
node_email -->|"sends email"| node_resend
node_auth -->|"uses"| node_database
node_plans -->|"reads plans"| node_database
node_subscriptions -->|"uses"| node_database
node_invoices -->|"reads invoices"| node_database
node_user -->|"signs up"| node_signup

click node_dashboard "https://github.com/saasdevsuite/biznow-app/blob/master/src/app/(dashboard)/news/page.tsx"
click node_news_state "https://github.com/saasdevsuite/biznow-app/blob/master/src/contexts/news-context.tsx"
click node_news_queries "https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/news/query.ts"
click node_news_processing "https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/news/operations.ts"
click node_scraper "https://github.com/saasdevsuite/biznow-app/blob/master/src/service/scraper.ts"
click node_categorizer "https://github.com/saasdevsuite/biznow-app/blob/master/src/service/categorization.ts"
click node_sentiment "https://github.com/saasdevsuite/biznow-app/blob/master/src/service/sentiment-analysis.ts"
click node_keyword "https://github.com/saasdevsuite/biznow-app/blob/master/src/service/keyword-finder.ts"
click node_groq "https://github.com/saasdevsuite/biznow-app/blob/master/src/lib/groqClient.ts"
click node_charts "https://github.com/saasdevsuite/biznow-app/blob/master/src/components/custom/line-chart.tsx"
click node_pdf "https://github.com/saasdevsuite/biznow-app/blob/master/src/utils/pdf-export.ts"
click node_scheduler_api "https://github.com/saasdevsuite/biznow-app/blob/master/src/app/api/scheduler/route.ts"
click node_cron "https://github.com/saasdevsuite/biznow-app/blob/master/cron.ts"
click node_signup "https://github.com/saasdevsuite/biznow-app/blob/master/src/app/api/auth/signup/route.ts"
click node_auth "https://github.com/saasdevsuite/biznow-app/blob/master/src/auth.ts"
click node_email "https://github.com/saasdevsuite/biznow-app/blob/master/src/service/email-service.ts"
click node_plans "https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/plan/query.ts"
click node_subscriptions "https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/subscription/operations.ts"
click node_invoices "https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/invoice/query.ts"
click node_database "https://github.com/saasdevsuite/biznow-app/blob/master/src/prisma.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_dashboard,node_user toneBlue
class node_signup,node_auth,node_email toneAmber
class node_plans,node_subscriptions,node_invoices toneMint
class node_news_state,node_news_queries,node_news_processing,node_scraper,node_categorizer,node_sentiment,node_keyword,node_groq,node_charts,node_pdf,node_scheduler_api,node_cron toneRose
class node_database,node_resend toneIndigo
```

## Components

### Web experience

- [News dashboard](https://github.com/saasdevsuite/biznow-app/blob/master/src/app/(dashboard)/news/page.tsx): `src/app/(dashboard)/news/page.tsx`

### Identity and access

- [Signup API](https://github.com/saasdevsuite/biznow-app/blob/master/src/app/api/auth/signup/route.ts): `src/app/api/auth/signup/route.ts`
- [Authentication](https://github.com/saasdevsuite/biznow-app/blob/master/src/auth.ts): `src/auth.ts`
- [Email service](https://github.com/saasdevsuite/biznow-app/blob/master/src/service/email-service.ts): `src/service/email-service.ts`

### Plans and billing

- [Plan queries](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/plan/query.ts): `src/actions/plan/query.ts`
- [Subscription operations](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/subscription/operations.ts): `src/actions/subscription/operations.ts`
- [Invoice queries](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/invoice/query.ts): `src/actions/invoice/query.ts`

### News analytics

- [News dashboard state](https://github.com/saasdevsuite/biznow-app/blob/master/src/contexts/news-context.tsx): `src/contexts/news-context.tsx`
- [News queries](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/news/query.ts): `src/actions/news/query.ts`
- [News processing](https://github.com/saasdevsuite/biznow-app/blob/master/src/actions/news/operations.ts): `src/actions/news/operations.ts`
- [News scraper](https://github.com/saasdevsuite/biznow-app/blob/master/src/service/scraper.ts): `src/service/scraper.ts`
- [Categorization](https://github.com/saasdevsuite/biznow-app/blob/master/src/service/categorization.ts): `src/service/categorization.ts`
- [Sentiment analysis](https://github.com/saasdevsuite/biznow-app/blob/master/src/service/sentiment-analysis.ts): `src/service/sentiment-analysis.ts`
- [Keyword finder](https://github.com/saasdevsuite/biznow-app/blob/master/src/service/keyword-finder.ts): `src/service/keyword-finder.ts`
- [Groq client](https://github.com/saasdevsuite/biznow-app/blob/master/src/lib/groqClient.ts): `src/lib/groqClient.ts`
- [News charts](https://github.com/saasdevsuite/biznow-app/blob/master/src/components/custom/line-chart.tsx): `src/components/custom/line-chart.tsx`
- [PDF export](https://github.com/saasdevsuite/biznow-app/blob/master/src/utils/pdf-export.ts): `src/utils/pdf-export.ts`
- [Scheduler API](https://github.com/saasdevsuite/biznow-app/blob/master/src/app/api/scheduler/route.ts): `src/app/api/scheduler/route.ts`
- [News scheduler](https://github.com/saasdevsuite/biznow-app/blob/master/cron.ts): `cron.ts`

### Persistence and services

- [Application database](https://github.com/saasdevsuite/biznow-app/blob/master/src/prisma.ts): `src/prisma.ts`

### Other components

- **User**
- **Resend email**

## Connections

- User → News dashboard: views (evidence: `README.md`)
- News dashboard → News dashboard state: uses
- News dashboard state → News queries: fetches (evidence: `src/contexts/news-context.tsx`)
- News dashboard state → PDF export: exports (evidence: `src/contexts/news-context.tsx`)
- News dashboard state → News charts: renders data (evidence: `src/contexts/news-context.tsx`)
- News queries → News processing: processes news (evidence: `src/actions/news/query.ts`)
- News queries → Application database: reads and caches (evidence: `src/actions/news/query.ts`)
- News processing → Categorization: uses (evidence: `src/actions/news/operations.ts`)
- News processing → Sentiment analysis: uses (evidence: `src/actions/news/operations.ts`)
- News processing → Keyword finder: uses (evidence: `src/actions/news/operations.ts`)
- News processing → Groq client: calls (evidence: `src/actions/news/operations.ts`)
- News scraper → Application database: stores news
- Scheduler API → News scheduler: starts or stops (evidence: `src/app/api/scheduler/route.ts`)
- News scheduler → News scraper: uses (evidence: `cron.ts`)
- News scheduler → News queries: uses (evidence: `cron.ts`)
- Signup API → Application database: creates account (evidence: `src/app/api/auth/signup/route.ts`)
- Signup API → Email service: sends verification (evidence: `src/app/api/auth/signup/route.ts`)
- Email service → Resend email: sends email (evidence: `src/service/email-service.ts`)
- Authentication → Application database: uses (evidence: `src/auth.ts`)
- Plan queries → Application database: reads plans (evidence: `src/actions/plan/query.ts`)
- Subscription operations → Application database: uses (evidence: `src/actions/subscription/operations.ts`)
- Invoice queries → Application database: reads invoices (evidence: `src/actions/invoice/query.ts`)
- User → Signup API: signs up (evidence: `README.md`)
