Added the project Workflow SVG

README.md

@@ -53,6 +53,7 @@ short_description: Autonomous drone delivery RL environment.
 - [Hugging Face Submission](#hugging-face-submission)
 - [Reward Engineering](#reward-engineering)
 - [Grading & Evaluation](#grading--evaluation)
+- [Project Architecture](#project-architecture)
 - [Project Structure](#project-structure)
 - [Configuration Reference](#configuration-reference)
 
@@ -661,6 +662,55 @@ $$\text{score} = 0.8 \times \underbrace{\frac{\text{deliveries done}}{\text{deli
 
 ---
 
+## 🚀 The Life of a Parcel (End-to-End Flow)
+
+If you want to understand how **SkyRelic** works "at a glance," follow the journey of a single delivery:
+
+```mermaid
+graph LR
+    subgraph "1. Initialization"
+    A[User] -- "Clicks Reset" --> B(FastAPI)
+    B -- "CityGen" --> C[New Map Generated]
+    end
+
+    subgraph "2. Decision Loop"
+    C -- "Telemetry" --> D{Dashboard UI}
+    D -- "State Info" --> E[Neural Brain]
+    E -- "Action (UP/DOWN/etc)" --> B
+    end
+
+    subgraph "3. Physics & Scoring"
+    B -- "Calculate" --> F{World Engine}
+    F -- "Collision/Battery" --> G[Updated State]
+    G -- "Success?" --> H((🏆 Score))
+    end
+
+    G -.-> D
+```
+
+### 📦 The Mission Journey:
+1.  **THE SPARK** ⚡: You click **Reset** in your browser. The Dashboard sends a request to the **FastAPI Server**.
+2.  **THE CREATION** 🏗️: The **Core Logic** generates a random 10x10 city with roads 🛣️, buildings 🏢, and trees 🌳. It places a **Parcel** 📦 at a random location.
+3.  **THE SIGHT** 👁️: The server sends the "State" (JSON) back to the **UI Dashboard**. You see the drone appear in the grid.
+4.  **THE BRAIN** 🧠: When you click **Start**, the **Neural Engine** (RL) looks at the map, calculates the distance, and picks the best direction.
+5.  **THE FLIGHT** 🛸: The drone moves! The **Physics Engine** drains its battery and checks for crashes against buildings.
+6.  **THE VICTORY** 🏁: Once the drone reaches the 📦, the **Grader** calculates your efficiency and updates your score!
+
+---
+
+## Project Architecture
+
+![Project Workflow](./src/svg/project_workflow.svg)
+
+The **SkyRelic** ecosystem is divided into four primary layers, interconnected via JSON telemetry and Python API endpoints:
+
+1.  **Frontend Dashboard**: A high-speed, browser-based UI that polls telemetry from the FastAPI backend and renders a real-time 2D grid of the drone's mission.
+2.  **FastAPI Server**: The communication hub that bridges the browser UI with the Python environment, managing routes for `/step`, `/reset`, and `/predict`.
+3.  **Neural RL Engine**: A PyTorch-powered Deep Q-Network (DQN) that processes urban grid data to select optimal flight paths.
+4.  **Core Logistics Env**: The "World Engine" which simulates urban terrain, battery physics, and parcel delivery missions.
+
+---
+
 ## Project Structure
 
 ```

data/memory.json

@@ -19684,5 +19684,71 @@
     "deliveries_done": 1,
     "total_reward": 0.75,
     "total_steps": 4
+  },
+  {
+    "task": "easy_delivery",
+    "steps": [
+      {
+        "step": 1,
+        "x": 3,
+        "y": 7,
+        "action": "RIGHT",
+        "reward": -0.05,
+        "battery": 0.9833
+      },
+      {
+        "step": 2,
+        "x": 4,
+        "y": 7,
+        "action": "RIGHT",
+        "reward": -0.05,
+        "battery": 0.9667
+      },
+      {
+        "step": 3,
+        "x": 5,
+        "y": 7,
+        "action": "RIGHT",
+        "reward": -0.05,
+        "battery": 0.95
+      },
+      {
+        "step": 4,
+        "x": 6,
+        "y": 7,
+        "action": "RIGHT",
+        "reward": -0.05,
+        "battery": 0.9333
+      },
+      {
+        "step": 5,
+        "x": 7,
+        "y": 7,
+        "action": "RIGHT",
+        "reward": -0.1,
+        "battery": 0.9167
+      },
+      {
+        "step": 6,
+        "x": 8,
+        "y": 7,
+        "action": "RIGHT",
+        "reward": 0.95,
+        "battery": 0.9
+      }
+    ],
+    "grid_meta": {
+      "width": 10,
+      "height": 10
+    },
+    "delivery_positions": [
+      [
+        8,
+        7
+      ]
+    ],
+    "deliveries_done": 1,
+    "total_reward": 0.65,
+    "total_steps": 6
   }
 ]

server/app.py

@@ -162,6 +162,20 @@ async def root():
         return FileResponse(index_path)
     return {"name": "Drone Delivery OpenEnv", "ui": "/ui"}
 
+@app.get("/favicon.png")
+async def favicon_png():
+    icon_path = BASE_DIR / "src" / "img" / "icon.png"
+    if icon_path.exists():
+        # Set headers to prevent aggressive caching during development
+        headers = {"Cache-Control": "no-cache, no-store, must-revalidate"}
+        return FileResponse(icon_path, media_type="image/png", headers=headers)
+    raise HTTPException(404, detail="Icon not found.")
+
+@app.get("/favicon.ico")
+async def favicon_ico():
+    """Redirect .ico requests to our branded .png version."""
+    return await favicon_png()
+
 @app.get("/ui")
 async def ui():
     index_path = STATIC_DIR / "index.html"

server/static/index.html

@@ -4,7 +4,9 @@
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>🚁 Drone Delivery — OpenEnv</title>
+  <title>🚁 SkyRelic - Drone Delivery Env</title>
+  <link rel="icon" type="image/svg+xml" href="/favicon.svg" sizes="any">
+  <link rel="shortcut icon" href="/favicon.ico">
   <link
     href="https://fonts.googleapis.com/css2?family=Syne:wght@400;600;700;800&family=JetBrains+Mono:wght@300;400;500;700&display=swap"
     rel="stylesheet" />