fix: stuff and things

Author: CodeMeAPixel

.env.example

@@ -14,15 +14,4 @@ LOG_LEVEL=info
 
 # Cache Configuration
 CACHE_ENABLED=true
-CACHE_TTL=3600
-
-# Database (Future)
-# DB_HOST=localhost
-# DB_PORT=5432
-# DB_NAME=fixfx
-# DB_USER=fixfx
-# DB_PASSWORD=
-
-# API Keys (Future)
-# API_KEY_ARTIFACTS=
-# API_KEY_NATIVES=
+CACHE_TTL=3600

.gitignore

@@ -31,10 +31,6 @@ go.work
 .env.local
 .env.*.local
 
-# Generated files
-docs/swagger.json
-docs/swagger.yaml
-
 # Logs
 *.log
 logs/

CHANGELOG.md

@@ -0,0 +1,181 @@
+# FixFX Backend Changelog
+
+All notable changes to the FixFX backend will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Release Strategy
+- **Patch versions** (0.1.x): Bug fixes, minor improvements
+- **Minor versions** (0.x.0): New features, non-breaking changes
+- **Major versions** (x.0.0): Breaking API changes
+
+## [Unreleased]
+
+### Planned
+- [ ] Chat API endpoint with message persistence
+- [ ] Contributors API with GitHub integration
+- [ ] Global search service (cross-service search)
+- [ ] Redis caching layer for improved performance
+- [ ] Rate limiting middleware
+- [ ] Authentication/Authorization system
+- [ ] Comprehensive test suite
+- [ ] Docker containerization
+- [ ] Monitoring and metrics collection
+
+---
+
+## [0.1.0] - 2026-01-25
+
+### Added
+
+#### Core Infrastructure
+- **Fiber v2 web framework** with middleware support
+  - CORS middleware for cross-origin requests
+  - Custom logging middleware
+  - Global error handler with proper HTTP status codes
+  - Health check endpoint (`/health`)
+
+- **Swagger/OpenAPI documentation** with ReDoc UI
+  - Auto-generated API specification from code comments
+  - Beautiful dark-themed ReDoc interface matching frontend design
+  - Interactive API documentation at `/docs`
+  - JSON spec available at `/docs/doc.json`
+
+#### Services & Handlers
+
+**Artifacts Service** (3 handlers, 4 endpoints)
+- GitHub API integration for FiveM server artifacts
+- Artifact fetching with intelligent caching (1-hour TTL)
+- Version extraction and support status determination
+  - Status types: recommended, latest, active, deprecated, eol
+- Platform-specific artifact generation (Windows/Linux)
+- Advanced filtering:
+  - Filter by platform (windows/linux/all)
+  - Filter by version
+  - Filter by support status
+- Sorting capabilities:
+  - Sort by version (semantic versioning aware)
+  - Sort by date
+  - Ascending/descending order
+- Pagination support:
+  - Configurable limit (default 50, max 200)
+  - Offset-based pagination
+- Changelog retrieval between versions
+- Fallback data handling for API failures
+
+Endpoints:
+- `GET /api/artifacts/fetch` - Fetch artifacts with filtering & pagination
+- `GET /api/artifacts/version/:version` - Get specific version details
+- `GET /api/artifacts/check` - Check artifact availability
+- `GET /api/artifacts/changes` - Get changelog between versions
+
+**Natives Service** (4 handlers, 4 endpoints)
+- Multi-source native function fetching:
+  - GTA5 natives from https://runtime.fivem.net/doc/natives.json
+  - RDR3 natives from runtime.fivem.net
+  - CFX natives (custom CitizenFX natives)
+- Intelligent caching (1-hour TTL per source)
+- Environment detection (client/server/shared)
+- Namespace-based organization
+- Full-text search with relevance scoring
+  - Exact name match: +4 points
+  - Name contains: +3 points
+  - Description match: +2 points
+  - Parameter match: +1 point
+- Advanced filtering:
+  - Filter by game (gta5/rdr3/cfx)
+  - Filter by environment (client/server/shared)
+  - Filter by namespace
+- Pagination support
+- Statistics generation (total natives, by game, by environment)
+
+Endpoints:
+- `GET /api/natives` - Get natives with filtering & pagination
+- `GET /api/natives/search` - Full-text search across all natives
+- `GET /api/natives/:hash` - Get specific native by hash
+- `GET /api/natives/stats` - Get natives statistics
+
+**Source Service** (1 handler, 1 endpoint)
+- Secure file serving with whitelist validation
+- Path traversal prevention
+  - Prevents `..` directory traversal
+  - Absolute path validation
+  - Whitelist-only access
+- Syntax highlighting detection for 25+ file types
+  - TypeScript, JavaScript, Go, Python
+  - JSON, YAML, XML
+  - SQL, Shell, Dockerfile
+  - And more...
+- Proper error handling (400/403/404)
+- File metadata (size, language, path)
+
+Endpoints:
+- `GET /api/source` - Read source files with syntax detection
+
+#### Project Structure
+- `internal/services/` - Business logic layer
+- `internal/handlers/` - HTTP request/response handling
+- `internal/routes/` - Route registration and Swagger docs
+- `docs/` - Auto-generated Swagger specification
+- `Makefile` - Build automation and common tasks
+- `go.mod` - Dependency management
+- `README.md` - Project documentation
+- `DEVELOPMENT.md` - Development setup guide
+
+#### DevOps & Tooling
+- Makefile with targets:
+  - `make install` - Install dependencies and tools
+  - `make build` - Build Go binary
+  - `make dev` - Run with hot-reload (air)
+  - `make run` - Run compiled binary
+  - `make test` - Run tests
+  - `make swagger` - Generate Swagger docs
+- GitHub Actions CI/CD pipeline
+- Docker support (Dockerfile included)
+- `.env.example` - Environment configuration template
+
+#### Documentation
+- `README.md` - Quick start and API reference
+- `DEVELOPMENT.md` - Development environment setup
+- `BACKEND_MIGRATION.md` - Migration guide from Next.js
+- `BACKEND_SETUP.md` - Detailed setup instructions
+- `CHANGELOG.md` - This file
+
+### Technical Details
+
+#### Dependencies
+- `github.com/gofiber/fiber/v2` v2.52.0 - Web framework
+- `github.com/swaggo/swag` v1.16.0 - Swagger documentation
+- `github.com/swaggo/files` v1.0.1 - Swagger UI files
+- `github.com/joho/godotenv` v1.5.1 - Environment variables
+
+#### Architecture
+- **Service Pattern**: Business logic encapsulated in services
+- **Handler Pattern**: HTTP concerns handled separately
+- **Middleware**: CORS, logging, error handling
+- **Error Handling**: Consistent error responses with proper status codes
+- **Caching**: In-memory cache with TTL (ready for Redis migration)
+- **API Versioning**: Prepared for future API versioning
+
+### Performance Features
+- In-memory caching with intelligent TTL management
+- Efficient filtering and sorting algorithms
+- Pagination to prevent large response payloads
+- Relevance-based search scoring
+
+### Security Features
+- CORS enabled for development (can be configured)
+- Path validation for file serving
+- Input validation on all endpoints
+- Structured logging for debugging
+- Proper HTTP status codes for security (403, 404, etc.)
+
+### Known Limitations
+- In-memory cache (no persistence across restarts)
+- No authentication/authorization yet
+- Search endpoint uses Next.js backend (to be migrated)
+- No rate limiting
+- Health check is basic (ready to enhance)
+
+---