# maksimboyko05/saasapp architecture

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

- Interactive diagram: https://gitdiagram.com/maksimboyko05/saasapp
- Repository: https://github.com/maksimboyko05/saasapp

## Overview

##### Project type and purpose
- This is a full-stack web application built with Astro. It comprises:
- A marketing/site section (homepage, pricing, FAQ, blog, authentication pages)
- A protected “app” section (project & task management, team management, Stripe billing)
- Server-side API routes (under src/pages/app/api)
- The README describes the Astro framework but the file tree shows advanced features: dynamic routing, Stripe integration, and Pocketbase for data/auth.

##### File structure
- Top-level:
- public/ – static assets served at root
- src/
– pages/ – Astro pages & server routes
– components/ – UI components grouped by “app” vs “site”
– layouts/ – page layouts for site vs app vs markdown
– data/ – Pocketbase client & types
– lib/ – helper modules (auth, Stripe)
– middleware.ts – global request middleware
- astro.config.mjs, tailwind.config.mjs – build/framework configs
- The presence of src/pages/app/api indicates Astro’s server-side routes acting as the backend API.
- src/data/pocketbase.ts shows use of a self-hosted or external Pocketbase backend for database+auth.
- src/lib/stripe.ts and pages/app/api/stripe/* handle payment flows and webhooks.

##### README for additional insights
- While the README is the default minimal Astro starter text, the project structure extends Astro with:
- A multi-page marketing site
- A SPA-like authenticated app using server routes
- Integration points for external services (Pocketbase, Stripe)

##### Detail without over-splitting
- Distinct flows for project/task CRUD, authentication, and billing.
- Essential elements:
- Static site vs app site
- Routing → file‐system mapping
- Server routes → data access
- External integrations (Pocketbase & Stripe)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    Browser["Client (Browser)"]:::client

    %% Static Hosting
    CDN["CDN / Static Host"]:::cdn

    %% Presentation Layer
    subgraph "Marketing Site Pages"
        direction TB
        Index["index.astro"]:::frontend
        BlogList["blog.astro"]:::frontend
        BlogPost["blog/[slug].astro"]:::frontend
        LoginPage["login.astro"]:::frontend
        LogoutPage["logout.astro"]:::frontend
        PasswordReset["password-reset.astro"]:::frontend
        Signup["signup.astro"]:::frontend
        Verify["verify.astro"]:::frontend
    end
    subgraph "Site UI Components"
        SiteComponents["src/components/site"]:::frontend
    end
    LayoutSite["LayoutSite.astro"]:::frontend

    subgraph "Protected App Pages"
        direction TB
        Dashboard["dashboard.astro"]:::frontend
        ProjectPage["project/[project_id].astro"]:::frontend
        TeamPage["team/[team_id].astro"]:::frontend
        Modals["modals"]:::frontend
    end
    AppComponents["src/components/app"]:::frontend
    LayoutApp["LayoutApp.astro"]:::frontend

    %% API Layer
    subgraph "Astro Server/API Layer"
        direction TB
        subgraph "Project & Task Endpoints"
            ProjectsList["projects.astro"]:::backend
            ProjectRoot["project"]:::backend
            ProjectById["project/[project_id]"]:::backend
            TaskRoot["project/[project_id]/task"]:::backend
            TaskById["project/[project_id]/task/[task_id]"]:::backend
        end
        subgraph "Team Endpoints"
            TeamsList["teams.astro"]:::backend
            TeamRoot["team"]:::backend
            TeamById["team/[team_id]"]:::backend
            TeamActivate["team/[team_id]/activate.ts"]:::backend
        end
        subgraph "Stripe Endpoints"
            StripeWebhook["stripe/webhook.ts"]:::backend
            StripeCallback["stripe/callback"]:::backend
            StripeSuccess["stripe/callback/success"]:::backend
            StripeTeamSuccess["stripe/callback/success/[team_id].ts"]:::backend
        end
    end

    %% Data Layer
    subgraph "Pocketbase Integration"
        direction TB
        PocketbaseClient["pocketbase.ts"]:::data
        PocketbaseTypes["pocketbase-types.ts"]:::data
    end

    %% Helpers & Middleware
    subgraph "Lib & Middleware"
        StripeHelper["stripe.ts"]:::lib
        AuthHelper["auth.ts"]:::lib
        Middleware["middleware.ts"]:::lib
    end

    %% External Services
    PocketbaseService["Pocketbase Backend"]:::external
    StripeService["Stripe Payment Gateway"]:::external

    %% Layouts
    LayoutSite -->|wraps| Index
    LayoutSite --> BlogList
    LayoutSite --> BlogPost
    LayoutSite --> LoginPage
    LayoutSite --> LogoutPage
    LayoutSite --> PasswordReset
    LayoutSite --> Signup
    LayoutSite --> Verify

    LayoutApp --> Dashboard
    LayoutApp --> ProjectPage
    LayoutApp --> TeamPage
    LayoutApp --> Modals

    Browser -->|HTTP| CDN
    CDN -->|serves| Index
    Browser -->|HTTP| Index
    Browser --> BlogList
    Browser --> BlogPost
    Browser --> LoginPage
    Browser --> Signup
    Browser --> Verify

    Browser -->|auth| Dashboard
    Browser --> ProjectPage
    Browser --> TeamPage

    Dashboard -->|"calls API"| ProjectsList
    ProjectPage --> TaskRoot
    ProjectById --> TaskById
    TeamPage --> TeamRoot

    ProjectsList --> PocketbaseClient
    ProjectRoot --> PocketbaseClient
    ProjectById --> PocketbaseClient
    TaskRoot --> PocketbaseClient
    TaskById --> PocketbaseClient

    TeamsList --> PocketbaseClient
    TeamRoot --> PocketbaseClient
    TeamById --> PocketbaseClient
    TeamActivate --> PocketbaseClient

    StripeWebhook --> StripeHelper
    StripeCallback --> StripeHelper
    StripeSuccess --> StripeHelper
    StripeTeamSuccess --> StripeHelper

    StripeCallback -->|on success| PocketbaseClient

    PocketbaseClient --> PocketbaseService
    PocketbaseClient --> PocketbaseTypes

    StripeHelper --> StripeService

    %% Auth & Middleware flows
    Browser -->|requests| ProjectsList
    ProjectsList --> Middleware
    Middleware --> AuthHelper
    AuthHelper --> PocketbaseClient

    %% Click Events
    click Index "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/index.astro"
    click BlogList "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/blog.astro"
    click BlogPost "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/blog/[slug].astro"
    click LoginPage "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/login.astro"
    click LogoutPage "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/logout.astro"
    click PasswordReset "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/password-reset.astro"
    click Signup "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/signup.astro"
    click Verify "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/verify.astro"
    click SiteComponents "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/components/site"
    click Dashboard "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/dashboard.astro"
    click ProjectPage "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/project/[project_id].astro"
    click TeamPage "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/team/[team_id].astro"
    click Modals "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/modals"
    click AppComponents "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/components/app"
    click ProjectsList "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/api/projects.astro"
    click ProjectRoot "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/project"
    click ProjectById "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/project/[project_id]"
    click TaskRoot "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/project/[project_id]/task"
    click TaskById "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/project/[project_id]/task/[task_id]"
    click TeamsList "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/api/teams.astro"
    click TeamRoot "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/team"
    click TeamById "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/team/[team_id]"
    click TeamActivate "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/api/team/[team_id]/activate.ts"
    click StripeWebhook "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/api/stripe/webhook.ts"
    click StripeCallback "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/stripe/callback"
    click StripeSuccess "https://github.com/maksimboyko05/saasapp/tree/SaaS-app/src/pages/app/api/stripe/callback/success"
    click StripeTeamSuccess "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/pages/app/api/stripe/callback/success/[team_id].ts"
    click PocketbaseClient "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/data/pocketbase.ts"
    click PocketbaseTypes "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/data/pocketbase-types.ts"
    click StripeHelper "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/lib/stripe.ts"
    click AuthHelper "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/lib/auth.ts"
    click Middleware "https://github.com/maksimboyko05/saasapp/blob/SaaS-app/src/middleware.ts"

    %% Styles
    classDef client fill:#eef,stroke:#77f,color:#033;
    classDef cdn stroke-dasharray: 5 5,fill:none,stroke:#888,color:#888;
    classDef frontend fill:#ddf,stroke:#55f,color:#024;
    classDef backend fill:#cdf,stroke:#38a,color:#036;
    classDef data fill:#dfd,stroke:#3a3,color:#030;
    classDef lib fill:#ffd,stroke:#fa0,color:#a60;
    classDef external fill:#fec,stroke:#f80,color:#a40;
```
