turash/docs/dev_guides

Development Guides Index

Quick reference guides for libraries and concepts used in the Turash MVP.

---

HTTP Frameworks

04_echo_framework.md ⭐ Primary Choice

• Library: github.com/labstack/echo/v4
• Used For: Primary HTTP API server
• Key Topics: Routing, middleware, validation, error handling

01_gin_framework.md - Alternative

• Library: github.com/gin-gonic/gin
• Used For: Alternative HTTP framework (if needed)
• Key Topics: Routing, middleware, request binding, error handling

---

Databases

02_neo4j_driver.md

• Library: github.com/neo4j/neo4j-go-driver/v5
• Used For: Graph database for resource matching
• Key Topics: Driver setup, Cypher queries, transactions, graph patterns

03_gorm.md ⭐ Primary Choice

• Library: gorm.io/gorm
• Used For: PostgreSQL ORM with PostGIS support
• Key Topics: Models, migrations, CRUD, relationships, PostGIS integration

05_pgx_postgres.md - Alternative

• Library: github.com/jackc/pgx/v5
• Used For: PostgreSQL driver (if raw SQL needed)
• Key Topics: Connection pooling, PostGIS spatial queries, transactions

---

Caching & Concurrency

06_go_channels_goroutines.md

• Library: Built-in Go concurrency
• Used For: Event processing, background workers, worker pools
• Key Topics: Goroutines, channels, worker pools, graceful shutdown

07_redis_go.md

• Library: github.com/redis/go-redis/v9
• Used For: Caching match results, sessions, rate limiting
• Key Topics: Caching patterns, session management, rate limiting

---

Coming Soon

• WebSockets - Real-time updates (gorilla/nhooyr)
• Validator - Input validation (go-playground/validator)
• Testing - Go testing patterns and best practices

---

Quick Links

• MVP Concept: ../mvp_concept.md
• Architecture Improvements: ../architecture_improvements.md
• Original Concept: ../concept.md