feat: copier update v0.9.0 → v0.10.0
Pulls in template changes: export_serving.py for atomic DuckDB swap, supervisor export step, SQLMesh glob macro, server provisioning script, imprint template, and formatting improvements. Template scaffold SQL models excluded (padelnomics has real models). Web app routes/analytics unchanged (padelnomics-specific customizations). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -5,18 +5,22 @@ This file tells Claude Code how to work in this repository.
|
||||
## Project Overview
|
||||
|
||||
Padelnomics is a SaaS application built with Quart (async Python), HTMX, and SQLite.
|
||||
|
||||
It includes a full data pipeline:
|
||||
|
||||
```
|
||||
External APIs → extract → landing zone → SQLMesh transform → DuckDB → web app
|
||||
```
|
||||
|
||||
|
||||
**Packages** (uv workspace):
|
||||
- `web/` — Quart + HTMX web application (auth, billing, dashboard)
|
||||
|
||||
- `extract/padelnomics_extract/` — data extraction to local landing zone
|
||||
- `transform/sqlmesh_padelnomics/` — 4-layer SQL transformation (raw → staging → foundation → serving)
|
||||
- `src/padelnomics/` — CLI utilities, export_serving helper
|
||||
|
||||
|
||||
## Skills: invoke these for domain tasks
|
||||
|
||||
### Working on extraction or transformation?
|
||||
@@ -32,6 +36,7 @@ Use the **`data-engineer`** skill for:
|
||||
/data-engineer (or ask Claude to invoke it)
|
||||
```
|
||||
|
||||
|
||||
### Working on the web app UI or frontend?
|
||||
|
||||
Use the **`frontend-design`** skill for UI components, templates, or dashboard layouts.
|
||||
@@ -66,6 +71,7 @@ uv run sqlmesh -p transform/sqlmesh_padelnomics plan prod
|
||||
# Export serving tables (run after SQLMesh)
|
||||
DUCKDB_PATH=local.duckdb SERVING_DUCKDB_PATH=analytics.duckdb \
|
||||
uv run python -m padelnomics.export_serving
|
||||
|
||||
```
|
||||
|
||||
## Architecture documentation
|
||||
@@ -96,6 +102,7 @@ analytics.duckdb ← serving tables only, web app read-only
|
||||
| `DUCKDB_PATH` | `local.duckdb` | SQLMesh pipeline DB (exclusive write) |
|
||||
| `SERVING_DUCKDB_PATH` | `analytics.duckdb` | Read-only DB for web app |
|
||||
|
||||
|
||||
## Coding philosophy
|
||||
|
||||
- **Simple and procedural** — functions over classes, no "Manager" patterns
|
||||
|
||||
Reference in New Issue
Block a user