# mescape/civo-temp architecture

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

- Interactive diagram: https://gitdiagram.com/mescape/civo-temp
- Repository: https://github.com/mescape/civo-temp

## Overview

Civo appears to be a multi-tenant website and page-building application: users authenticate, configure data sources, edit pages, and manage releases. The tree shows these as distinct product areas, plus a component platform and civic-data integrations. The README is only the generic Next.js starter, so it does not document product workflows. Relationships below are limited to sampled imports and calls; links for unsampled runtime wiring are dashed and marked unverified.

Main entry points: [`src/modules/builder/presentation/components/builder-shell.tsx`](https://github.com/mescape/civo-temp/blob/main/src/modules/builder/presentation/components/builder-shell.tsx) (Editor UI), [`src/modules/release/application/commands/publish-release.ts`](https://github.com/mescape/civo-temp/blob/main/src/modules/release/application/commands/publish-release.ts) (Release operations), [`src/modules/auth/presentation/actions`](https://github.com/mescape/civo-temp/tree/main/src/modules/auth/presentation/actions) (Auth actions), [`src/modules/auth/application/authorization-service.ts`](https://github.com/mescape/civo-temp/blob/main/src/modules/auth/application/authorization-service.ts) (Authorization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_pages["Auth pages<br/>[page.tsx]"]
  node_auth_actions["Auth actions"]
  node_auth_service["Authorization"]
  node_auth_decision["Access rules<br/>[authorize.ts]"]
  node_auth_provider["Auth provider<br/>[create-auth.ts]"]
end

subgraph group_builder["Page authoring"]
  node_builder_page["Builder page<br/>[page.tsx]"]
  node_builder_ui["Editor UI<br/>[builder-shell.tsx]"]
  node_drag_controller["Canvas dragging"]
  node_editor_kernel["Editor kernel<br/>[editor-model.ts]"]
  node_page_use_cases["Page operations"]
  node_page_store[("Page repository")]
end

subgraph group_content["Data and components"]
  node_data_ui["Source management"]
  node_data_actions["Source actions"]
  node_data_use_cases["Data operations"]
  node_data_connectors["Data connectors"]
  node_external_data["Civic data"]
  node_components["Component platform<br/>[definitions.ts]"]
end

subgraph group_delivery["Publishing"]
  node_release_actions["Release actions"]
  node_release_use_cases["Release operations<br/>[publish-release.ts]"]
  node_release_store[("Release repository")]
  node_public_page["Public pages<br/>[page.tsx]"]
end

subgraph group_platform["Application platform"]
  node_database[("Postgres access<br/>[client.ts]")]
  node_localization["Localization<br/>[config.ts]"]
end

node_user(("User"))

node_user -.->|"opens"| node_auth_pages
node_user -.->|"edits"| node_builder_page
node_user -.->|"configures"| node_data_ui
node_auth_actions -.->|"authorizes"| node_auth_service
node_auth_service -->|"decides"| node_auth_decision
node_auth_provider -.->|"serves"| node_auth_actions
node_builder_page -.->|"renders"| node_builder_ui
node_builder_ui -.->|"uses"| node_drag_controller
node_drag_controller -->|"resolves placement"| node_editor_kernel
node_page_use_cases -.->|"persists"| node_page_store
node_data_ui -.->|"invokes"| node_data_actions
node_data_actions -.->|"dispatches"| node_data_use_cases
node_data_use_cases -.->|"reads sources"| node_data_connectors
node_data_connectors -.->|"fetches"| node_external_data
node_builder_ui -.->|"renders components"| node_components
node_release_actions -.->|"dispatches"| node_release_use_cases
node_release_use_cases -.->|"stores releases"| node_release_store
node_release_use_cases -.->|"supplies snapshots"| node_public_page
node_page_store -.->|"queries"| node_database
node_release_store -.->|"queries"| node_database

click node_auth_pages "https://github.com/mescape/civo-temp/blob/main/src/app/%5Blocale%5D/(auth)/sign-in/page.tsx"
click node_auth_actions "https://github.com/mescape/civo-temp/tree/main/src/modules/auth/presentation/actions"
click node_auth_service "https://github.com/mescape/civo-temp/blob/main/src/modules/auth/application/authorization-service.ts"
click node_auth_decision "https://github.com/mescape/civo-temp/blob/main/src/modules/auth/domain/models/authorize.ts"
click node_auth_provider "https://github.com/mescape/civo-temp/blob/main/src/modules/auth/infrastructure/better-auth/create-auth.ts"
click node_builder_page "https://github.com/mescape/civo-temp/blob/main/src/app/%5Blocale%5D/(protected)/websites/%5BwebsiteId%5D/builder/%5BpageId%5D/page.tsx"
click node_builder_ui "https://github.com/mescape/civo-temp/blob/main/src/modules/builder/presentation/components/builder-shell.tsx"
click node_drag_controller "https://github.com/mescape/civo-temp/blob/main/src/modules/builder/presentation/dnd/canvas-drag-controller.ts"
click node_editor_kernel "https://github.com/mescape/civo-temp/blob/main/src/modules/builder/application/contracts/editor-model.ts"
click node_page_use_cases "https://github.com/mescape/civo-temp/blob/main/src/modules/builder/application/commands/save-page-config.ts"
click node_page_store "https://github.com/mescape/civo-temp/blob/main/src/modules/builder/infrastructure/prisma/prisma-page.repository.ts"
click node_data_ui "https://github.com/mescape/civo-temp/blob/main/src/modules/data-sources/presentation/components/data-sources-settings.tsx"
click node_data_actions "https://github.com/mescape/civo-temp/tree/main/src/modules/data-sources/presentation/actions"
click node_data_use_cases "https://github.com/mescape/civo-temp/blob/main/src/modules/data-sources/application/commands/create-data-source.ts"
click node_data_connectors "https://github.com/mescape/civo-temp/tree/main/src/modules/data-sources/infrastructure/connector"
click node_external_data "https://github.com/mescape/civo-temp/blob/main/src/modules/integrations/civic/infrastructure/civic-data-provider.ts"
click node_components "https://github.com/mescape/civo-temp/blob/main/src/modules/component-platform/infrastructure/definitions.ts"
click node_release_actions "https://github.com/mescape/civo-temp/blob/main/src/modules/release/presentation/actions/publish-release-action.ts"
click node_release_use_cases "https://github.com/mescape/civo-temp/blob/main/src/modules/release/application/commands/publish-release.ts"
click node_release_store "https://github.com/mescape/civo-temp/blob/main/src/modules/release/infrastructure/prisma/prisma-release.repository.ts"
click node_public_page "https://github.com/mescape/civo-temp/blob/main/src/app/%5Blocale%5D/(public)/%5B...rest%5D/page.tsx"
click node_database "https://github.com/mescape/civo-temp/blob/main/src/lib/db/client.ts"
click node_localization "https://github.com/mescape/civo-temp/blob/main/src/i18n/config.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_auth_pages,node_auth_actions,node_auth_service,node_auth_decision,node_auth_provider,node_user toneBlue
class node_builder_page,node_builder_ui,node_drag_controller,node_editor_kernel,node_page_use_cases,node_page_store toneAmber
class node_data_ui,node_data_actions,node_data_use_cases,node_data_connectors,node_external_data,node_components toneMint
class node_release_actions,node_release_use_cases,node_release_store,node_public_page toneRose
class node_database,node_localization toneIndigo
```

## Components

### Identity and access

- [Auth pages](https://github.com/mescape/civo-temp/blob/main/src/app/%5Blocale%5D/(auth)/sign-in/page.tsx): `src/app/[locale]/(auth)/sign-in/page.tsx`
- [Auth actions](https://github.com/mescape/civo-temp/tree/main/src/modules/auth/presentation/actions): `src/modules/auth/presentation/actions`
- [Authorization](https://github.com/mescape/civo-temp/blob/main/src/modules/auth/application/authorization-service.ts): `src/modules/auth/application/authorization-service.ts`
- [Access rules](https://github.com/mescape/civo-temp/blob/main/src/modules/auth/domain/models/authorize.ts): `src/modules/auth/domain/models/authorize.ts`
- [Auth provider](https://github.com/mescape/civo-temp/blob/main/src/modules/auth/infrastructure/better-auth/create-auth.ts): `src/modules/auth/infrastructure/better-auth/create-auth.ts`

### Page authoring

- [Builder page](https://github.com/mescape/civo-temp/blob/main/src/app/%5Blocale%5D/(protected)/websites/%5BwebsiteId%5D/builder/%5BpageId%5D/page.tsx): `src/app/[locale]/(protected)/websites/[websiteId]/builder/[pageId]/page.tsx`
- [Editor UI](https://github.com/mescape/civo-temp/blob/main/src/modules/builder/presentation/components/builder-shell.tsx): `src/modules/builder/presentation/components/builder-shell.tsx`
- [Canvas dragging](https://github.com/mescape/civo-temp/blob/main/src/modules/builder/presentation/dnd/canvas-drag-controller.ts): `src/modules/builder/presentation/dnd/canvas-drag-controller.ts`
- [Editor kernel](https://github.com/mescape/civo-temp/blob/main/src/modules/builder/application/contracts/editor-model.ts): `src/modules/builder/application/contracts/editor-model.ts`
- [Page operations](https://github.com/mescape/civo-temp/blob/main/src/modules/builder/application/commands/save-page-config.ts): `src/modules/builder/application/commands/save-page-config.ts`
- [Page repository](https://github.com/mescape/civo-temp/blob/main/src/modules/builder/infrastructure/prisma/prisma-page.repository.ts): `src/modules/builder/infrastructure/prisma/prisma-page.repository.ts`

### Data and components

- [Source management](https://github.com/mescape/civo-temp/blob/main/src/modules/data-sources/presentation/components/data-sources-settings.tsx): `src/modules/data-sources/presentation/components/data-sources-settings.tsx`
- [Source actions](https://github.com/mescape/civo-temp/tree/main/src/modules/data-sources/presentation/actions): `src/modules/data-sources/presentation/actions`
- [Data operations](https://github.com/mescape/civo-temp/blob/main/src/modules/data-sources/application/commands/create-data-source.ts): `src/modules/data-sources/application/commands/create-data-source.ts`
- [Data connectors](https://github.com/mescape/civo-temp/tree/main/src/modules/data-sources/infrastructure/connector): `src/modules/data-sources/infrastructure/connector`
- [Civic data](https://github.com/mescape/civo-temp/blob/main/src/modules/integrations/civic/infrastructure/civic-data-provider.ts): `src/modules/integrations/civic/infrastructure/civic-data-provider.ts`
- [Component platform](https://github.com/mescape/civo-temp/blob/main/src/modules/component-platform/infrastructure/definitions.ts): `src/modules/component-platform/infrastructure/definitions.ts`

### Publishing

- [Release actions](https://github.com/mescape/civo-temp/blob/main/src/modules/release/presentation/actions/publish-release-action.ts): `src/modules/release/presentation/actions/publish-release-action.ts`
- [Release operations](https://github.com/mescape/civo-temp/blob/main/src/modules/release/application/commands/publish-release.ts): `src/modules/release/application/commands/publish-release.ts`
- [Release repository](https://github.com/mescape/civo-temp/blob/main/src/modules/release/infrastructure/prisma/prisma-release.repository.ts): `src/modules/release/infrastructure/prisma/prisma-release.repository.ts`
- [Public pages](https://github.com/mescape/civo-temp/blob/main/src/app/%5Blocale%5D/(public)/%5B...rest%5D/page.tsx): `src/app/[locale]/(public)/[...rest]/page.tsx`

### Application platform

- [Postgres access](https://github.com/mescape/civo-temp/blob/main/src/lib/db/client.ts): `src/lib/db/client.ts`
- [Localization](https://github.com/mescape/civo-temp/blob/main/src/i18n/config.ts): `src/i18n/config.ts`

### Other components

- **User**

## Connections

- User → Auth pages: opens
- User → Builder page: edits
- User → Source management: configures
- Auth actions → Authorization: authorizes
- Authorization → Access rules: decides (evidence: `src/modules/auth/application/authorization-service.ts`)
- Auth provider → Auth actions: serves
- Builder page → Editor UI: renders
- Editor UI → Canvas dragging: uses
- Canvas dragging → Editor kernel: resolves placement (evidence: `src/modules/builder/presentation/dnd/canvas-drag-controller.ts`)
- Page operations → Page repository: persists
- Source management → Source actions: invokes
- Source actions → Data operations: dispatches
- Data operations → Data connectors: reads sources
- Data connectors → Civic data: fetches
- Editor UI → Component platform: renders components
- Release actions → Release operations: dispatches
- Release operations → Release repository: stores releases
- Release operations → Public pages: supplies snapshots
- Page repository → Postgres access: queries
- Release repository → Postgres access: queries
