From 445e2a4923c2ddfd587e5ef9f6e00e6ccd2156d2 Mon Sep 17 00:00:00 2001
From: ThatGuySam <sam@sam.lc>
Date: Sat, 14 Jun 2025 14:58:19 -0500
Subject: [PATCH] update: add more detail to flow

---
 docs/app-flow.md | 48 +++++++++++++++++++++++++++++++-----------------
 1 file changed, 31 insertions(+), 17 deletions(-)

diff --git a/docs/app-flow.md b/docs/app-flow.md
index b0933e3..cdab1af 100644
--- a/docs/app-flow.md
+++ b/docs/app-flow.md
@@ -15,27 +15,41 @@ Mermaid Diagram Notes:
 
 ```mermaid
 flowchart TD
-    A["👤 User: Submits App Request or Issue"] --> B{"🔧 Maintainer: Type of Issue?"}
-    B -- New App Request --> C["⚙️ System: Check for Existing Issue"]
-    C -- Not Found --> D["👤 User: Fill Out Issue Form<br/>(App Name, Status, Category, Links, Screenshot)"]
-    D --> E["⚙️ System: Label as 'New App Request'"]
-    E --> F["🔧 Maintainer: Reviews Submission"]
-    F -- Info Complete --> G["🔧 Maintainer: Label as 'Ready to Add'"]
-    F -- Info Missing --> H["🔧 Maintainer: Request More Info from User"]
-    H --> H2["🔧 Maintainer: Add 'Needs ...' Labels<br/>(e.g. Needs Screenshots, Needs Category)"]
+    A["1A. 👤 User: Submits App Request or Issue<br/>(via '🙋 Request an App with Github' from doesitarm.com OR directly to GitHub repo)"] --> B["2A. 👤 User: Check for Existing Issue<br/>(Search query page from doesitarm.com)"]
+    B -- Not Found --> C["3A. 👤 User: Fill Out Issue Form<br/>(App Name, Status, Category, Links, Screenshot)"]
+    C --> D["4A. ⚙️ System: Label as 'New App Request'"]
+    D --> E["5A. 🔧 Maintainer: Type of Issue?"]
+    E -- New App Request --> F["6A. 🔧 Maintainer: Reviews Submission"]
+    F -- Info Complete --> F2["7A. 🔧 Maintainer: Comment Thank You"]
+    F2 --> F3["8A. 🔧 Maintainer: Explain Options<br/>(User can make PR or Does It ARM bot will try to add automatically)"]
+    F3 --> G["9A. 🔧 Maintainer: Label as 'Ready to Add'"]
+    F -- Info Missing --> H0["6B. 🔧 Maintainer: Thank User for Info Provided"]
+    H0 --> H["7B. 🔧 Maintainer: Request More Info from User"]
+    H --> H2["8B. 🔧 Maintainer: Add 'Needs ...' Labels<br/>(e.g. Needs Screenshots, Needs Category)"]
     H2 --> F
-    G --> I["👥 Contributor: Creates PR"]
-    I --> J["👥 Contributor: App Added to Compatibility List"]
-    J --> K["⚙️ System: Close Issue"]
+    
+    G --> I["10A. 👥 Contributor: Creates PR"]
+    G --> I2["10B. 🔧 Maintainer: Updates README Directly"]
+    I --> J["11A. 👥 Contributor: App Added to Compatibility List"]
+    I2 --> I3["11B. 🔧 Maintainer: Verify App Updated on doesitarm.com<br/>(can take up to 15 mins)"]
+    J --> J1["12A. 🔧 Maintainer: Review PR"]
+    J1 --> J2["13A. 🔧 Maintainer: Thank Contributor for PR"]
+    J2 --> J3["14A. 🔧 Maintainer: PR Decision"]
+    J3 -- Changes Requested --> J4["15A. 🔧 Maintainer: Request PR Changes"]
+    J4 --> J5["16A. 👥 Contributor: Update PR"]
+    J5 --> J1
+    J3 -- Approved --> L1["17A. 🔧 Maintainer: Comment that App is Live"]
+    I3 --> L1
+    L1 --> K["18A. ⚙️ System: Close Issue"]
 
-    B -- App Update --> L["👤 User: Reports Update<br/>(e.g. Native Support Now Available)"]
-    L --> M["👤 User: Provide Evidence<br/>(Links, Screenshots)"]
-    M --> N["🔧 Maintainer: Label as 'App Update'"]
+    E -- App Update --> L["1C. 👤 User: Reports Update<br/>(e.g. Native Support Now Available)"]
+    L --> M["2C. 👤 User: Provide Evidence<br/>(Links, Screenshots)"]
+    M --> N["3C. ⚙️ System: Label as 'App Update'<br/>(Auto-applied via App Update Template)"]
     N --> F
 
-    B -- Feature/Meta Issue --> O["🔧 Maintainer: Label as 'Feature Request' or 'Bug'"]
-    O --> P["🔧 Maintainer: Discuss, Assign, and Track Progress"]
-    P --> Q["👥 Contributor: Implement and Close"]
+    E -- Feature/Meta Issue --> O["1D. 🔧 Maintainer: Label as 'Feature Request' or 'Bug'"]
+    O --> P["2D. 🔧 Maintainer: Discuss, Assign, and Track Progress"]
+    P --> Q["3D. 👥 Contributor: Implement and Close"]
 
     style A stroke:#f9f,stroke-width:2px
     style J stroke:#bbf,stroke-width:2px