flowchart TB
    subgraph Client["Client Layer"]
        WEB[Web Client - React/Angular]
        MOB[Mobile Client]
        API[API Consumer]
    end

    subgraph Gateway["API Gateway"]
        REST[REST API :8080]
        GRPC[gRPC Server :9090]
        SSR[SSR Engine]
    end

    subgraph Plugins["Plugin System - OSGi"]
        PM[Plugin Manager]
        PB[Plugin Bundles]
        EXT[Extension Registry]
    end

    subgraph Controller["Controller Layer"]
        AUTH[AuthController]
        USER[UserController]
        PLUG[PluginController]
    end

    subgraph Service["Service Layer"]
        AS[AuthService]
        US[UserService]
        JWT[JwtTokenProvider]
        CB[Circuit Breaker]
    end

    subgraph Repository["Repository + DAO Layer"]
        UR[UserRepository]
        TR[TokenRepository]
        UD[UserDao]
        TD[TokenDao]
    end

    subgraph Data["Data Layer"]
        MYSQL[(MySQL 8.0)]
        PGSQL[(PostgreSQL)]
        MONGO[(MongoDB)]
        REDIS[(Redis 7.0)]
    end

    WEB --> SSR
    WEB --> REST
    MOB --> REST
    API --> GRPC

    SSR --> REST
    REST --> AUTH
    REST --> USER
    REST --> PLUG
    GRPC --> AUTH
    GRPC --> USER

    PLUG --> PM
    PM --> PB
    PM --> EXT

    AUTH --> AS
    USER --> US

    AS --> CB
    US --> CB
    CB --> UR
    CB --> TR
    JWT --> TR

    UR --> UD
    TR --> TD
    UD --> MYSQL
    UD --> PGSQL
    UD --> MONGO
    TD --> REDIS

    style Client fill:#e0f2fe
    style Gateway fill:#fef3c7
    style Plugins fill:#fce7f3
    style Controller fill:#d1fae5
    style Service fill:#e0e7ff
    style Repository fill:#fef9c3
    style Data fill:#f3f4f6

flowchart TB
    subgraph Service["Service Layer"]
        US[UserService]
    end

    subgraph Repository["Repository Layer"]
        UR["UserRepository (Interface)"]
        URI[UserRepositoryImpl]
    end

    subgraph DAO["DAO Layer"]
        UD["UserDao (Interface)"]
    end

    subgraph Impl["DAO Implementations - Conditional Beans"]
        JPA["UserDaoJpaImpl
        orm=jpa"]
        MYB["UserDaoMybatisImpl
        orm=mybatis (default)"]
        MON["UserDaoMongodbImpl
        type=mongodb"]
    end

    subgraph DB["Databases"]
        MYSQL[(MySQL)]
        PG[(PostgreSQL)]
        MONGO[(MongoDB)]
    end

    US --> UR
    UR --> URI
    URI --> UD
    UD -.->|jpa| JPA
    UD -.->|mybatis| MYB
    UD -.->|mongodb| MON
    JPA --> MYSQL
    JPA --> PG
    MYB --> MYSQL
    MYB --> PG
    MON --> MONGO

    style Service fill:#e0e7ff
    style Repository fill:#fef9c3
    style DAO fill:#d1fae5
    style Impl fill:#fce7f3
    style DB fill:#f3f4f6

mindmap
  root((DAO Pattern))
    Database Portability
      Switch MySQL ↔ PostgreSQL
      Switch SQL ↔ MongoDB
      Zero code changes
    ORM Flexibility
      JPA for rapid dev
      MyBatis for complex SQL
      MongoDB for documents
    Testing
      Mock DAO interface
      In-memory H2 for tests
      Testcontainers support
    Maintainability
      Single interface contract
      Implementation isolation
      Easy to add new DBs

sequenceDiagram
    participant App as Application
    participant Spring as Spring Context
    participant Cond as @ConditionalOnProperty
    participant DAO as UserDao Bean

    App->>Spring: Start Application
    Spring->>Spring: Read application.properties
    Spring->>Cond: Evaluate conditions

    alt database.orm=jpa
        Cond->>DAO: Register UserDaoJpaImpl
    else database.orm=mybatis (default)
        Cond->>DAO: Register UserDaoMybatisImpl
    else database.type=mongodb
        Cond->>DAO: Register UserDaoMongodbImpl
    end

    Spring->>App: Context Ready
    Note over App,DAO: Only ONE DAO implementation active at runtime

mindmap
  root((Arcana Cloud))
    Architecture
      Five-Layer Clean Architecture
      Dual Protocol Support gRPC/REST
      Five Deployment Modes
      Circuit Breaker Pattern
    DAO Layer
      Multi-ORM Support
      JPA Hibernate
      MyBatis SQL Mapper
      MongoDB Documents
      Runtime Switching
    Plugin System
      OSGi Apache Felix
      Hot Deployment
      Extension Points
      Spring-OSGi Bridge
      Distributed Sync
      Bean Whitelisting
      JAR Signature Verification
    SSR Engine
      GraalJS Runtime
      React Next.js Support
      Angular Universal Support
      Render Caching
    Security
      OAuth2 + JWT
      Role-Based Access
      Token Refresh
      TLS/mTLS gRPC
      Plugin Audit Logging
    Resilience
      Resilience4j Circuit Breaker
      Cascading Failure Prevention
      Configurable Thresholds
    Configuration
      Spring Cloud Config
      Centralized Management
      Environment Profiles
      Runtime Refresh
    API Versioning
      Semantic Versioning
      @Since Annotations
      Compatibility Checks
      Deprecation Policy

flowchart TB
    subgraph Monolithic["1. Monolithic"]
        M_ALL[All Layers<br/>REST + gRPC<br/>Plugins Local]
    end

    subgraph LayeredHTTP["2. Layered + HTTP"]
        LH_C[Controller<br/>:8080] -->|HTTP| LH_S[Service<br/>:8081]
        LH_S -->|HTTP| LH_R[Repository<br/>:8082]
    end

    subgraph LayeredGRPC["3. Layered + gRPC"]
        LG_C[Controller<br/>:8080] -->|gRPC :9090| LG_S[Service<br/>:8081]
        LG_S -->|gRPC :9091| LG_R[Repository<br/>:8082]
    end

    subgraph K8sHTTP["4. K8s + HTTP"]
        KH_C[Controller Pods] -->|HTTP| KH_S[Service Pods]
        KH_S -->|Redis| KH_REDIS[(Plugin Sync)]
        KH_S -->|PVC| KH_PVC[(Shared Plugins)]
    end

    subgraph K8sGRPC["5. K8s + gRPC"]
        KG_C[Controller Pods] -->|gRPC + TLS| KG_S[Service Pods]
        KG_S -->|Redis| KG_REDIS[(Plugin Sync)]
        KG_S -->|PVC| KG_PVC[(Shared Plugins)]
    end

    style Monolithic fill:#d1fae5
    style LayeredHTTP fill:#fef3c7
    style LayeredGRPC fill:#dbeafe
    style K8sHTTP fill:#fce7f3
    style K8sGRPC fill:#e0e7ff

flowchart LR
    subgraph Host["Host Application"]
        SM[Spring Context]
        BR[Spring-OSGi Bridge]
        PM[Plugin Manager]
    end

    subgraph Felix["Apache Felix OSGi"]
        FW[Framework]
        SR[Service Registry]
        BL[Bundle Lifecycle]
    end

    subgraph Plugins["Plugin Bundles"]
        P1[Audit Plugin]
        P2[Custom Plugin]
        P3[SSR Views]
    end

    SM <--> BR
    BR <--> SR
    PM --> FW
    FW --> BL
    BL --> P1
    BL --> P2
    BL --> P3
    P1 --> SR
    P2 --> SR
    P3 --> SR

    style Host fill:#d1fae5
    style Felix fill:#fef3c7
    style Plugins fill:#dbeafe

sequenceDiagram
    participant Admin as Administrator
    participant PM as Plugin Manager
    participant Felix as Apache Felix
    participant Bundle as Plugin Bundle
    participant Bridge as Spring-OSGi Bridge
    participant Spring as Spring Context

    Admin->>PM: installPlugin(jarFile)
    PM->>PM: Validate plugin descriptor
    PM->>Felix: installBundle(jar)
    Felix->>Bundle: Create bundle instance
    Felix-->>PM: Bundle installed (INSTALLED)

    Admin->>PM: enablePlugin(key)
    PM->>Felix: startBundle(bundleId)
    Felix->>Bundle: Activator.start()
    Bundle-->>Felix: Started (ACTIVE)

    Felix->>Bridge: onBundleStarted(bundle)
    Bridge->>Spring: registerBean(pluginServices)
    Bridge-->>PM: Plugin fully activated
    PM-->>Admin: Plugin enabled successfully

sequenceDiagram
    participant C as Browser
    participant S as Spring Boot
    participant E as SSR Engine
    participant G as GraalJS
    participant R as React/Angular

    C->>S: GET /dashboard
    S->>E: render(path, props)
    E->>E: Check Cache
    alt Cache Hit
        E-->>S: Cached HTML
    else Cache Miss
        E->>G: Execute JS
        G->>R: renderToString()
        R-->>G: HTML
        G-->>E: HTML
        E->>E: Cache Result
        E-->>S: Fresh HTML
    end
    S-->>C: HTML + Hydration Script

graph LR
    subgraph Latency["Latency (Lower is Better)"]
        L1[Layered+gRPC<br/>0.60ms] --> L2[K8s+gRPC<br/>0.80ms]
        L2 --> L3[Layered+HTTP<br/>1.30ms]
        L3 --> L4[K8s+HTTP<br/>1.50ms]
    end

    style L1 fill:#22c55e
    style L2 fill:#84cc16
    style L3 fill:#facc15
    style L4 fill:#f97316

graph LR
    subgraph Patterns["Architecture Patterns Used"]
        CA[Clean Architecture]
        DAO[DAO Pattern]
        REP[Repository Pattern]
        SL[Service Layer]
        DI[Dependency Injection]
        PL[Plugin Architecture]
        CB[Circuit Breaker]
        GW[API Gateway]
    end

    CA --> DAO
    DAO --> REP
    REP --> SL
    SL --> DI
    DI --> PL
    PL --> CB
    CB --> GW

    style Patterns fill:#e0f2fe