تنزيل sama server - تنزيل رمز مصدر sama server

sama server

كود الذكاء الاصطناعي

0.27.0

تنزيل

SAMA - بديل للرسائل البسيطة ولكن المتقدمة - خادم الدردشة

مدعوم من `uWebSockets.js`

لقطة الشاشة 2022-12-31 في 14 15 04

تحفيز

تتمثل نية بروتوكول المراسلة وخادم الدردشة ، والتي تختلف عن الآخرين ، في توفير حل بديل لبروتوكول مراسلة XMPP على نطاق واسع (ولكي نكون صادقين - المعيار الواسع "المعيار" في هذه الأيام).

اقرأ المنشورات المتوسطة الكاملة التي تقدم SAMA وما هو Sama حول ما هو Sama والمشاكل التي نحاول حلها معها:

https://medium.com/sama-communications/introducing-sama-simple-but-advanced-messaging-alternative-chat-server-524a532e2040
https://medium.com/sama-communications/what-is-sama-a6d9045fd69a

تطبيق Frontend (Web + Mobile) متاح على https://github.com/sama-communications/sama-client

التنمية المحلية

تأكد من تثبيت أحدث Node 18 .
نسخ .env.example إلى .env .
Run docker-compose -f docker-compose.yml -f docker-compose.development.yml up الخدمات المعتمدة (Mongodb ، minio ، redis)
npm install لتثبيت التبعيات
npm run migrate-mongo-up لتشغيل ترحيل DB
npm run start Server (في حالة التشغيل تحت Windows - انظر #128)
الآن سوف يستمع الخادم للاتصالات الواردة على ws://localhost:9001

هناك أيضًا مكونات أخرى متوفرة في Sama Stack - تحقق من نشر Sama Chat Server مكدس: دليل شامل

النشر

يمكن أن يتم نشر تطبيق SAMA بسهولة باستخدام Docker ، سواء كنت تريد إعدادًا كاملاً مع جميع التبعيات أو بيئة محلية مع التطبيقات الرئيسية. فيما يلي خطوات متابعة:

Docker النشر الواحد

هذا النهج يبني ويدير تطبيق SAMA بأكمله ، بما في ذلك جميع التبعيات ، في أمر واحد. إنه مثالي لإعداد البيئة الكاملة بسرعة.

للنشر باستخدام هذه الطريقة ، قم بتشغيل:

 docker-compose -f docker-compose-full.yml up --build

Docker النشر المحلي

لتشغيل خدمات التبعية إلى جانب تطبيقات SAMA الرئيسية ( sama-client ، sama-server ، و sama-push-daemon ) ، استخدم:

 docker-compose up --build

️ إذا كنت تستخدم MacOS أو Windows ، وتريد تشغيل تطبيقات SAMA ، أضف هذين المتغيرين قبل أمر الإطلاق:

ماكوس

 MINIO_ENDPOINT=$(ipconfig getifaddr en0) MINIO_PORT=9010

النوافذ

 $env:MINIO_ENDPOINT = (Get-NetIPAddress | Where-Object { $_.AddressFamily -eq 'IPv4' -and $_.IPAddress -match '^192.168.|^10.|^172.(1[6-9]|2[0-9]|3[0-1]).' } | Select-Object -ExpandProperty IPAddress)[1]; $env:MINIO_PORT = 9010;

إذا كنت تواجه مشكلات مع المرفقات في عميل الويب ، فهذا يشير إلى حدوث خطأ في المتغير الأول. لحل ذلك ، يمكنك ببساطة تحديث قطاع الرمز باستخدام عنوان IP الخاص لجهازك.

الآن يمكنك الوصول إلى التطبيقات على العناوين التالية:

خادم api
ويب العميل
minio-api
Minio-Client
Push Dashboard
الخادم dashboard
redis-commander

اختبار Docker E2E

تشغيل الهجرات:

 docker-compose exec sama-server sh -c "MONGODB_URL=mongodb://172.25.0.4/samatests npm run migrate-mongo-up"

قم بتشغيل اختبارات E2E:

 docker-compose exec sama-server sh -c "MONGODB_URL=mongodb://172.25.0.4/samatests npm run test"

التجريبي السحابي العام

يمكن اختبار مكدس Sama بأكمله باستخدام https://app.samacloud.io Public Cloud.

API

مرجع API

أيضا ، هناك مجموعة من المقالات التفصيلية لكل واجهة برمجة تطبيقات:

المستخدمين API
محادثات API
رسائل API
أنشطة API
API دفتر العناوين
دفع الإخطارات API

حاوية DI مخصصة

مثال على كيفية إنشاء واستخدام مزود:

إنشاء app/providers/services/my_provider مع 2 ملف index.js و Provider.js
يجب أن تحتوي index.js على تنفيذ الخدمة نفسها:

 export default class MyProvider {
  constructor ( redisConnection , userRepo ) {
    this . redisConnection = redisConnection
    this . userRepo = userRepo
  }

  async updateAction ( ws , fields ) {
    const id = await this . redisConnection . client . . .
    const updatedUser = await this . userRepo . update . ...
    ... .
    return updatedUser
  }
}

يجب على Provider.js تصدير مثيل لـ registerProvider الذي يحتوي على تعليمات كيفية إنشاء مثيل لفئة index.js مع تبعيات:

 import RegisterProvider from "@sama/common/RegisterProvider.js"
import MyProvider from "./index.js"

const name = "MyProvider"

class MyProviderRegistration extends RegisterProvider {
  register ( slc ) {
    const redisConnection = slc . use ( "RedisClient" )
    const userRepo = slc . use ( "UserRepository" )

    return new MyProvider ( redisConnection , userRepo )
  }
}

export default new MyProviderRegistration ( { name , implementationName : MyProvider . name } )

ثم ، أضف تصدير Provider.js إلى app/providers/index.js

 import UserRepoProvider from "./repositories/user/Provider.js"
...
...
import MyProviderRegistration from "./services/my_provider/Provider.js"

const providers = [
  UserRepoProvider ,

  ...
  ...

  MyProviderRegistration
]

export default providers

لأي مقدمي واجهات برمجة التطبيقات المخصصة - الاستخدام /APIs/[API_NAME]/providers/index.js 20/providers/index.js ملف:
والآن يمكنك استخدام فئة MyProvider عند الحاجة ، على سبيل المثال في وحدة التحكم:

 import ServiceLocatorContainer from "@sama/common/ServiceLocatorContainer.js"

class Controller {
  async edit ( ws , data ) {
    const myProvider = ServiceLocatorContainer . use ( "MyProvider" )
    const updatedUser = await myProvider . updateAction ( ws , data )
    . ...
  }
}