From 111894bbe068b64f2e1fe443e11809a53a62df83 Mon Sep 17 00:00:00 2001
From: Adamskiee <tosinomatthew@gmail.com>
Date: Tue, 18 Aug 2026 00:53:31 +0800
Subject: [PATCH] docs(mobile-docs): resolve gaps between documentation and
 implementation.

- Added POST /gsm/request to API.md
- Removed unused EXPO_PUBLIC_API_URL from .env.example
- Fixed Transport Summary table in CONNECTION_MESSAGES.md
- Removed duplicate phone_number_verified column declaration in schema.ts
---
 mobile-app/sapot-mobile-app/.env.example               |  1 -
 mobile-app/sapot-mobile-app/docs/API.md                | 10 ++++++++++
 .../sapot-mobile-app/docs/CONNECTION_MESSAGES.md       |  6 +++---
 .../features/shared/core/database/schema.ts            |  5 -----
 4 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/mobile-app/sapot-mobile-app/.env.example b/mobile-app/sapot-mobile-app/.env.example
index 103dc1ed..bd9ae421 100644
--- a/mobile-app/sapot-mobile-app/.env.example
+++ b/mobile-app/sapot-mobile-app/.env.example
@@ -21,7 +21,6 @@ EXPO_PUBLIC_DEBUG_MENU=
 # DebugAuthService.loginAs(). Debug-menu only; never set in a production build.
 EXPO_PUBLIC_QA_API_TOKEN=
 
-EXPO_PUBLIC_API_URL=
 EXPO_PUBLIC_SERVER_VERIFY_KEY=
 APP_VARIANT=
 SERVER_CERT=
diff --git a/mobile-app/sapot-mobile-app/docs/API.md b/mobile-app/sapot-mobile-app/docs/API.md
index 2a9b88a6..9ac1560f 100644
--- a/mobile-app/sapot-mobile-app/docs/API.md
+++ b/mobile-app/sapot-mobile-app/docs/API.md
@@ -909,6 +909,16 @@ If the onboarding SMS is rejected, the endpoint preserves the gateway error and
 
 ---
 
+### `POST /gsm/request` — Request Phone Verification OTP
+**Auth:** Required
+
+**Request body:**
+```json
+{ "phone_number": "string" }
+```
+
+---
+
 ### `POST /gsm/verify` — Verify Phone Code
 **Auth:** Required
 
diff --git a/mobile-app/sapot-mobile-app/docs/CONNECTION_MESSAGES.md b/mobile-app/sapot-mobile-app/docs/CONNECTION_MESSAGES.md
index d3b45ec6..a0de921a 100644
--- a/mobile-app/sapot-mobile-app/docs/CONNECTION_MESSAGES.md
+++ b/mobile-app/sapot-mobile-app/docs/CONNECTION_MESSAGES.md
@@ -424,8 +424,8 @@ may not be a registered peer.
 | `ping` | | | ✓ |
 | `pong` | | | ✓ |
 | `profile-info` | ✓ | ✓ | |
-| `server-ack` | | ✓ | |
-| `get-active-users` | | ✓ | |
-| `public-chat` | | ✓ | |
+| `server-ack` | ✓ | | |
+| `get-active-users` | ✓ | | |
+| `public-chat` | ✓ | | |
 
 > **WebSocket** messages are server-relayed. **TCP** messages are direct peer-to-peer. WebSocket uses `from_user`; TCP uses `from`.
diff --git a/mobile-app/sapot-mobile-app/features/shared/core/database/schema.ts b/mobile-app/sapot-mobile-app/features/shared/core/database/schema.ts
index 32eea8d6..ce58c15b 100644
--- a/mobile-app/sapot-mobile-app/features/shared/core/database/schema.ts
+++ b/mobile-app/sapot-mobile-app/features/shared/core/database/schema.ts
@@ -51,11 +51,6 @@ export default appSchema({
           type: "boolean",
           isOptional: true,
         },
-        {
-          name: "phone_number_verified",
-          type: "boolean",
-          isOptional: true,
-        },
         {
           name: "role",
           type: "string",