DocuInsight

Events

15 Eylül 2025: DocuInsight emekli edildi ancak şimdi tamamen açık kaynak olarak github.com/eandf/DocuInsight adresinde bulunuyor, belgeler ise eandf.github.io/DocuInsight adresinde. Orijinal alan adı 2027 yılına kadar oraya yönlendiriyor.

27 Ocak 2025: DocuInsight, 2024-2025 DocuSign Hackathon Unlocked için Mehmet Yilmaz ve Dylan Eck tarafından oluşturuldu. Şuraya göz atın www.docuinsight.ai veya bizim live demo. Bu gönderi, bizim Devpost submission gönderimize dayanmaktadır.

About

DocuInsight, anahtar maddeleri vurgulayarak, bunları sade İngilizceye çevirerek ve e‑imzalar için DocuSign ile entegre ederek yasal sözleşmeleri basitleştiren bir platformdur, ayrıca yasal uzmanlara erişim sağlar.

DocuInsight, sözleşme tuzağını çözmek için yaratıldı; burada temel sözleşme detayları yasal jargonun arkasında gizli kalıyor ve insanlar haklarını ya da yükümlülüklerini tam olarak anlamadan imzalama yapıyor. Vizyonumuz, her iki tarafın da – imzalayanların ve gönderenlerin – 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ı kurabilecekleri basit bir yol sunmak istedik.

Aralık 2024’ten Ocak 2025’e kadar DocuSign Hackathon için geliştirilen DocuInsight, DocuSign teknolojisiyle sözleşmeleri veya şablonları içe aktarıyor, metin analizi için OpenAI API’sini kullanıyor ve sözleşmeyle ilgili soruları yanıtlayabilen ya da avukat bulmak için kaynaklar sağlayabilen bir sohbet arayüzü sunuyor. Bu bilgi boşluğunu kapatmanın, herkes için karışıklığı, hukuki anlaşmazlıkları ve kaçırılan fırsatları azaltacağına inanıyoruz.

Demo

Inspiration

2024’ün başlarında, yakın bir arkadaşla bir startup kurdum. Ona güvendiğim için şirket sözleşmelerini tam olarak incelemeden imzaladım. Şirketin MVP’lerini maaş almadan geliştirmek için çok zaman ve uzmanlık harcadıktan 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ı keşfettim. Yakın arkadaşımın bencil ve sorumsuz davranışı nedeniyle anlaşmazlık kişisel olarak beni yıprattı ve şirkete değerli zaman kaybettirdi. Bu deneyim, yasal anlaşmalardaki her detayı anlamanın kişisel hakları korumak ve organizasyonel istikrarı sağlamak açısından kritik önemini öğretti.

What it does

Features and Functionality:

  1. Net Sözleşme Özetleri: DocuInsight, gelişmiş AI modelleriyle yasal belgeleri analiz eder ve özlü özetler üretir. Bu özetler, ana maddeleri, alışılmadık terimleri, potansiyel riskleri ve büyük taahhütleri vurgulayarak kullanıcılara sözleşmenin net ve anlaşılır bir genel bakışı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ı ya da ilgili yasal kavramlar hakkında sorular sorabilirler. Sohbet botu ayrıca web’de gezinti yaparak iyi kaynaklı, doğru ve güncel bilgiler sunar, böylece kullanıcılar güvenilir yanıtlar alır.

  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 avukat öneren optimize edilmiş arama sorguları oluşturur. Arama sonuçları, hukuk profesyonellerinin iletişim bilgileri ve incelemelerini içerir, böylece kullanıcılar uzmanlarla bağlantı kurmak için eyleme geçirilebilir bir yol elde eder.

  4. Geliştirilmiş İmza Süreci: DocuInsight, DocuSign’in mevcut imzalama iş akışıyla sorunsuz bir şekilde bütünleşir. Kullanıcılar e‑postalarıyla oturum açar, şablonlara erişmek için DocuSign hesaplarını bağlar 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 girebilir ve standart DocuSign platformunda olduğu gibi imzalayabilir.

  5. İmza Sonrası Erişim: İmzaladıktan sonra kullanıcılar, orijinal bağlantı üzerinden belgelerine tekrar ulaşabilir, imzalanmış anlaşmayı gözden geçirebilir, AI içgörülerine erişebilir ve sohbet arayüzüyle takip soruları sorabilir. Bu, imzalayanların anlaşmaları hakkında sürekli bir netlik elde etmelerini sağlar.

Bu özellikler, DocuInsight’ı yasal sözleşmelerin karmaşıklığını basitleştiren güçlü bir araç haline getirir. AI‑güdümlü içgörüler, etkileşimli destek ve DocuSign ile sorunsuz entegrasyonu birleştirerek, imzalayanların bilinçli kararlar almasını, gönderenlerin dağıttıkları anlaşmalara güven inşa etmesini ve yasal profesyonellere daha fazla kullanıcıyla bağlantı kurma fırsatları sunar. Amacımız, anlaşma sürecinde şeffaflık, güven ve erişilebilirliği artırarak, yasal metinleri daha anlaşılır ve herkes için daha adil hâle getirmektir.

Eğer DocuInsight’ı kullanarak özelliklerini net bir şekilde gösteren bir video görmek isterseniz, bu ek videoya göz atın (bu bizim demo videomuz değildir, sadece daha fazla detay isteyenler için ek bir kaynaktır):

How we built it

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

  • Database: Tüm işler, raporlar, kullanıcı verileri vb. saklanır. Projenin gerekli verilerini içerir.
  • Frontend: Projenin UI’sı, kullanıcıların gördüğü ve etkileşimde bulunduğu kısım.
  • Analyzer: Yasal sözleşmeleri analiz eden ve e‑postalar gönderen bir arka uç hizmeti.

Bu proje için bir veritabanı kullanıldı. Veritabanı PostgreSQL idi ve Supabase üzerinde barındırıldı. Frontend ve Analyzer, Supabase’in API’sini SDK’ları aracılığıyla kullandı. Veritabanı kurulumu üç 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 izlemek için, raporlar tablosu ise Analyzer tarafından oluşturulan sözleşme raporlarını saklamak için kullanıldı.

Frontend, Next.js adlı bir ön uç çerçevesi kullanılarak geliştirildi. Bu çerçevede HTML, Tailwind CSS, JavaScript, TypeScript ve React kullandık. Bu teknolojiler, ön ucun dinamik ve duyarlı bir şekilde çalışmasını ve içerik göstermesini sağladı. Ayrıca ön uçta birkaç API kullandık:

  • OpenAI API’si: Her imzalama oturumu için sohbet botunu barındırmak ve çalıştırmak amacıyla.
  • DocuSign API’si: Özellikle eSignature API’si, tüm imzalama süreçlerini yönetmek ve kullanıcıların DocuSign hesaplarındaki şablonlara kolay erişim sağlamak için kullanıldı.
  • Tavily API’si: LLM’ler için tasarlanmış özel bir arama motoru API’si, sohbet botunun web’de gezinti yaparak en son haberleri veya güncellemeleri almasını sağladı.
  • Resend API’si: Özellikle ön uçtaki oturum açma süreçleri için tüm e‑posta görevlerini yönetmek amacıyla.
  • Supabase API’si: Supabase üzerinde barındırılan projenin veritabanına erişerek CRUD işlemlerini gerçekleştirmek için.

Frontend, Next.js çerçevesinin yaratıcıları tarafından geliştirilen bir barındırma hizmeti olan Vercel’de tamamen barındırılıyor.

Analyzer, Python kullanılarak oluşturuldu. OpenAI API’sini, OpenAI’nin en gelişmiş modellerinden biri olan o1-preview ile yasal sözleşmeleri analiz etmek için kullanıyor. Ayrıca Resend API’si, bir makbuz göndermek ya da DocuInsight’ta bir sözleşmeyi imzalamak için gerekli e‑postayı göndermek gibi görevler için kullanılıyor. Analyzer, kritik bir şey kırıldığında ya da gerçekleştiğinde kullanıcıların uyarı almasını sağlayan Discord webhooklarını destekler. Projenin geri kalan kısmı gibi Analyzer da Supabase’i kullanarak projenin veritabanına erişir.

Analyzer kodu, aşağıdaki paketleri içerir:

  • PyMuPDF, openpyxl, python-docx ve OpenAI’nin 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’e sahip bir Linode örneğinde, işletim sistemi olarak Ubuntu çalıştırılarak barındırılır.

Challenges we ran into

DocuInsight’ı inşa etmek, teknik ve pratik açıdan birçok zorlukla doluydu. Veritabanımıza sorunsuz bir şekilde bağlanan güvenli bir kimlik doğrulama sistemini nasıl uygulayacağımızı ve kullanıcı verilerini koruyacağımızı bulmamız gerekti. İstediğimiz işlevselliği sağlamak için DocuSign API’sinin hangi bölümlerini kullanmamız gerektiğini anlamak, deneme‑yanılma gerektirdi. Frontendi, 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 zorlayıcıydı. Gerçek zamanlı veri akışını sunucu‑istemci arasında sohbet arayüzü için sağlamak karmaşıktı; ayrıca, API üzerinden erişilebilen uygun ve uygun fiyatlı bir hukuk profesyonelleri veri seti bulunmadığından avukat önerme mekanizması geliştirmek zordu. Chatbotun halüsinasyonlarını en aza indirmek ve yanıtlarını daha güvenilir hâle getirmek için web‑tarama mantığını inşa ettik. Son olarak, projeyi üretim ortamına hazır hâle getirmek en zor kısımdı. Yerel olarak bir demo için bir şey inşa edip çalıştırmak bir şey, yüksek kullanılabilirlik ve güvenilirlikle web’de dağıtmak tamamen başka bir meydan okuma. Üretimde tek bir hata bile kötü bir izlenim bırakabilir; bu yüzden istikrarı sağlamak kritik ve son derece zordu.

Accomplishments that we’re proud of

Accomplishments that we’re proud of

We are proud of successfully deploying DocuInsight and making it accessible for anyone to use. Building a production-ready application that integrates seamlessly with DocuSign, handles real-world usage, and delivers reliable AI-powered insights was a significant achievement. It is one thing to build locally for a demo, but ensuring everything works in a live environment with high uptime was a challenge we are proud to have overcome.

What we learned

Throughout this project, we realized that building a solution like DocuInsight was far more complex than we initially anticipated. Parsing legal documents, ensuring accuracy, and balancing AI capabilities with affordability required careful thought and constant iteration. We also learned the importance of proper video production. To ensure our demo effectively communicated our project’s value, we started working on the video two weeks before the deadline, using professional film equipment to deliver a polished final product. Additionally, scaling projects like this presented unique challenges. Calling advanced AI models to analyze content is computationally expensive, so we had to carefully balance using the most intelligent models with making the solution cost-effective. Finally, we conducted basic market research by browsing the web, speaking with potential users, and consulting lawyers to ensure DocuInsight could provide real value. This process taught us that building something meaningful requires validating its impact rather than simply creating a solution for the sake of it.

What’s next for DocuInsight

We plan to expand DocuInsight by developing more advanced AI agents for deeper contract analysis, refining vectorized datasets for better insights, and creating a more comprehensive directory of lawyers to connect signers and businesses with legal professionals in their area. Future features include tools like an SEC case search to reference legal precedents. Our goal is to deliver even more value to signers, senders, and businesses while fostering trust and transparency in agreements.