> For the complete documentation index, see [llms.txt](https://framework.aic.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://framework.aic.io/technical-guidelines-code-standards-and-tech-stack/summary.md).

# Summary

### 1. Engineering Operating Model

* Technical Mission and Principles
* Engineering Golden Rules
* Architecture Decision Model
* Technical Governance and Quality Gates
* Documentation and Evidence Model
* Technical Debt and Continuous Improvement

### 2. AIC Tech Stack

* Tech Stack Overview
* Runtime and Language Standard
* IDE and Developer Tooling
* ReSharper and Static Analysis
* Web API Stack
* Desktop Stack WPF
* Cross-Platform App Stack MAUI
* Data Access Stack
* Cloud Distributed Apps and Aspire
* Observability and Telemetry Stack
* Testing Stack
* DevOps and CI/CD Stack
* Package Dependency and Supply Chain Stack
* Security Tooling Stack
* Approved Technology Radar

### 3. Solution and Architecture Standards

* Solution Structure
* Modular Clean Architecture
* Domain Driven Design Guidelines
* Vertical Slice Architecture
* Dependency Injection Standards
* Configuration and Options Pattern
* Error Handling and Result Patterns
* Logging and Correlation Standards
* Validation Strategy
* Caching Strategy
* Background Jobs and Messaging
* API Gateway and Integration Patterns
* Multi-Tenancy and Environment Isolation
* Migration and Modernisation Standards

### 4. C# Code Standards

* C# Language Version and Feature Policy
* Naming Standards
* Formatting and Style Standards
* Nullable Reference Types
* Records, Classes, Structs and Immutability
* Methods, Parameters and Return Types
* Async Await and Cancellation
* LINQ Standards
* Collections and Performance Conscious Code
* Exceptions and Guard Clauses
* Date, Time and Time Zones
* Serialization and JSON Standards
* Comments, XML Documentation and API Docs
* Analyzers, Warnings and Treat Warnings as Errors

### 5. SOLID Clean Code and Design Patterns

* SOLID in AIC Projects
* Clean Code Rules
* Design Patterns We Use
* Anti Patterns We Avoid
* Refactoring Standards
* Code Review Heuristics

### 6. Test-Driven Development and Quality Engineering

* TDD Operating Model
* Test Pyramid and Test Types
* Unit Test Standards
* Integration Test Standards
* Contract Test Standards
* UI Test Standards for WPF and MAUI
* Test Data Fixtures and Builders
* Mocking Fakes and Test Doubles
* Code Coverage and Mutation Testing
* Performance Load and Soak Testing
* Defect Management and Regression Testing

### 7. ASP.NET Core Web API Standards

* API Design Principles
* Minimal APIs vs Controllers
* Routing, Versioning and Resources
* Request and Response Models
* ProblemDetails and Error Responses
* Validation Filters and Middleware
* Authentication and Authorization Integration
* OpenAPI and API Documentation
* Pagination, Filtering and Sorting
* Idempotency, Concurrency and ETags
* Health Checks and Operational Endpoints
* API Performance and Resilience
* API Testing Checklist

### 8. WPF Standards

* WPF Application Architecture
* MVVM Standards
* XAML Style and Resource Standards
* Data Binding and Commands
* Threading and UI Responsiveness
* Navigation and Dialogs
* Accessibility and Usability
* WPF Testing and Automation
* Packaging Deployment and Updates

### 9. .NET MAUI Standards

* MAUI Application Architecture
* MVVM and State Management
* Platform Specific Code
* Permissions and Secure Storage
* Offline First and Sync
* API Integration
* Performance and Startup
* Accessibility and Device Testing
* Signing Packaging and Distribution

### 10. Data and Persistence Standards

* Database Selection
* MongoDB Standards
* EF Core Standards
* Migrations and Schema Governance
* Query Performance Standards
* Transactions and Concurrency
* Audit Trails and Soft Deletes
* Repository and Unit of Work Guidance
* Dapper and Raw SQL
* Data Seeding and Test Databases

### 11. Secure Engineering Standards

* Secure by Design for Developers
* OWASP ASVS and Top 10 Mapping
* Input Validation and Output Encoding
* Authentication, Authorization, RBAC and ABAC
* Secrets and Key Management
* Cryptography Standards
* Secure Logging
* Dependency and Vulnerability Management
* SBOM and Provenance
* Secure Coding Checklist

### 12. DevOps Repository and Release Standards

* Repository Layout
* Branching and Pull Request Model
* Commit Standards
* CI Pipeline Standards
* Build, Test and Analyse
* Release and Deployment Standards
* Environment Strategy
* Infrastructure as Code
* Versioning and Changelog
* Rollback and Feature Flags

### 13. AI-Assisted Development

* AI Coding Assistant Policy
* Prompting and Review Standards
* AI Code Risk Controls
* Generated Code Acceptance Criteria

### 14. Templates and Reference Assets

* `global.json` Template
* `Directory.Build.props` Template
* `.editorconfig` Template
* `NuGet.config` Template
* `Directory.Packages.props` Template
* Solution README Template
* Pull Request Template
* Code Review Checklist
* ADR Template
* API Design Review Template
* Test Plan Template
* ReSharper Settings Guidance
* Runsettings Template
* CI Pipeline Template
* Release Checklist

### 15. Glossary

* Glossary