Legal Document Analysis Platform

A full-stack web application for searching, analyzing, and visualizing relationships between legal documents, names, and entities. This platform provides powerful tools for exploring court filings, flight logs, contact lists, and other legal documents while tracking connections between mentioned individuals.

🚀 Features

• Document Import & Analysis: Upload and analyze various types of legal documents
• AI-Powered Insights: Advanced document analysis using Google's Gemini AI
• Network Visualization: Interactive graphs showing relationships between entities
• Timeline View: Chronological display of legal events and documents
• Name Analysis: Track individuals mentioned across multiple documents
• Export Functionality: Export data in CSV, JSON, and PDF formats
• Real-time Search: Fast document and entity search capabilities
• Responsive Design: Works seamlessly on desktop and mobile devices

🛠 Tech Stack

Frontend

• React 18 with TypeScript
• Tailwind CSS for styling
• shadcn/ui component library built on Radix UI
• TanStack React Query for server state management
• Wouter for client-side routing
• D3.js for data visualization
• Vite for development and building

Backend

• Node.js with Express.js
• TypeScript with ESM modules
• Drizzle ORM for type-safe database operations
• PostgreSQL (Neon Database)
• Google Gemini AI integration
• RESTful API architecture

Database & Infrastructure

• Neon Database (Serverless PostgreSQL)
• Connection pooling for performance
• Drizzle migrations for schema management

📋 Prerequisites

• Node.js 20 or higher
• PostgreSQL database (Neon Database recommended)
• Google AI API key (for AI insights feature)

🚀 Getting Started

1. Clone and Install

# Install dependencies
npm install

2. Environment Setup

Create a .env file in the root directory:

DATABASE_URL=your_neon_database_url
GOOGLE_AI_API_KEY=your_google_ai_api_key
NODE_ENV=development

3. Database Setup

# Push database schema
npm run db:push

4. Development

# Start development server
npm run dev

The application will be available at http://localhost:5000

5. Production Build

# Build for production
npm run build

# Start production server
npm start

📁 Project Structure

├── client/                 # React frontend
│   ├── src/
│   │   ├── components/     # Reusable UI components
│   │   ├── pages/          # Application pages
│   │   ├── hooks/          # Custom React hooks
│   │   └── lib/            # Utility functions
├── server/                 # Express backend
│   ├── ai-service.ts       # AI integration
│   ├── db.ts              # Database configuration
│   ├── routes.ts          # API routes
│   └── storage.ts         # Data access layer
├── shared/                # Shared types and schemas
└── migrations/            # Database migrations

🔧 Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm start - Start production server
• npm run check - Type checking
• npm run db:push - Push database schema

🌐 API Endpoints

Documents

• GET /api/documents - List all documents
• GET /api/documents/:id - Get specific document
• POST /api/documents - Upload new document

Names & Entities

• GET /api/names - List all names/entities
• GET /api/names/:id - Get specific name details

Network & Relationships

• GET /api/network - Get relationship network data

AI Insights

• POST /api/ai/analyze - Generate AI insights for documents
• GET /api/ai/status - Check AI service status

Dashboard

• GET /api/dashboard/stats - Get dashboard statistics
• GET /api/timeline - Get timeline events

🔐 Security & Privacy

• All data is sourced from publicly available court documents
• Secure API key management through environment variables
• Rate limiting on API endpoints
• Input validation and sanitization
• CORS protection enabled

⚠️ Important Disclaimer

This platform analyzes publicly available court documents and legal filings. Association or mention in documents does not imply guilt or wrongdoing. All data is sourced from verified legal records.

🚀 Deployment

Replit Deployment

This project is configured for easy deployment on Replit:

1. Push your changes to the repository
2. The build process will automatically run: npm run build
3. The production server will start with: npm run start
4. Your app will be available on your Replit domain

Environment Variables

Make sure to set the following in your Replit Secrets:

• DATABASE_URL - Your Neon database connection string
• GOOGLE_AI_API_KEY - Your Google AI API key

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Data Sources

• U.S. Department of Justice releases
• Federal court document unseals
• Public flight manifest records
• Verified legal depositions

All sources are cross-referenced and verified for authenticity.

---

For more information about the platform architecture and features, see the project documentation.