<div dir="rtl" align="right">

# סכימת הנתונים — Airtable

הסכימה היא מקור האמת של הפרויקט. כל שם שדה חייב להיות **זהה בדיוק**, כולל
אותיות גדולות וקטנות — הצמתים ב-n8n פונים לשדות בשמם.

```
בסיס:   FINAL      appAPS688i7OgQKJT
```

מודל הנתונים המלא של פרויקט כזה הוא 14 טבלאות (לקוחות, לידים, ספקים, מוצרים,
הזמנות, חשבוניות, חשבוניות-מס, קבלות, הצעות מחיר, הוצאות, עובדים, פרויקטים,
משימות, קבצים). עשרת התהליכים דורשים **ארבע בלבד** — ואיתן מתחילים.

---

## Invoices — `tblXwl4ia8wcSDMLL`

| שדה | סוג | מי כותב | הערות |
|---|---|---|---|
| `InvoiceNumber` | Single line text | WF1 | מספר רץ `INV-2026-0001`. שדה ראשי |
| `CustomerId` | Single line text | האפליקציה | מפתח זר כטקסט, למשל `CUST-0001` |
| `Amount` | Number | האפליקציה | סכום **לפני** מע"מ |
| `VatAmount` | Number | WF1 | מחושב: `Amount × שיעור המע"מ` |
| `Total` | Number | WF1 | `Amount + VatAmount` |
| `Status` | Single line text | WF1 / WF8 | ראו מילון הסטטוסים למטה |
| `PdfUrl` | URL | WF8 | קישור למסמך בגוגל דרייב |
| `Created` | **Created time** | Airtable | ⚠️ חייב להיות מסוג Created time — WF1 מסתמך עליו כטריגר |

בעל העסק ממלא `CustomerId` ו-`Amount` בלבד. כל השאר מתמלא אוטומטית.

### מחזור החיים של חשבונית

```
רשומה נוצרת  →  WF1 (תוך דקה)  →  WF8 (תוך דקה)  →  ידני
   ריקה           מחשב מע"מ         מפיק מסמך        סימון תשלום
                  ומספר מסמך        ומעלה לדרייב
     ↓                 ↓                  ↓              ↓
  (ללא סטטוס)       Ready             Issued           Paid
                      │
                      └─ אם חסר סכום או לקוח → Invalid + משימה ב-Tasks
```

---

## Leads — `tblgCWOnLU1ZCJu9U`

| שדה | סוג | מי כותב | הערות |
|---|---|---|---|
| `Name` | Single line text | WF3 | שם הליד. שדה ראשי |
| `Email` | Email | WF3 | מפתח הזיהוי לסינון כפילויות |
| `Company` | Single line text | WF3 | משמש את WF4a להתאמת המייל הקר |
| `Status` | Single line text | WF3 / WF4a / WF4b | ראו מילון הסטטוסים |
| `Created` | **Created time** | Airtable | ⚠️ חייב להיות מסוג Created time |

### מחזור החיים של ליד

```
WF3            WF4a               WF4b
נוצר    →    נשלח מייל    →    הליד השיב    →    טיפול אנושי
  ↓             ↓                  ↓
 New        Contacted           Replied

         ↘ שליחה נכשלה
           Email Failed  (יוצא מהתור, לא יקבל מייל נוסף)
```

---

## Products — `tbl4mva0zPHfY5qtt`

| שדה | סוג | הערות |
|---|---|---|
| `Name` | Single line text | שם המוצר. שדה ראשי |
| `Category` | Single line text | אוזניות, מסכים, מקלדות, רמקולים וכו' |
| `Price` | Number | בשקלים, כולל מע"מ |
| `Description` | Long text | מק"ט + מפרט טכני מלא + תנאי אחריות |
| `InStock` | Checkbox | זמינות במלאי |

הטבלה משמשת את האפליקציה לתצוגה. **סוכן שירות הלקוחות אינו קורא ממנה ישירות** —
הוא שולף מהמאגר הווקטורי שנבנה ב-WF7 מתוך `data/products/products.csv`.
עדכון מוצר בטבלה מחייב עדכון מקביל ב-CSV והרצה חוזרת של WF7.

---

## Tasks — `tblJzJnQf8MFXsEPS`

| שדה | סוג | מי כותב |
|---|---|---|
| `Title` | Single line text | WF1 / האפליקציה |
| `Status` | Single line text | `Open` / `Done` |

WF1 פותח כאן משימה אוטומטית בכל פעם שחשבונית נפסלת באימות.

---

## מילון הסטטוסים

מכיוון שכל שדות ה-`Status` הם טקסט חופשי ולא Single select, אין שום דבר שמונע
הקלדת ערך שגוי. אלה הערכים שהתהליכים מכירים:

### Invoices
| ערך | משמעות | מי קובע |
|---|---|---|
| `Ready` | עברה אימות, ממתינה להפקת מסמך | WF1 |
| `Issued` | המסמך הופק והועלה לדרייב | WF8 |
| `Invalid` | נכשלה באימות — חסר סכום או לקוח | WF1 |
| `Paid` | שולמה | ידני / האפליקציה |

WF9 מחשב "סכום שטרם שולם" כ-`NOT({Status}='Paid')`. כלומר `Ready`, `Issued`
ו-`Invalid` כולם נחשבים לא-משולמים.

### Leads
| ערך | משמעות | מי קובע |
|---|---|---|
| `New` | נקלט, טרם נשלח מייל | WF3 |
| `Contacted` | נשלח מייל קר | WF4a |
| `Replied` | הליד השיב — לטיפול אנושי | WF4b |
| `Email Failed` | שליחת המייל נכשלה | WF4a |

WF4a בוחר רק לידים ב-`New`. שינוי סטטוס בחזרה ל-`New` יגרום לשליחת מייל נוסף.

### Tasks
`Open` · `Done`

---

## שתי החלטות סכימה קריטיות

1. **`Created` מוגדר כ-Created time.** אילו היה שדה Date רגיל, הטריגר של
   Airtable ב-WF1 לא היה נורה כלל — בלי הודעת שגיאה.
2. **`Status` מוגדר כטקסט רגיל ולא Single select**, כדי שהתהליכים יוכלו
   לכתוב ערכים בלי להגדיר אותם מראש ברשימה.

---

## קשרים בין טבלאות

הקשרים הם **מפתחות זרים כטקסט** ולא קישורי Airtable (Linked records). למשל
`Invoices.CustomerId` מכיל מחרוזת כמו `CUST-0001`.

למה: פשוט יותר לכתוב מ-n8n (אין צורך לחפש record id לפני כל כתיבה), וקל יותר
להציג באפליקציה. המחיר: אין אכיפת שלמות — אפשר לכתוב מזהה לקוח שלא קיים.

</div>
