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