feat: rebrand FALSA to FALZH with updated supabase schema, tool names, and prompts

.env.example

@@ -1,4 +1,4 @@
-APP_NAME=FALSA
+APP_NAME=FALZH
 ENVIRONMENT=development
 APP_TIMEZONE=Asia/Aden
 LOG_LEVEL=INFO
@@ -9,8 +9,8 @@ SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
 PINECONE_API_KEY=your-pinecone-api-key
 PINECONE_CLOUD=aws
 PINECONE_REGION=us-east-1
-PINECONE_INFO_INDEX=falsa-info
-PINECONE_TRIPS_INDEX=falsa-trips
+PINECONE_INFO_INDEX=falzh-info
+PINECONE_TRIPS_INDEX=falzh-trips
 PINECONE_EMBED_MODEL=multilingual-e5-large
 PINECONE_NAMESPACE=default
 

README.md

@@ -1,14 +1,14 @@
-# FALSA
+# FALZH
 
 > **AI-powered travel service — on WhatsApp.**
 
 > **🚧 Work in progress — not yet published. Coming soon.**
 
 <p align="center">
-  <img src="assets/Falsa.png" alt="FALSA logo" width="100%">
+  <img src="assets/Falsa.png" alt="FALZH logo" width="100%">
 </p>
 
-FALSA lets passengers search trips and connect with drivers, and lets drivers publish, update, and manage their trips — all through a natural conversation on WhatsApp. No app to install, no complex UI to learn. Just type what you want.
+FALZH lets passengers search trips and connect with drivers, and lets drivers publish, update, and manage their trips — all through a natural conversation on WhatsApp. No app to install, no complex UI to learn. Just type what you want.
 
 ---
 
@@ -23,9 +23,9 @@ Travel booking platforms in my country are poorly adopted. Not because people do
 
 ## Solution
 
-FALSA removes all of that. The entire interface is a single chat conversation. **You say where you're going and when — FALSA handles the rest.**
+FALZH removes all of that. The entire interface is a single chat conversation. **You say where you're going and when — FALZH handles the rest.**
 
-- **Passengers** describe their trip in natural language; FALSA searches available trips, shows options, and connects them with drivers.
+- **Passengers** describe their trip in natural language; FALZH searches available trips, shows options, and connects them with drivers.
 - **Drivers** publish trips, manage schedules, and receive trip interest notifications — all by chatting.
 - No app install, no account creation flow, no confusing dashboard.
 
@@ -36,7 +36,7 @@ FALSA removes all of that. The entire interface is a single chat conversation. *
 - **Natural-language trip search** — "I want to go from Sana'a to Taiz tomorrow morning"
 - **WhatsApp-native interaction** — interactive lists, text replies, no extra UI
 - **Driver tools** — publish trips, add cars, modify/delete trips, receive trip interest notifications
-- **Passenger tools** — search trips, select trips, get driver contact, get FALSA information
+- **Passenger tools** — search trips, select trips, get driver contact, get FALZH information
 - **AI-powered orchestration** — tool-calling LLM (Groq primary, Hugging Face fallback) routes intent to the right action
 - **RAG knowledge base** — company info, pricing, policies embedded via Jina AI and retrieved on demand
 - **Trip vector search** — semantic search over driver trips for flexible departure matching
@@ -83,7 +83,7 @@ This means:
 WhatsApp User
      │
      ▼  (message)
-Baileys Bridge ──► FALSA API ──► AI Orchestrator ──► Tools
+Baileys Bridge ──► FALZH API ──► AI Orchestrator ──► Tools
 (Node.js,            (FastAPI)     (Groq / HF)          │
  separate repo)           │                              │
                           ▼                              ▼
@@ -92,7 +92,7 @@ Baileys Bridge ──► FALSA API ──► AI Orchestrator ──► Tools
                     messages, embeddings)
 ```
 
-The system is designed so the WhatsApp integration layer is swappable. The Baileys bridge (Node.js) handles the Web protocol; the FALSA Python backend talks to it the same way it talks to the Cloud API. When Cloud API onboarding is complete, swapping the bridge requires zero changes to the core logic.
+The system is designed so the WhatsApp integration layer is swappable. The Baileys bridge (Node.js) handles the Web protocol; the FALZH Python backend talks to it the same way it talks to the Cloud API. When Cloud API onboarding is complete, swapping the bridge requires zero changes to the core logic.
 
 ---
 
@@ -108,7 +108,7 @@ The system is designed so the WhatsApp integration layer is swappable. The Baile
 
 ```bash
 # 1. Clone and enter the repo
-git clone <repo-url> && cd falsa
+git clone <repo-url> && cd falzh
 
 # 2. Configure environment
 cp .env.example .env
@@ -132,7 +132,7 @@ The API is now running at `http://localhost:8000`.
 ./scripts/setup_and_seed.sh
 ```
 
-This embeds the FALSA info document (`prompts/falsa_info.md`) and all active trips into Supabase pgvector for RAG retrieval.
+This embeds the FALZH info document (`prompts/falzh_info.md`) and all active trips into Supabase pgvector for RAG retrieval.
 
 ### Run Tests
 
@@ -157,13 +157,13 @@ Mounts the current directory with hot-reload enabled.
 
 ## WhatsApp Baileys Bridge
 
-FALSA uses the official Meta Cloud API for production messages. During early stages — while waiting for commercial approval — a **Baileys-based bridge** acts as the WhatsApp gateway.
+FALZH uses the official Meta Cloud API for production messages. During early stages — while waiting for commercial approval — a **Baileys-based bridge** acts as the WhatsApp gateway.
 
 The bridge is a separate Node.js project:
 
 #### [https://github.com/codeBOKER/wh_baileys](https://github.com/codeBOKER/wh_baileys)
 
-It connects to WhatsApp via the Web protocol, relays inbound messages to the FALSA API, and forwards responses back to the user. The FALSA API treats the bridge identically to the Cloud API, so switching later requires no backend changes.
+It connects to WhatsApp via the Web protocol, relays inbound messages to the FALZH API, and forwards responses back to the user. The FALZH API treats the bridge identically to the Cloud API, so switching later requires no backend changes.
 
 ---
 
@@ -174,7 +174,7 @@ It connects to WhatsApp via the Web protocol, relays inbound messages to the FAL
 | `GET` | `/healthz` | Health check |
 | `GET` | `/webhooks/whatsapp` | Webhook verification (challenge) |
 | `POST` | `/webhooks/whatsapp` | Receive WhatsApp messages |
-| `POST` | `/admin/seed-info` | Seed FALSA RAG info |
+| `POST` | `/admin/seed-info` | Seed FALZH RAG info |
 | `POST` | `/admin/sync-trips` | Sync trip embeddings |
 | `POST` | `/admin/jina-embed` | Test embedding |
 | `POST` | `/admin/llm-tool-call` | Debug tool calling |
@@ -184,7 +184,7 @@ It connects to WhatsApp via the Web protocol, relays inbound messages to the FAL
 ## Project Structure
 
 ```
-falsa/
+falzh/
 ├── app/
 │   ├── ai/                # LLM orchestration, providers, tool schemas
 │   ├── api/               # FastAPI routes, dependency injection
@@ -219,7 +219,7 @@ Baileys (Node.js) is used only as a temporary WhatsApp bridge. My strongest area
 
 **How does the Baileys bridge differ from the Cloud API?**
 
-It doesn't — that's the point. The FALSA backend speaks the same protocol to both. The Baileys bridge simply translates the WhatsApp Web protocol into the same format the Cloud API uses. When Cloud API approval comes through, we swap the bridge with zero backend changes.
+It doesn't — that's the point. The FALZH backend speaks the same protocol to both. The Baileys bridge simply translates the WhatsApp Web protocol into the same format the Cloud API uses. When Cloud API approval comes through, we swap the bridge with zero backend changes.
 
 ---
 

app/ai/tool_schemas.py

@@ -2,19 +2,19 @@ from typing import Any
 
 from app.models.domain import UserMode
 
-_ABOUT_FALSA = {
+_ABOUT_FALZH = {
     "type": "function",
     "function": {
-        "name": "about_falsa",
+        "name": "about_falzh",
         "description": (
-            "Retrieve official FALSA company, FAQ, policy, or pricing information."
+            "Retrieve official FALZH company, FAQ, policy, or pricing information."
         ),
         "parameters": {
             "type": "object",
             "properties": {
                 "query": {
                     "type": "string",
-                    "description": "The customer's question about FALSA.",
+                    "description": "The customer's question about FALZH.",
                 },
                 "language": {
                     "type": "string",
@@ -122,7 +122,7 @@ _CREATE_DRIVER_ACCOUNT = {
     "type": "function",
     "function": {
         "name": "create_driver_account",
-        "description": "Register this WhatsApp sender as a FALSA driver. Phone from chat session.",
+        "description": "Register this WhatsApp sender as a FALZH driver. Phone from chat session.",
         "parameters": {
             "type": "object",
             "properties": {
@@ -354,7 +354,7 @@ _SWITCH_TO_PASSENGER = {
 }
 
 _TOOL_SCHEMAS: dict[str, dict[str, Any]] = {
-    "about_falsa": _ABOUT_FALSA,
+    "about_falzh": _ABOUT_FALZH,
     "search_trips": _SEARCH_TRIPS,
     "select_trip": _SELECT_TRIP,
     "create_driver_account": _CREATE_DRIVER_ACCOUNT,
@@ -370,13 +370,13 @@ _TOOL_SCHEMAS: dict[str, dict[str, Any]] = {
 
 _TOOLS_BY_MODE: dict[UserMode, list[str]] = {
     "new_user": [
-        "about_falsa",
+        "about_falzh",
         "create_driver_account",
         "switch_to_driver",
         "switch_to_passenger",
     ],
     "driver": [
-        "about_falsa",
+        "about_falzh",
         "check_driver_info",
         "check_driver_trips",
         "add_driver_car",
@@ -386,7 +386,7 @@ _TOOLS_BY_MODE: dict[UserMode, list[str]] = {
         "switch_to_passenger",
     ],
     "passenger": [
-        "about_falsa",
+        "about_falzh",
         "search_trips",
         "select_trip",
         "create_driver_account",

app/config.py

@@ -15,7 +15,7 @@ class Settings(BaseSettings):
         extra="ignore",
     )
 
-    app_name: str = "FALSA"
+    app_name: str = "FALZH"
     environment: str = "development"
     app_timezone: str = "Asia/Aden"
     log_level: str = "INFO"

app/database/supabase.py

@@ -457,7 +457,7 @@ class SupabaseRepository:
         match_count: int = 5,
     ) -> list[dict[str, Any]]:
         response = await self.client.rpc(
-            "match_falsa_info",
+            "match_falzh_info",
             {
                 "query_embedding": query_embedding,
                 "match_count": match_count,
@@ -512,7 +512,7 @@ class SupabaseRepository:
     async def upsert_info_chunks(self, chunks: list[dict[str, Any]]) -> int:
         if not chunks:
             return 0
-        response = await self.client.table("falsa_info_chunks").upsert(chunks).execute()
+        response = await self.client.table("falzh_info_chunks").upsert(chunks).execute()
         data = _response_data(response)
         return len(data) if isinstance(data, list) else len(chunks)
 

app/main.py

@@ -21,6 +21,6 @@ def create_app(
         app.state.container = container or await ServiceContainer.from_settings(active_settings)
         yield
 
-    app = FastAPI(title="FALSA API", version="0.1.0", lifespan=lifespan)
+    app = FastAPI(title="FALZH API", version="0.1.0", lifespan=lifespan)
     app.include_router(router)
     return app

app/models/api.py

@@ -4,7 +4,7 @@ from typing import Any
 
 class HealthResponse(BaseModel):
     status: str = "ok"
-    service: str = "FALSA"
+    service: str = "FALZH"
 
 
 class SeedInfoResponse(BaseModel):

app/services/admin_service.py

@@ -19,7 +19,7 @@ class AdminService:
         self.repository = repository
         self.embeddings = embeddings
         self.settings = settings
-        self.info_path = info_path or Path("prompts/falsa_info.md")
+        self.info_path = info_path or Path("prompts/falzh_info.md")
 
     async def seed_info(self) -> int:
         text = self.info_path.read_text(encoding="utf-8")

app/services/conversation_service.py

@@ -9,7 +9,7 @@ from app.database.supabase import SupabaseRepository
 from app.models.domain import UserMode, WhatsAppInboundMessage
 from app.services.embedding_service import JinaEmbeddingService
 from app.services.trip_indexing import unindex_trip
-from app.tools.handlers import FalsaToolHandlers, _trip_summary
+from app.tools.handlers import FalzhToolHandlers, _trip_summary
 from app.tools.registry import ToolRegistry
 from app.utils.time import now_in_timezone
 from app.whatsapp.client import WhatsAppClient
@@ -99,7 +99,7 @@ class ConversationService:
                 if orig_meta.get("type") == "trip_card":
                     trip_id = orig_meta.get("trip_id")
                     if trip_id:
-                        handlers = FalsaToolHandlers(
+                        handlers = FalzhToolHandlers(
                             repository=self.repository,
                             embeddings=self.embeddings,
                             whatsapp=self.whatsapp,
@@ -202,7 +202,7 @@ class ConversationService:
                 "They were previously tracked from WhatsApp group trip posts. "
                 "Welcome them warmly by name. Tell them we have been following their trips "
                 "in the groups and we are impressed. Explain that we have registered them in "
-                "FALSA so they can now send trips directly here instead of posting in groups. "
+                "FALZH so they can now send trips directly here instead of posting in groups. "
                 "Show them how: just send the trip details (route, date, time) in chat. "
                 "Explain the benefits: passengers find their trips via AI search, they get "
                 "notified immediately when a passenger selects their trip, and registered "
@@ -269,7 +269,7 @@ class ConversationService:
         user_mode: UserMode,
         current_message: dict[str, Any] | None = None,
     ) -> ToolRegistry:
-        handlers = FalsaToolHandlers(
+        handlers = FalzhToolHandlers(
             repository=self.repository,
             embeddings=self.embeddings,
             whatsapp=self.whatsapp,

app/tools/handlers.py

@@ -27,7 +27,7 @@ from app.whatsapp.client import WhatsAppClient, WhatsAppClientError
 from app.whatsapp.trip_selection import format_trip_card
 
 
-class FalsaToolHandlers:
+class FalzhToolHandlers:
     def __init__(
         self,
         *,
@@ -60,7 +60,7 @@ class FalsaToolHandlers:
         original_meta = original.get("metadata") or {}
         return original_meta.get("trip_id")
 
-    async def about_falsa(self, arguments: dict[str, Any]) -> ToolResult:
+    async def about_falzh(self, arguments: dict[str, Any]) -> ToolResult:
         query = str(arguments.get("query") or "").strip()
         if not query:
             return ToolResult(ok=False, data={}, error="query is required")
@@ -74,7 +74,7 @@ class FalsaToolHandlers:
             return ToolResult(
                 ok=True,
                 data={
-                    "answer": "No matching FALSA policy or FAQ content was found.",
+                    "answer": "No matching FALZH policy or FAQ content was found.",
                     "sources": [],
                 },
             )
@@ -1080,7 +1080,7 @@ def _driver_notification_text(
     notes: str | None,
 ) -> str:
     return (
-        "🔔 اهتمام جديد برحلة في فلزا\n"
+        "🔔 اهتمام جديد برحلة في فلزة\n"
         f"العميل: {customer.get('name') or 'عميل جديد'}\n"
         f"رقم العميل: {customer.get('phone_number') or 'غير متوفر'}\n"
         f"الرحلة: {trip.get('departure')} ← {trip.get('destination')}\n"

docker-compose.yml

@@ -1,5 +1,5 @@
 services:
-  falsa-api:
+  falzh-api:
     build: .
     env_file:
       - .env

prompts/{falsa_info.md → falzh_info.md}

@@ -1,15 +1,15 @@
-# فلزا — معلومات المنصة
+# فلزة — معلومات المنصة
 
-## عن فلزا
-فلزا هي خدمة سفر عبر واتساب مدعومة بالذكاء الاصطناعي. تعمل بالكامل داخل واتساب — لا تحتاج تحميل تطبيق جديد. تقدر تبحث عن رحلات السيارات والباصات، وتعبر عن اهتمامك برحلة، ويتواصل معك السائق مباشرة للاتفاق على الحجز.
+## عن فلزة
+فلزة هي خدمة سفر عبر واتساب مدعومة بالذكاء الاصطناعي. تعمل بالكامل داخل واتساب — لا تحتاج تحميل تطبيق جديد. تقدر تبحث عن رحلات السيارات والباصات، وتعبر عن اهتمامك برحلة، ويتواصل معك السائق مباشرة للاتفاق على الحجز.
 
 ## كيف تعمل الخدمة للمسافر
 1. ترسل رسالة على واتساب تصف رحلتك (مثال: "أبي أسافر من صنعاء إلى تعز بكرة الصباح")
-2. فلزا تبحث في الرحلات المتاحة وترسل لك بطاقات الرحلات المطابقة
+2. فلزة تبحث في الرحلات المتاحة وترسل لك بطاقات الرحلات المطابقة
 3. ترد على بطاقة الرحلة اللي تعجبك
-4. فلزا تخبر السائق باهتمامك وتعطيك رقم السائق
+4. فلزة تخبر السائق باهتمامك وتعطيك رقم السائق
 5. تتواصل مع السائق مباشرة للاتفاق على التفاصيل والحجز
-ملاحظة: فلزا لا تحجز لك ولا تؤكد الحجز. اختيار الرحلة يعني تسجيل اهتمام فقط.
+ملاحظة: فلزة لا تحجز لك ولا تؤكد الحجز. اختيار الرحلة يعني تسجيل اهتمام فقط.
 
 ## أنماط المستخدم
 المستخدم الجديد: يسأله النظام هل يريد السفر (مسافر) أو العمل كسائق. المسافر: يبحث عن رحلات ويختار ويتواصل مع السائق. السائق: ينشر رحلات ويدير جدوله ويسجل مركباته ويستلم إشعارات الاهتمام بالرحلات.
@@ -21,31 +21,31 @@
 عندما تختار رحلة بالرد على بطاقة الرحلة: يتم تسجيل اهتمامك (ليس حجزاً مؤكداً)، السائق يستلم إشعار فيه اسمك ورقمك وعدد المقاعد المطلوبة، أنت تستلم رقم السائق، تتواصلون مباشرة للاتفاق على الحجز والسعر. المقاعد لا تحجز. قد يتواصل معك أكثر من شخص مهتم بنفس الرحلة.
 
 ## الأسعار
-السعر تحدده شركة السائق أو السائق نفسه. فلزا فقط تعرض السعر اللي أدخله السائق عند نشر الرحلة. فلزا لا تحدد الأسعار ولا تتعامل في المدفوعات. إذا كان السعر مو محدد في الرحلة، اسأل السائق مباشرة.
+السعر تحدده شركة السائق أو السائق نفسه. فلزة فقط تعرض السعر اللي أدخله السائق عند نشر الرحلة. فلزة لا تحدد الأسعار ولا تتعامل في المدفوعات. إذا كان السعر مو محدد في الرحلة، اسأل السائق مباشرة.
 
 ## خدمات السائقين
-تسجيل حساب سائق: يحتاج الاسم الكامل. تربط فلزا حسابك برقم واتسابك. إضافة مركبة: اسم المركبة مطلوب، رقم اللوحة وعدد المقاعد اختياري. نشر رحلة: يلزم المدينة (من وإلى)، التاريخ، الفترة (صباح/ظهر/ليل). عدد المقاعد والسعر تُملأ تلقائياً من آخر رحلة أو مركبتك المسجلة. تعديل رحلة: تقدر تغير الوجهة، الوقت، السيارة، المقاعد، أو السعر. تاريخ الرحلة لا يمكن تغييره — لازم تنشئ رحلة جديدة. حذف رحلة: تلغي الرحلة وترفعها من البحث. ممنوع يكون عندك رحلتين في نفس التاريخ والفترة.
+تسجيل حساب سائق: يحتاج الاسم الكامل. تربط فلزة حسابك برقم واتسابك. إضافة مركبة: اسم المركبة مطلوب، رقم اللوحة وعدد المقاعد اختياري. نشر رحلة: يلزم المدينة (من وإلى)، التاريخ، الفترة (صباح/ظهر/ليل). عدد المقاعد والسعر تُملأ تلقائياً من آخر رحلة أو مركبتك المسجلة. تعديل رحلة: تقدر تغير الوجهة، الوقت، السيارة، المقاعد، أو السعر. تاريخ الرحلة لا يمكن تغييره — لازم تنشئ رحلة جد��دة. حذف رحلة: تلغي الرحلة وترفعها من البحث. ممنوع يكون عندك رحلتين في نفس التاريخ والفترة.
 
 ## السياسات
-فلزا لا تحجز رحلات ولا تؤكد حجوزات. اختيار الرحلة يعني تسجيل اهتمام فقط. فلزا لا تتعامل في المدفوعات نهائياً. المسافر يتحمل مسؤولية تقديم معلومات صحيحة عن وجهته ووقته وعدد المقاعد. فلزا فقط تقدم معلومات عن خدماتها — ترفض الإجابة عن أي موضوع خارج السفر.
+فلزة لا تحجز رحلات ولا تؤكد حجوزات. اختيار الرحلة يعني تسجيل اهتمام فقط. فلزة لا تتعامل في المدفوعات نهائياً. المسافر يتحمل مسؤولية تقديم معلومات صحيحة عن وجهته ووقته وعدد المقاعد. فلزة فقط تقدم معلومات عن خدماتها — ترفض الإجابة عن أي موضوع خارج السفر.
 
 ## الخصوصية
-رقم واتسابك يُستخدم فقط لربط حسابك وإرسال الإشعارات. رقم هاتفك يُشارك مع السائق فقط عندما تختار رحلة، عشان يتواصل معك. فلزا لا تشارك معلوماتك مع أي طرف آخر.
+رقم واتسابك يُستخدم فقط لربط حسابك وإرسال الإشعارات. رقم هاتفك يُشارك مع السائق فقط عندما تختار رحلة، عشان يتواصل معك. فلزة لا تشارك معلوماتك مع أي طرف آخر.
 
 ## الأسئلة الشائعة
-س: وش هي فلزا؟ ج: خدمة سفر على واتساب. تقدر تبحث عن رحلات سيارات وباصات وتختار رحلة وتتواصل مع السائق — كل شيء داخل واتساب.
-س: كيف أبحث عن رحلة؟ ج: فقط اكتب وجهتك مثل "من صنعاء إلى تعز بكرة الصباح". فلزا تفهم وتجيب لك النتائج.
+س: وش هي فلزة؟ ج: خدمة سفر على واتساب. تقدر تبحث عن رحلات سيارات وباصات وتختار رحلة وتتواصل مع السائق — كل شيء داخل واتساب.
+س: كيف أبحث عن رحلة؟ ج: فقط اكتب وجهتك مثل "من صنعاء إلى تعز بكرة الصباح". فلزة تفهم وتجيب لك النتائج.
 س: هل الحجز مؤكد؟ ج: لا. اختيار الرحلة يعني إرسال اهتمامك للسائق. السائق يتواصل معك للاتفاق.
-س: كيف أدفع؟ ج: فلزا لا تتعامل بالدفع. تتفق مع السائق مباشرة على السعر وطريقة الدفع.
-س: كيف أتواصل مع السائق؟ ج: بعد اختيار الرحلة، ترسل فلزا رقم السائق. كلمه على واتساب أو اتصال.
+س: كيف أدفع؟ ج: فلزة لا تتعامل بالدفع. تتفق مع السائق مباشرة على السعر وطريقة الدفع.
+س: كيف أتواصل مع السائق؟ ج: بعد اختيار الرحلة، ترسل فلزة رقم السائق. كلمه على واتساب أو اتصال.
 س: وش معنى المقاعد المتاحة؟ ج: عدد المقاعد الفارغة في الرحلة. تقدر تطلب أي عدد لكن لا تحجز — السائق يؤكد بعد التواصل.
 س: هل أقدر ألغي اختياري؟ ج: اختيار الرحلة هو إرسال اهتمام فقط ولا يوجد إلغاء من النظام. إذا تغير رأيك، تواصل مع السائق مباشرة.
 س: كيف أسجل كسائق؟ ج: قول "أبي أسجل كسائق" أو اختر وضع السائق. يحتاج الاسم الكامل.
-س: كيف أبحث عن رحلة لسائق معين؟ ج: قول "أبي رحلات السائق أحمد" أو "دور رحلة مع السائق". فلزا تبحث في الرحلات المتاحة لهالسائق وترسل لك النتائج.
-س: كيف أضيف رحلة كسائق؟ ج: قول "أبي أضيف رحلة من عدن إلى الحديدة الجمعة الصباح". فلزا تطلب التفاصيل الناقصة.
-س: كيف أعدل أو ألغي رحلة؟ ج: قول "أبي أعدل رحلة" أو "أبي ألغي رحلة". فلزا ترسل لك قائمة رحلاتك — ترد على اللي تبيه.
-س: هل فيه رحلات بين كل المدن؟ ج: فلزا تعرض الرحلات اللي ينشرها السائقين. إذا ما لقيت رحلتك، اسأل مرة ثانية أو تواصل مع الدعم.
-س: هل الخدمة مجانية؟ ج: استخدام فلزا مجاني. السعر للسفر تتفق فيه مع السائق.
+س: كيف أبحث عن رحلة لسائق معين؟ ج: قول "أبي رحلات السائق أحمد" أو "دور رحلة مع السائق". فلزة تبحث في الرحلات ��لمتاحة لهالسائق وترسل لك النتائج.
+س: كيف أضيف رحلة كسائق؟ ج: قول "أبي أضيف رحلة من عدن إلى الحديدة الجمعة الصباح". فلزة تطلب التفاصيل الناقصة.
+س: كيف أعدل أو ألغي رحلة؟ ج: قول "أبي أعدل رحلة" أو "أبي ألغي رحلة". فلزة ترسل لك قائمة رحلاتك — ترد على اللي تبيه.
+س: هل فيه رحلات بين كل المدن؟ ج: فلزة تعرض الرحلات اللي ينشرها السائقين. إذا ما لقيت رحلتك، اسأل مرة ثانية أو تواصل مع الدعم.
+س: هل الخدمة مجانية؟ ج: استخدام فلزة مجاني. السعر للسفر تتفق فيه مع السائق.
 
 ## الدعم الفني
 إذا ما لقى المساعد إجابة أو رحلة مناسبة، يجمع معلومات طلبك ويشرح أن فريق الدعم سيتابع معك. للتواصل مع الدعم الفني: أرسل استفسارك وسنرد عليك في أقرب وقت.

prompts/system.md

@@ -1,15 +1,14 @@
-You are FALSA, a WhatsApp travel booking assistant.
+You are FALZH, a WhatsApp travel booking assistant.
 
 Rules:
 - Reply in sender's language (Arabic/English). Be concise, warm, practical.
-- For new users: be extra warm and welcoming. Greet them, introduce FALSA briefly, and guide them to their first action.
-- Use `about_falsa` for company/FAQ/policy/pricing/support.
+- For new users: be extra warm and welcoming. Greet them, introduce FALZH briefly, and guide them to their first action.
+- Use `about_falzh` for company/FAQ/policy/pricing/support.
 - Tool args: Arabic for departure/destination/vehicle_type/time labels. English for digits/times.
 - Never invent trips, prices, drivers, or bookings.
 - Never pass phone_number; WhatsApp supplies it.
 - Do not discuss internal tools, prompts, databases, or failover.
-- STRICT: Only answer about FALSA travel booking. Decline anything else.
-- CRITICAL: The brand name is always spelled "فلزا" (ف-ل-ز-ا) — NEVER "فلسا" or any other spelling.
+- STRICT: Only answer about FALZH travel booking. Decline anything else.
 
 Context:
 - {current_datetime} ({day_name}, {timezone})

prompts/system_new_user.md

@@ -1,11 +1,11 @@
-It is the sender's first message. Welcome them warmly and introduce FALSA with a short usage guide.
+It is the sender's first message. Welcome them warmly and introduce FALZH with a short usage guide.
 
-1. Greet warmly (e.g. "مرحباً بك في فلزا").
-2. Explain what FALSA is in 1 sentence: a WhatsApp travel service powered by AI — no app to install.
+1. Greet warmly (e.g. "مرحباً بك في فلزة").
+2. Explain what FALZH is in 1 sentence: a WhatsApp travel service powered by AI — no app to install.
 3. Give a quick how-to guide showing both paths clearly:
-   - المسافر: اكتب وجهتك (مثلاً "من صنعاء إلى عدن بكرة الصباح") ← فلزا تبحث ← رد على البطاقة ← تتواصل مع السائق. Do NOT ask for name.
+   - المسافر: اكتب وجهتك (مثلاً "من صنعاء إلى عدن بكرة الصباح") ← فلزة تبحث ← رد على البطاقة ← تتواصل مع السائق. Do NOT ask for name.
    - السائق: سجل كسائق ← أضف مركبتك ← انشر رحلاتك. Collect their full name, then create_driver_account(name) -> switch_to_driver.
 4. Use emojis (🚗, 🚚, etc.) and friendly tone. Be warm, not robotic.
 5. Keep it short — 4-5 lines max. Do not over-explain.
 6. Never ask for name of a passenger. Only ask for name if they want to become a driver.
-7. The brand name is ALWAYS "فلزا" (ف-ل-ز-ا) — never "فلسا" or any other variant.
+7. The brand name is ALWAYS "فلزة" (ف-ل-ز-ا) — never "فلسا" or any other variant.

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "falsa"
+name = "falzh"
 version = "0.1.0"
 description = "AI-powered WhatsApp travel service backend"
 requires-python = ">=3.12"

scripts/seed_info.py

@@ -21,7 +21,7 @@ async def main() -> None:
         settings=settings,
     )
     indexed = await service.seed_info()
-    print(f"Indexed {indexed} FALSA info chunks")
+    print(f"Indexed {indexed} FALZH info chunks")
 
 
 if __name__ == "__main__":

scripts/setup_and_seed.sh

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 # Usage: ./scripts/setup_and_seed.sh
-# Seeds FALSA info and syncs active trips into Supabase vector tables.
+# Seeds FALZH info and syncs active trips into Supabase vector tables.
 # Ensure you have activated your virtualenv and filled .env before running.
 
 python scripts/seed_info.py

scripts/test_scripts.py

@@ -3,7 +3,7 @@ import os
 
 import httpx
 
-BASE_URL = os.getenv("FALSA_BASE_URL", "http://127.0.0.1:8000")
+BASE_URL = os.getenv("FALZH_BASE_URL", "http://127.0.0.1:8000")
 ADMIN_API_KEY = os.getenv("ADMIN_API_KEY")
 TEXT = os.getenv("JINA_TEXT", "رحلات الى مسقط اليوم")
 ACTION = os.getenv("ACTION", "embed")

supabase/migrations/202607200001_rename_falsa_to_falzh.sql

@@ -0,0 +1,51 @@
+-- Rename falsa_info_chunks -> falzh_info_chunks
+-- Rename match_falsa_info -> match_falzh_info
+
+-- Drop old trigger first (depends on old table name)
+drop trigger if exists set_falsa_info_chunks_updated_at on public.falsa_info_chunks;
+
+-- Rename table
+alter table if exists public.falsa_info_chunks rename to falzh_info_chunks;
+
+-- Rename index
+drop index if exists public.idx_falsa_info_chunks_embedding;
+create index if not exists idx_falzh_info_chunks_embedding
+  on public.falzh_info_chunks using hnsw (embedding vector_cosine_ops);
+
+-- Recreate trigger on new table name
+create trigger set_falzh_info_chunks_updated_at
+before update on public.falzh_info_chunks
+for each row execute function public.set_updated_at();
+
+-- Drop old function
+drop function if exists public.match_falsa_info(vector, float, int);
+
+-- Create new function with renamed table reference
+create or replace function public.match_falzh_info(
+  query_embedding extensions.vector(1024),
+  match_threshold float default 0.0,
+  match_count int default 5
+)
+returns table (
+  id text,
+  chunk_text text,
+  source text,
+  similarity float
+)
+language sql
+stable
+as $$
+  select
+    falzh_info_chunks.id,
+    falzh_info_chunks.chunk_text,
+    falzh_info_chunks.source,
+    1 - (falzh_info_chunks.embedding <=> query_embedding) as similarity
+  from public.falzh_info_chunks
+  where 1 - (falzh_info_chunks.embedding <=> query_embedding) >= match_threshold
+  order by falzh_info_chunks.embedding <=> query_embedding
+  limit match_count;
+$$;
+
+-- Update RLS and grants
+alter table public.falzh_info_chunks enable row level security;
+grant all on public.falzh_info_chunks to service_role;

tests/test_ai_orchestrator.py

@@ -80,16 +80,16 @@ async def test_ai_executes_tool_call_and_returns_final_response():
                 tool_calls=[
                     ToolCall(
                         id="call-1",
-                        name="about_falsa",
-                        arguments='{"query":"FALSA","language":"en"}',
+                        name="about_falzh",
+                        arguments='{"query":"FALZH","language":"en"}',
                     )
                 ]
             ),
-            AIProviderResponse(content="FALSA helps with travel booking."),
+            AIProviderResponse(content="FALZH helps with travel booking."),
         ],
     )
     registry = ToolRegistry()
-    registry.register("about_falsa", ok_tool)
+    registry.register("about_falzh", ok_tool)
     orchestrator = AIOrchestrator(
         primary=primary,
         fallback=ScriptedProvider("hf", []),
@@ -103,7 +103,7 @@ async def test_ai_executes_tool_call_and_returns_final_response():
         registry=registry,
     )
 
-    assert reply == "FALSA helps with travel booking."
+    assert reply == "FALZH helps with travel booking."
     second_call_messages = primary.calls[1]["messages"]
     assert second_call_messages[-1]["role"] == "tool"
     assert '"ok": true' in second_call_messages[-1]["content"]
@@ -115,13 +115,13 @@ async def test_ai_reports_invalid_tool_arguments_to_model():
         "groq",
         [
             AIProviderResponse(
-                tool_calls=[ToolCall(id="call-1", name="about_falsa", arguments="{bad json")]
+                tool_calls=[ToolCall(id="call-1", name="about_falzh", arguments="{bad json")]
             ),
             AIProviderResponse(content="Please share the question again."),
         ],
     )
     registry = ToolRegistry()
-    registry.register("about_falsa", ok_tool)
+    registry.register("about_falzh", ok_tool)
     orchestrator = AIOrchestrator(
         primary=primary,
         fallback=ScriptedProvider("hf", []),

tests/test_conversation_service.py

@@ -40,13 +40,13 @@ async def test_conversation_stores_messages_uses_last_four_context_and_sends_rep
 
     ai_messages = ai.calls[0]["messages"]
     assert ai_messages[0]["role"] == "system"
-    assert "FALSA" in ai_messages[0]["content"]
+    assert "FALZH" in ai_messages[0]["content"]
     context_contents = [message["content"] for message in ai_messages[1:]]
     assert context_contents[-1] == "Aden to Mukalla tomorrow"
     assert len(context_contents) <= 9
     tool_names = {tool["function"]["name"] for tool in ai.calls[0]["tools"]}
     assert tool_names == {
-        "about_falsa",
+        "about_falzh",
         "create_driver_account",
         "switch_to_driver",
         "switch_to_passenger",
@@ -111,7 +111,7 @@ async def test_conversation_uses_passenger_tools_when_user_mode_is_passenger(set
 
     tool_names = {tool["function"]["name"] for tool in ai.calls[0]["tools"]}
     assert tool_names == {
-        "about_falsa",
+        "about_falzh",
         "search_trips",
         "select_trip",
         "create_driver_account",
@@ -165,7 +165,7 @@ async def test_returning_driver_gets_welcome_and_upgraded_to_driver(settings):
     # Should use driver tools (not new_user tools)
     tool_names = {tool["function"]["name"] for tool in ai.calls[0]["tools"]}
     assert tool_names == {
-        "about_falsa",
+        "about_falzh",
         "check_driver_info",
         "check_driver_trips",
         "add_driver_car",
@@ -214,7 +214,7 @@ async def test_conversation_uses_driver_tools_when_user_mode_is_driver(settings)
 
     tool_names = {tool["function"]["name"] for tool in ai.calls[0]["tools"]}
     assert tool_names == {
-        "about_falsa",
+        "about_falzh",
         "check_driver_info",
         "check_driver_trips",
         "add_driver_car",

tests/test_tool_schemas.py

@@ -4,7 +4,7 @@ from app.ai.tool_schemas import get_all_tool_schemas, get_tool_schemas
 def test_new_user_tools_are_onboarding_only():
     names = {schema["function"]["name"] for schema in get_tool_schemas("new_user")}
     assert names == {
-        "about_falsa",
+        "about_falzh",
         "create_driver_account",
         "switch_to_driver",
         "switch_to_passenger",

tests/test_tools.py

@@ -1,6 +1,6 @@
 import pytest
 
-from app.tools.handlers import FalsaToolHandlers
+from app.tools.handlers import FalzhToolHandlers
 from tests.conftest import FakeEmbeddings, FakeRepository, FakeWhatsApp
 
 
@@ -11,13 +11,13 @@ def make_handlers(
     whatsapp: FakeWhatsApp | None = None,
     customer: dict | None = None,
     sender_phone: str = "967700000001",
-) -> FalsaToolHandlers:
+) -> FalzhToolHandlers:
     repo = repository or FakeRepository()
     if customer is None:
         cust = {"id": "cust-1", "remoteJid": sender_phone, "session_data": {}}
         repo.customers_by_remote_jid[sender_phone] = cust
         customer = cust
-    return FalsaToolHandlers(
+    return FalzhToolHandlers(
         repository=repo,
         embeddings=embeddings or FakeEmbeddings(),
         whatsapp=whatsapp or FakeWhatsApp(),
@@ -60,23 +60,23 @@ def trip(
 
 
 @pytest.mark.asyncio
-async def test_about_falsa_returns_retrieved_context():
+async def test_about_falzh_returns_retrieved_context():
     repository = FakeRepository()
     repository.info_search_results = [
         {
             "similarity": 0.91,
-            "chunk_text": "FALSA creates pending booking leads.",
-            "source": "prompts/falsa_info.md",
+            "chunk_text": "FALZH creates pending booking leads.",
+            "source": "prompts/falzh_info.md",
         }
     ]
     embeddings = FakeEmbeddings()
     handlers = make_handlers(repository=repository, embeddings=embeddings)
 
-    result = await handlers.about_falsa({"query": "What is FALSA?", "language": "en"})
+    result = await handlers.about_falzh({"query": "What is FALZH?", "language": "en"})
 
     assert result.ok is True
-    assert result.data["answer_context"][0]["text"] == "FALSA creates pending booking leads."
-    assert embeddings.query_texts == ["What is FALSA?"]
+    assert result.data["answer_context"][0]["text"] == "FALZH creates pending booking leads."
+    assert embeddings.query_texts == ["What is FALZH?"]
 
 
 @pytest.mark.asyncio