Skip to content

Templates Overview

This document provides an overview of the ConnectSoft templates available for generating code, infrastructure, and documentation using the AI Software Factory. Templates are the foundation for generating consistent, high-quality, production-ready solutions that follow ConnectSoft's architectural principles and best practices.

What Are Templates?

Templates are pre-configured, reusable solution structures that the AI Software Factory uses to generate code, infrastructure, and documentation. Each template embodies:

  • Architectural Patterns - Clean Architecture, DDD, Event-Driven, Cloud-Native
  • Best Practices - Security-first, observability-driven, modular design
  • Technology Stack - .NET Core, Azure, modern frameworks and tools
  • Cross-Cutting Concerns - Logging, metrics, tracing, health checks, resilience

Template Categories

Backend Templates

Base Template

  • Foundation template for all specialized microservice templates
  • Domain-agnostic microservice structure
  • Clean Architecture layout
  • Base bootstrapping and infrastructure
  • See: Base Template

Microservice Template

  • Full-featured microservice with Clean Architecture
  • Domain-Driven Design patterns
  • Event-driven capabilities
  • Multi-tenant support
  • See: Microservice Template

Identity Backend Template

  • Identity and user management microservice
  • User authentication and authorization
  • Profile management
  • Multi-tenant identity support
  • See: Identity Backend Template

Authorization Server Template

API Gateway Template

  • Custom .NET Core reverse proxy gateway
  • Request routing and aggregation
  • Authentication and authorization
  • Rate limiting and throttling
  • Backend for Frontend (BFF) pattern
  • Comprehensive observability
  • See: API Gateway Template

Library Templates

Library Template

API Library Template

  • Service agent libraries for API integration
  • HTTP client management
  • Authentication support
  • Resiliency patterns
  • See: API Library Template

Platform Templates

Platform Template

  • Multi-service SaaS platform
  • Shared infrastructure
  • Platform capabilities
  • Tenant management
  • Infrastructure as Code using Pulumi (C#) for Azure and AWS
  • See: Platform Template

Frontend Templates

Frontend Templates

Mobile App Templates

  • .NET MAUI, Flutter, React Native
  • Cross-platform support
  • Native integrations
  • See: Mobile App Templates

Infrastructure Templates

DevOps Templates

  • CI/CD pipelines
  • Infrastructure as Code (Bicep, Terraform, Pulumi)
  • Deployment configurations
  • See: DevOps Templates

Observability Templates

Security and Compliance Templates

Documentation Templates

Documentation Template

Template Architecture

Templates follow a layered architecture that enables:

  • Composition - Templates can be composed together
  • Overlays - Domain-specific overlays extend base templates
  • Reusability - Common patterns shared across templates
  • Extensibility - Templates can be extended and customized

See: Template Architecture Implementation

Template Selection Guide

When to Use Base Template

  • Creating new specialized template overlays
  • Understanding microservice foundation structure
  • Building domain-agnostic microservice infrastructure
  • Extending base template functionality

When to Use Microservice Template

  • Building backend services
  • Creating domain-specific services
  • Implementing business logic
  • Building event-driven services

When to Use Identity Backend Template

  • Building identity and user management services
  • Implementing user authentication
  • Managing user profiles and accounts
  • Creating multi-tenant identity solutions

When to Use Authorization Server Template

  • Building OAuth2/OpenID Connect servers
  • Implementing token-based authentication
  • Creating authorization servers for API access
  • Building SSO (Single Sign-On) solutions

When to Use API Gateway Template

  • Aggregating multiple microservices
  • Implementing API versioning
  • Managing API authentication
  • Rate limiting and throttling

When to Use Library Template

  • Creating reusable utilities
  • Building domain models
  • Developing business logic libraries
  • Publishing NuGet packages

When to Use API Library Template

  • Integrating with external APIs
  • Building SDKs for services
  • Creating service agent libraries
  • Multi-tenant API clients

When to Use Platform Template

  • Building multi-service platforms
  • Creating SaaS platforms
  • Implementing platform capabilities
  • Managing shared infrastructure

Template Usage in AI Factory

Templates are used by the AI Software Factory in the following ways:

  1. Agent Generation - Agents use templates to generate code
  2. Blueprint Execution - Blueprints reference templates
  3. Project Bootstrap - Templates scaffold new projects
  4. Code Generation - Templates provide structure for generated code

Template Quality Standards

All ConnectSoft templates must meet:

  • Security Standards - Security-first design, secure defaults
  • Architecture Standards - Clean Architecture, DDD, event-driven
  • Quality Standards - Comprehensive testing, code quality
  • Observability Standards - Logging, metrics, tracing
  • Documentation Standards - Comprehensive documentation