Descarga sama server - Descarga del código fuente sama server

sama server

Código Fuente de IA

0.27.0

Descargar

SAMA - Alternativa de mensajería simple pero avanzada - servidor de chat

Impulsado por `uWebSockets.js`

Captura de pantalla 2022-12-31 a 14 15 04

Motivación

La intención de nuestro protocolo de mensajería y servidor de chat, que son diferentes de los demás, es proporcionar una solución alternativa al protocolo de mensajería XMPP amplio (y para ser honesto, el único 'estándar' amplio en estos días).

Lea las publicaciones medianas completas que introducen a Sama y qué es Sama sobre lo que es Sama y qué problemas estamos tratando de resolver con él:

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

La aplicación frontend (web + móvil) está disponible en https://github.com/sama-communications/sama-client

Desarrollo local

Asegúrese de tener el último Node 18 instalado.
Copiar .env.example a .env .
Ejecutar docker-compose -f docker-compose.yml -f docker-compose.development.yml up para ejecutar servicios dependientes (MongoDB, Minio, Redis)
npm install para instalar dependencias
npm run migrate-mongo-up para ejecutar migraciones de DB
npm run start to ejecutar servidor (en un caso de ejecución en Windows - ver #128)
Ahora el servidor escuchará las conexiones entrantes en ws://localhost:9001

También hay otros componentes disponibles en SAMA Stack: consulte la implementación de Sama Chat Server Stack: una guía completa

Despliegue

La implementación de la aplicación SAMA se puede hacer fácilmente con Docker, ya sea que desee una configuración completa con todas las dependencias o un entorno local con las aplicaciones principales. A continuación se muestran los pasos a seguir:

Implementación de un mando de Docker

Este enfoque construye y ejecuta toda la aplicación SAMA, incluidas todas las dependencias, en un solo comando. Es ideal para configurar el entorno completo rápidamente.

Para implementar usando este método, ejecute:

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

Implementación local de Docker

Para ejecutar los servicios de dependencia junto con las principales aplicaciones SAMA ( sama-client , sama-server y sama-push-daemon ), use:

 docker-compose up --build

️ Si está utilizando macOS o Windows y desea ejecutar aplicaciones SAMA , agregue estas dos variables antes del comando de lanzamiento:

Macosa

 MINIO_ENDPOINT=$(ipconfig getifaddr en0) MINIO_PORT=9010

Windows

 $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;

Si se encuentra con problemas con los archivos adjuntos en el cliente web, sugiere que se produjo un error en la primera variable. Para resolver esto, simplemente puede actualizar el segmento de código con la dirección IP privada de su máquina.

Ahora puede acceder a aplicaciones en las siguientes direcciones:

Servidor-API
Web-cliente
Minio-api
Minio-cliente
Tablero de empuje
Tablero de servidor
Comandante

Pruebas de Docker E2E

Ejecutar migraciones:

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

Ejecutar pruebas E2E:

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

Demostración de nube pública

Toda la pila Sama se puede probar usando https://app.samacloud.io Public Cloud.

API

Referencia de API

Además, hay un conjunto de artículos detallados para cada API:

API de usuarios
API de conversaciones
API de mensajes
API de actividades
API de la libreta de direcciones
API de notificaciones empuje

Contenedor DI personalizado

Un ejemplo de cómo crear y usar el proveedor:

Crear app/providers/services/my_provider con 2 archivos index.js y Provider.js
index.js debe contener la implementación del servicio en sí:

 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 debe exportar una instancia de RegisterProvider que contiene instrucciones sobre cómo crear una instancia de clase index.js con dependencias:

 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 } )

Luego, agregue la exportación de Provider.js a 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

Para cualquier proveedor de API personalizado: use /APIs/[API_NAME]/providers/index.js archivo:
Y ahora puede usar la clase MyProvider donde sea necesario, por ejemplo, en el controlador:

 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 )
    . ...
  }
}