JimCo.API

تطبيق توضيح تجار التجزئة Jimco

تطبيق توضيح تجار التجزئة Jimco هو مجموعة من أربعة تطبيقات ويب ذات صلة. يتكون من الأجزاء التالية:

1. واجهة برمجة تطبيقات النهاية الخلفية المكتوبة في C# باستخدام ASP.NET CORE.
2. موقع ويب للبيع بالتجزئة يهدف إلى المتسوقين عبر الإنترنت المكتوبون باستخدام React
3. موقع ويب بوابة الموظف يهدف إلى موظفين داخليين مكتوبين باستخدام React
4. موقع ويب بوابة البائعين يهدف إلى البائعين الذين يوزعون المنتجات على المتجر المكتوب باستخدام React

يتم استضافة جميع مواقع الويب الأربعة على Microsoft Azure. يتم استضافة مستودعات التعليمات البرمجية على Github (انظر أدناه للحصول على روابط للمستودعات الفردية ، أو انقر هنا لرؤيتها جميعًا) ، ويتم معالجة CI/CD بواسطة Microsoft Azure DevOps.

واجهة برمجة التطبيقات (هذا المشروع)

مستودع هنا

واجهة برمجة التطبيقات هي النهاية الخلفية لمواقع الويب الثلاثة الأمامية. تمت كتابته في الإصدار 10 C# باستخدام ASP.NET Core / .NET Core الإصدار 6. يتم أرسيته في نهج متعدد الطبقات كما هو موضح أدناه:

اسم الطبقة	وظيفة	يكتب
الوصول إلى البيانات	طبقة المستودع التي تتولى الوصول إلى قاعدة البيانات	مكتبة الفصل
خدمات	طبقة منطق العمل التي تقع بين طبقات الوصول إلى البيانات وطبقة البيانات	مكتبة الفصل
API	واجهة برمجة التطبيقات التي تواجه الويب باستخدام الحد الأدنى من نقاط النهاية	واجهة برمجة تطبيقات الويب
النماذج	نماذج DTO المشتركة بين طبقات API وطبقات الخدمات	مكتبة الفصل
شائع	الفئات الشائعة ، والسمات ، والتعداد ، وطرق التمديد ، وما إلى ذلك	مكتبة الفصل

بالإضافة إلى ما سبق ، يستخدم API Dapper للوصول إلى قاعدة بيانات Microsoft SQL / Azure SQL.

موقع البيع بالتجزئة

مستودع هنا

موقع البيع بالتجزئة مكتوب في TypeScript باستخدام وظائف / خطافات React ، الإصدار 18 React و React Router الإصدار 6.3 . يستجيب وصولاً إلى 375 بكسل. لا يستخدم حاليًا أي تفويض أو مصادقة (على الرغم من أن هذا قد يتغير).

بوابة الموظف

مستودع هنا

تتم كتابة بوابة الموظف في TypeScript باستخدام وظائف / Hooks React ، الإصدار 18 React و React Router الإصدار 6.3 . إنه مصمم خصيصًا للاستخدام داخل المتجر على الأجهزة اللوحية أو أجهزة الكمبيوتر المكتبية ، وبالتالي فهو مصمم لحجم شاشة لا يقل عن 1024 × 768 بكسل. يستخدم Auth0 للترخيص ، ويتم استخدام قاعدة البيانات الداخلية للمصادقة القائمة على الأدوار.

بوابة البائع

مستودع هنا

تتم كتابة بوابة البائع في TypeScript باستخدام وظائف / خطافات React ، الإصدار 18 React و React Router الإصدار 6.3 . إنه مصمم خصيصًا لأجهزة الكمبيوتر المكتبية ، وبالتالي تم تصميمه للحصول على الحد الأدنى من دقة الشاشة 1024 × 768 بكسل. يتم استخدام Auth0 للمصادقة ، ويتم استخدام قاعدة البيانات الداخلية للترخيص القائم على الأدوار.

التبعيات الخارجية

من أجل واجهة برمجة التطبيقات:

1. ASPNETCORDELIMIT المستخدمة لتقييم طلبات الحد
2. hashids.net المستخدمة في التعرف على المعرفات المرسلة إلى المستخدمين النهائيين
3. يستخدم Dapper للوصول إلى قاعدة البيانات
4. json.net مكتبة json لـ .NET

لمواقع الويب ، حزم NPM التالية:

1. رد الفعل ، رد الفعل ، ورد فعل ، ورد ، ريال
2. @mui/مادة ، تستخدم للتنبيهات
3. @Auth0/Auth0-React ، يستخدم للتفاعل مع Auth0
4. uuid ، تستخدم لتوليد uuids