feat: Goa GEL Blockchain e-Licensing Platform - Full Stack Implementation

Complete implementation of the Goa Government e-Licensing platform with: Backend: - NestJS API with JWT authentication - PostgreSQL database with Knex ORM - Redis caching and session management - MinIO document storage - Hyperledger Besu blockchain integration - Multi-department workflow system - Comprehensive API tests (266/282 passing) Frontend: - Angular 21 with standalone components - Angular Material + TailwindCSS UI - Visual workflow builder - Document upload with progress tracking - Blockchain explorer integration - Role-based dashboards (Admin, Department, Citizen) - E2E tests with Playwright (37 tests) Infrastructure: - Docker Compose orchestration - Blockscout blockchain explorer - Development and production configurations
2026-02-07 10:23:29 -04:00
commit 80566bf0a2
441 changed files with 102418 additions and 0 deletions
--- a/container-architecture.html
+++ b/container-architecture.html
@@ -0,0 +1,101 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>container-architecture</title>
+  <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+  <style>
+    body {
+      margin: 0;
+      padding: 20px;
+      background: #1a1a1a;
+      color: #fff;
+      font-family: Arial, sans-serif;
+    }
+    h1 {
+      text-align: center;
+      color: #3b82f6;
+    }
+    .mermaid {
+      display: flex;
+      justify-content: center;
+      background: transparent;
+    }
+  </style>
+</head>
+<body>
+  <h1>CONTAINER ARCHITECTURE</h1>
+  <div class="mermaid">
+graph TB
+    subgraph Client["Client Layer"]
+        WEB["🌐 Next.js 14 Frontend<br/>shadcn/ui<br/>Port: 3000"]
+    end
+
+    subgraph API["API & Backend Layer"]
+        APIGW["📡 API Gateway<br/>NestJS<br/>Port: 3001"]
+        AUTH["🔐 Auth Service<br/>API Key + Secret<br/>(POC)"]
+        WORKFLOW["⚙️ Workflow Service<br/>NestJS Module"]
+        APPROVAL["✅ Approval Service<br/>NestJS Module"]
+        DOCUMENT["📄 Document Service<br/>NestJS Module"]
+    end
+
+    subgraph Data["Data Layer"]
+        DB["🗄️ PostgreSQL<br/>Port: 5432<br/>license_requests<br/>approvals, documents<br/>audit_logs"]
+        CACHE["⚡ Redis Cache<br/>Port: 6379<br/>Session, Workflow State"]
+        STORAGE["📦 MinIO<br/>Port: 9000<br/>Document Files<br/>License PDFs"]
+    end
+
+    subgraph Blockchain["Blockchain Layer"]
+        BESU["⛓️ Hyperledger Besu<br/>QBFT Consensus<br/>Port: 8545"]
+        CONTRACTS["📋 Smart Contracts<br/>• LicenseRequestNFT<br/>• ApprovalManager<br/>• DepartmentRegistry<br/>• WorkflowRegistry"]
+        BCDB["📚 Chain State<br/>Account Balances<br/>NFT Metadata"]
+    end
+
+    subgraph Integrations["External Integrations"]
+        DIGILOCKER["📱 DigiLocker Mock<br/>Document Verification"]
+        LEGACY["💼 Legacy Systems<br/>Data Integration"]
+        WEBHOOK["🔔 Webhook Service<br/>Event Notifications"]
+    end
+
+    WEB -->|REST/GraphQL| APIGW
+    APIGW -->|Validate Token| AUTH
+    APIGW -->|Route Request| WORKFLOW
+    APIGW -->|Route Request| APPROVAL
+    APIGW -->|Route Request| DOCUMENT
+
+    WORKFLOW -->|Read/Write| DB
+    WORKFLOW -->|Cache State| CACHE
+    WORKFLOW -->|Submit TX| BESU
+
+    APPROVAL -->|Read/Write| DB
+    APPROVAL -->|Cache| CACHE
+    APPROVAL -->|Smart Contract Call| BESU
+
+    DOCUMENT -->|Store Files| STORAGE
+    DOCUMENT -->|Hash Generation| DOCUMENT
+    DOCUMENT -->|Record Hash| BESU
+
+    BESU -->|Execute| CONTRACTS
+    CONTRACTS -->|Update State| BCDB
+
+    APIGW -->|Verify Docs| DIGILOCKER
+    APIGW -->|Query Legacy| LEGACY
+    APPROVAL -->|Send Event| WEBHOOK
+
+    style WEB fill:#10b981,stroke:#059669,stroke-width:2px,color:#fff
+    style APIGW fill:#3b82f6,stroke:#1e40af,stroke-width:2px,color:#fff
+    style AUTH fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#fff
+    style DB fill:#8b5cf6,stroke:#6d28d9,stroke-width:2px,color:#fff
+    style STORAGE fill:#ec4899,stroke:#be123c,stroke-width:2px,color:#fff
+    style CACHE fill:#06b6d4,stroke:#0891b2,stroke-width:2px,color:#fff
+    style BESU fill:#ef4444,stroke:#991b1b,stroke-width:2px,color:#fff
+    style CONTRACTS fill:#dc2626,stroke:#7f1d1d,stroke-width:2px,color:#fff
+
+  </div>
+  <script>
+    mermaid.initialize({ startOnLoad: true, theme: 'dark' });
+    mermaid.contentLoaded();
+  </script>
+</body>
+</html>