איך להשתמש בלוח
מדריך קצר לעוזר AI חדש (וגם לאנשים) שמצטרף לעבודה עם יוחאי.
מה זה
- האתר: https://idea-drawer-roadmap.pages.dev/ – לוחות משימות (קנבן), "החלטות ושאלות" ליוחאי, ומדריך זה.
- הגיליון: גיליון Google אחד. הוא מקור האמת. האתר קורא וכותב אליו דרך API קטן (Google Apps Script).
- הגיליון לא פתוח לציבור. רק בעלים ועורכים שיוחאי אישר.
כניסה והרשאות
- לכניסה לאתר יש קוד גישה אחד. מי שיש לו את הקוד יכול לצפות ולערוך.
- את הקוד מבקשים מיוחאי. לא מפרסמים אותו, לא מעבירים הלאה, ולא כותבים אותו בגיליון או בצ'אט קבוצתי.
- הקוד נשמר רק במכשיר שנכנסו ממנו. "יציאה" מוחקת אותו.
- גישת עורך לגיליון עצמו: רק דרך יוחאי.
הלוחות
- לכל פרויקט יש לוח ולשונית משלו בגיליון. הרשימה נמצאת בלשונית boards, בעמודות:
board_id, title, sheet_tab, order, has_models. - לוח נבחר בכתובת:
?board=idea-drawer,?board=pirate-rss,?board=general. - לוח חדש: מהאתר (כפתור "לוח חדש"), או דרך ה-API (
addBoard). בגיליון: מעתיקים את הלשונית_templateומוסיפים שורה ב-boards.
עמודות הלוח (שורה אחת = משימה אחת)
| עמודה | מה כותבים |
|---|---|
| id | מספר. נוצר אוטומטית, לא משנים |
| title | שם המשימה, קצר וברור |
| status | תכנון / בעבודה / בוצע / בבדיקה / ארכיון. ערכים ישנים עדיין עובדים: לעשות מוצג בתכנון, עתידי מוצג בתכנון עם סימון "עתידי" |
| owner | Tab / Instinct / הבילדר של Instinct / יוחאי / פתוח |
| priority | 1 (הכי דחוף) עד 5, או ריק |
| code | קוד הפאץ' או המשימה, למשל P3 או RSS22 |
| tag | למשל נמסר / שולב / בדיקה (כרטיס בדיקה) |
| note | הערה קצרה (למשל "מחכה לדוגמה") |
| updated | תאריך ושעה, למשל 13.10 08:15. ה-API ממלא לבד |
| order | המיקום בתוך העמודה (1 = למעלה = הכי חשוב). הגרירה באתר מעדכנת |
איך עובדים עם משימות
- הזרימה: תכנון ← בעבודה ← בוצע ← בבדיקה ← ארכיון. "בבדיקה" = בוצע ומחכה שיוחאי יבדוק. אחרי הבדיקה מעבירים לארכיון.
- ארכיון הוא סל המיחזור: מוסתר מהלוח ולא נספר. שום שורה לא נמחקת מהגיליון; רק הסטטוס משתנה. "הצג ארכיון" מראה אותו, ו"שחזור" מחזיר כרטיס.
- המספר ליד כל שם = המשימות הפתוחות של אותו אחראי בלוח (כל מה שלא בארכיון).
- שמירה: כל שינוי מופיע מיד ונשמר ברקע. בפינה מופיע "שומר…" ואז "נשמר". אם אין רשת, השינוי נשמר במכשיר ונשלח כשהחיבור חוזר.
- הזזה: באתר גוררים כרטיס לעמודה אחרת, או למעלה ולמטה בתוך העמודה. בטלפון גוררים מהידית (שש הנקודות) שבפינת הכרטיס.
- עריכה: נגיעה בכרטיס פותחת חלון: כותרת, סטטוס, אחראי, קוד, עדיפות, תגית, הערה. שם אפשר גם להעביר לארכיון (אין מחיקה).
- ארכיון לבדיקה שלמה: "העבר לארכיון את כל הבדיקות של…" בוחר גרסה (למשל 3.0.13) ומעביר את כל כרטיסי הבדיקה שלה לארכיון, אחרי אישור.
- הוספה: כפתור "הוספת משימה".
- עורכי הגיליון יכולים לשנות גם ישירות בגיליון, ואז לרענן את האתר.
החלטות ושאלות
- לשונית בגיליון: החלטות ושאלות. עמודות: id, board_id, question, context, options, asked_by, status (
פתוח/הוחלט), answer, answered, created. - עוזר שצריך החלטה מיוחאי מוסיף שאלה. אפשר דרך הכפתור "שאלה חדשה" באתר, או דרך
addDecisionב-API. כדאי להוסיף שורת הקשר אחת, ואם יש, גם אפשרויות מופרדות ב-|. - יוחאי עונה באתר. התשובה נשמרת עם שעה, והשאלה עוברת ל"הוחלט".
- כדי לקרוא תשובה:
readשל הלוח מחזיר אתdecisionsעם answer ו-answered. מקבלים גם מייל התראה (ראו למטה).
ה-API
כתובת: https://script.google.com/macros/s/AKfycbzXPQxGypjkVLZ2kS-7lpjpmDpzp9recoNtagkjxLTRrVfy-Z2HccfPnsWXwD1BhaTH4g/exec
שולחים POST עם גוף JSON. כל בקשה כוללת pass, שהוא קוד הגישה. מומלץ להוסיף "by" עם השם שלכם.
| action | שדות |
|---|---|
| auth | – |
| boards | – |
| read | board |
| update | board, changes: [{id, status/order/title/owner/note/code/priority/tag}]. כמה שינויים בבקשה אחת. ארכיון = status: "ארכיון" |
| add | board, item: {title, status, owner, note, code, priority, order} |
| delete | board, id. נשאר בשביל תאימות; האתר לא מוחק, רק מעביר לארכיון |
| addBoard | board_id (אותיות לטיניות קטנות ומקף), title |
| addDecision | board, decision: {question, context, options, asked_by} |
| decide | id, fields: {answer} |
| testResult | board, id, result (תקין / לא תקין / אחר), note (חובה ב-אחר). רק בכרטיס בדיקה. כותב שורת "תוצאה:" בראש ההערה ומעביר ל"בוצע" |
כל פעולת כתיבה מחזירה את מצב הלוח המעודכן מהגיליון. מגרסה 4 של הסקריפט: "lite": true מחזיר רק {ok, done} (מהיר יותר); op_id (מחרוזת ייחודית) מונע כפילות כשאותה בקשה נשלחת שוב; batch עם ops: [{action:"update",...},{action:"testResult",...}] מריץ כמה פעולות בבקשה אחת ומחזיר results. read מחזיר api_version.
דוגמה, העברת משימה 12 ל"בעבודה":
curl -sL -X POST "https://script.google.com/macros/s/AKfycbzXPQxGypjkVLZ2kS-7lpjpmDpzp9recoNtagkjxLTRrVfy-Z2HccfPnsWXwD1BhaTH4g/exec" \
-H "Content-Type: text/plain;charset=utf-8" \
-d '{"pass":"<קוד גישה>","action":"update","board":"pirate-rss","by":"Tab","changes":[{"id":"12","status":"בעבודה"}]}'
דוגמה, שאלה חדשה ליוחאי:
curl -sL -X POST "https://script.google.com/macros/s/AKfycbzXPQxGypjkVLZ2kS-7lpjpmDpzp9recoNtagkjxLTRrVfy-Z2HccfPnsWXwD1BhaTH4g/exec" \
-H "Content-Type: text/plain;charset=utf-8" \
-d '{"pass":"<קוד גישה>","action":"addDecision","board":"idea-drawer","decision":{"question":"לאשר את הנוסח?","context":"P3","options":"כן | לא","asked_by":"Tab"}}'
התראות
- ההתראות מצטברות ונשלחות במייל לכל היותר פעם ב-5 דקות.
- ליוחאי (Tab מעביר לו הודעה קצרה בוואטסאפ): משימה חדשה עם אחראי יוחאי, משימה שהועברה ליוחאי, ושאלה או החלטה חדשה.
- לעוזרים (Tab ו-Instinct): יוחאי ענה על שאלה, נשמרה תוצאת בדיקה בכרטיס בדיקה, נוספה משימה או הועברה ל-Tab / Instinct / הבילדר של Instinct, או שמישהו אחר שינה סטטוס של משימה. שינוי סטטוס שבעל המשימה עשה בעצמו (
byזהה ל-owner) לא שולח התראה. גם העברה לבבדיקהאו לארכיון, ושחזור מהארכיון, לא שולחים התראה; יותר מ-3 שינויי סטטוס בבקשה אחת יוצאים כשורה אחת מסכמת. - כתובות המייל שמורות בהגדרות הסקריפט בלבד, לא באתר.
אבטחה
- הקוד נשלח רק בגוף הבקשה (POST), אף פעם לא בכתובת. לא כותבים אותו בלוגים.
- אחרי 10 ניסיונות קוד שגויים בתוך 10 דקות, ה-API נועל את כל הכניסות ל-10 דקות ("נסה שוב מאוחר יותר").
- כל ערך נשמר בגיליון כטקסט. ערך שמתחיל ב-= + - @ נשמר עם גרש בהתחלה, כך שאף פעם לא מופעל כנוסחה. תווי בקרה נמחקים.
- אורך מקסימלי: כותרת 200 תווים, הערה 1000, תשובה 2000.
- האתר מציג את כל הטקסט מהגיליון כטקסט רגיל, לא כ-HTML.
כללי התנהגות
- משנים סטטוס רק למשימות שלכם. במשימה של מישהו אחר: שאלה או הערה.
- משימה אחת בכל שורה. לא מאחדים ולא מפצלים משימות של אחרים.
- לא משנים את שורת הכותרות ולא את שמות הלשוניות.
- מעדכנים את updated (ה-API עושה את זה לבד).
- לא כותבים סיסמאות, מפתחות, קוד או פרטים אישיים בלוח.
- כשמסיימים משימה:
בוצע, ובהערה מה נמסר ואיפה. כשזה מוכן לבדיקה של יוחאי:בבדיקה. מה שנבדק ונסגר:ארכיון. - בדיקה של גרסה = כרטיס אחד בלוח, עם תגית
בדיקה(או כותרת כמוPirate RSS 3.0.12 test #4). בהערה כותבים איך בודקים. לא פותחים עליה שאלה נפרדת. יוחאי עונה בכרטיס עצמו (תקין / לא תקין / אחר + הערה), והתוצאה מגיעה לעוזרים במייל ההתראות.
למי פונים
- הרשאות, קוד עריכה, גישה לגיליון: יוחאי.
- תקלה באתר או ב-API: Tab.