# gavinlondigital/clubmembershipapplication architecture

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

- Interactive diagram: https://gitdiagram.com/gavinlondigital/clubmembershipapplication
- Repository: https://github.com/gavinlondigital/clubmembershipapplication

## Overview

##### Project type and purpose
- This is a C# console‐based “Club Membership” tutorial application that demonstrates use of EF Core (SQLite), delegates, interface‐based validation, and a simple layered architecture. It consists of two projects:
- ClubMembershipApplication – the main console app with presentation, business logic, data access, and factory code.
- FieldValidatorAPI – a reusable class‐library exposing common regex patterns and validation functions.

##### File structure
- Top‐level solution file (`.sln`) and two project folders.
- ClubMembershipApplication/
- `Program.cs` – bootstraps the app.
- Views/ – console UI views implementing `IView`.
- Models/ – domain entities (e.g., `User`).
- Data/ – EF Core `DbContext`, repository‐style interfaces (`ILogin`, `IRegister`) and implementations (`LoginUser`, `RegisterUser`).
- FieldValidators/ – interface `IFieldValidator` plus concrete validators using delegates.
- CommonOutput* – classes handling console output formatting.
- `Factory.cs` – builds instances and wires dependencies.
- FieldValidatorAPI/
- Provides `CommonFieldValidatorFunctions` and regex patterns for reuse.

##### README
- Confirms it’s a tutorial demonstrating C# delegates, EF Core with SQLite migrations, and advises on running migrations before execution.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        IView["IView"]:::presentation
        MainView["MainView"]:::presentation
        UserLoginView["UserLoginView"]:::presentation
        UserRegistrationView["UserRegistrationView"]:::presentation
        WelcomeUserView["WelcomeUserView"]:::presentation
    end

    subgraph "Orchestration Layer"
        Program["Program"]:::orchestration
        Factory["Factory"]:::orchestration
    end

    subgraph "Business Logic Layer"
        IFieldValidator["IFieldValidator"]:::business
        FieldConstants["FieldConstants"]:::business
        UserRegistrationValidator["UserRegistrationValidator"]:::business
    end

    subgraph "Data Access Layer"
        ClubMembershipDbContext["ClubMembershipDbContext"]:::data
        ILogin["ILogin"]:::data
        IRegister["IRegister"]:::data
        LoginUser["LoginUser"]:::data
        RegisterUser["RegisterUser"]:::data
    end

    subgraph "Domain Model"
        User["User"]:::domain
    end

    subgraph "Output Formatting"
        CommonOutputFormat["CommonOutputFormat"]:::output
        CommonOutputText["CommonOutputText"]:::output
    end

    subgraph "External Library"
        CommonFieldValidatorFunctions["CommonFieldValidatorFunctions"]:::external
        CommonRegularExpressionValidationPatterns["CommonRegularExpressionValidationPatterns"]:::external
    end

    SQLiteDB["SQLite Database"]:::persistence

    %% Orchestration connections
    Program --> Factory
    Program --> MainView
    Program --> UserLoginView
    Program --> UserRegistrationView
    Program --> WelcomeUserView

    Factory --> MainView
    Factory --> UserLoginView
    Factory --> UserRegistrationView
    Factory --> WelcomeUserView
    Factory --> IFieldValidator
    Factory --> LoginUser
    Factory --> RegisterUser
    Factory --> ClubMembershipDbContext

    %% Presentation flow
    MainView --> UserLoginView
    MainView --> UserRegistrationView

    UserRegistrationView --> IFieldValidator
    UserLoginView --> ILogin
    UserRegistrationView --> IRegister

    %% Business logic
    UserRegistrationView --> UserRegistrationValidator
    UserRegistrationValidator --> CommonFieldValidatorFunctions
    UserRegistrationValidator --> CommonRegularExpressionValidationPatterns

    %% Data access bindings
    IRegister --> RegisterUser
    ILogin --> LoginUser
    RegisterUser --> ClubMembershipDbContext
    LoginUser --> ClubMembershipDbContext

    ClubMembershipDbContext --> SQLiteDB
    SQLiteDB --> ClubMembershipDbContext

    %% Output formatting
    RegisterUser --> CommonOutputFormat
    RegisterUser --> CommonOutputText
    LoginUser --> CommonOutputFormat
    LoginUser --> CommonOutputText

    %% Domain usage
    RegisterUser --> User
    LoginUser --> User

    %% Click Events
    click Program "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Program.cs"
    click Factory "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Factory.cs"
    click IView "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Views/IView.cs"
    click MainView "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Views/MainView.cs"
    click UserLoginView "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Views/UserLoginView.cs"
    click UserRegistrationView "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Views/UserRegistrationView.cs"
    click WelcomeUserView "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Views/WelcomeUserView.cs"
    click User "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Models/User.cs"
    click ClubMembershipDbContext "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Data/ClubMembershipDbContext.cs"
    click ILogin "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Data/ILogin.cs"
    click IRegister "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Data/IRegister.cs"
    click LoginUser "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Data/LoginUser.cs"
    click RegisterUser "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/Data/RegisterUser.cs"
    click IFieldValidator "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/FieldValidators/IFieldValidator.cs"
    click FieldConstants "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/FieldValidators/FieldConstants.cs"
    click UserRegistrationValidator "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/FieldValidators/UserRegistrationValidator.cs"
    click CommonOutputFormat "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/CommonOutputFormat.cs"
    click CommonOutputText "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/ClubMembershipApplication/CommonOutputText.cs"
    click CommonFieldValidatorFunctions "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/FieldValidatorAPI/CommonFieldValidatorFunctions.cs"
    click CommonRegularExpressionValidationPatterns "https://github.com/gavinlondigital/clubmembershipapplication/blob/master/FieldValidatorAPI/CommonRegularExpressionValidationPatterns.cs"

    %% Styles
    classDef presentation fill:#b3ffb3,stroke:#2d7f2d,color:#000
    classDef orchestration fill:#b3ffff,stroke:#0d5c5c,color:#000
    classDef business fill:#b3d1ff,stroke:#2e3d7f,color:#000
    classDef data fill:#ffddb3,stroke:#7f5c2d,color:#000
    classDef domain fill:#e6e6e6,stroke:#999,color:#000
    classDef output fill:#ffe6f2,stroke:#7f2d5c,color:#000
    classDef external fill:#d9d9d9,stroke:#666,color:#000
    classDef persistence fill:#999966,stroke:#333,color:#000
```
