docs: replace ASCII architecture diagrams with Mermaid

Convert all 6 architecture diagrams (root, prisma, auth, notifications,
storage, audit-log) from ASCII art to Mermaid graph diagrams with color-
coded nodes for better visual clarity on GitHub.

Author: JonatanSalas

README.md

@@ -6,19 +6,29 @@ Each module is a self-contained feature -- own Prisma schema, feature flags, pro
 
 ## Architecture
 
+```mermaid
+graph TD
+    App["Your NestJS App"]
+
+    App --> Prisma["PrismaModule<br/><code>@bbv/nestjs-prisma</code>"]
+    App --> Pagination["PaginationDto, paginate()<br/><code>@bbv/nestjs-pagination</code>"]
+    App --> Response["TransformInterceptor, Filter<br/><code>@bbv/nestjs-response</code>"]
+
+    Prisma --> Auth["AuthModule<br/><code>@bbv/nestjs-auth</code>"]
+    Prisma --> Notifications["NotificationModule<br/><code>@bbv/nestjs-notifications</code>"]
+    Prisma --> Storage["StorageModule<br/><code>@bbv/nestjs-storage</code>"]
+    Prisma --> AuditLog["AuditLogModule<br/><code>@bbv/nestjs-audit-log</code>"]
+
+    style Prisma fill:#e3f2fd,stroke:#1565c0
+    style Auth fill:#fce4ec,stroke:#c62828
+    style Notifications fill:#fce4ec,stroke:#c62828
+    style Storage fill:#fce4ec,stroke:#c62828
+    style AuditLog fill:#fce4ec,stroke:#c62828
+    style Pagination fill:#f3e5f5,stroke:#6a1b9a
+    style Response fill:#f3e5f5,stroke:#6a1b9a
 ```
-  Your NestJS App
-  |
-  +-- PrismaModule (@bbv/nestjs-prisma)        <-- foundation, all plugins depend on this
-  |     |
-  |     +-- AuthModule              (@bbv/nestjs-auth)           Tier 1 plugin
-  |     +-- NotificationModule      (@bbv/nestjs-notifications)  Tier 1 plugin
-  |     +-- StorageModule           (@bbv/nestjs-storage)        Tier 1 plugin
-  |     +-- AuditLogModule          (@bbv/nestjs-audit-log)      Tier 1 plugin
-  |
-  +-- PaginationDto, paginate()    (@bbv/nestjs-pagination)      Tier 2 utility
-  +-- TransformInterceptor, Filter (@bbv/nestjs-response)        Tier 2 utility
-```
+
+> **Blue** = Foundation &nbsp;|&nbsp; **Red** = Tier 1 Plugin Modules &nbsp;|&nbsp; **Purple** = Tier 2 Utilities
 
 ## Packages
 

packages/nestjs-audit-log/README.md

@@ -206,22 +206,38 @@ When `features.registerController` is enabled:
 
 ## Architecture
 
-```
-AuditLogModule (global)
-  forRoot() / forRootAsync()
-  |
-  +-- AuditContextMiddleware       -- captures userId, IP, UA via AsyncLocalStorage
-  |     (applied to all routes)
-  |
-  +-- createAuditMiddleware()      -- Prisma $use middleware for auto CRUD tracking
-  |     +-- excludes configured entities/fields
-  |     +-- sanitizes sensitive data ([REDACTED])
-  |     +-- tracks old/new values on updates
-  |
-  +-- @Audited() decorator         -- route-level audit via AuditedInterceptor
-  |
-  +-- AuditLogService              -- log(), findAll(), findByEntity(), cleanup()
-  +-- AuditLogController           -- opt-in REST API for querying logs
+```mermaid
+graph TD
+    Module["AuditLogModule (global)<br/>forRoot() / forRootAsync()"]
+
+    CtxMW["AuditContextMiddleware<br/>captures userId, IP, UA<br/>via AsyncLocalStorage"]
+    PrismaMW["createAuditMiddleware()<br/>Prisma $use for auto CRUD"]
+    Decorator["@Audited() decorator<br/>route-level audit via<br/>AuditedInterceptor"]
+    Service["AuditLogService<br/>log(), findAll(), findByEntity(), cleanup()"]
+    Controller["AuditLogController<br/>/audit-logs<br/><i>opt-in</i>"]
+
+    Module --> CtxMW
+    Module --> PrismaMW
+    Module --> Decorator
+    Module --> Service
+    Module --> Controller
+
+    CtxMW -->|"provides context"| PrismaMW
+    CtxMW -->|"provides context"| Decorator
+    PrismaMW -->|"writes entries"| Service
+    Decorator -->|"writes entries"| Service
+    Controller -->|"queries"| Service
+
+    PrismaMW -.-> Exclude["Exclude entities/fields"]
+    PrismaMW -.-> Sanitize["Sanitize sensitive data"]
+    PrismaMW -.-> Changes["Track old/new values"]
+
+    style Module fill:#e3f2fd,stroke:#1565c0
+    style Service fill:#fff3e0,stroke:#e65100
+    style Controller fill:#e8f5e9,stroke:#2e7d32
+    style CtxMW fill:#fce4ec,stroke:#c62828
+    style PrismaMW fill:#fce4ec,stroke:#c62828
+    style Decorator fill:#f3e5f5,stroke:#6a1b9a
 ```
 
 ## License

packages/nestjs-auth/README.md

@@ -266,22 +266,47 @@ providers: {
 
 ## Architecture
 
-```
-AuthModule
-  forRoot() / forRootAsync()
-  |
-  +-- AuthController (/auth)          -- registration, login, social, verify, reset, profile, sessions
-  +-- OrganizationController (/organizations)  -- CRUD + membership (feature-gated)
-  |
-  +-- AuthService                     -- business logic, token generation, user management
-  +-- OrganizationService             -- org CRUD, member management
-  |
-  +-- JwtStrategy                     -- Passport JWT validation
-  +-- LocalStrategy                   -- Passport email/password validation
-  +-- GoogleStrategy                  -- Passport Google OAuth (conditionally registered)
-  |
-  +-- JwtAuthGuard                    -- route protection, @Public() support
-  +-- RolesGuard                      -- @Roles() enforcement
+```mermaid
+graph TD
+    Module["AuthModule<br/>forRoot() / forRootAsync()"]
+
+    subgraph Controllers
+        AuthCtrl["AuthController<br/>/auth"]
+        OrgCtrl["OrganizationController<br/>/organizations"]
+    end
+
+    subgraph Services
+        AuthSvc["AuthService<br/>business logic, tokens, users"]
+        OrgSvc["OrganizationService<br/>org CRUD, members"]
+    end
+
+    subgraph Strategies ["Passport Strategies"]
+        JWT["JwtStrategy"]
+        Local["LocalStrategy"]
+        Google["GoogleStrategy<br/><i>conditional</i>"]
+    end
+
+    subgraph Guards
+        JwtGuard["JwtAuthGuard<br/>@Public() support"]
+        RolesGuard["RolesGuard<br/>@Roles() enforcement"]
+    end
+
+    Module --> Controllers
+    Module --> Services
+    Module --> Strategies
+    Module --> Guards
+
+    AuthCtrl --> AuthSvc
+    OrgCtrl --> OrgSvc
+    AuthSvc --> JWT
+    AuthSvc --> Local
+    AuthSvc --> Google
+
+    style Module fill:#e3f2fd,stroke:#1565c0
+    style AuthCtrl fill:#e8f5e9,stroke:#2e7d32
+    style OrgCtrl fill:#e8f5e9,stroke:#2e7d32
+    style AuthSvc fill:#fff3e0,stroke:#e65100
+    style OrgSvc fill:#fff3e0,stroke:#e65100
 ```
 
 ## License

packages/nestjs-notifications/README.md

@@ -266,30 +266,38 @@ Preferences are checked automatically before sending. If a user has disabled a c
 
 ## Architecture
 
-```
-NotificationModule
-  forRoot() / forRootAsync()
-  |
-  +-- NotificationService           -- unified send() API, routes to channels
-  |     |
-  |     +-- routeEmail()            -- queues to BullMQ 'notifications-email'
-  |     +-- routeInApp()            -- delegates to InAppService
-  |     +-- routeSms()              -- queues to BullMQ 'notifications-sms'
-  |
-  +-- EmailProcessor                -- BullMQ worker, uses EMAIL_PROVIDER
-  |     +-- SmtpEmailProvider       -- nodemailer
-  |     +-- SendGridEmailProvider   -- SendGrid API
-  |
-  +-- SmsProcessor                  -- BullMQ worker, uses SMS_PROVIDER
-  |     +-- TwilioSmsProvider       -- Twilio API
-  |
-  +-- InAppService                  -- direct Prisma writes (no queue)
-  +-- InAppController               -- REST API for in-app notifications
-  |
-  +-- PreferenceService             -- user notification preferences
-  +-- PreferenceController          -- REST API for preferences
-  |
-  +-- TemplateService               -- Handlebars template rendering + caching
+```mermaid
+graph TD
+    Module["NotificationModule<br/>forRoot() / forRootAsync()"]
+    NService["NotificationService<br/>unified send() API"]
+
+    Module --> NService
+    Module --> Templates["TemplateService<br/>Handlebars + caching"]
+
+    NService -->|"channel: email"| EmailQ["BullMQ Queue<br/>notifications-email"]
+    NService -->|"channel: in_app"| InApp["InAppService<br/>direct Prisma writes"]
+    NService -->|"channel: sms"| SmsQ["BullMQ Queue<br/>notifications-sms"]
+
+    EmailQ --> EmailProc["EmailProcessor"]
+    EmailProc --> SMTP["SmtpEmailProvider<br/>nodemailer"]
+    EmailProc --> SendGrid["SendGridEmailProvider"]
+
+    SmsQ --> SmsProc["SmsProcessor"]
+    SmsProc --> Twilio["TwilioSmsProvider"]
+
+    InApp --> InAppCtrl["InAppController<br/>/notifications"]
+
+    Module --> PrefSvc["PreferenceService"]
+    PrefSvc --> PrefCtrl["PreferenceController<br/>/notification-preferences"]
+
+    style Module fill:#e3f2fd,stroke:#1565c0
+    style NService fill:#fff3e0,stroke:#e65100
+    style EmailQ fill:#fce4ec,stroke:#c62828
+    style SmsQ fill:#fce4ec,stroke:#c62828
+    style InApp fill:#e8f5e9,stroke:#2e7d32
+    style SMTP fill:#f3e5f5,stroke:#6a1b9a
+    style SendGrid fill:#f3e5f5,stroke:#6a1b9a
+    style Twilio fill:#f3e5f5,stroke:#6a1b9a
 ```
 
 ## License

packages/nestjs-prisma/README.md

@@ -174,16 +174,25 @@ describe('UserService', () => {
 
 ## Architecture
 
-```
-PrismaModule
-  forRoot() / forRootAsync()  --> registers PrismaService as provider + export
-  |
-  PrismaService (extends PrismaClient)
-    onModuleInit()    --> $connect()
-    onModuleDestroy() --> $disconnect()
-
-softDeleteMiddleware()       --> opt-in Prisma middleware
-createMockPrismaService()    --> testing utility (Proxy-based)
+```mermaid
+graph TD
+    Module["PrismaModule<br/>forRoot() / forRootAsync()"]
+    Service["PrismaService<br/><i>extends PrismaClient</i>"]
+    Init["onModuleInit() → $connect()"]
+    Destroy["onModuleDestroy() → $disconnect()"]
+    SoftDelete["softDeleteMiddleware()<br/>opt-in Prisma middleware"]
+    Mock["createMockPrismaService()<br/>testing utility (Proxy-based)"]
+
+    Module -->|registers & exports| Service
+    Service --> Init
+    Service --> Destroy
+    Module -.->|optional| SoftDelete
+    Module -.->|testing| Mock
+
+    style Module fill:#e3f2fd,stroke:#1565c0
+    style Service fill:#e3f2fd,stroke:#1565c0
+    style SoftDelete fill:#fff3e0,stroke:#e65100
+    style Mock fill:#f3e5f5,stroke:#6a1b9a
 ```
 
 ## License

packages/nestjs-storage/README.md

@@ -223,22 +223,35 @@ When `features.registerController` is enabled:
 
 ## Architecture
 
-```
-StorageModule
-  forRoot() / forRootAsync()
-  |
-  +-- StorageController (/storage)  -- opt-in REST endpoints
-  |
-  +-- StorageService                -- upload, getUrl, delete, exists
-  |     +-- validates file (size, MIME type)
-  |     +-- delegates to StorageProvider
-  |     +-- tracks in Prisma (if trackUploads)
-  |
-  +-- StorageProvider (interface)
-        +-- S3StorageProvider       -- AWS SDK v3
-        +-- FirebaseStorageProvider
-        +-- DOSpacesStorageProvider
-        +-- LocalStorageProvider    -- filesystem
+```mermaid
+graph TD
+    Module["StorageModule<br/>forRoot() / forRootAsync()"]
+    Controller["StorageController<br/>/storage<br/><i>opt-in</i>"]
+    Service["StorageService<br/>upload, getUrl, delete, exists"]
+    Validate["Validate file<br/>size & MIME type"]
+    Track["Track in Prisma<br/><i>if trackUploads</i>"]
+
+    Module --> Controller
+    Module --> Service
+
+    Service --> Validate
+    Service --> Provider
+    Service -.-> Track
+
+    subgraph Provider ["StorageProvider (interface)"]
+        S3["S3StorageProvider<br/>AWS SDK v3"]
+        Firebase["FirebaseStorageProvider"]
+        DO["DOSpacesStorageProvider"]
+        Local["LocalStorageProvider<br/>filesystem"]
+    end
+
+    style Module fill:#e3f2fd,stroke:#1565c0
+    style Service fill:#fff3e0,stroke:#e65100
+    style Controller fill:#e8f5e9,stroke:#2e7d32
+    style S3 fill:#f3e5f5,stroke:#6a1b9a
+    style Firebase fill:#f3e5f5,stroke:#6a1b9a
+    style DO fill:#f3e5f5,stroke:#6a1b9a
+    style Local fill:#f3e5f5,stroke:#6a1b9a
 ```
 
 ## License