العمل اليومي

العمل داخل مساحة العمل

ما الذي تحصل عليه داخل مساحة عمل قيد التشغيل في code-server: المحرر وإضافاته، وتطبيق Archibus وقاعدة بياناته، والسجلات، واختبار البريد الإلكتروني، وgit، وأين تقع ملفاتك.

أعضاء العملاءمسؤولو العملاءمشغّلو المنصة

آخر تحديث 19 يونيو 2026

هذا الدليل موجّه لكل من يفتح مساحة العمل ويؤدي العمل فيها — عضوًا كان أم مسؤولًا أم مشغّلًا. يمكن لأي شخص لديه حق الوصول إلى مساحة عمل أن يفتحها في code-server (نسخة VS Code داخل المتصفح) وأن يستخدم كل ما هو موضّح أدناه. أما إنشاء مساحات العمل وبدء تشغيلها فمشروح في Create the first workspace وManage workspaces؛ ويبدأ هذا الدليل من اللحظة التي يُفتح فيها المحرر.

فتح المحرر

من My Workspaces في Console، ابحث عن مساحة العمل قيد التشغيل وانقر على Browser. يُفتح المحرر في تبويب جديد، وهو موجّه مسبقًا إلى مجلد التطبيق (/home/codespace/applications). وإذا كنت تفضّل أدواتك المحلية، فإن قائمة الإجراءات الإضافية في الصف توفّر أيضًا VS Code Desktop وJetBrains Gateway — وهما يتصلان بمساحة العمل نفسها عبر نفق.

قد يستغرق أول فتح بعد البدء بضع ثوانٍ ريثما تكمل الإضافات تثبيتها في الخلفية.

ما هو مثبّت مسبقًا

يأتي المحرر مهيّأً للعمل على Archibus، لذا نادرًا ما تحتاج إلى تثبيت أي شيء بنفسك:

• Archibot — المساعد داخل مساحة العمل، في لوحته الخاصة بالشريط الجانبي. راجع Use the workspace bot.
• مجموعة أدوات Java كاملة — دعم اللغة، والمصحّح، وMaven، وGradle — لكود خادم Archibus.
• SQLTools مع مشغّلات SQL Server وOracle، بالإضافة إلى عميل قاعدة بيانات — اتصل بقاعدة بيانات مساحة العمل ونفّذ الاستعلامات من المحرر.
• GitLens للتاريخ وتتبّع التغييرات، وDocker، وYAML، وEditorConfig، وPrettier، وmarkdownlint.
• Rainbow CSV وExcel viewer لملفات البيانات.

يمكنك إضافة إضافاتك الخاصة؛ فهي تُحفظ في مجلد منزل مساحة العمل وتبقى بعد عملية إيقاف/بدء.

تطبيق Archibus

تشغّل معظم مساحات عمل Archibus خادم Tomcat مع نشر ملف Archibus WAR مسبقًا ضمن tomcat/webapps/archibus/. يستمع Tomcat على المنفذ 8080.

• افتح التطبيق قيد التشغيل من رابط Tomcat في صفحة مساحة عمل Coder.
• بعد تغيير الكود أو الإعدادات، أعد تشغيل Tomcat. استخدم إجراء Restart Tomcat على مساحة العمل، أو نفّذ ~/tomcat-service.sh restart في الطرفية. يخبرك ~/tomcat-service.sh status بما إذا كان يعمل.
• يذهب إخراج الخادم إلى ~/logs/catalina.out.

قاعدة البيانات

بحسب طريقة بناء مساحة العمل، فإنها تشغّل إما SQL Server (المنفذ 1433) أو Oracle (المنفذ 1521). الاتصال مهيّأ مسبقًا ضمن إعدادات Archibus — فأنت لا تُعدّ بيانات الاعتماد يدويًا. إضافتا SQLTools وعميل قاعدة البيانات مثبّتتان مسبقًا، ويمكن للبوت تنفيذ استعلامات للقراءة فقط نيابةً عنك (فهو لن يغيّر البيانات). توجد إعدادات المشروع والاتصال في WEB-INF/config/afm-projects.xml ضمن مجلد التطبيق.

أو اطلب من البوت أن يبحث عن شيء ما — فهو ينفّذ الاستعلام بأداته المخصّصة للقراءة فقط ويعرض الصفوف مباشرةً في الطرفية.

أين تقع الأشياء

بعض المسارات الجديرة بالمعرفة:

• /home/codespace/applications — جذر تطبيق Archibus الذي يفتح فيه المحرر.
• ~/logs — startup.log (ما الذي شُغِّل عند بدء مساحة العمل)، وcatalina.out (الخاص بـ Tomcat)، وmail-debug.log (البريد الاختباري).
• ~/flyway — إعدادات ترحيل قاعدة البيانات، عند استخدام Flyway.

مجلد المنزل لديك هو تخزين دائم. فهو يبقى بعد عملية stop وstart، لكن عملية delete تزيل مساحة العمل وقرصها. لأي شيء تريد الاحتفاظ به عبر مساحات العمل — ملاحظات، أو أدلة، أو مسودّات — أودِعه في git أو احفظه في Shared Drive.

يذهب البريد الإلكتروني إلى صندوق وارد اختباري

حتى لا يصل بريد مساحة العمل إلى مستلم حقيقي أبدًا، يُلتقط البريد الصادر بواسطة خادم تصحيح أخطاء محلي على 127.0.0.1:1025. اقرأ ما “أرسله” التطبيق في ~/logs/mail-debug.log. وإذا كنت تحتاج تحديدًا إلى تسليم فعلي، فعيّن SMTP_DEBUG_DISABLE=1 قبل بدء Tomcat.

git مصادَق عليه مسبقًا

الوصول إلى المستودع (Bitbucket أو GitLab) مُعدّ من خلال بيانات اعتماد مُدارة، لذا تعمل أوامر git pull وcommit وpush دون أن تلصق رمزًا (token). نفّذ commit وpush كما تفعل عادةً. لا تُخزّن الرموز أو المفاتيح أو ملفات بيانات الاعتماد في المستودع أو في Shared Drive.

أدلة ذات صلة

• Use the workspace bot — ابدأ Archibot في المحرر وضعه في العمل.
• Manage workspaces — ابدأ وأوقف وحدّث وجدول من Console.
• Workspace Archibot and Shared Drive — احتفظ بالملاحظات والمخرجات التي تتجاوز عمر مساحة العمل.
• Troubleshooting — الخطوات الأولى عندما يبدو التطبيق أو المحرر خاطئًا.