# gsmtcnr/corex architecture

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

- Interactive diagram: https://gitdiagram.com/gsmtcnr/corex
- Repository: https://github.com/gsmtcnr/corex

## Overview

Corex is a .NET infrastructure library, not a standalone application. Its documented use-case path is an application-facing operation manager coordinating validation, business/data operations, persistence, mapping, caching, and result/error handling. The repository also supplies independent infrastructure branches for models, logging, communication, files, serialization, and other integrations. Several capability branches are documented in the README but their implementation calls were not sampled, so those relationships are omitted rather than inferred.

Main entry points: [`Corex.Operation.Manager/BaseOperationManager.cs`](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Manager/BaseOperationManager.cs) (Operation manager), [`Corex.Operation.Derived.DataOperation/BaseDataOperation.cs`](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.DataOperation/BaseDataOperation.cs) (Data operation), [`Corex.MongoDB.Derived.V1/Repository/Repository.cs`](https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Repository.cs) (Mongo repository), [`Corex.Data.Infrastructure/Repositories/BaseEntityRepository.cs`](https://github.com/gsmtcnr/corex/blob/master/Corex.Data.Infrastructure/Repositories/BaseEntityRepository.cs) (EF repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Operations"]
  node_operation_manager["Operation manager"]
  node_business_operation["Business operation"]
  node_validation_operation["Validation operation"]
  node_data_operation["Data operation"]
  node_operation_results["Operation results"]
end

subgraph group_data["Data access"]
  node_entity_framework["EF repository"]
  node_entity_context["Entity context"]
  node_mongo_repository["Mongo repository<br/>[Repository.cs]"]
  node_mongo_insert["Mongo insert<br/>[Insert.cs]"]
  node_mongo_update["Mongo update<br/>[Update.cs]"]
  node_mongo_delete["Mongo delete<br/>[Delete.cs]"]
end

subgraph group_foundation["Shared foundation"]
  node_model_types["Model types<br/>[IModel.cs]"]
  node_mapping["Object mapping<br/>[IMapping.cs]"]
  node_cache["Cache managers<br/>[ICacheManager.cs]"]
  node_exception_manager["Exception manager"]
  node_validation_rules["Validation rules<br/>[ValidationBase.cs]"]
end

subgraph group_integrations["Integrations"]
  node_logging["Logging<br/>[ILog.cs]"]
  node_email["Email sending<br/>[IEmailSender.cs]"]
  node_sms["SMS sending<br/>[ISmsSender.cs]"]
  node_push["Push sending<br/>[IPushSender.cs]"]
  node_cloud_files["Cloud uploads"]
  node_pdf["PDF conversion<br/>[IPDFConverter.cs]"]
  node_serialization["Serialization<br/>[IJsonSerializer.cs]"]
  node_encryption["Encryption"]
  node_template_render["Template rendering<br/>[ITemplateRender.cs]"]
end

subgraph group_presentation["Presentation"]
  node_mvc["MVC hosting<br/>[BaseMvcStartup.cs]"]
end

node_application(("Application layer"))
node_external_stores[("External stores")]
node_external_services{{"External services"}}

node_application -->|"uses"| node_operation_manager
node_operation_manager -->|"coordinates"| node_data_operation
node_operation_manager -->|"validates through"| node_validation_operation
node_operation_manager -->|"maps models"| node_mapping
node_operation_manager -->|"reads cache"| node_cache
node_operation_manager -->|"formats errors"| node_exception_manager
node_operation_manager -->|"returns"| node_operation_results
node_operation_manager -->|"coordinates"| node_business_operation
node_data_operation -->|"writes through"| node_mongo_insert
node_data_operation -->|"updates through"| node_mongo_update
node_data_operation -->|"deletes through"| node_mongo_delete
node_mongo_insert -->|"uses collection"| node_mongo_repository
node_mongo_update -->|"uses collection"| node_mongo_repository
node_mongo_delete -->|"uses collection"| node_mongo_repository
node_entity_framework -->|"creates context"| node_entity_context
node_entity_framework -.->|"persists data"| node_external_stores
node_mongo_repository -->|"accesses MongoDB"| node_external_stores
node_cloud_files -->|"uploads blobs"| node_external_stores
node_logging -.->|"writes logs"| node_external_stores
node_email -.->|"sends email"| node_external_services
node_sms -.->|"sends SMS"| node_external_services
node_push -.->|"sends notifications"| node_external_services
node_pdf -.->|"uploads output"| node_cloud_files
node_mvc -.->|"hosts layer"| node_application

click node_operation_manager "https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Manager/BaseOperationManager.cs"
click node_business_operation "https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.BusinessOperation/BaseBusinessOperation.cs"
click node_validation_operation "https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.ValidationOperation/BaseValidationOperation.cs"
click node_data_operation "https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.DataOperation/BaseDataOperation.cs"
click node_operation_results "https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Manager/Results/ResultObjectModel.cs"
click node_entity_framework "https://github.com/gsmtcnr/corex/blob/master/Corex.Data.Infrastructure/Repositories/BaseEntityRepository.cs"
click node_entity_context "https://github.com/gsmtcnr/corex/blob/master/Corex.Data.Infrastructure/Contexts/BaseEntityContext.cs"
click node_mongo_repository "https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Repository.cs"
click node_mongo_insert "https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Insert.cs"
click node_mongo_update "https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Update.cs"
click node_mongo_delete "https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Delete.cs"
click node_model_types "https://github.com/gsmtcnr/corex/blob/master/Corex.Model.Infrastructure/IModel.cs"
click node_mapping "https://github.com/gsmtcnr/corex/blob/master/Corex.Mapper.Infrastructure/IMapping.cs"
click node_cache "https://github.com/gsmtcnr/corex/blob/master/Corex.Cache.Infrastructure/ICacheManager.cs"
click node_exception_manager "https://github.com/gsmtcnr/corex/blob/master/Corex.ExceptionHandling.Manager/BaseExceptionManager.cs"
click node_validation_rules "https://github.com/gsmtcnr/corex/blob/master/Corex.Validation.Infrastructure/ValidationBase.cs"
click node_logging "https://github.com/gsmtcnr/corex/blob/master/Corex.Log.Infrastructure/ILog.cs"
click node_email "https://github.com/gsmtcnr/corex/blob/master/Corex.EmailSender.Infrastructure/IEmailSender.cs"
click node_sms "https://github.com/gsmtcnr/corex/blob/master/Corex.SmsSender.Infrastructure/ISmsSender.cs"
click node_push "https://github.com/gsmtcnr/corex/blob/master/Corex.PushSender.Infrastructure/IPushSender.cs"
click node_cloud_files "https://github.com/gsmtcnr/corex/blob/master/Corex.CloudFile.Derived.AzureBlobStorage/BaseAzureBlobStorage.cs"
click node_pdf "https://github.com/gsmtcnr/corex/blob/master/Corex.PDFConverter.Infrastructure/IPDFConverter.cs"
click node_serialization "https://github.com/gsmtcnr/corex/blob/master/Corex.JsonSerializer.Infrastructure/IJsonSerializer.cs"
click node_encryption "https://github.com/gsmtcnr/corex/blob/master/Corex.CipherEncryption.Infrastructure/ICipherEncryption.cs"
click node_template_render "https://github.com/gsmtcnr/corex/blob/master/Corex.TemplateRender.Infrastructure/ITemplateRender.cs"
click node_mvc "https://github.com/gsmtcnr/corex/blob/master/Corex.Presentation.Derived.MVC/BaseMvcStartup.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_operation_manager,node_business_operation,node_validation_operation,node_data_operation,node_operation_results toneBlue
class node_entity_framework,node_entity_context,node_mongo_repository,node_mongo_insert,node_mongo_update,node_mongo_delete,node_external_stores toneAmber
class node_model_types,node_mapping,node_cache,node_exception_manager,node_validation_rules toneMint
class node_logging,node_email,node_sms,node_push,node_cloud_files,node_pdf,node_serialization,node_encryption,node_template_render toneRose
class node_mvc,node_application,node_external_services toneIndigo
```

## Components

### Operations

- [Operation manager](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Manager/BaseOperationManager.cs): `Corex.Operation.Manager/BaseOperationManager.cs`
- [Business operation](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.BusinessOperation/BaseBusinessOperation.cs): `Corex.Operation.Derived.BusinessOperation/BaseBusinessOperation.cs`
- [Validation operation](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.ValidationOperation/BaseValidationOperation.cs): `Corex.Operation.Derived.ValidationOperation/BaseValidationOperation.cs`
- [Data operation](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Derived.DataOperation/BaseDataOperation.cs): `Corex.Operation.Derived.DataOperation/BaseDataOperation.cs`
- [Operation results](https://github.com/gsmtcnr/corex/blob/master/Corex.Operation.Manager/Results/ResultObjectModel.cs): `Corex.Operation.Manager/Results/ResultObjectModel.cs`

### Data access

- [EF repository](https://github.com/gsmtcnr/corex/blob/master/Corex.Data.Infrastructure/Repositories/BaseEntityRepository.cs): `Corex.Data.Infrastructure/Repositories/BaseEntityRepository.cs`
- [Entity context](https://github.com/gsmtcnr/corex/blob/master/Corex.Data.Infrastructure/Contexts/BaseEntityContext.cs): `Corex.Data.Infrastructure/Contexts/BaseEntityContext.cs`
- [Mongo repository](https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Repository.cs): `Corex.MongoDB.Derived.V1/Repository/Repository.cs`
- [Mongo insert](https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Insert.cs): `Corex.MongoDB.Derived.V1/Repository/Insert.cs`
- [Mongo update](https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Update.cs): `Corex.MongoDB.Derived.V1/Repository/Update.cs`
- [Mongo delete](https://github.com/gsmtcnr/corex/blob/master/Corex.MongoDB.Derived.V1/Repository/Delete.cs): `Corex.MongoDB.Derived.V1/Repository/Delete.cs`

### Shared foundation

- [Model types](https://github.com/gsmtcnr/corex/blob/master/Corex.Model.Infrastructure/IModel.cs): `Corex.Model.Infrastructure/IModel.cs`
- [Object mapping](https://github.com/gsmtcnr/corex/blob/master/Corex.Mapper.Infrastructure/IMapping.cs): `Corex.Mapper.Infrastructure/IMapping.cs`
- [Cache managers](https://github.com/gsmtcnr/corex/blob/master/Corex.Cache.Infrastructure/ICacheManager.cs): `Corex.Cache.Infrastructure/ICacheManager.cs`
- [Exception manager](https://github.com/gsmtcnr/corex/blob/master/Corex.ExceptionHandling.Manager/BaseExceptionManager.cs): `Corex.ExceptionHandling.Manager/BaseExceptionManager.cs`
- [Validation rules](https://github.com/gsmtcnr/corex/blob/master/Corex.Validation.Infrastructure/ValidationBase.cs): `Corex.Validation.Infrastructure/ValidationBase.cs`

### Integrations

- [Logging](https://github.com/gsmtcnr/corex/blob/master/Corex.Log.Infrastructure/ILog.cs): `Corex.Log.Infrastructure/ILog.cs`
- [Email sending](https://github.com/gsmtcnr/corex/blob/master/Corex.EmailSender.Infrastructure/IEmailSender.cs): `Corex.EmailSender.Infrastructure/IEmailSender.cs`
- [SMS sending](https://github.com/gsmtcnr/corex/blob/master/Corex.SmsSender.Infrastructure/ISmsSender.cs): `Corex.SmsSender.Infrastructure/ISmsSender.cs`
- [Push sending](https://github.com/gsmtcnr/corex/blob/master/Corex.PushSender.Infrastructure/IPushSender.cs): `Corex.PushSender.Infrastructure/IPushSender.cs`
- [Cloud uploads](https://github.com/gsmtcnr/corex/blob/master/Corex.CloudFile.Derived.AzureBlobStorage/BaseAzureBlobStorage.cs): `Corex.CloudFile.Derived.AzureBlobStorage/BaseAzureBlobStorage.cs`
- [PDF conversion](https://github.com/gsmtcnr/corex/blob/master/Corex.PDFConverter.Infrastructure/IPDFConverter.cs): `Corex.PDFConverter.Infrastructure/IPDFConverter.cs`
- [Serialization](https://github.com/gsmtcnr/corex/blob/master/Corex.JsonSerializer.Infrastructure/IJsonSerializer.cs): `Corex.JsonSerializer.Infrastructure/IJsonSerializer.cs`
- [Encryption](https://github.com/gsmtcnr/corex/blob/master/Corex.CipherEncryption.Infrastructure/ICipherEncryption.cs): `Corex.CipherEncryption.Infrastructure/ICipherEncryption.cs`
- [Template rendering](https://github.com/gsmtcnr/corex/blob/master/Corex.TemplateRender.Infrastructure/ITemplateRender.cs): `Corex.TemplateRender.Infrastructure/ITemplateRender.cs`

### Presentation

- [MVC hosting](https://github.com/gsmtcnr/corex/blob/master/Corex.Presentation.Derived.MVC/BaseMvcStartup.cs): `Corex.Presentation.Derived.MVC/BaseMvcStartup.cs`

### Other components

- **Application layer**
- **External stores**
- **External services**

## Connections

- Application layer → Operation manager: uses (evidence: `README.md`)
- Operation manager → Data operation: coordinates (evidence: `Corex.Operation.Manager/BaseOperationManager.cs`)
- Operation manager → Validation operation: validates through (evidence: `Corex.Operation.Manager/BaseOperationManager.cs`)
- Operation manager → Object mapping: maps models (evidence: `Corex.Operation.Manager/BaseOperationManager.cs`)
- Operation manager → Cache managers: reads cache (evidence: `Corex.Operation.Manager/BaseOperationManager.cs`)
- Operation manager → Exception manager: formats errors (evidence: `Corex.Operation.Manager/BaseOperationManager.cs`)
- Operation manager → Operation results: returns (evidence: `Corex.Operation.Manager/BaseOperationManager.cs`)
- Operation manager → Business operation: coordinates (evidence: `README.md`)
- Data operation → Mongo insert: writes through (evidence: `Corex.Operation.Derived.DataOperation/BaseDataOperation.cs`)
- Data operation → Mongo update: updates through (evidence: `Corex.Operation.Derived.DataOperation/BaseDataOperation.cs`)
- Data operation → Mongo delete: deletes through (evidence: `Corex.Operation.Derived.DataOperation/BaseDataOperation.cs`)
- Mongo insert → Mongo repository: uses collection (evidence: `Corex.MongoDB.Derived.V1/Repository/Insert.cs`)
- Mongo update → Mongo repository: uses collection (evidence: `Corex.MongoDB.Derived.V1/Repository/Update.cs`)
- Mongo delete → Mongo repository: uses collection (evidence: `Corex.MongoDB.Derived.V1/Repository/Delete.cs`)
- EF repository → Entity context: creates context (evidence: `Corex.Data.Infrastructure/Repositories/BaseEntityRepository.cs`)
- EF repository → External stores: persists data
- Mongo repository → External stores: accesses MongoDB (evidence: `Corex.MongoDB.Derived.V1/Repository/Repository.cs`)
- Cloud uploads → External stores: uploads blobs (evidence: `Corex.CloudFile.Derived.AzureBlobStorage/BaseAzureBlobStorage.cs`)
- Logging → External stores: writes logs (evidence: `README.md`)
- Email sending → External services: sends email (evidence: `README.md`)
- SMS sending → External services: sends SMS (evidence: `README.md`)
- Push sending → External services: sends notifications (evidence: `README.md`)
- PDF conversion → Cloud uploads: uploads output (evidence: `README.md`)
- MVC hosting → Application layer: hosts layer (evidence: `README.md`)
