الصفحة الرئيسية>موارد بناء الموقع>بيانات الموقع
تنزيل

crossBILLy - مايكل ألكسيو

@alekseew/ crossBILLy

يحتوي هذا المستودع على تطبيق ويب ومتعدد المنصات (Web PWA وWindows وMac OS X وiOS وAndroid) لتسهيل إنشاء الفواتير. من المفترض أن يساعد هذا المشروع في الحفاظ على بيانات العملاء، وإجراء الفواتير / إعداد الفواتير، ...

الأطر المستخدمة أو التجريبية، والأنظمة الأساسية، والمكتبات، والمكونات الإضافية، والمفاهيم، والبنى، والتقنيات، ... هي التالية:

  • نموذج تفرع التحكم بالمصادر: GitFlow
  • منصة / إطار عمل WebApp للواجهة الأمامية: Angular
  • أداة / إطار بناء النظام الأساسي: المكثف الأيوني أو كوردوفا والإلكترون
  • لغة التطوير: Typescript / ( JavaScript )
  • مكتبة واجهة مستخدم WebApp: المادة الزاويّة
  • مكتبة "السلوك" لواجهة مستخدم WebApp: Angular CDK
  • تنسيق الكود: أجمل
  • الإصدار، سجل التغيير التلقائي (الإصدارات): الإصدار القياسي
  • أداة رسالة الالتزام: الالتزام
  • أداة Git-Hooks: Husky
  • الرسوم المتحركة: لوتي ولوتي ويب
  • الاستضافة والمزيد...: FireBase
  • التكامل المستمر (CI) / الاختبارات والإنشاءات: ترافيس
  • مراقبة التبعية: Greenkeeper
  • سوف يستمر ...

المتطلبات الأساسية

يتطلب هذا المشروع تثبيت التبعيات التالية مسبقًا:

  • Node.js
  • الآلية الوقائية الوطنية

التبعيات

لتثبيت جميع التبعيات المطلوبة، فقط قم بتشغيل: 

npm install

يقوم هذا أيضًا بإعداد قالب رسالة التزام git (وضبط حزمة wip لاستخدام الالتزام).

جيت فلو

الرجاء استخدام نموذج التفريع GitFlow والأسماء الافتراضية لفروع SourceTree في هذا المشروع، ويمكن العثور على مزيد من المعلومات هنا:

  • جيت فلو
  • سورس تري + جيت فلو

اصطلاح تسمية أسماء الفروع والبادئات (الإعداد الافتراضي في SourceTree):

  • فرع الإنتاج : ماستر
  • فرع التطوير : التطوير
  • بادئة فرع الميزة: الميزة/
  • بادئة فرع الإصدار: الإصدار/
  • بادئة فرع الإصلاح العاجل: الإصلاح العاجل/
  • لا توجد بادئة لعلامة الإصدار (ستكون أسماء العلامات على سبيل المثال v0.1.0)

سجل التغيير/الالتزامات التقليدية

في هذا المشروع (الزاوي) يتم استخدام إرشادات رسالة الالتزام الزاوي .

سيتم استخدامها لإنشاء سجل التغيير تلقائيًا باستخدام الإصدار القياسي لحزمة npm، وللقيام بذلك، ما عليك سوى تشغيل npm run release . هذا سوف يقوم بالمهمة التالية:

  • تحديث نسخة المشروع
  • إنشاء/تحديث CHANGELOG.md
  • تنفيذ هذه التغييرات (جاهز للدفع إلى جهاز التحكم عن بعد)
  • قم بإنشاء علامة git

يمكنك استخدام npm run commit للحصول على معالج يساعدك على كتابة رسائل الالتزام الصحيحة (يتم ذلك باستخدام الالتزام ).

سيتم أيضًا التحقق من صحة رسائل الالتزام باستخدام الالتزام (إذا كنت تريد حقًا تخطيها، فيمكنك تجاوز githooks، لكن لا يجب عليك القيام بذلك بشكل طبيعي).

يمكنك إنشاء قالب رسالة التزام git باستخدام npm run prepare-git-commit-template ، وسيتم ذلك أيضًا أثناء تثبيت npm.

الالتزام بتنسيق الرسالة

يجب ألا يزيد طول الرأس (الذي يتكون من النوع والنطاق والموضوع ) عن 72 حرفًا. 

 type(scope?): subject

body?

footer?

يكتب

يجب أن يكون واحدًا مما يلي:

  • الفذ : ميزة جديدة
  • الإصلاح : إصلاح الخلل
  • المستندات : الوثائق تتغير فقط
  • النمط : التغييرات التي لا تؤثر على معنى الكود (المسافة البيضاء، التنسيق، الفواصل المنقوطة المفقودة، إلخ)
  • refactor : تغيير التعليمات البرمجية الذي لا يصلح خطأ ولا يضيف ميزة
  • perf : تغيير التعليمات البرمجية لتحسين الأداء
  • الاختبار : إضافة الاختبارات المفقودة أو تصحيح الاختبارات الموجودة
  • البناء : التغييرات التي تؤثر على نظام البناء أو تكوين CI أو التبعيات الخارجية (مثال على النطاقات: gulp، broccoli، npm)
  • ci : تغييرات على ملفات تكوين CI والبرامج النصية الخاصة بنا (مثال على النطاقات: Travis وCircle وBrowserStack وSauceLabs)
  • العمل الرتيب : التغييرات الأخرى التي لا تؤدي إلى تعديل ملفات src أو test
  • revert : إرجاع الالتزام السابق

نِطَاق

يمكن أن يكون النطاق أي شيء يحدد مكان تغيير الالتزام. أنا أستخدم الاتفاقيات التالية (الأمثلة):

  • الكل : التغييرات للمشروع بأكمله (إصدار المشروع العام، ...)
  • الجذر : التغييرات في الجذر (المجلد) للمشروع
  • يكون : التغييرات في الجزء الخلفي من المشروع
  • fe : تغييرات في الجزء الأمامي (webapp) للمشروع

موضوع

يحتوي الموضوع على وصف موجز للتغيير:

  • استخدم الأمر في زمن المضارع: "يتغير" وليس "يتغير" ولا "يتغير"
  • لا تكتب الحرف الأول بحرف كبير
  • بدون نقطة (.) في النهاية

جسم

كما هو الحال في الموضوع ، استخدم الأمر في زمن المضارع: "تغيير" وليس "تغيير" ولا "تغييرات". يجب أن يتضمن الجسم الدافع للتغيير ومقارنة ذلك بالسلوك السابق.

تذييل

يجب أن يحتوي التذييل على أية معلومات حول كسر التغييرات كما أنه المكان المناسب للإشارة إلى مشكلات JIRA التي يؤدي هذا الالتزام إلى إغلاقها .

يجب أن تبدأ التغييرات العاجلة بالكلمة كسر BREAKING CHANGE: بمسافة أو سطرين جديدين. ثم يتم استخدام بقية رسالة الالتزام لهذا الغرض.

ارتكاب السنانير

في هذا الريبو يتم استخدام خطافات git (الإعداد باستخدام husky ) للتحقق من كود المصدر "النظيف".

أجمل تنسيق الاختيار

إذا تم تغيير ملفات Typescript أو SCSS ودفعها، فسيتم تشغيل ربط الالتزام ويتم تنسيق الملفات المرحلية بشكل أجمل. فهو يقوم بالتنسيق/التغييرات والالتزام بهذه التغييرات ودفعها بمساعدة ملف .

الالتزام بفحص الرسالة

يتحقق مما إذا كانت رسالة التزام git هي رسالة التزام git تقليدية، وإلا فسيتم إلغاء الالتزام.

نسخة المشروع والإصدار

يجب أن يقوم الالتزام الأخير في فرع الإصدار بتعيين إصدار المشروع وإنشاء سجل التغيير، ويجب أن يتم ذلك باستخدام npm run release . هذه المجموعة هي نسخة المشروع ، وتقوم بإنشاء سجل التغيير وتنفيذ هذه التغييرات . يمكن العثور على مزيد من المعلومات في الفصل: سجل التغيير/الالتزامات التقليدية

يستمر التكامل والنشر

في هذا المشروع، تم إعداد Travis CI كـ lint- وtest- وe2e-tests- وbuild-slave. إذا تم اختبار كل شيء وبناءه بنجاح، فسوف يقوم Travis CI بنشر WebApp على FireBase .

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل