employee manager

مدير الموظفين

نظام إدارة يستخدم الإصدار 8 من Angular لواجهة المستخدم الأمامية وAsp.Net Core لواجهة برمجة تطبيقات الويب الخلفية.

نِطَاق

هذا مشروع لتوضيح توسيع المفاهيم إلى مشاريع أكبر. إنه نظام لإدارة الموظفين مع التحقق من صحة النموذج باستخدام Angular وASP.Net Core. تتمثل الفكرة في التعرف على إطار عمل JavaScript شائع ودمجه مع C#/ASP.Net Core، مع توفير إصدار Api واختبار نقطة نهاية وحدة التحكم واختبارات تكامل الإعداد لتطبيقات الميزات المستقبلية.

إن استخدام كائنات نقل البيانات (Dtos) باستخدام Auto Mapper يحمي ويعين فئات الكيانات الأصلية الموجودة في دليل DataEntities الخاص بـ Api إلى فئات لمهام محددة، مثل الجلب والإنشاء والتحرير.

مكدس التنمية

تم إنشاء التطبيق باستخدام الأدوات والأطر التالية:

• سي #/ASP.نت كور 2.2
• الإصدار الزاوي 8.3
• التمهيد 4
• SQL Server أو قاعدة بيانات PostgreSQL (يتم تكوينها بسهولة في فئة DbContext)

المدمج في اختبار نقطة النهاية

يحتوي المشروع على اختبار نقطة نهاية API المضمنة باستخدام Swagger. تم هذا الإعداد في فئة Startup.cs في كل من تكوين الخدمات وIConfiguration ليتم استخدامه عند بدء التشغيل. بعد إطلاق المشروع في بيئة محلية، انتقل إلى https://localhost:5001/swagger لعرض صفحة فهرس الاختبار.

يثبت

من أجل اختبار/استخدام هذا التطبيق، سوف تحتاج إلى ما يلي:

• Asp.Net Core 2.0 SDK، ويفضل 2.2.1
• Node.js الإصدار 8 أو أعلى
• الزاوي CLI
• Microsoft SQL Server أو pgAdmin لـ PostgreSQL

تثبيت

احصل على المستودع إما عن طريق تنزيل الملف المضغوط أو استنساخ المشروع.

بعد استنساخ الملفات أو فك ضغطها، انتقل إلى الدليل الذي يحتوي على ملف الحل:

 ~ $ cd src/EmployeeManager/

في أي من الترتيبين، انتقل إلى ملفات العميل أو واجهة برمجة التطبيقات/الخادم وقم بتثبيت تبعياتها. مرة أخرى، ستحتاج إلى تثبيت Node.js و npm مع .Net Core 2.2 SDK.

بالنسبة لتبعيات جانب العميل:

 ~ $ cd src/EmployeeManager/client
~ $ npm install

تأكد من تثبيت @angularcli أيضًا:

 # for Angular
~ $ npm install -g @angular/cli @angular/core

بالنسبة للتعليمات البرمجية من جانب الخادم، قم ببناء واستعادة التبعيات وحزم NuGet:

 ~ $ cd src/EmployeeManager/server/
~ $ dotnet restore

تشغيل البيئة

لتشغيل بيئة محلية من جانب العميل: استخدم أوامر البرنامج النصي npm في مربع الأوامر/المحطة أثناء وجودك في دليل ../client :

 # for Angular client
~ $ ng build -options

يؤدي هذا إلى إخراج ملف JavaScript مصغر في دليل wwwroot لواجهة برمجة التطبيقات (API) عبر البرامج النصية angular.json .

لتشغيل بيئة محلية على جانب الخادم: استخدم أداة dotnet لتشغيلها في محطة طرفية أو استخدم Visual Studio لتشغيلها باستخدام CTL + F5

انتقل إلى localhost:5001 (أو إلى ) في المتصفح لرؤية الإصدار الحالي قيد التشغيل.

المهام

• إضافة التفويض وتسجيل الدخول.
• تمكين البحث حسب اسم الموظف.

المشكلات والأخطاء المعروفة

• يواجه إجراء التحديث في فئة نقطة نهاية وحدة التحكم ضمن ApiVersion 2 (أي api/v2/endpoint) مشكلة في إرسال الطلبات الناجحة إلى الخادم بسبب عدم تمكن AutoMapper من ربط EmployeeDto إلى EmployeeUpdateDto ، لذا فهو يستخدم فئة السياق بدلاً من ذلك في الإصدار 1 ضمن /v1/... الطريق. (تم إصلاح المشكلة)