xcancloud / AngusInfra

AngusInfra English | 中文 **AngusInfra** is a rapid development foundational framework based on SpringBoot. It aims to simplify and accelerate the development process of multi-tenant applications, enabling developers to build scalable, secure, and maintainable server-side applications more efficiently. **Core Features** • 🌟 **OpenAPI Support**: Strict compliance with OpenAPI specifications ensures broad community support for API development and management. • 🌟 **Multi-Tenancy Architecture**: Designed as a shared-datasource multi-tenant system, AngusInfra simplifies management and reduces hardware/operational costs while ensuring robust data isolation and security. • 🌟 **SpringBoot Foundation**: Built on SpringBoot with business-oriented extensions, it delivers powerful backend capabilities, leverages a mature ecosystem, and accelerates development workflows. • 🌟 **Rapid Development**: Pre-built components and modules enable developers to quickly scaffold applications, cutting development cycles significantly. • 🚀 **Generic Business Logic**: Standardized templates for high-frequency business scenarios reduce redundant code by over 50%. • 🚀 **Rich Utilities**: Out-of-the-box APIs for data conversion, validation, and enhanced wrappers for mainstream middleware (Cache/Database/Remote) boost development efficiency by 50%. • 🌟 **Extensibility**: Modular architecture allows flexible customization of business logic and user interfaces to meet project-specific needs. • 🌟 **Security-First Design**: Integrated authentication and authorization mechanisms (OAuth2, API Key, etc.) safeguard user data and application integrity. **Core Modules** | Module | Description | |------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ** ** | Public specifications library defining global common models (DTOs/enums/error codes), interface contracts, and cross-module communication protocols. | | ** ** | Core aggregator module — re-exports all sub-modules below for backward compatibility. New projects should depend on individual sub-modules for leaner dependencies. | Core Sub-Modules | Module | Description | |--------------------------------|------------------------------------------------------------------------------------------------------------------| | ** ** | Essential business logic, exception handling, event collection, multi-tenancy, Spring extensions, and utilities. | | ** ** | Spring Data JDBC integration with multi-tenant support, batch operations, and converter utilities. | | ** ** | Spring Data JPA integration including generic repositories, specification builders, and audit support. | | ** ** | Spring Cloud OpenFeign declarative HTTP client integration with encoding, decoding, and error handling. | | ** ** | Jackson JSON serialization customization with standard ObjectMapper configuration and custom serializers. | | ** ** | Logging, metrics, and data export utilities for application observability. | **Data Layer Modules** | Module | Description | |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ** ** | Datasource extension library offering multi-tenant dynamic datasource configuration, basic sharding strategies, and read-write separation based on Spring JPA. | | ** ** | Two-level cache library integrating Redis + Caffeine for high-performance caching, supporting distributed consistency and cache penetration prevention strategies. | | ** ** | Redis enhancement library standardizing Lettuce configurations and providing business extension utilities. | **Security & Authentication** | Module | Description | |---------------------------------------|----------------------------------------------------------------------------------------------------------------------| | ** ** | OAuth2 authorization server with automated token issuance, key management, and authorization endpoint configuration. | | ** ** | Resource server component supporting password and client credentials grant types for resource access authorization. | | ** ** | Private API authentication module (OAuth2 client credentials) for third-party system integration. | | ** ** | Open API authentication module (API Key schema) for standardized SaaS private deployment authorization. | | ** ** | Internal service authentication module (lightweight signature verification) for secure inter-service communication. | **SpringBoot Rapid Integration** | Module | Description | |--------------------------------|------------------------------------------------------------------------------------------------------------------------------| | ** ** | RESTful API development toolkit with auto-configured unified response formats, global exception handling, and CORS policies. | | ** ** | OpenAPI 3.x support with automated API documentation generation and Swagger UI integration. | **Development Toolchain** | Module | Description | |------------------|-----------------------------------------------------------------------------------------------------------------------| | ** ** | Distributed ID generator supporting Snowflake, custom business IDs, and other strategies. | | ** ** | Enhanced validation library with annotation-based rules and custom validator templates. | | ** ** | Automated code style rules enforcing Google coding standards. | | ** ** | OpenFeign-based remote call library with DTO/VO/TO definitions, unified response formats, and multi-language support. | | ** ** | Bill of Materials (BOM) for centralized dependency version management and conflict resolution. | **Architecture Governance** | Module | Description | |--------------|-----------------------------------------------------------------------------------------------------| | ** ** | Maven parent POM defining gl…