# Development Guides Index

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

---

## HTTP Frameworks

### [04_echo_framework.md](./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](./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](./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](./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](./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](./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](./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](../mvp_concept.md)
- **Architecture Improvements**: [../architecture_improvements.md](../architecture_improvements.md)
- **Original Concept**: [../concept.md](../concept.md)