Gallery · Documents · Score · SQL
sqlc architecture explained
Generate type-safe code from SQL. This page explains the architecture RepoLens read from sqlc-dev/sqlc at 1911a76. It is a static, deterministic scan: modules, files, and the document set. No API key is used.
Scanned the SQL compiler and the example SQL. Generated language backends are not included.
Code health for this snapshot is 94 / 100.
- Files
- 401
- Modules
- 35
- API routes
- 0
- Language
- SQL
How the code is grouped
sqlc is scanned as SQL under its public license (MIT). RepoLens groups files into modules from the repository layout, then writes the same document set it writes for a local project.
| Module | Files |
|---|---|
internal/sql/ast |
315 |
examples/ondeck |
15 |
examples/authors |
14 |
internal/sql/catalog |
9 |
examples/booktest |
6 |
internal/sql/astutils |
4 |
internal/sql/preprocess |
4 |
internal/sql/validate |
4 |
examples/batch |
2 |
examples/jets |
2 |
internal/sql/named |
2 |
internal/compiler/analyze.go |
1 |
internal/compiler/catalog_core.go |
1 |
internal/compiler/compat.go |
1 |
internal/compiler/compile.go |
1 |
internal/compiler/engine.go |
1 |
internal/compiler/expand.go |
1 |
internal/compiler/expand_core.go |
1 |
internal/compiler/find_params.go |
1 |
internal/compiler/output_columns.go |
1 |
internal/compiler/parse.go |
1 |
internal/compiler/parse_core.go |
1 |
internal/compiler/query.go |
1 |
internal/compiler/query_catalog.go |
1 |
Documents
The full generated pages live on the sqlc document page. Each section below is one of those documents.
- Executive Summary — High-level overview for leadership, product, and stakeholders
- System Overview — Concise technical overview readable by all
- Business Domains — Codebase structure translated into business language
- Architecture Overview — Layered architecture and design patterns
- Module Catalog — Complete inventory of code modules with AI explanations
- Route Map — Application routes and API endpoints with context
- API Surface — Backend API endpoints with usage examples
- Data Flows — Major information flows through the system
- Architecture Diff — Git diff analysis and impact assessment
- System Map — Visual dependency graph with explanation
- Developer Onboarding — Quick start guide for new developers
- GraphQL Schema — GraphQL types, queries, mutations, and resolver map
- TypeScript Type Graph — TypeScript interfaces, types, classes, and relationships
- Dependency Graph — Module dependency analysis with cycle detection
- Architecture Drift — Structural changes compared to baseline snapshot
- Security Hotspots — Security anti-pattern detection with CWE classification
- Code Health Report — Per-module health scores from complexity, coupling, docs, and security