DocuInsight

🟢 DocuInsight yayında! Şu adresten inceleyin: www.docuinsight.ai ya da canlı demo BURADA izleyebilirsiniz, bu bir hesap oluşturmanızı veya başka bir şey yapmanızı gerektirmiyor!

🔴 Bu proje gönderisi, 27 Ocak 2025’te gönderdiğimiz Devpost hackathon başvurusu neredeyse tam bir kopyasıdır. DocuInsight, Mehmet Yilmaz ve Dylan Eck tarafından 2024-2025 DocuSign Hackathon Unlocked için oluşturuldu. 12 Mart 2025 itibarıyla hackathonu kazanamadık, ancak çok şey öğrendik ve DocuInsight’ın göndericilere ve imzalayanlara gerçek değer sağlayabileceğine inanıyoruz. Bu yüzden çabalarımızı gerçek bir ürün haline getirmeye odaklıyoruz.

Hakkında

DocuInsight, anahtar maddeleri vurgulayarak, bunları sade İngilizceye çevirerek ve e-imzalar için DocuSign ile entegre ederek, ayrıca hukuk uzmanlarına erişim sağlayan bir platformdur.

DocuInsight, sözleşme tuzağını çözmek için oluşturuldu; yani temel sözleşme detayları yasal jargonun arkasında gizlenerek insanların haklarını veya yükümlülüklerini tam olarak anlamadan imzalamalarına neden oluyor. Vizyonumuz, her iki tarafın—imzalayanların ve göndericilerin—imzalamadan önce tam bir netlik kazanmasını sağlamak. Ayrıca, kullanıcıların kişiselleştirilmiş danışmanlık ihtiyacı duyduklarında hukuk profesyonelleriyle kolayca bağlantı kurabilmesi için basit bir yol sunmak istedik.

Aralık 2024’ten Ocak 2025’e kadar DocuSign Hackathonu için geliştirilen DocuInsight, DocuSign teknolojisiyle sözleşmeleri veya şablonları içe aktarmak, metin analizi için OpenAI API’sini kullanmak ve sözleşme hakkında sorulara yanıt verebilen bir sohbet arayüzü sunmak için birleştirildi. Bu bilgi boşluğunu kapatarak herkes için karışıklığı, hukuki anlaşmazlıkları ve kaçırılan fırsatları azaltacağına inanıyoruz.

İlham

2024’ün başlarında, yakın bir arkadaşla bir startup kurdum. Ona güvenerek, şirket sözleşmelerini tam olarak incelemeden imzaladım. Şirketin MVP’lerini ücretsiz geliştirdikten sonra, arkadaşım ek hisselerini kullanarak ya hisselerimi azaltmamı ya da şirketten çıkarılmamı istedi. Bir avukat bulduktan sonra, önemli hakları farkında olmadan devrettiğimi ve kendimi ya da şirketi etkili bir şekilde savunamadığımı fark ettim. Yakın arkadaşımın bencil ve sorumsuz davranışı kişisel olarak beni zorladı ve şirketin değerli zamanını kaybettirdi. Bu deneyim, yasal anlaşmalardaki her detayı anlamanın kişisel hakları korumak ve organizasyonel istikrarı sağlamak için kritik olduğunu öğretti.

Ne Yapar

Özellikler ve İşlevsellik:

  1. Açık Sözleşme Özetleri: DocuInsight, gelişmiş AI modelleriyle yasal belgeleri analiz eder ve kısa özetler üretir. Bu özetler, ana maddeleri, alışılmadık terimleri, potansiyel riskleri ve büyük taahhütleri vurgular, kullanıcıya sözleşmenin net ve anlaşılır bir görünümünü sunar.

  2. Etkileşimli Sohbet Arayüzü: AI destekli sohbet özelliği, kullanıcıların sözleşmeleriyle “konuşmasını” sağlar. Belirli maddeler, anlaşmanın genel amacı veya ilgili yasal kavramlar hakkında sorular sorabilirler. Sohbet botu ayrıca web’de gezerek güvenilir, güncel ve kaynaklı bilgiler sunar.

  3. Avukat Önerileri: Ek yasal yardım arayan kullanıcılar için, DocuInsight, kullanıcının konumu ve incelenen sözleşme türüne göre optimize edilmiş arama sorguları oluşturarak avukat önerir. Arama sonuçları iletişim bilgileri ve incelemeler içerir, böylece kullanıcılar uzmanlarla bağlantı kurabilir.

  4. Gelişmiş İmza Süreci: DocuInsight, DocuSign’in mevcut imzalama iş akışıyla sorunsuz bir şekilde entegre olur. Kullanıcılar e-posta ile giriş yapar, DocuSign hesaplarını bağlayarak şablonlara erişir ve belgeleri imzalamak için gönderir. Gönderildikten sonra alıcı belgeyi inceleyebilir, AI tarafından oluşturulan içgörülerle etkileşime geçebilir ve standart DocuSign platformunda olduğu gibi imzalayabilir.

  5. İmza Sonrası Erişim: İmzaladıktan sonra kullanıcılar, orijinal bağlantı üzerinden belgeyi yeniden ziyaret ederek imzalanmış sözleşmeyi inceleyebilir, AI içgörülerine erişebilir ve sohbet arayüzüyle takip soruları sorabilir. Bu, imzalayanların anlaşmaları hakkında sürekli netlik sağlar.

Bu özellikler, DocuInsight’ı yasal sözleşmelerin karmaşıklığını basitleştiren güçlü bir araç haline getirir. AI destekli içgörüler, etkileşimli destek ve DocuSign ile sorunsuz entegrasyon sayesinde, imzalayanların bilinçli kararlar almasını, göndericilerin dağıttıkları anlaşmalara güven oluşturmasını ve hukuk profesyonellerinin kullanıcılarla bağlantı kurmasını sağlar. Amacımız, anlaşma sürecinde şeffaflık, güven ve erişilebilirliği artırarak yasal metni daha anlaşılır ve adil bir hale getirmektir.

Daha net bir video görmek isterseniz, DocuInsight’ı kullanarak özelliklerini gösteren ek videomuzu izleyin (bu bizim demo videomuz değildir, sadece daha fazla detay isteyenler için ek bir kaynaktır):

Nasıl Oluşturuldu

DocuInsight üç ana bölümden oluşur:

  • Veritabanı: Tüm işler, raporlar, kullanıcı verileri vb. saklar. Projenin gerekli verilerini içerir.
  • Frontend: Kullanıcıların gördüğü ve etkileşimde bulunduğu UI.
  • Analyzer: Yasal sözleşmeleri analiz eden ve e-posta gönderen bir backend hizmeti.

Bu proje için bir veritabanı kullanıldı. Veritabanı PostgreSQL idi ve Supabase üzerinde barındırıldı. Frontend ve Analyzer, Supabase API’sini SDK’ları aracılığıyla kullandı. Veritabanı üç tablo içeriyordu: kullanıcılar, işler ve raporlar. Kullanıcılar tablosu kimlik doğrulama ve hesap takibi için, işler tablosu analiz edilmesi gereken sözleşmeleri, raporlar tablosu ise Analyzer tarafından oluşturulan raporları saklar.

Frontend, Next.js adlı bir frontend çerçevesiyle oluşturuldu. Bu çerçevede HTML, Tailwind CSS, JavaScript, TypeScript ve React kullanıldı. Ayrıca frontend’de birkaç API kullanıldı:

  • OpenAI API: Her imzalama oturumu için chatbotu barındırmak ve çalıştırmak.
  • DocuSign API: Özellikle eSignature API, imzalama süreçlerini yönetmek ve DocuInsight üzerinden kullanıcıların şablonlarına kolay erişim sağlamak için kullanıldı.
  • Tavily API: LLM’ler için tasarlanmış özel bir arama motoru API’si, chatbotun web’de gezinmesini ve en son haberleri almasını sağlar.
  • Resend API: Frontend’de giriş süreçleri için e-posta görevlerini yönetir.
  • Supabase API: Supabase’de barındırılan veritabanına CRUD işlemleri için erişim sağlar.

Frontend, Next.js çerçevesinin yaratıcıları tarafından geliştirilen Vercel üzerinde tamamen barındırılır.

Analyzer, Python ile oluşturuldu. OpenAI API’sini kullanarak o1-preview modelini kullanarak yasal sözleşmeleri analiz eder. Ayrıca Resend API’yi e-posta göndermek için kullanır, özellikle bir makbuz veya DocuInsight’ta bir sözleşme imzalamak için gereken e-posta. Analyzer, Discord webhook’larını destekler, böylece kritik bir şey kırıldığında veya bir şey olduğunda kullanıcılar uyarı alabilir. Projenin geri kalanında olduğu gibi Analyzer da Supabase’i veritabanına erişmek için kullanır.

Analyzer kodu şu paketleri içerir:

  • PyMuPDF, openpyxl, python-docx, ve OpenAI o1-preview modeli: PDF, DOCX, DOC, JPG ve PNG gibi çeşitli dosya türlerinin içeriğini yüklemek için.

Analyzer, en az 4 GB RAM’li bir Linode örneğinde Ubuntu işletim sistemiyle barındırılır.

Karşılaştığımız Zorluklar

DocuInsight’ı oluşturmak teknik ve pratik zorluklarla doluydu. Kullanıcı verilerini korurken veritabanına sorunsuz bir şekilde bağlanan güvenli kimlik doğrulama uygulamak zorunda kaldık. İstediğimiz işlevsellik için DocuSign API’sinin hangi bölümlerini kullanacağımızı anlamak çok deneme yanılma gerektirdi. Frontend’i iyi bir kullanıcı deneyimi sunacak şekilde yapılandırmak ve gelişmiş LLM işlevselliğini mevcut DocuSign imzalama sürecine entegre etmek de zor oldu. Gerçek zamanlı veri akışı ve sohbet arayüzü için sunucudan istemciye veri akışı zorlayıcıydı, ayrıca avukat önerileri için uygun bir veri seti bulunmadığından bu da zor bir görevdi. Chatbotun halüsinasyonlarını azaltmak ve cevaplarını daha güvenilir hâle getirmek için web tarama mantığı geliştirmek zorunda kaldık. Son olarak, projeyi üretim ortamına hazır hale getirmek en zor kısımdı. Yerel bir demo için bir şeyler oluşturmak ve çalıştırmak bir şey, ancak yüksek uptime ve güvenilirlikle web’de dağıtmak tamamen başka bir zorluk. Üretimde tek bir hata kötü bir izlenim bırakabilir, bu yüzden stabilite kritik ve çok zor bir görevdi.

Gurur Duyduğumuz Başarılar

DocuInsight’ı başarıyla dağıttığımız ve herkesin erişebileceği bir ürün haline getirdiğimiz için gurur duyuyoruz. DocuSign ile sorunsuz bir şekilde entegre olan, gerçek dünya kullanımını yöneten ve güvenilir AI destekli içgörüler sunan bir üretim uygulaması oluşturmak büyük bir başarıydı. Yerel bir demo için bir şeyler oluşturmak bir şey, ancak yüksek uptime ile canlı bir ortamda her şeyin çalışmasını sağlamak gurur duyduğumuz bir zorluktu.

Öğrendiklerimiz

Bu proje boyunca, DocuInsight gibi bir çözümün başlangıçta düşündüğümüzden çok daha karmaşık olduğunu fark ettik. Yasal belgeleri ayrıştırmak, doğruluğu sağlamak ve AI yeteneklerini uygun maliyetle dengelemek dikkatli düşünme ve sürekli iterasyon gerektiriyor. Ayrıca video üretiminin önemini öğrendik. Demo’nun değerini etkili bir şekilde iletmek için iki hafta önce profesyonel ekipmanla çalışmaya başladık. Ayrıca bu tür projeleri ölçeklendirmek de zorluklar içeriyor. Gelişmiş AI modellerini çağırmak maliyetli, bu yüzden en akıllı modelleri kullanmakla maliyet etkin bir çözüm sunmak arasında denge kurmak zorundaydık. Ayrıca temel bir pazar araştırması yaparak web’de gezinerek, potansiyel kullanıcılarla konuşarak ve avukatlarla danışarak DocuInsight’ın gerçek değer sağlayıp sağlayamayacağını test ettik. Bu süreç, bir şey yaratmanın sadece bir çözüm üretmekten daha fazlasını gerektirdiğini, etkisini doğrulamanın önemini gösterdi.

DocuInsight’ın Geleceği

DocuInsight’ı daha gelişmiş AI ajanlarıyla derinleştirilmiş sözleşme analizi, daha iyi içgörüler için vektörleştirilmiş veri setleri ve bölgedeki hukuk profesyonelleriyle bağlantı kurmak için daha kapsamlı bir avukat dizini oluşturmak için genişletmeyi planlıyoruz. Gelecek özellikler arasında SEC dava araması gibi araçlar da bulunacak. Amacımız, imzalayanlara, göndericilere ve işletmelere daha fazla değer sağlamak ve anlaşmalarda güven ve şeffaflığı artırmak.