# superealabs/genesis architecture

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

- Interactive diagram: https://gitdiagram.com/superealabs/genesis
- Repository: https://github.com/superealabs/genesis

## Overview

Genesis is a database-first project generator exposed through a CLI and JetBrains integration. A user selects language, framework, database entities, and output options; Genesis introspects the schema, builds generation context, renders backend and frontend templates, then writes or merges a runnable project. Separate paths support AI-generated SQL, rule-to-code generation, and synchronization reports. The tree and excerpts establish the main orchestration and metadata flow; several generator-to-output links are documented capabilities rather than fully sampled implementations.

Main entry points: [`genesis-core/src/main/java/org/labs/genesis/connexion/Database.java`](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/connexion/Database.java) (Database Access), [`genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/ProjectGenerator.java`](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/ProjectGenerator.java) (Project Generator), [`genesis-cli/src/main/java/org/labs/handler/ProjectGeneratorHandler.java`](https://github.com/superealabs/genesis/blob/main/genesis-cli/src/main/java/org/labs/handler/ProjectGeneratorHandler.java) (Project Handler), [`genesis-intellij/src/main/java/org/labs/genesis/context/GenerationContextManager.java`](https://github.com/superealabs/genesis/blob/main/genesis-intellij/src/main/java/org/labs/genesis/context/GenerationContextManager.java) (IDE Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry Points"]
  node_cli["CLI Entry<br/>[GenesisCLI.java]"]
  node_cli_handler["Project Handler"]
  node_ide_context["IDE Context"]
end

subgraph group_analysis["Schema and Context"]
  node_generation_context["Generation Context"]
  node_database["Database Access<br/>[Database.java]"]
  node_table_metadata["Schema Metadata<br/>[TableMetadata.java]"]
end

subgraph group_generation["Code Generation"]
  node_project_generator["Project Generator"]
  node_framework_generator["Backend Generator"]
  node_template_loader["Template Loader"]
  node_template_engine["Template Engine"]
  node_frontend_generator["Frontend Generator"]
  node_generated_backend["Generated Backend"]
  node_generated_frontend["Generated Frontend"]
  node_merge_tool["Project Merge<br/>[MergeTool.java]"]
end

subgraph group_sync["Sync and Integration"]
  node_sync_generator["Sync Generator<br/>[SyncGenerator.java]"]
  node_evaluators["Schema Evaluators"]
  node_sync_report["Change Reports"]
  node_llm_sql["AI SQL Client<br/>[LlmApiClient.java]"]
  node_llm_rules["Rule Code AI"]
end

node_user(("Developer"))
node_database_system[("Source Database")]
node_llm_service{{"LLM Service"}}

node_user -->|"starts generation"| node_cli
node_user -->|"starts generation"| node_ide_context
node_cli -->|"dispatches to"| node_cli_handler
node_cli_handler -->|"builds context"| node_generation_context
node_ide_context -->|"selects mode"| node_generation_context
node_cli_handler -->|"reads schema"| node_database
node_database -->|"queries metadata"| node_database_system
node_database -->|"creates metadata"| node_table_metadata
node_project_generator -->|"loads entities"| node_database
node_project_generator -->|"dispatches backend"| node_framework_generator
node_framework_generator -->|"loads templates"| node_template_loader
node_framework_generator -->|"renders code"| node_template_engine
node_template_engine -->|"produces files"| node_generated_backend
node_project_generator -->|"dispatches frontend"| node_frontend_generator
node_frontend_generator -->|"produces files"| node_generated_frontend
node_project_generator -->|"writes project"| node_merge_tool
node_ide_context -->|"selects sync"| node_sync_generator
node_sync_generator -->|"loads schema"| node_database
node_sync_generator -->|"evaluates changes"| node_evaluators
node_evaluators -->|"records changes"| node_sync_report
node_llm_sql -->|"reads schema"| node_database
node_llm_sql -.->|"generates SQL"| node_llm_service
node_llm_rules -.->|"generates code"| node_llm_service

click node_cli "https://github.com/superealabs/genesis/blob/main/genesis-cli/src/main/java/org/labs/GenesisCLI.java"
click node_cli_handler "https://github.com/superealabs/genesis/blob/main/genesis-cli/src/main/java/org/labs/handler/ProjectGeneratorHandler.java"
click node_ide_context "https://github.com/superealabs/genesis/blob/main/genesis-intellij/src/main/java/org/labs/genesis/context/GenerationContextManager.java"
click node_generation_context "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/ProjectGenerationContext.java"
click node_database "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/connexion/Database.java"
click node_table_metadata "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/connexion/model/TableMetadata.java"
click node_project_generator "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/ProjectGenerator.java"
click node_framework_generator "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/GenesisGenerator.java"
click node_template_loader "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/FrameworkTemplateLoader.java"
click node_template_engine "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/engine/GenesisTemplateEngine.java"
click node_frontend_generator "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/frontend/generator/FontendGenerator.java"
click node_merge_tool "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/merge/MergeTool.java"
click node_sync_generator "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/SyncGenerator.java"
click node_evaluators "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/evaluators/DatabaseEvaluatorsManager.java"
click node_sync_report "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/report/DatabaseReportManager.java"
click node_llm_sql "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/LlmApiClient.java"
click node_llm_rules "https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/ruleToCode/LlmApiClientRule.java"

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_cli,node_cli_handler,node_ide_context toneBlue
class node_generation_context,node_database,node_table_metadata,node_database_system toneAmber
class node_project_generator,node_framework_generator,node_template_loader,node_template_engine,node_frontend_generator,node_generated_backend,node_generated_frontend,node_merge_tool toneMint
class node_sync_generator,node_evaluators,node_sync_report,node_llm_sql,node_llm_rules toneRose
class node_user,node_llm_service toneIndigo
```

## Components

### Entry Points

- [CLI Entry](https://github.com/superealabs/genesis/blob/main/genesis-cli/src/main/java/org/labs/GenesisCLI.java): `genesis-cli/src/main/java/org/labs/GenesisCLI.java`
- [Project Handler](https://github.com/superealabs/genesis/blob/main/genesis-cli/src/main/java/org/labs/handler/ProjectGeneratorHandler.java): `genesis-cli/src/main/java/org/labs/handler/ProjectGeneratorHandler.java`
- [IDE Context](https://github.com/superealabs/genesis/blob/main/genesis-intellij/src/main/java/org/labs/genesis/context/GenerationContextManager.java): `genesis-intellij/src/main/java/org/labs/genesis/context/GenerationContextManager.java`

### Schema and Context

- [Generation Context](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/ProjectGenerationContext.java): `genesis-core/src/main/java/org/labs/genesis/config/ProjectGenerationContext.java`
- [Database Access](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/connexion/Database.java): `genesis-core/src/main/java/org/labs/genesis/connexion/Database.java`
- [Schema Metadata](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/connexion/model/TableMetadata.java): `genesis-core/src/main/java/org/labs/genesis/connexion/model/TableMetadata.java`

### Code Generation

- [Project Generator](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/ProjectGenerator.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/ProjectGenerator.java`
- [Backend Generator](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/GenesisGenerator.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/GenesisGenerator.java`
- [Template Loader](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/FrameworkTemplateLoader.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/FrameworkTemplateLoader.java`
- [Template Engine](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/engine/GenesisTemplateEngine.java): `genesis-core/src/main/java/org/labs/genesis/engine/GenesisTemplateEngine.java`
- [Frontend Generator](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/frontend/generator/FontendGenerator.java): `genesis-core/src/main/java/org/labs/genesis/frontend/generator/FontendGenerator.java`
- **Generated Backend**
- **Generated Frontend**
- [Project Merge](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/merge/MergeTool.java): `genesis-core/src/main/java/org/labs/genesis/merge/MergeTool.java`

### Sync and Integration

- [Sync Generator](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/SyncGenerator.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/SyncGenerator.java`
- [Schema Evaluators](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/evaluators/DatabaseEvaluatorsManager.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/evaluators/DatabaseEvaluatorsManager.java`
- [Change Reports](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/report/DatabaseReportManager.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/report/DatabaseReportManager.java`
- [AI SQL Client](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/LlmApiClient.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/LlmApiClient.java`
- [Rule Code AI](https://github.com/superealabs/genesis/blob/main/genesis-core/src/main/java/org/labs/genesis/config/langage/generator/ruleToCode/LlmApiClientRule.java): `genesis-core/src/main/java/org/labs/genesis/config/langage/generator/ruleToCode/LlmApiClientRule.java`

### Other components

- **Developer**
- **Source Database**
- **LLM Service**

## Connections

- Developer → CLI Entry: starts generation
- Developer → IDE Context: starts generation
- CLI Entry → Project Handler: dispatches to
- Project Handler → Generation Context: builds context
- IDE Context → Generation Context: selects mode
- Project Handler → Database Access: reads schema
- Database Access → Source Database: queries metadata
- Database Access → Schema Metadata: creates metadata
- Project Generator → Database Access: loads entities
- Project Generator → Backend Generator: dispatches backend
- Backend Generator → Template Loader: loads templates
- Backend Generator → Template Engine: renders code
- Template Engine → Generated Backend: produces files
- Project Generator → Frontend Generator: dispatches frontend
- Frontend Generator → Generated Frontend: produces files
- Project Generator → Project Merge: writes project
- IDE Context → Sync Generator: selects sync
- Sync Generator → Database Access: loads schema
- Sync Generator → Schema Evaluators: evaluates changes
- Schema Evaluators → Change Reports: records changes
- AI SQL Client → Database Access: reads schema
- AI SQL Client → LLM Service: generates SQL
- Rule Code AI → LLM Service: generates code
