goserve Example API - PostgreSQL
Production-Ready Go Backend Architecture
Build scalable REST APIs with PostgreSQL, Redis, JWT auth, and clean modular design.
Quick Links
- 🚀 Get Started - Set up your development environment
- 📚 API Reference - Complete endpoint documentation
- 🏗️ Architecture - Understand the project structure
- ⚙️ Configuration - Configure your setup
Key Features
🏗️ Modular Architecture
Feature-based organization with clean separation of controllers, services, models, and DTOs for maintainable code.
🔐 Complete Authentication
JWT-based authentication with RSA signing, refresh tokens, and role-based authorization (LEARNER, AUTHOR, EDITOR, ADMIN).
⚡ High Performance
Redis caching layer, PostgreSQL connection pooling, and optimized queries for blazing-fast API responses.
🐳 Docker Ready
Complete Docker Compose setup with PostgreSQL, Redis, and application containers for easy development and deployment.
🧪 Comprehensive Testing
Unit tests and integration tests included with helper utilities for testing authentication and authorization flows.
📝 API Key Protection
All endpoints protected with API key middleware, ensuring secure access control at the infrastructure level.
🔄 Code Generation
Built-in CLI tools to generate new API features with proper structure, saving development time and ensuring consistency.
🎯 Production Ready
Best practices for error handling, validation, logging, and security built-in from day one.
Why goserve?
The goserve framework provides a robust foundation for building production-ready REST APIs in Go. This example project demonstrates:
- Clean Architecture: Feature-based modules that scale as your application grows
- Security First: JWT authentication, API keys, role-based access control
- Performance: Redis caching, database connection pooling, efficient queries
- Developer Experience: Code generators, Docker setup, comprehensive tests
Quick Example
// Create a new blog post
POST /blog/author
Authorization: Bearer <jwt_token>
x-api-key: your-api-key
{
"title": "My First Blog",
"description": "A great blog post",
"draftText": "Full blog content here...",
"slug": "my-first-blog",
"imgUrl": "https://example.com/image.jpg",
"tags": ["TECH", "GOLANG"]
}