דיאגרמות¶
דיאגרמות ארכיטקטורה ברמת חשבון לתכנון, תיעוד והצגות. כל דיאגרמה היא קנבס בבעלות המשתמש — לא מפת מלאי חיה.
| פריט | ערך |
|---|---|
| קונסול | דיאגרמות → /console/diagrams |
| הרשאות | diagrams.read / diagrams.create / diagrams.update / diagrams.delete |
| דלי נכסים | so://diagrams-{account_number}/diagrams/{diagram_id}/assets/… (בבעלות החשבון ובתשלום שלו; מופיע תחת הצג באקטים של שירותי החשבון) |
רשימה ויצירה¶
- פתחו דיאגרמות.
- דיאגרמה חדשה — שם (חובה) ותיאור אופציונלי.
- פתחו שורה לעריכה בקנבס.
יסודות העורך¶
- nodes מסוג Live מפנים למשאבי HomeCloud אמיתיים (מסומנים stale אם המשאב נמחק).
- nodes מסוג Planned מתארים רכיבים עתידיים בלי ליצור משאבים.
- טקסט וצורות (מלבן, אליפסה, frame) להערות וגבולות.
- מצבים: בחירה / הזזה / חיבור; snap, יישור, שכבות, undo/redo, שמירה אוטומטית.
- פלטת פקודות: Ctrl+K.
- ייבוא אופציונלי של ארכיטקטורת החשבון כ־nodes חיים (הקנבס הריק הוא ברירת המחדל).
- לחיצה כפולה על node חי — פתיחה בקונסול; על טקסט — עריכה inline.
Present וייצוא¶
- Present — תצוגה במסך מלא לקריאה בלבד של הדיאגרמה החיה.
- ייצוא PNG / SVG — כל הקנבס או הבחירה הנוכחית.
שיתוף (קישורים לצפייה בלבד)¶
כל מי שיש לו את הכתובת יכול לפתוח תמונת מצב קפואה בלי התחברות.
- בעורך (עם
diagrams.update) לחצו שיתוף. - בחרו תוקף: ללא הגבלה, 7 ימים או 30 ימים; תווית אופציונלית.
- צור קישור — העתיקו את ה־URL מיד (מוצג פעם אחת).
- הנמענים פותחים
/share/diagrams/{token}— קנבס בסגנון Present, בלי מעטפת הקונסול. - בטלו קישור פעיל מאותו דיאלוג.
משמעות תמונת המצב¶
- הדף הציבורי מציג את המסמך שנלכד בזמן היצירה (שם, תיאור, nodes, edges, groups, viewport).
- עריכת הדיאגרמה אחר כך אינה מעדכנת שיתופים קיימים. צרו קישור חדש לפרסום מחדש.
- צופים ציבוריים לא קוראים ל־API של החשבון לרענון מלאי חי ולא רואים סודות.
- תמונות nodes ב־
so://…נפתרות דרך URL נכסים המוגבל לטוקן השיתוף.
IAM¶
| פעולה | תפקידים אופייניים |
|---|---|
| רשימה / פתיחה / רשימת שיתופים | diagrams.read (owner, admin, developer, viewer) |
| יצירה / עריכה / העלאת נכסים / יצירה וביטול שיתופים | diagrams.update (owner, admin, developer) |
| יצירת דיאגרמה | diagrams.create |
| מחיקת דיאגרמה | diagrams.delete (owner, admin) |
דלי נכסי SO¶
תמונות מותאמות ל־nodes מועלות לדלי diagrams-{account_number} תחת diagrams/{diagram_id}/assets/… (URI: so://diagrams-{account_number}/diagrams/{diagram_id}/assets/{filename}). האחסון בבעלות החשבון ובתשלום שלו. ב־Object Storage הם מופיעים תחת הצג באקטים של שירותי החשבון — משתמשים שאינם root יכולים לראות ברשימה אך לא לפתוח או לשנות; root של החשבון שומר גישה מלאה. קישורי שיתוף לא מעתיקים קבצים; הם עושים presign מחדש לאותם so://. הקידומת shared/{share_id}/ שמורה למצב עתידי של עותק קפוא ואינה בשימוש כרגע.
CLI ו-SDK¶
homecloud diagrams list
homecloud diagrams get DIAGRAM_ID
homecloud diagrams create "Production plan" --description "Draft"
homecloud diagrams patch DIAGRAM_ID --name "Production architecture" --revision 1
from homecloud import HomeCloud
client = HomeCloud()
for d in client.diagrams.list():
print(d["id"], d["name"], d["revision"])
client.diagrams.create("Production plan", description="Draft")
client.diagrams.update(diagram_id, name="Production architecture", revision=1)
אימות: JWT משתמש או Access Key קשור למשתמש. פרטים: diagrams CLI, Python SDK.
הפניות במשימות¶
בכותרת, בפירוט או בדיון של משימות הקלידו #diagrams או #diagrams/<diagram-id> להשלמה אוטומטית וקישורים.