mss-boot

---

English | 简体中文

An enterprise-level language heterogeneous microservice solution that supports grpc and http protocols. The single-service code framework adheres to the principle of minimalism, while providing complete devops process support (gitops).

📦 Latest Version: v0.7.1

documentation

http service template

grpc service template

✨ Features

• Follow RESTful API Design Specifications
• Login support idp(dex)
• Support for Swagger documentation (based on swaggo)
• Code generation tool
• Perfect cicd package
• Comprehensive core libraries (log, cache, queue, search, config)
• Multi-database support (MySQL, PostgreSQL, SQLite, MongoDB)
• Multi-storage provider support (local, S3, embed)
• Advanced error handling with standardized error codes
• Action scope management for context-aware operations
• Extensive middleware ecosystem

🚀 v0.7.1 Highlights

Core Improvements

• Enhanced Error Handling: Standardized error codes and improved error propagation
• Action Scope Management: Better context management for complex operations
• Dependency Updates: Comprehensive dependency refresh across all modules
• Performance Optimizations: Improved memory usage and response times

Testing & Quality

• Test Coverage: Comprehensive test suite with 80%+ coverage requirement
• Integration Testing: Robust integration tests for all core components
• CI/CD Pipeline: Enhanced GitHub Actions workflow with quality gates

Documentation

• Comprehensive Guides: Updated documentation for all core features
• API Reference: Complete Swagger documentation for all endpoints
• Migration Guides: Clear upgrade paths from previous versions

📋 Todo List

• Support dynamodb
• Support config provider
• Support istio traces
• Out-of-the-box support
• Enhanced error handling (v0.7.1)
• Action scope management (v0.7.1)
• Comprehensive testing infrastructure (v0.7.1)

🧪 Testing

The project follows strict testing requirements:

Test Types

• Unit Tests: *_test.go files alongside source code
• Integration Tests: Database and API integration validation
• E2E Tests: Full stack testing with real dependencies

Coverage Requirements

• Minimum Coverage: 80%
• Critical Components: 85%+
• New Code: Must meet or exceed existing coverage

Running Tests

# Unit tests
go test ./... -v

# Coverage report
go test ./... -coverprofile=coverage.out
go tool cover -func=coverage.out

# Integration tests (requires database)
go test -tags=integration ./...

🔧 Quick Start

Using Go Modules

go get github.com/mss-boot-io/mss-boot@v0.7.1

Basic Usage

package main

import (
    "github.com/mss-boot-io/mss-boot/core/server"
    "github.com/mss-boot-io/mss-boot/pkg/log"
)

func main() {
    s := server.New()
    if err := s.Run(); err != nil {
        log.Fatal("server run failed", log.Err(err))
    }
}

📝 CHANGELOG

For detailed release notes and migration guides, see CHANGELOG.md.

Buy me a coffee

JetBrains open source certificate support

The mss-boot-io project has always been developed in the GoLand integrated development environment under JetBrains, based on the free JetBrains Open Source license(s) genuine free license. I would like to express my gratitude.

🔑 License

MIT

Copyright (c) 2022 mss-boot-io