### **מסמך אפיון דרישות: מערכת אוטומציה ליצירת תוכן ומונחים באתר וורדפרס באמצעות Gemini API**
#### **1. מטרת הפרויקט**
הקמת מערכת אוטומטית שתייצר תוכן חדש באתר וורדפרס על בסיס קבוע. המערכת תהיה אחראית על שתי משימות מרכזיות:
1. **יצירת מאמרים חדשים** בתדירות ובכמות שתיקבע מראש, והעלאתם כטיוטה לאתר.
2. **סריקה וזיהוי של מונחים חדשים** בתוכן האתר, ויצירת הגדרות עבורם באמצעות התוסף **CM Tooltip Glossary**.
כל תהליך יצירת התוכן (מאמרים והגדרות) יתבצע באמצעות קריאות ל-**Gemini API**.
#### **2. ארכיטקטורת המערכת**
המערכת תורכב מתוסף וורדפרס ייעודי (או סקריפט חיצוני המופעל על ידי Cron Job) שיבצע את הלוגיקה הבאה:
1. **טריגר זמן (מתוזמן):** מפעיל את תהליך יצירת המאמרים.
2. **קריאה ל-Gemini API:** שליחת פרומפט מוגדר מראש ליצירת מאמר.
3. **יצירת פוסט (טיוטה):** קבלת התוכן מ-Gemini ויצירת פוסט חדש במצב "טיוטה" בוורדפרס.
4. **טריגר סריקה (מתוזמן):** מפעיל את תהליך סריקת האתר למונחים חדשים.
5. **סריקת תוכן האתר:** המערכת תסרוק את כל הפוסטים והעמודים באתר.
6. **השוואה מול מילון המונחים:** המערכת תשווה את המילים שנמצאו מול המונחים שכבר קיימים ב-CM Tooltip Glossary.
7. **קריאה ל-Gemini API:** עבור כל מונח חדש שזוהה, תישלח בקשה ל-Gemini ליצירת הגדרה.
8. **הוספת מונח חדש:** המערכת תוסיף את המונח וההגדרה שלו ישירות ל-CM Tooltip Glossary.
---
### **תהליך #1: יצירת מאמרים באוטומציה**
**א. מטרת התהליך:**
לייצר באופן אוטומטי **כמות מוגדרת מראש של מאמרים חדשים בתדירות קבועה** (לדוגמה: מאמר אחד ביום, 5 מאמרים בשבוע וכו'), מבוסס על נושאים מוגדרים מראש, ולהגיש אותם כטיוטה לעריכה ואישור במערכת הניהול של וורדפרס.
**ב. תזרים עבודה (Workflow):**
1. המערכת מופעלת בתדירות קבועה שתוזמנה מראש (למשל, כל יום בשעה 02:00 בלילה) ומייצרת את כמות המאמרים שהוגדרה.
2. עבור כל מאמר שנדרש לייצר, המערכת בוחרת נושא למאמר מתוך **מאגר נושאים** שיוגדר מראש.
3. המערכת בונה **פרומפט (הנחיה)** מפורט עבור Gemini API. הפרומפט יכלול:
* הנושא שנבחר.
* הוראות לגבי קהל היעד, טון הכתיבה, אורך המאמר, ומבנה רצוי (למשל, "כלול 3 כותרות משנה וסיכום").
4. הפרומפט נשלח ל-Gemini API.
5. המערכת מקבלת את התוכן שנוצר (כותרת ומאמר מלא) מ-Gemini.
6. המערכת יוצרת פוסט חדש בוורדפרס:
* **כותרת:** הכותרת שהתקבלה מ-Gemini.
* **תוכן:** גוף המאמר שהתקבל מ-Gemini.
* **סטטוס:** **טיוטה (Draft)** - שלב קריטי לבקרת איכות.
* **קטגוריה/תגיות:** ניתן להגדיר קטגוריית ברירת מחדל כמו "מאמרים אוטומטיים".
7. המערכת מסמנת את הנושא כ"נוצל" במאגר הנושאים כדי למנוע כפילות.
**ג. דרישות טכניות:**
* אינטגרציה מאובטחת עם Gemini API (שמירת מפתח API בצורה מוצפנת).
* יכולת ליצור, לקרוא ולעדכן פוסטים בוורדפרס באמצעות קוד.
* מערכת לניהול תזמון משימות (WordPress Cron).
* טיפול בשגיאות (למשל, מה קורה אם הקריאה ל-API נכשלת).
**ד. ממשק ניהול נדרש (בתוך וורדפרס):**
* **הגדרות תזמון:** שדות לבחירת תדירות ההרצה (יומי, שבועי) והגדרת **כמות המאמרים ליצירה** בכל הרצה.
* **מאגר נושאים:** אזור טקסט פשוט שבו ניתן להזין רשימת נושאים למאמרים, כל נושא בשורה נפרדת.
* **תבנית פרומפט:** אזור טקסט שבו ניתן לערוך את תבנית הפרומפט שנשלחת ל-Gemini, עם אפשרות להשתמש במשתנה כמו `[TOPIC]` שיוחלף בנושא היומי.
* **לוג (יומן פעילות):** טבלה פשוטה שתציג את היסטוריית הפעולות: תאריך, נושא המאמר, והאם הפעולה הצליחה או נכשלה.
---
### **תהליך #2: סריקה ויצירת מונחים חדשים ב-CM Tooltip Glossary**
**א. מטרת התהליך:**
לסרוק את כלל התוכן הקיים באתר, לזהות מונחים פוטנציאליים שאינם קיימים במילון המונחים, וליצור עבורם הגדרות באופן אוטומטי.
**ב. תזרים עבודה (Workflow):**
1. המערכת מופעלת בתדירות קבועה (למשל, פעם ביום או פעם בשבוע).
2. **איסוף תוכן:** המערכת סורקת את כל התוכן מטקסט של הפוסטים והעמודים באתר.
3. **איסוף מונחים קיימים:** המערכת שולפת את כל רשימת המונחים שכבר קיימת בתוסף CM Tooltip Glossary.
4. **זיהוי מונחים חדשים:** המערכת מעבדת את התוכן שנאסף ומזהה צירופי מילים או מונחים מקצועיים פוטנציאליים שאינם מופיעים ברשימת המונחים הקיימים.
5. עבור כל מונח חדש שזוהה:
* נשלחת בקשה ל-Gemini API עם פרומפט ייעודי: "כתוב הגדרה קצרה (עד 40 מילים) למונח: `[TERM]`".
* המערכת מקבלת את ההגדרה מ-Gemini.
6. **הוספה ל-Glossary:** המערכת משתמשת בפונקציות של וורדפרס כדי להוסיף את המונח החדש (כשם המונח) וההגדרה שלו (כתוכן המונח) ישירות לתוך CM Tooltip Glossary.
7. המונח החדש יופיע באתר באופן אוטומטי, בהתאם להגדרות התוסף.
**ג. דרישות טכניות:**
* יכולת לקרוא את התוכן מכל הפוסטים/עמודים באתר.
* יכולת להתממשק עם בסיס הנתונים או הפונקציות של התוסף **CM Tooltip Glossary** כדי לקרוא מונחים קיימים וליצור חדשים.
* לוגיקה לעיבוד שפה טבעית (NLP) בסיסית לזיהוי מונחים פוטנציאליים.
* טיפול בשגיאות ומניעת יצירת מונחים כפולים או לא רלוונטיים.
**ד. ממשק ניהול נדרש (בתוך וורדפרס):**
* **כפתור הפעלה ידני:** "סרוק אתר וחפש מונחים חדשים עכשיו".
* **רשימת מונחים ממתינים לאישור (אופציונלי אך מומלץ):** במקום להוסיף מונחים אוטומטית, המערכת תציג רשימה של מונחים שהיא זיהתה עם ההגדרות שנוצרו, והמנהל יוכל לאשר או למחוק כל מונח בלחיצת כפתור.
* **לוג (יומן פעילות):** פירוט של המונחים שנוספו ותאריך הוספתם.