TicketScout

Menyederhanakan tiket dengan presisi yang digerakkan AI

---

Keterangan

Selamat datang di Ticketscout, di mana kami merevolusi pengalaman tiket dengan teknologi AI mutakhir. Platform kami menyederhanakan proses menemukan dan mengelola tiket, memanfaatkan pencarian vektor MongoDB Atlas yang kuat dan model-model embatan teks canggih Openai untuk memberikan hasil pencarian yang tepat dan relevan.

Memulai

Prasyarat

• Akun MongoDB Atlas
• Akun GitHub untuk otentikasi OAuth
• Kunci API Openai untuk Embeddings Teks
• Render akun untuk penyebaran CI/CD

Panduan Pengaturan

Konfigurasi GitHub OAuth

• Arahkan ke "Pengaturan"> "Pengaturan Pengembang"> "OAuth Apps" di akun GitHub Anda.
• Klik "Aplikasi OAuth Baru", isi detail yang diperlukan, dan atur http://localhost:8080/login/oauth2/code/github sebagai url callback otorisasi.
• Setelah pembuatan, catat ID dan rahasia klien.

Pencarian vektor mongodb atlas

1. Pengaturan Cluster dan Database :

   • Daftar untuk MongoDB Atlas dan buat cluster.
   • Buat Database TicketScout dan koleksi tickets di dalamnya.

2. Indeks Pencarian Vektor :

   • Arahkan ke tab "Cari" di halaman cluster Anda.
   • Buat indeks pencarian baru bernama vector_index_titleAndDescription menggunakan editor JSON, dengan konfigurasi berikut:

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

Pengembangan Lokal

Untuk mulai meretas, Anda perlu mengatur variabel lingkungan berikut:

Nama	Keterangan
OAUTH_GITHUB_ID	ID klien dari aplikasi github oauth Anda, yang digunakan untuk otentikasi pengguna.
OAUTH_GITHUB_SECRET	Rahasia klien dari aplikasi github oauth Anda, diperlukan untuk aliran oauth yang aman.
APP_URL	URL dasar di mana aplikasi Anda dapat diakses, penting untuk pengalihan oAuth dan panggilan balik layanan.
MONGODB_URI	String koneksi Atlas MongoDB Anda, mengaktifkan akses basis data untuk aplikasi Anda.
OPENAI_EMBEDDING_BASE_URL	URL dasar untuk embedding API Openai, memfasilitasi operasi embedding teks untuk fitur pencarian lanjutan.
OPENAI_API_KEY	Kunci API pribadi Anda untuk mengakses Layanan OpenAI, yang diperlukan untuk memanfaatkan fungsionalitas yang digerakkan AI.

Konfigurasi CI/CD

Kelola pipa CI/CD Anda secara efisien dengan menyiapkan lingkungan production di GitHub dan mengkonfigurasi rahasia yang diperlukan. Rahasia -rahasia ini sangat penting untuk mengotomatisasi proses penyebaran Anda dan memastikan akses yang aman ke akun Dockerhub Anda dan membuat pemicu penyebaran.

Nama	Keterangan
DOCKERHUB_USERNAME	Nama pengguna untuk akun Dockerhub Anda, digunakan untuk mengotentikasi dengan Dockerhub dalam skrip CI/CD.
DOCKERHUB_PASSWORD	Kata sandi untuk akun Dockerhub Anda, penting untuk mendorong dan menarik gambar Docker dengan aman.
DOCKERHUB_TAG	Tag untuk gambar Docker Anda, biasanya menentukan versi atau lingkungan. latest direkomendasikan untuk penyebaran berkelanjutan.
RENDER_DEPLOY	URL atau webhook untuk memicu penyebaran pada render, mengintegrasikan pipa CI/CD Anda dengan layanan hosting Render.

Ingatlah untuk juga mengkonfigurasi variabel lingkungan dari bagian "pengembangan lokal" di pengaturan lingkungan render Anda.