[RTY-260025]

.env.sample

@@ -2,5 +2,5 @@ MODE=local
 MONGO_URI=mongodb://<username>:<password>@127.0.0.1:27017/?authSource=admin&retryWrites=true&w=majority
 DOMAIN=https://localhost:8001
 PORT=8001
-API_VERSION=""
-APP_NAMe="LOCAL"
+API_VERSION="/api/v1"
+APP_NAME="LOCAL"

.github/workflows/comment-on-issue.yml

@@ -10,6 +10,10 @@ on:
         description: "Issue number"
         required: true
         type: number
+      comment_body:
+        description: "Comment text"
+        required: true
+        type: string
 
 permissions:
   issues: write
@@ -20,16 +24,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: actions/github-script@v8
+      - name: Run Comment Action
+        uses: recursivezero/action-club/.github/actions/comment-on-issue@main
         with:
-          script: |
-            // For workflow_dispatch, use the input; for issue events, use context.issue.number
-            const issue_number = context.payload.inputs?.issue_number
-              ? parseInt(context.payload.inputs.issue_number, 10)
-              : context.issue.number;
-
-            await github.rest.issues.createComment({
-              ...context.repo,
-              issue_number,
-              body: "👋 Thank you for opening this issue! We will look into it as soon as possible."
-            });
+          issue_number: ${{ github.event.inputs.issue_number }}
+          comment_body: ${{ github.event.inputs.comment_body }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/deploy.yml

@@ -0,0 +1,28 @@
+name: Deploy App
+run-name: Deploy Tiny App to Cloud Server
+
+on:
+  push:
+    branches: [release]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@master
+        with:
+          host: ${{ secrets.HOST }}
+          username: ${{ secrets.USERNAME }}
+          key: ${{ secrets.SSH_PRIVATE_KEY }}
+          script: |
+            cd /opt/tz_apps/tiny
+            # Fetch latest code
+            git pull origin release
+
+            # Install dependencies (Production mode, no dev deps)
+            /root/.local/bin/poetry install --only main --all-extras --sync
+
+            # Restart the service
+            sudo systemctl restart tiny.service

.github/workflows/format-issue-title.yml

@@ -1,4 +1,4 @@
-name: "Auto Format Issue Title"
+name: "Format Issue Title"
 
 on:
   issues:
@@ -11,7 +11,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Format issue title
-        uses: recursivezero/template/.github/actions/format-issue-title@v2.6
+        uses: recursivezero/action-club/.github/actions/format-issue-title@v0.2.57
         with:
           prefix: RTY
-          dry_run: false

.github/workflows/main-ro-release.yml

@@ -0,0 +1,37 @@
+name: Sync Main to Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Required to compare branches
+
+      - name: Check for Code Differences
+        id: diff_check
+        run: |
+          DIFF=$(git diff origin/release...origin/main --name-only)
+          if [ -z "$DIFF" ]; then
+            echo "No changes found between main and release. Skipping."
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "## ⏭️ Sync Skipped" >> $GITHUB_STEP_SUMMARY
+            echo "Main and Release are already in sync." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Run PR Logic
+        if: steps.diff_check.outputs.has_changes == 'true'
+        uses: recursivezero/action-club/.github/actions/release-pr@main
+        with:
+          # Use your PAT here if the standard token continues to fail
+          github_token: ${{ secrets.PROJECT_PAT }}

.gitignore

@@ -59,3 +59,6 @@ poetry.lock
 *.tmp
 *.temp
 *.bak
+
+
+assets/images/qr/*

.vscode/dictionaries/project-words.txt

@@ -1,2 +1,4 @@
+appleboy
 projectx
+RZRO
 xkeshav

.vscode/dictionaries/team-member.txt

@@ -1,2 +1,3 @@
 keshav
 mohta
+recursivezero

CHANGELOG.md

@@ -11,3 +11,13 @@ All notable changes to this repository will be documented in this file.
 
 - Restructure folder structure
 - added poetry dev script
+
+## [1.0.0] Sun, Feb 15, 2026
+
+- Added In-Memory cache strategy
+- DB dependency optional
+- Change UI
+
+## [1.0.3] Wed, Feb 18, 2026
+
+- Added Database connection retry logic

README.md

@@ -268,6 +268,62 @@ pip install dist/*.whl
 pip install --upgrade dist/*.whl
 ```
 
+# 📡 Endpoints
+
+# 🔐 Cache Admin Endpoints (Authentication)
+
+To use the cache admin endpoints (`/cache/purge`, `/cache/remove`), you must configure a secret token in your environment and send it in the request header.
+Setup
+
+Add a token in your .env file:
+
+```
+CACHE_PURGE_TOKEN=your-secret-token
+```
+
+🧪 How to test
+
+PowerShell
+
+```
+Invoke-RestMethod `
+  -Method DELETE `
+  -Uri "http://127.0.0.1:8000/cache/purge" `
+  -Headers @{ "X-Cache-Token" = "your-secret-token" }
+```
+
+🧹 Remove a single cache entry
+
+```
+Invoke-RestMethod `
+  -Method PATCH `
+  -Uri "http://127.0.0.1:8000/cache/remove?key=abc123" `
+  -Headers @{ "X-Cache-Token" = "your-secret-token" }
+```
+
+🖥️ UI Endpoints
+
+| Method | Path            | Description                          |
+| ------ | --------------- | ------------------------------------ |
+| GET    | `/`             | Home page (URL shortener UI)         |
+| GET    | `/recent`       | Shows recently shortened URLs        |
+| GET    | `/{short_code}` | Redirects to the original URL        |
+| GET    | `/cache/list`   | 🔧 Debug cache view (local/dev only) |
+| DELETE | `/cache/purge`  | 🧹 Remove all entries from cache     |
+| PATCH  | `/cache/remove` | 🧹 Remove a single cache entry       |
+
+🔌 API Endpoints (v1)
+
+| Method | Path                | Description                          |
+| ------ | ------------------- | ------------------------------------ |
+| POST   | `/api/v1/shorten`   | Create a short URL                   |
+| GET    | `/api/v1/version`   | Get API version                      |
+| GET    | `/api/v1/health`    | Health check (DB + cache status)     |
+| GET    | `/api/{short_code}` | Redirect to original URL             |
+| GET    | `/cache/list`       | 🔧 Debug cache view (local/dev only) |
+| DELETE | `/cache/purge`      | 🧹 Remove all entries from cache     |
+| PATCH  | `/cache/remove`     | 🧹 Remove a single cache entry       |
+
 ## License
 
 📜Docs