create-luff-app 2.0.0 → 2.0.1

package/NOTES.md

@@ -109,11 +109,9 @@ Handles everything: clears port conflicts, starts Docker DBs, launches all servi
 ### Option B: Kubernetes Mode (Production)
 
 ```mermaid
+%%{init: {'theme':'dark','themeVariables':{'fontSize':'10px'}}}%%
 flowchart LR
-  A[Build] --> B[Tag]
-  B --> C[ArgoCD]
-  C --> D[Deploy]
-  D --> E[Forward]
+  A[Build] --> B[Tag] --> C[ArgoCD] --> D[Deploy] --> E[Forward]
 ```
 
 ```bash
@@ -169,13 +167,9 @@ kubectl create secret generic ai-secrets \
 ## 🤖 5. CI/CD Pipeline
 
 ```mermaid
+%%{init: {'theme':'dark','themeVariables':{'fontSize':'10px'}}}%%
 flowchart LR
-  Push --> CI[Actions]
-  CI --> Lint
-  Lint --> Build
-  Build --> GHCR
-  GHCR --> Argo[ArgoCD]
-  Argo --> K8s
+  Push --> CI[Actions] --> Lint --> Build --> Reg[GHCR] --> Argo[ArgoCD] --> K8s
 ```
 
 > **⚠️ Important**: Add `GOOGLE_CLIENT_ID` to GitHub Repository Secrets. Next.js `NEXT_PUBLIC_` variables are baked into the Docker image at build time.

package/README.md

@@ -7,7 +7,7 @@
   <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" />
 </p>
 
-> **Scaffold the entire LUFF. microservices ecosystem in one command.**  
+> **Scaffold the entire LUFF. microservices ecosystem in one command.**
 > Full-stack Next.js + Express + Prisma + Gemini AI + Razorpay — ready to run.
 
 ---
@@ -86,6 +86,7 @@ During scaffolding, the CLI asks:
 ### AI Architecture
 
 ```mermaid
+%%{init: {'theme':'dark','themeVariables':{'fontSize':'10px'}}}%%
 flowchart LR
   A[Upload] --> B[Parse]
   B --> C[Embed]
@@ -96,8 +97,87 @@ flowchart LR
   G --> H[Answer]
 ```
 
+## 🧬 Architecture at a Glance
+
+```mermaid
+%%{init: {'theme':'dark','themeVariables':{'fontSize':'19px'}}}%%
+graph LR
+  FE[FE] --> GW[API GW]
+  GW --> A[Auth]
+  GW --> P[Posts]
+  GW --> Pay[Pay]
+  GW --> AI[AI]
+  A --> AD[(AuthDB)]
+  P --> PD[(PostsDB)]
+  Pay --> PaD[(PayDB)]
+  AI --> V[(Vector)]
+  AI --> G[Gemini]
+```
+
 ---
 
+## 💳 Payment Service — Transaction Infrastructure
+
+<summary><b>🔍 Click to expand Payment Architecture</b></summary>
+
+```mermaid
+%%{init: {'theme':'dark','themeVariables':{'fontSize':'10px'}}}%%
+sequenceDiagram
+  participant U as User
+  participant F as Frontend
+  participant G as Gateway
+  participant P as Payment
+  participant R as Razorpay
+  participant DB as PayDB
+
+  U->>F: Buy
+  F->>G: POST /create-order
+  G->>P: Forward
+  P->>R: Create Order
+  R-->>P: order_id
+  P-->>F: order_id
+  F->>R: Checkout
+  R-->>F: Callback
+  F->>G: POST /verify
+  G->>P: Forward
+  P->>P: HMAC Check
+  P->>DB: Save
+  P-->>F: Verified
+```
+
+| Route | Method | Auth | Description |
+|:---|:---:|:---:|:---|
+| `/payments/create-order` | POST | ✅ | Creates a Razorpay order with amount & currency |
+| `/payments/verify` | POST | ✅ | Verifies payment signature (HMAC-SHA256) |
+| `/payments/my-purchases` | GET | ✅ | Returns user's transaction history |
+
+---
+
+## 🔐 Auth Service — Stateless Security
+
+<summary><b>🔍 Click to expand Authentication Flow</b></summary>
+
+```mermaid
+%%{init: {'theme':'dark','themeVariables':{'fontSize':'10px'}}}%%
+sequenceDiagram
+  participant U as User
+  participant F as Frontend
+  participant G as Google
+  participant A as Auth
+  participant DB as AuthDB
+
+  U->>F: Login
+  F->>G: OAuth Popup
+  G-->>F: Token
+  F->>A: POST /auth/google
+  A->>G: Verify
+  G-->>A: Profile
+  A->>DB: Upsert
+  A->>A: Sign JWT
+  A-->>F: JWT + User
+  F->>F: Store JWT
+```
+
 ## 🔑 Credentials Setup
 
 <details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-luff-app",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "CLI to scaffold the Luff Microservices Boilerplate",
   "bin": {
     "create-luff-app": "bin/cli.js"