# sligter/landppt architecture

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

## Overview

LandPPT is an AI presentation-generation platform: users provide a topic or document, develop an outline (optionally with research), generate and edit slides, then add narration or export/share the result. The graph preserves documented template-package, image, research, authentication, and export capabilities. Edges are based on README workflows and the supplied source index/excerpts; unsampled implementation details and wiring are not asserted.

Main entry points: [`src/landppt/web/routes.py`](https://github.com/sligter/landppt/blob/master/src/landppt/web/routes.py) (Web and API routes), [`src/landppt/services/outline/outline_workflow_service.py`](https://github.com/sligter/landppt/blob/master/src/landppt/services/outline/outline_workflow_service.py) (Outline workflow), [`src/landppt/ai/providers.py`](https://github.com/sligter/landppt/blob/master/src/landppt/ai/providers.py) (AI providers), [`src/landppt/services/slide/slide_authoring_service.py`](https://github.com/sligter/landppt/blob/master/src/landppt/services/slide/slide_authoring_service.py) (Slide authoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web and identity"]
  node_web["Web and API routes<br/>[routes.py]"]
  node_auth["Authentication<br/>[auth_service.py]"]
end

subgraph group_planning["Planning and AI"]
  node_outline["Outline workflow"]
  node_files["Document processing<br/>[file_processor.py]"]
  node_research["Deep research"]
  node_ai["AI providers<br/>[providers.py]"]
  node_execution["AI execution context<br/>[ai_execution.py]"]
end

subgraph group_creation["Slides and templates"]
  node_slides["Slide authoring"]
  node_image["Image service<br/>[image_service.py]"]
  node_packages["Template packages<br/>[service.py]"]
  node_package_storage["Package generation state<br/>[storage.py]"]
end

subgraph group_delivery["Media and delivery"]
  node_narration["Narration and scripts"]
  node_export["Export services"]
  node_sharing["Public sharing<br/>[share_service.py]"]
end

subgraph group_platform["Data and runtime"]
  node_database[("Database models<br/>[models.py]")]
  node_repositories["Database repositories<br/>[repositories.py]"]
  node_dbconfig["Configuration service"]
  node_config["Application configuration<br/>[config.py]"]
  node_cache["Cache service<br/>[cache_service.py]"]
end

node_user(("Presenter"))
node_ai_services{{"AI model providers"}}
node_research_engines{{"Search engines"}}
node_image_sources{{"Image sources"}}
node_tts{{"TTS provider"}}
node_consumers(("Export consumers"))

node_user -->|"submits topic or document"| node_web
node_web -->|"authenticates requests"| node_auth
node_web -->|"starts outline workflow"| node_outline
node_web -->|"accepts documents"| node_files
node_outline -->|"adds research"| node_research
node_outline -->|"generates outline"| node_ai
node_research -->|"searches web"| node_research_engines
node_research -->|"summarizes findings"| node_ai
node_outline -->|"hands off outline"| node_slides
node_slides -->|"generates slide content"| node_ai
node_slides -->|"requests slide imagery"| node_image
node_image -->|"searches or generates images"| node_image_sources
node_web -->|"manages template packages"| node_packages
node_packages -->|"persists generation state"| node_package_storage
node_package_storage -->|"reads and writes state"| node_database
node_repositories -.->|"accesses persisted records"| node_database
node_dbconfig -->|"loads configuration"| node_repositories
node_config -->|"configures providers"| node_ai
node_slides -.->|"adds presentation narration"| node_narration
node_narration -->|"creates spoken audio"| node_tts
node_web -->|"requests format export"| node_export
node_export -->|"delivers exported formats"| node_consumers
node_web -->|"creates public share"| node_sharing
node_auth -->|"reads and updates users"| node_database
node_auth -->|"manages sessions"| node_cache
node_execution -.->|"sets execution context"| node_ai
node_files -.->|"provides document input"| node_outline

click node_web "https://github.com/sligter/landppt/blob/master/src/landppt/web/routes.py"
click node_auth "https://github.com/sligter/landppt/blob/master/src/landppt/auth/auth_service.py"
click node_outline "https://github.com/sligter/landppt/blob/master/src/landppt/services/outline/outline_workflow_service.py"
click node_files "https://github.com/sligter/landppt/blob/master/src/landppt/services/file_processor.py"
click node_research "https://github.com/sligter/landppt/blob/master/src/landppt/services/research/enhanced_research_service.py"
click node_ai "https://github.com/sligter/landppt/blob/master/src/landppt/ai/providers.py"
click node_execution "https://github.com/sligter/landppt/blob/master/src/landppt/services/runtime/ai_execution.py"
click node_slides "https://github.com/sligter/landppt/blob/master/src/landppt/services/slide/slide_authoring_service.py"
click node_image "https://github.com/sligter/landppt/blob/master/src/landppt/services/image/image_service.py"
click node_packages "https://github.com/sligter/landppt/blob/master/src/landppt/services/template_package/service.py"
click node_package_storage "https://github.com/sligter/landppt/blob/master/src/landppt/services/slide/package_generation/storage.py"
click node_narration "https://github.com/sligter/landppt/blob/master/src/landppt/services/narration_service.py"
click node_export "https://github.com/sligter/landppt/blob/master/src/landppt/services/video_export_service.py"
click node_sharing "https://github.com/sligter/landppt/blob/master/src/landppt/services/share_service.py"
click node_database "https://github.com/sligter/landppt/blob/master/src/landppt/database/models.py"
click node_repositories "https://github.com/sligter/landppt/blob/master/src/landppt/database/repositories.py"
click node_dbconfig "https://github.com/sligter/landppt/blob/master/src/landppt/services/db_config_service.py"
click node_config "https://github.com/sligter/landppt/blob/master/src/landppt/core/config.py"
click node_cache "https://github.com/sligter/landppt/blob/master/src/landppt/services/cache_service.py"

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_web,node_auth toneBlue
class node_outline,node_files,node_research,node_ai,node_execution toneAmber
class node_slides,node_image,node_packages,node_package_storage toneMint
class node_narration,node_export,node_sharing toneRose
class node_database,node_repositories,node_dbconfig,node_config,node_cache,node_user,node_ai_services,node_research_engines,node_image_sources,node_tts,node_consumers toneIndigo
```

## Components

### Web and identity

- [Web and API routes](https://github.com/sligter/landppt/blob/master/src/landppt/web/routes.py): `src/landppt/web/routes.py`
- [Authentication](https://github.com/sligter/landppt/blob/master/src/landppt/auth/auth_service.py): `src/landppt/auth/auth_service.py`

### Planning and AI

- [Outline workflow](https://github.com/sligter/landppt/blob/master/src/landppt/services/outline/outline_workflow_service.py): `src/landppt/services/outline/outline_workflow_service.py`
- [Document processing](https://github.com/sligter/landppt/blob/master/src/landppt/services/file_processor.py): `src/landppt/services/file_processor.py`
- [Deep research](https://github.com/sligter/landppt/blob/master/src/landppt/services/research/enhanced_research_service.py): `src/landppt/services/research/enhanced_research_service.py`
- [AI providers](https://github.com/sligter/landppt/blob/master/src/landppt/ai/providers.py): `src/landppt/ai/providers.py`
- [AI execution context](https://github.com/sligter/landppt/blob/master/src/landppt/services/runtime/ai_execution.py): `src/landppt/services/runtime/ai_execution.py`

### Slides and templates

- [Slide authoring](https://github.com/sligter/landppt/blob/master/src/landppt/services/slide/slide_authoring_service.py): `src/landppt/services/slide/slide_authoring_service.py`
- [Image service](https://github.com/sligter/landppt/blob/master/src/landppt/services/image/image_service.py): `src/landppt/services/image/image_service.py`
- [Template packages](https://github.com/sligter/landppt/blob/master/src/landppt/services/template_package/service.py): `src/landppt/services/template_package/service.py`
- [Package generation state](https://github.com/sligter/landppt/blob/master/src/landppt/services/slide/package_generation/storage.py): `src/landppt/services/slide/package_generation/storage.py`

### Media and delivery

- [Narration and scripts](https://github.com/sligter/landppt/blob/master/src/landppt/services/narration_service.py): `src/landppt/services/narration_service.py`
- [Export services](https://github.com/sligter/landppt/blob/master/src/landppt/services/video_export_service.py): `src/landppt/services/video_export_service.py`
- [Public sharing](https://github.com/sligter/landppt/blob/master/src/landppt/services/share_service.py): `src/landppt/services/share_service.py`

### Data and runtime

- [Database models](https://github.com/sligter/landppt/blob/master/src/landppt/database/models.py): `src/landppt/database/models.py`
- [Database repositories](https://github.com/sligter/landppt/blob/master/src/landppt/database/repositories.py): `src/landppt/database/repositories.py`
- [Configuration service](https://github.com/sligter/landppt/blob/master/src/landppt/services/db_config_service.py): `src/landppt/services/db_config_service.py`
- [Application configuration](https://github.com/sligter/landppt/blob/master/src/landppt/core/config.py): `src/landppt/core/config.py`
- [Cache service](https://github.com/sligter/landppt/blob/master/src/landppt/services/cache_service.py): `src/landppt/services/cache_service.py`

### Other components

- **Presenter**
- **AI model providers**
- **Search engines**
- **Image sources**
- **TTS provider**
- **Export consumers**

## Connections

- Presenter → Web and API routes: submits topic or document (evidence: `README.md`)
- Web and API routes → Authentication: authenticates requests
- Web and API routes → Outline workflow: starts outline workflow (evidence: `README.md`)
- Web and API routes → Document processing: accepts documents (evidence: `README.md`)
- Outline workflow → Deep research: adds research
- Outline workflow → AI providers: generates outline
- Deep research → Search engines: searches web (evidence: `README.md`)
- Deep research → AI providers: summarizes findings (evidence: `src/landppt/services/research/enhanced_research_service.py`)
- Outline workflow → Slide authoring: hands off outline (evidence: `README.md`)
- Slide authoring → AI providers: generates slide content (evidence: `src/landppt/services/slide/slide_authoring_service.py`)
- Slide authoring → Image service: requests slide imagery (evidence: `src/landppt/services/slide/slide_authoring_service.py`)
- Image service → Image sources: searches or generates images (evidence: `README.md`)
- Web and API routes → Template packages: manages template packages (evidence: `README.md`)
- Template packages → Package generation state: persists generation state (evidence: `src/landppt/services/slide/package_generation/storage.py`)
- Package generation state → Database models: reads and writes state (evidence: `src/landppt/services/slide/package_generation/storage.py`)
- Database repositories → Database models: accesses persisted records (evidence: `src/landppt/database/repositories.py`)
- Configuration service → Database repositories: loads configuration (evidence: `src/landppt/services/db_config_service.py`)
- Application configuration → AI providers: configures providers (evidence: `src/landppt/core/config.py`)
- Slide authoring → Narration and scripts: adds presentation narration (evidence: `README.md`)
- Narration and scripts → TTS provider: creates spoken audio (evidence: `README.md`)
- Web and API routes → Export services: requests format export (evidence: `README.md`)
- Export services → Export consumers: delivers exported formats (evidence: `README.md`)
- Web and API routes → Public sharing: creates public share (evidence: `README.md`)
- Authentication → Database models: reads and updates users (evidence: `src/landppt/auth/auth_service.py`)
- Authentication → Cache service: manages sessions (evidence: `src/landppt/auth/auth_service.py`)
- AI execution context → AI providers: sets execution context
- Document processing → Outline workflow: provides document input (evidence: `README.md`)
