Go Chat AI - Microservices Monorepo

A modern, scalable microservices architecture built with Go, featuring authentication and AI-powered chat services. This project follows Go best practices and domain-driven design principles.

🏗️ Architecture Overview

This monorepo contains two main microservices:

• Auth Service: Handles user authentication, authorization, and user management
• Chat Service: Provides AI-powered chat functionality with OpenAI integration

Both services support both gRPC and REST APIs, with shared libraries for common functionality.

📁 Project Structure

go-chat-ai/
├── api/                    # API definitions (protobuf, OpenAPI)
│   ├── auth/              # Auth service API definitions
│   ├── chat/              # Chat service API definitions
│   └── common/            # Shared protobuf definitions
├── pkg/                   # Shared, reusable packages
│   ├── auth/              # JWT, authentication utilities
│   ├── logger/            # Structured logging
│   ├── middleware/        # HTTP/gRPC middleware
│   ├── metrics/           # Prometheus metrics
│   ├── database/          # Database connection and migrations
│   ├── config/            # Configuration management
│   ├── errors/            # Error handling utilities
│   └── utils/             # Common utilities
├── services/              # Microservices
│   ├── auth-service/      # Authentication service
│   └── chat-service/      # Chat service
├── deployments/           # Deployment configurations
│   ├── local/            # Local development
│   ├── staging/          # Staging environment
│   └── production/       # Production environment
├── scripts/               # Build and deployment scripts
├── docs/                  # Documentation
└── tools/                 # Development tools

🚀 Quick Start

Prerequisites

• Go 1.24 or later
• Docker and Docker Compose
• PostgreSQL
• Protocol Buffers compiler (protoc)

Local Development

1. Clone the repository

   git clone <repository-url>
   cd go-chat-ai

2. Set up environment variables

   cp services/auth-service/env.example services/auth-service/.env
   cp services/chat-service/env.example services/chat-service/.env
   # Edit .env files with your configuration

3. Generate protobuf code

   ./scripts/generate.sh

4. Build all services

   ./scripts/build.sh

5. Start local services

   ./scripts/deploy.sh -e local

6. Run tests

   ./scripts/test.sh

🛠️ Development

Code Generation

The project uses Protocol Buffers for API definitions. To regenerate code after changes:

./scripts/generate.sh

Building

Build individual services:

cd services/auth-service
go build -o bin/auth-service ./cmd/server

cd services/chat-service
go build -o bin/chat-service ./cmd/server

Or build all services:

./scripts/build.sh

Testing

Run tests for all services:

./scripts/test.sh

Run tests for a specific service:

cd services/auth-service
go test ./...

🚢 Deployment

Local Development

./scripts/deploy.sh -e local

Staging

./scripts/deploy.sh -e staging -s all

Production

./scripts/deploy.sh -e production -s all

Deploy Specific Service

./scripts/deploy.sh -e staging -s auth
./scripts/deploy.sh -e production -s chat

📚 API Documentation

Auth Service

• gRPC: Port 50051
• REST: Port 8080
• Health Check: /health

Chat Service

• gRPC: Port 50052
• REST: Port 8081
• Health Check: /health

🔧 Configuration

Environment Variables

Auth Service

• DATABASE_URL: PostgreSQL connection string
• JWT_SECRET: Secret for JWT token signing
• JWT_EXPIRY: JWT token expiry time
• PORT: Service port (default: 8080)
• GRPC_PORT: gRPC port (default: 50051)

Chat Service

• DATABASE_URL: PostgreSQL connection string
• OPENAI_API_KEY: OpenAI API key
• PORT: Service port (default: 8081)
• GRPC_PORT: gRPC port (default: 50052)

🧪 Testing

Unit Tests

go test ./...

Integration Tests

go test -tags=integration ./...

End-to-End Tests

go test -tags=e2e ./...

📊 Monitoring

The services expose Prometheus metrics at /metrics endpoints:

• HTTP request metrics
• gRPC request metrics
• Database connection metrics
• Custom business metrics

🔒 Security

• JWT-based authentication
• HTTPS/TLS support
• Input validation and sanitization
• SQL injection prevention
• CORS configuration

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

For support and questions:

• Create an issue in the repository
• Check the documentation
• Review the architecture guide

🔮 Roadmap

• Add notification service
• Implement payment service
• Add API Gateway
• Enhanced monitoring and alerting
• Multi-region deployment support
• Performance testing suite