TicketScout

Vereinfachung der Ticketing mit KI-gesteuerter Präzision

---

Beschreibung

Willkommen bei TicketsCout, wo wir das Ticketing-Erlebnis mit der modernen KI-Technologie revolutionieren. Unsere Plattform vereinfacht den Prozess des Findens und Verwaltens von Tickets und nutzt die leistungsstarke Vektorsuche von MongoDB Atlas und die erweiterten Text-Embde-Modelle von OpenAI, um präzise, ​​relevante Suchergebnisse zu liefern.

Erste Schritte

Voraussetzungen

• MongoDB Atlas Account
• Github -Konto für die OAuth -Authentifizierung
• OpenAI -API -Schlüssel für Texteinbettungen
• Berücksichtigen Sie die CI/CD -Bereitstellung

Setup -Handbuch

GitHub OAuth -Konfiguration

• Navigieren Sie in Ihrem GitHub -Konto zu "Einstellungen"> "Entwicklereinstellungen"> "OAuth Apps".
• Klicken Sie auf "New OAuth App", geben Sie die erforderlichen Details ein und setzen Sie http://localhost:8080/login/oauth2/code/github als Autorisierungs -Callback -URL.
• Beachten Sie nach der Erstellung die Client -ID und das Geheimnis.

MongoDb Atlas Vectorsuche

1. Cluster- und Datenbank -Setup :

   • Melden Sie sich für MongoDB Atlas an und erstellen Sie einen Cluster.
   • Erstellen Sie eine TicketScout -Datenbank und eine tickets -Sammlung darin.

2. Vektorsuche Index :

   • Navigieren Sie auf der Registerkarte "Suche" auf der Seite Ihres Clusters.
   • Erstellen Sie mit der folgenden Konfiguration einen neuen Suchindex mit dem Namen vector_index_titleAndDescription mit dem JSON -Editor:

     {
       "fields" : [
         {
           "numDimensions" : 3072 ,
           "path" : " titleAndDescriptionEmbedding " ,
           "similarity" : " cosine " ,
           "type" : " vector "
         }
       ]
     }

Lokale Entwicklung

Um mit dem Hacken zu beginnen, müssen Sie die folgenden Umgebungsvariablen festlegen:

Name	Beschreibung
OAUTH_GITHUB_ID	Die Client -ID Ihrer Github OAuth -Anwendung, die für die Benutzerauthentifizierung verwendet wird.
OAUTH_GITHUB_SECRET	Das Kunde geheim ist aus Ihrer Github OAuth -Anwendung, die für sichere OAuth -Ströme erforderlich ist.
APP_URL	Die Basis -URL, bei der Ihre Anwendung zugänglich ist, und für die Wiederleitungen von OAuth und Service -Rückrufe von entscheidender Bedeutung ist.
MONGODB_URI	Ihre MongoDB -Atlas -Verbindungszeichenfolge, die den Datenbankzugriff für Ihre Anwendung aktiviert.
OPENAI_EMBEDDING_BASE_URL	Die Basis -URL für OpenAIs Einbettungs -API ermöglicht die Einbettungsoperationen von Text für fortschrittliche Suchfunktionen.
OPENAI_API_KEY	Ihr persönlicher API-Schlüssel zum Zugriff auf OpenAI-Dienste, die für die Verwendung von KI-gesteuerten Funktionen erforderlich sind.

CI/CD -Konfiguration

Verwalten Sie Ihre CI/CD -Pipelines effizient, indem Sie eine production auf GitHub einrichten und die erforderlichen Geheimnisse konfigurieren. Diese Geheimnisse sind entscheidend für die Automatisierung Ihres Bereitstellungsprozesses und für den sicheren Zugriff auf Ihr DockerHub -Konto und die Bereitstellung von Bereitstellungsauslöschern.

Name	Beschreibung
DOCKERHUB_USERNAME	Der Benutzername für Ihr DockerHub -Konto, das zur Authentifizierung mit DockerHub in CI/CD -Skripten verwendet wird.
DOCKERHUB_PASSWORD	Das Passwort für Ihr DockerHub -Konto ist entscheidend, um Docker -Bilder sicher zu drücken und zu ziehen.
DOCKERHUB_TAG	Das Tag für Ihr Docker -Bild, das normalerweise die Version oder Umgebung angibt. latest wird für den kontinuierlichen Einsatz empfohlen.
RENDER_DEPLOY	Die URL oder das Webhook, um die Bereitstellung für Render auszulösen und Ihre CI/CD -Pipeline in die Hosting -Dienste von Render integrieren zu können.

Denken Sie daran, auch die Umgebungsvariablen aus dem Abschnitt "Lokale Entwicklung" in Ihren Umgebungseinstellungen für Render zu konfigurieren.