Aller au contenu principal

Serveur d'Application IMS d'Omnitouch

Serveur d'application IMS fournissant des services d'application de téléphonie complets, y compris le routage des appels, les services supplémentaires, la facturation en ligne et la gestion des abonnés.

Liens Rapides​

Opérations & Surveillance​

Configuration​

  • Guide de Configuration - Référence complète de configuration pour Event Socket, Panneau de Contrôle, API, Trunks SIP et Diameter
  • Interface Sh - Récupération des données des abonnés depuis HSS/Dépôt
  • Blocs de Données du Dépôt - Données RepositoryData par document (MMTel, ODB, personnalisé) exposées en tant que variables de plan de numérotation
  • Facturation en Ligne (Ro) - Intégration OCS et contrôle de crédit
  • SS7 MAP - Requêtes HLR pour l'itinérance et le renvoi d'appels

Routage des Appels & Services​

  • Configuration du Plan de Numérotation - Fondamentaux du plan de numérotation XML, variables et logique de routage des appels
  • Traduction de Numéros - Normalisation E.164 et traduction spécifique au pays
  • Services Supplémentaires - Renvoi d'appels, blocage CLI et appels d'urgence
  • SRVCC - Continuité d'Appel Vocal à Radio Unique : schéma de préfixe STN-SR et transfert de session PS vers CS
  • Messagerie Vocale - Messagerie vocale (dépôt/récupération) avec notifications SMS, salutations personnelles, renvoi de messages, conservation/expiration et boîtes aux lettres fédérées multi-TAS
  • Invitations TTS - L'audio des invitations est généré au moment du déploiement par les playbooks Ansible d'Omnicore ; OmniTAS ne fait que le jouer

Conformité​

Vue d'Ensemble du Traitement des Appels​

Vue d'Ensemble des Fonctionnalités​

Fonctionnalité de Base​

  • Traitement des Appels Conforme IMS - Fonctionnalité complète du Serveur d'Application IMS 3GPP
  • Intégration Diameter - Interfaces Sh (données des abonnés) et Ro (facturation en ligne)
  • Gestion des Trunks SIP - Support de plusieurs passerelles avec surveillance et basculement
  • Routage des Appels - Plan de numérotation XML flexible avec support complet des variables
  • Traduction de Numéros - Normalisation E.164 pour plusieurs pays (AU, US, PF, extensible)

Services Supplémentaires​

  • Renvoi d'Appels - Toutes les variantes (CFA, CFB, CFNRy, CFNRc) avec support MMTel-Config
  • Blocage CLI - Blocage d'identification de l'appelant basé sur le préfixe et l'en-tête SIP
  • Appels d'Urgence - Routage dédié pour les services d'urgence avec contournement OCS
  • Messagerie Vocale - Service de messagerie vocale complet : dépôt, récupération, notifications SMS, salutations personnelles, renvoi, expiration et boîtes aux lettres fédérées multi-TAS
  • Conférence IMS - Conférence multi-parties conforme 3GPP (RFC 4579, RFC 4575)

Surveillance & Opérations​

  • Interface Web du Panneau de Contrôle - Interface de surveillance complète (HTTPS sur le port 443)
    • Enregistrements d'abonnés en temps réel
    • Dossiers de Détails d'Appels avec recherche et filtrage avancés
    • Surveillance des appels actifs
    • Statut des passerelles et des pairs Diameter
    • Journaux système et métriques
    • Outils de test (Sh, OCS, HLR, Traduction de Numéros, Simulateur d'Appels)
  • API REST - API documentée OpenAPI/Swagger pour un accès programmatique (port 8444)
  • Métriques Prometheus - Métriques étendues sur 3 points de terminaison (9094, 9090, 9093)

Points d'Intégration​

  • HSS/Dépôt (Sh) - Récupération du profil d'abonné et de MMTel-Config
  • OCS (Ro) - Contrôle de crédit en temps réel avec réautorisation périodique
  • HLR (SS7 MAP) - Récupération de MSRN pour les abonnés en itinérance
  • SMSc - Notifications de messagerie vocale et d'appels manqués
  • OpenAI TTS - Génération dynamique d'invitations
  • SBCs/Passerelles - Support de plusieurs trunks SIP

Démarrage Rapide​

Structure de Configuration​

Fichiers de Configuration​

Toute la configuration se trouve dans config/runtime.exs :

# Event Socket - Interface de contrôle des appels
config :tas,
  fs_event_socket: %{
    host: "127.0.0.1",
    port: 8021,
    secret: "VotreMotDePasseSecret"
  }

# IPs sources autorisées pour le routage des appels
config :tas,
  allowed_sbc_source_ips: ["10.5.198.200"],
  allowed_cscf_ips: ["10.8.3.34"]

# Traduction de numéros
config :tas,
  number_translate: %{
    country_code: :AU,  # :AU, :US, :PF
    localAreaCode: "617"
  }

# Facturation en ligne
config :tas,
  online_charging: %{
    enabled: true,
    periodic_ccr_time_seconds: 10,
    schedule_hangup_auth: false,
    skipped_regex: ["^2222", "^911"]  # Contourner OCS pour ces destinations
  }

# Appels d'urgence
config :tas,
  emergency_call_codes: ["911", "112", "000", "sos"]

# Messagerie vocale (dépôt + récupération pilotée par ESL)
config :tas,
  voicemail: %{
    timezone: "UTC",
    say_language: "fr",
    storage_dir: "/usr/local/freeswitch/storage/voicemail",
    # invitations omises ici (les invitations vocales sont générées par TTS via :prompts) ; outbound_socket,
    # enregistrement et menu par défaut dans le code - voir la doc de la Messagerie Vocale
    # invitations: %{...},
    smsc: %{
      smsc_url: "https://10.80.14.219:8443",
      source_msisdn: "2222"
    }
  }

Voir le Guide de Messagerie Vocale pour la configuration complète et le flux, et le Guide de Configuration pour la référence complète des paramètres.

Architecture de Surveillance & Accès​

Points d'Accès​

  • Panneau de Contrôle : https://your-server-ip/ (configuré dans config/runtime.exs)
  • API REST : https://your-server-ip:8444/api/swaggerui
  • Métriques Prometheus :
    • http://your-server-ip:9094/metrics (moteur TAS, Diameter, OCS, HLR)
    • http://your-server-ip:9090/metrics (Système, passerelles, cœur de téléphonie)
    • http://your-server-ip:9093/esl?module=default (qualité des médias RTP/RTCP)

Modèles de Plan de Numérotation​

Les modèles XML de plan de numérotation se trouvent dans priv/templates/ :

  • mo_dialplan.xml - Appels Originaire Mobile
  • mt_dialplan.xml - Appels Terminé Mobile
  • mo_emergency_dialplan.xml - Appels d'Urgence

Voir Configuration du Plan de Numérotation pour la documentation détaillée du plan de numérotation.

Structure de la Documentation​

Ce README fournit un aperçu de haut niveau. La documentation détaillée est organisée par sujet :

Par Rôle​

Opérateurs & Administrateurs :

  1. Commencez par le Guide des Opérations pour la surveillance et les tâches quotidiennes
  2. Consultez la Référence des Métriques pour configurer la surveillance et les alertes
  3. Utilisez le Panneau de Contrôle à https://your-server-ip/ pour les tâches opérationnelles

Intégrateurs Systèmes & Ingénieurs :

  1. Commencez par le Guide de Configuration pour la configuration du système
  2. Consultez la Configuration du Plan de Numérotation pour la logique de routage des appels
  3. Configurez les interfaces : Interface Sh, Facturation en Ligne, SS7 MAP
  4. Implémentez les services : Services Supplémentaires, Messagerie Vocale

Développeurs :

  1. Consultez la documentation de l'API REST (OpenAPI/Swagger)
  2. Consultez la Référence des Métriques pour l'intégration Prometheus
  3. Consultez le Guide de Configuration pour la configuration de l'API

Par Sujet​

Traitement des Appels :

Données des Abonnés :

Configuration du Système :

Services à Valeur Ajoutée :

Exigences Système​

Exigences​

  • Runtime Elixir/OTP
  • PostgreSQL ou SQLite pour le stockage des CDR
  • Accès au Core IMS (S-CSCF)
  • Connectivité réseau vers :
    • DRA/HSS (Diameter : Sh et éventuellement Ro)
    • Passerelles SIP/SBC
    • Optionnel : Passerelle MAP SS7, SMSc, API OpenAI TTS

Support & Documentation​

  • Problèmes & Demandes de Fonctionnalités : Contactez votre ingénieur d'intégration
  • Métriques & Surveillance : Voir docs/metrics.md
  • Documentation API : Accédez à Swagger UI à https://your-server-ip:8444/api/swaggerui
  • Panneau de Contrôle : Accédez à https://your-server-ip/

Licence​

Propriétaire - Omnitouch Systems

Dernière mise à jour le