התקנה עצמית
המדריך הקצר. התיעוד המלא, כולל איך הלשכה בנויה, איך כותבים אפליקציה ומה עוד לא עובד, נמצא במאגר בגיטהאב.
התחלה מהירה
על לינוקס, מק או ווינדוס: מורידים את הקוד, ממלאים קובץ הגדרות אחד, ומריצים פקודה אחת. דומיין צריך רק לשרת ציבורי. על מחשב מקומי הכל עובד בכתובות מקומיות.
git clone https://github.com/bina-solution/digital-office
cd digital-office
cp .env.ex .env # business name, domain
./bbox run # on Windows: bbox.cmd run
אחרי שהלשכה עולה, אשף ההגדרה במסך הראשי משלים את מה שחסר: חיבור לגוגל, סריקת קוד לוואטסאפ ומפתחות של שירותים חיצוניים. אל תריצו את הרכיבים ישירות, בלי הפקודה של הלשכה: היא זו שבונה אותם מקובצי ההצהרה ובודקת שכל אחד עלה.
על מחשב, על שרת או בענן
הלשכה זהה בכל מקום. מה שמשתנה הוא הכתובת שממנה נגזרות כתובות כל האפליקציות, וזו שורה אחת בקובץ ההגדרות.
מחשב מקומי
מחשב במשרד או בבית. אין צורך בדומיין: כל אפליקציה זמינה בכתובת מקומית משלה.
שרת משלכם
שרת עם כתובת ציבורית ודומיין משלכם. תעודות האבטחה מונפקות לבד.
ענן מנוהל (בקרוב)
רק שם העסק. אנחנו מקצים כתובת, שרת, גיבויים ועדכונים, ואפשר לחבר דומיין משלכם אחר כך.
מעבר ביניהם הוא שינוי של שורת הכתובת והעברת המידע. אותו קובץ הגדרות עולה במחשב ובשרת, ומהענן שלנו אפשר לעבור לשרת שלכם בלי קנסות.
דרישות
- מערכת הפעלה: לינוקס, מק או ווינדוס.
- זיכרון: 4 ג׳יגה לליבה, 8 ג׳יגה ומעלה עם כל האפליקציות.
- דיסק: 40 ג׳יגה לפחות, 100 ג׳יגה מומלץ.
- לשרת ציבורי: כתובת ציבורית, פתחים 80 ו־443, ודומיין עם רשומה לכל תתי־הדומיין. למייל נכנס גם פתח 25.
קובץ ההגדרות
כל ההגדרות בקובץ אחד, שנוצר מקובץ הדוגמה ולא נשמר במאגר. שם העסק והדומיין קובעים את כל הכתובות, ואשף ההתקנה מייצר את הסיסמאות של המערכת לבד, כך שממלאים רק את מה שאדם צריך להחליט.
COMPANY_SLUG / COMPANY_BASE_DOMAIN business name and domain
TZ Asia/Jerusalem
איך הלשכה בנויה
הלשכה נבנית מקבצים, ולא מורכבת ביד. כל אפליקציה מתוארת בקובץ הצהרה אחד, והלשכה קוראת את כולם, בוחרת לכל צורך ספק אחד, ובונה מהם את כל המערכת. שלוש שכבות, וכל תיקייה היא שכבה:
platform/ layer 0: the compiler
platform-base/ layers 1-2: what every office gets
apps/ layer 3: one folder per app
אפליקציה כקובץ הצהרה, במלואו ←
ניהול אפליקציות
מתקינים, מכבים ומסירים מהמסך הראשי, או מהשורה:
./bbox help # every command
./bbox apps # install, enable, disable
אפליקציה חדשה היא תיקייה עם קובץ הצהרה. המדריך המלא נמצא במאגר.
תפעול
./bbox baseline # every service up as declared
./bbox n8n pull # automations to and from the repo
גיבוי: עדיין אין גיבוי מתוך הלשכה. עד שיהיה, גבו את מסדי הנתונים ואת הקבצים לפני כל פעולה שמוחקת משהו. בענן המנוהל זה כלול.
תרומה לפרויקט
- קראו את כללי העבודה במאגר. הם לבני אדם ולסוכני בינה מלאכותית כאחד.
- לפני עבודה גדולה, פתחו דיון. התקלות מנוהלות במאגר עם חומרה ומצב.
- כל שינוי עובר את הבדיקות ואת התקנת הלשכה ממחשב נקי. ירוק, או שהוא לא נכנס.
- תרומה משוחררת תחת הרישיון של הפרויקט. רישיון ←