Imported from isaquerr25/go-templ-htmx (AGENTS.md). Install upstream with npx skills add isaquerr25/go-templ-htmx. Copyright stays with the author.

go-templ-htmx

Go + Echo v4 + GORM + SQLite + templ + HTMX + Tailwind CSS — agricultural management system focused on planting lifecycle (fields, plantings, fertilizations, pulverizations, irrigations, harvests, vaccinations, services, cash flow, sales).

Commands

Architecture

• All .go files are package main in the repo root — no internal/ or cmd/.
• Global var db *gorm.DB — most handlers capture it via closures; Server struct (in product.go) used only for Product/Client/Sale/TypeProduct handlers.
• SQLite via gorm.io/driver/sqlite — base.db checked into VC. No PostgreSQL.
• templ codegen: each views/**/*.templ produces sibling _templ.go (compiled Go) and _templ.txt (watch marker). Generated files checked in.
• HTMX v2 drives frontend partial rendering via hx-* attributes. No session/auth middleware.
• Tailwind CSS vendored binary in root; content scans ./views/**/*.templ.
• No authentication, no multi-tenancy, no organizations — single-user mode.
• All views under views/pages/<entity>/ with Index, List, Show, Form patterns.
• Single base template at views/templates/index.templ.

Data Models (models.go)

Handler Files

Key Patterns

• FIFO stock: consumeStock() consumes oldest lots first; restoreStock() returns to recent lots. Used by pulverization and fertilization.
• regraDeTres() (rule of three): (b * c) / a — calculates proportional cost from total qty/cost.
• HX-Redirect header for HTMX navigation after form submission — no JSON responses.
• No validation packages — validation inline in each handler/bind.
• Server struct (empty) serves as method receiver for Product/Client/Sale/TypeProduct routes only.
• Planting stage computation based on TypeProduct phenological day offsets since StartedAt.

Quirks

• Confusing naming: Field struct exists but GetAllFields() returns TypeProduct data; field.go handler manages physical Field model but helper mixes types.
• typeProductId typo: Planting form field named typeProdutcId (missing 'c') — consistent across validation and model.
• Irrigation DELETE: uses in-memory irrigationStore slice instead of DB.
• CreatePulverization divides raw quantity by 1000 (assumes input in mL, stores in L).
• No cascade deletes on Planting — child records orphaned on delete.
• Sale model saves SoldAt as string via time.Time.String() instead of time.Time — breaks date filtering.
• Harvest modifies TypeProduct.Quantity (which is supposed to be a crop type template, not inventory).
• No auth, no sessions — single-user mode, no middleware.
• go vet / go build is the only validation available — no linters or tests.