# kirov-opensource/nautowired architecture

> Architecture diagram of the GitHub repository kirov-opensource/nautowired, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kirov-opensource/nautowired
- Repository: https://github.com/kirov-opensource/nautowired

## Overview

##### Project Type and Purpose
- This is a .NET-based dependency-injection framework/library (NAutowired) with multiple integration layers:
- NAutowired.Core – the core attribute- and reflection-based injector
- NAutowired – ASP.NET Core integration (IControllerActivator replacement)
- NAutowired.Console – console-host integration
- Sample applications (ASP.NET Core 3.x, ASP.NET Core 6, Console)
- Unit tests for injection scenarios

##### File-Structure Analysis
- Top-level solution “NAutowired.sln” aggregates four main projects plus Samples and scripts.
- NAutowired.Core: Attributes, Models, Extensions, Exceptions, Startup base class
- NAutowired.Console: ConsoleHost builder and default host implementation
- NAutowired: ASP.NET Core controller activator and attribute for ServiceFilter
- NAutowired.Console.Test: unit tests covering injection scenarios, lifetime, circular deps
- Sample folder: three sample apps demonstrating WebAPI (3.x & 6) and Console usage
- Build/deployment scripts under “scripts/” and CI workflows under “.github/workflows”

##### README Insights
- The library “ports”/.extends the default .NET Core container, adding field injection via [Autowired]
- ASP.NET Core sample replaces default IControllerActivator with NAutowiredControllerActivator
- ConsoleHost (NAutowired.Console) bootstraps the Core DI container and injects into Startup.Run
- Supports automatic registration (AutoRegisterDependency), attributes ([Service], [Repository], etc.), and manual registration

##### Main Components & Their Interactions (to include
A. Developer Application (two variants):
1. WebAPI Host
- ASP.NET Core runtime builds IServiceCollection
- Extension methods: AddControllersAsServices(), Replace(IControllerActivator → NAutowiredControllerActivator)
- Calls AutoRegisterDependency or manual `services.AddScoped<…>()`
2. Console Host
- ConsoleHost.CreateDefaultBuilder(assemblies, args)
- Builds IServiceCollection via Startup (inherits NAutowired.Core.Startup)
3. Common: Startup.ConfigureServices adds registrations, then builds ServiceProvider
B. NAutowired.Core Library
- Scans assemblies based on attribute markers or manual registration
- Builds internal DependencyTreeModels, enforces lifetimes, resolves types via reflection
- Provides extension methods: GetServiceWithAutowired, WithAutowired
C. NAutowired (ASP.NET Integration)
- NAutowiredControllerActivator intercepts controller creation
- Uses Core’s field-injection engine to set [Autowired] properties/fields
- ServiceFilter attribute triggers resolution of filters from ServiceProvider
D. NAutowired.Console
- DefaultConsoleHostBuilder → constructs ServiceProvider and runs Startup.Run(args)
- Injects [Autowired] fields into the Startup instance before Run()
E. DI Container (IServiceCollection → IServiceProvider)
- Central registry of ServiceDescriptors (manual + auto)
- Holds Transient, Scoped, Singleton lifetimes

##### Architectural Patterns & Design Principles
- Attribute-based field injection (similar to Spring but layered over .NET Core DI)
- Extension-method based container registration (fluent builder pattern)
- Decorator/Strategy for IControllerActivator replacement
- Reflection-driven auto-scanner for annotated classes
- Hosted-service pattern for console (ConsoleHost builder)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Applications
    subgraph "Developer Applications"
        direction TB
        WebAPIHost["ASP.NET Core WebAPI Host"]:::app
        ConsoleHost["Console Host"]:::app
        WebAPIHost -->|builds IServiceCollection| ServiceCollection
        ConsoleHost -->|CreateDefaultBuilder| ConsoleHostBuilder
        ConsoleHostBuilder["ConsoleHostBuilder"]:::console -->|bootstraps| ServiceCollection
    end

    %% Core Library
    subgraph "NAutowired.Core Library"
        direction TB
        CoreProj["NAutowired.Core.csproj"]:::core
        Attributes["Attributes"]:::core
        Models["Models"]:::core
        Extensions["Extensions"]:::core
        Exceptions["Exceptions"]:::core
        StartupBase["Startup (base)"]:::core
        DIHelpers["DependencyInjection"]:::core
        HostInterfaces["Console Host Interfaces"]:::core
    end

    %% ASP.NET Integration
    subgraph "NAutowired (ASP.NET Core Integration)"
        direction TB
        AspProj["NAutowired.csproj"]:::asp
        ControllerActivator["NAutowiredControllerActivator"]:::asp
        ServiceFilterAttr["ServiceFilterAttribute"]:::asp
    end

    %% Console Integration
    subgraph "NAutowired.Console Integration"
        direction TB
        ConsoleProj["NAutowired.Console.csproj"]:::console
        ConsoleBuilder["DefaultConsoleHostBuilder"]:::console
        DefaultConsoleHost["DefaultConsoleHost"]:::console
        ConsoleAbstraction["ConsoleHost"]:::console
    end

    %% DI Container
    subgraph "DI Container"
        direction TB
        ServiceCollection[(IServiceCollection)]:::container
        ServiceProvider[(IServiceProvider)]:::container
    end

    %% Unit Tests
    subgraph "Unit Tests"
        direction TB
        TestProj["NAutowired.Console.Test.csproj"]:::test
        UnitTest["UnitTest Entry"]:::test
    end

    %% Sample Applications
    subgraph "Sample Applications"
        direction TB
        SampleWebAPI3["ASP.NET Core 3.x Sample"]:::app
        SampleWebAPI6["ASP.NET Core 6 Sample"]:::app
        SampleConsole["Console Sample"]:::app
    end

    %% Solution & Scripts
    subgraph "Solutions & Scripts"
        direction TB
        MainSolution["NAutowired.sln"]:::app
        SampleSolution["Sample/NAutowired.Sample.sln"]:::app
        CIWorkflows[".github/workflows"]:::app
        Scripts["scripts/"]:::app
    end

    %% Connections
    ServiceCollection -->|builds| ServiceProvider
    ServiceProvider -->|resolves| ControllerActivator
    ControllerActivator -->|calls| CoreScan
    CoreScan["Core scanning engine"]:::core -->|registers types| ServiceCollection
    ServiceProvider -->|injects| StartupBase
    StartupBase -->|ConfigureServices| ServiceCollection
    AspProj -->|uses| ControllerActivator
    AspProj -->|uses| ServiceFilterAttr
    ConsoleBuilder -->|uses| DIHelpers
    ConsoleAbstraction -->|runs| StartupBase
    SampleWebAPI3 -->|inherits| WebAPIHost
    SampleWebAPI6 -->|inherits| WebAPIHost
    SampleConsole -->|inherits| ConsoleHost
    UnitTest -->|tests| CoreScan

    %% Click Events
    click CoreProj "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/NAutowired.Core.csproj"
    click Attributes "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/Attributes/AutowiredAttribute.cs"
    click Models "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/Models/DependencyTreeModel.cs"
    click Extensions "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/Extensions/ServiceCollectionExtension.cs"
    click Exceptions "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/Exceptions/RegisterDependencyException.cs"
    click StartupBase "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/Startup.cs"
    click DIHelpers "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/DependencyInjection.cs"
    click HostInterfaces "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Core/IConsoleHostBuilder.cs"
    click AspProj "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired/NAutowired.csproj"
    click ControllerActivator "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired/NAutowiredControllerActivator.cs"
    click ServiceFilterAttr "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired/Attributes/ServiceFilterAttribute.cs"
    click ConsoleProj "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Console/NAutowired.Console.csproj"
    click ConsoleBuilder "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Console/DefaultConsoleHostBuilder.cs"
    click DefaultConsoleHost "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Console/DefaultConsoleHost.cs"
    click ConsoleAbstraction "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Console/ConsoleHost.cs"
    click TestProj "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Console.Test/NAutowired.Console.Test.csproj"
    click UnitTest "https://github.com/kirov-opensource/nautowired/blob/master/NAutowired.Console.Test/UnitTest.cs"
    click SampleWebAPI3 "https://github.com/kirov-opensource/nautowired/blob/master/Sample/NAutowired.WebAPI.Sample/NAutowired.WebAPI.Sample.csproj"
    click SampleWebAPI6 "https://github.com/kirov-opensource/nautowired/blob/master/Sample/NAutowired.AasNetCore6.WebAPI.Sample/NAutowired.AspNetCore6.WebAPI.Sample.csproj"
    click SampleConsole "https://github.com/kirov-opensource/nautowired/blob/master/Sample/NAutowired.Console.Sample/NAutowired.Console.Sample.csproj"

    %% Styles
    classDef core fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef asp fill:#90EE90,stroke:#000,stroke-width:1px
    classDef console fill:#FFA500,stroke:#000,stroke-width:1px
    classDef app fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef test fill:#D8BFD8,stroke:#000,stroke-width:1px
    classDef container fill:#FFFFFF,stroke:#000,stroke-width:2px,stroke-dasharray: 5 5
```
