סביבות עבודה וארגונים

סביבות עבודה הן המקום שבו העבודה נמצאת במופע עם ארגונים: כיתה בבית ספר, צוות בחברה. פקודות ה-CLI של Nodaro שבדף הזה בוחרות את סביבת העבודה שבה הפקודות שלכם פועלות, מנהלות ארגונים ואת החברים בהם, ומייצאות דוחות שימוש. ארגונים הם יכולת של Nodaro Cloud, ומפעילים אותם בנפרד בכל מופע; במופע שבו הם לא מופעלים, הפקודות האלה לא זמינות.

בחירת סביבת העבודה שבה פקודה פועלת

בדפדפן, סביבת העבודה הנוכחית מוצגת בכל מסך. בטרמינל לא מוצג כלום, ולכן ב-CLI הבחירה נעשית במפורש. יש שלוש דרכים לקבוע אותה, וכל אחת מהן גוברת על זו שמתחתיה:

nodaro --workspace <id> workflows list   # 1. this command only
export NODARO_WORKSPACE=<id>             # 2. this shell, or this CI job
nodaro workspace use <id>                # 3. saved on the profile until you change it

• הפקודה nodaro workspace current מציגה באיזו סביבת עבודה אתם נמצאים, ואיזו משלוש הדרכים קבעה אותה. אחרת, משתנה NODARO_WORKSPACE שעבר בירושה היה נראה בדיוק כמו סביבת עבודה שמורה.
• הפקודה nodaro workspace use בודקת את סביבת העבודה לפני שהיא שומרת אותה, כך שפקודה עם שגיאת הקלדה נכשלת פעם אחת, כבר בשלב הזה, ולא בכל פקודה שאחריה.
• הפקודה nodaro workspace clear מסירה מהפרופיל את סביבת העבודה השמורה.
• כשלא נקבעה סביבת עבודה, הכול קורה במרחב האישי שלכם.

סביבת העבודה קובעת מאיזו סביבת עבודה רשימה מחזירה פריטים, ולאן נכנס מה שיוצרים. היא אף פעם לא קובעת את הגישה: קריאה, עדכון, מחיקה או הרצה של משהו שמציינים לפי מזהה נקבעים לפי סביבת העבודה של הפריט עצמו. לכן אם שוכחים את --workspace, העבודה שלכם לא מוסתרת, וסביבת עבודה שגויה לא יכולה להגיע לעבודה של אף אחד אחר.

פקודות סביבות העבודה

nodaro workspace list [--json]
nodaro workspace current [--json]
nodaro workspace use <id> [--json]
nodaro workspace clear
nodaro workspace get <id> [--json]
nodaro workspace members <id> [--limit <n>] [--cursor <token>] [--json]
nodaro workspace join <code> [--json]
nodaro workspace usage [id] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--tz <iana>] [--group-by member|model|day|none] [--user <id>] [--limit <n>] [--cursor <token>] [--csv] [--json]

הפקודה workspace join מקבלת את קוד ההצטרפות בן שמונה התווים שמנהל סביבת העבודה משתף. קוד הצטרפות הופך אתכם לחברים רגילים בסביבת עבודה אחת.

פקודות הארגונים

nodaro org list [--json]
nodaro org get <id> [--json]
nodaro org create --name <name> --kind school|team [--slug <slug>] [--accept-terms] [--json]
nodaro org members <orgId> [--limit <n>] [--cursor <token>] [--json]
nodaro org invite <orgId> --email a@x.com --email b@x.com [--role admin|member] [--workspace <id>] [--workspace-role admin|member] [--json]
nodaro org invitations <orgId> [--status open|accepted|revoked|expired] [--limit <n>] [--cursor <token>] [--json]
nodaro org revoke <invitationId> [--json]
nodaro org audit <orgId> [--limit <n>] [--cursor <token>] [--json]
nodaro org usage <orgId> [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--tz <iana>] [--group-by workspace|member|model|day|none] [--workspace <id>] [--user <id>] [--limit <n>] [--cursor <token>] [--csv] [--json]

• הפקודה org create --kind school דורשת את --accept-terms: הבעלים מצהיר שיש לו סמכות לרשום תלמידים.
• ארגון חדש מתחיל בדרך כלל כממתין לאישור, והופך לפעיל אחרי שהפלטפורמה מאשרת אותו. עד אז, שום דבר בו לא יכול להשתנות.
• הפקודה org revoke מבטלת הזמנה, והקישור שלה מפסיק לעבוד.
• הפקודה org audit מציגה את יומן הביקורת של הארגון.

הזמנת אנשים

צירוף של כיתה או צוות למופע הוא פעולה חד־פעמית שבה מוסיפים אנשים רבים בבת אחת, והפקודה nodaro org invite נבנתה בשבילה. חזרו על --email פעם אחת לכל אדם, ואם תרצו, הכניסו את כולם לסביבת עבודה:

nodaro org invite org_abc --email ada@school.edu --email grace@school.edu --workspace ws_xyz --workspace-role member

הפקודה מדפיסה שורה אחת לכל כתובת, ומציינת אם נשלח אליה אימייל. התקנה בלי שירות אימייל לא יכולה לשלוח אימייל לאף אחד. בשורות שלה כתוב not emailed (link_only) (לא נשלח אימייל, קישור בלבד), וקישור ההזמנה מופיע בשורה שאחריה.

שלחו את הקישורים האלה בעצמכם. אחרת, ההזמנה קיימת, אבל אף אחד לא יכול להגיע אליה. תוקף ההזמנה פג אחרי 14 ימים.

דוחות שימוש

הפקודות nodaro org usage ו-nodaro workspace usage עונות על השאלה מי הוציא כמה קרדיטים ועל מה, בטווח תאריכים.

• הדגלים --from ו---to מקבלים תאריכי התחלה וסיום, ששניהם נכללים בטווח, בפורמט YYYY-MM-DD. הדגל --tz קובע את אזור הזמן של החלוקה לימים; ברירת המחדל היא אזור הזמן של הטרמינל שלכם.
• הדגל --group-by מקבץ את הדוח לפי workspace (בדוחות של ארגון בלבד), member, model או day. הערך none מציג את ההרצות הבודדות, מהחדש לישן.
• פלט ברירת המחדל הוא טבלה עם שורת סיכום. הדגל --json מדפיס את הדוח המלא, והדגל --csv כותב את ה-CSV לפלט הסטנדרטי, מוכן להפניה לקובץ.

nodaro org usage org_abc --from 2026-09-01 --to 2026-09-30 --group-by member --csv > september.csv

חבר רגיל בסביבת עבודה רואה רק את השימוש שלו. מנהלי סביבת עבודה רואים את כל מי שבסביבת העבודה, ודוחות של ארגון מיועדים לבעלים ולמנהלי הארגון.