How devanandhnagesh/trademark-arbitration-decision-support-system works
Trademark DSS is a decision-support web application for Indian trademark arbitration disputes. An arbitrator submits dispute details in the browser; the API coordinates deterministic arbitrability analysis, landmark-case retrieval, LLM-generated legal analysis, and DOCX report assembly, then returns results for display. A separate lawyer-finder flow supports city search or browser geolocation. The README documents local vector retrieval and live IndiaKanoon lookup, LLM fallbacks, and Google Places fallback behavior. Some implementation details are unsampled, so those links are shown only where documented.
Main entry points: main.py Analysis API · landmark_retrieval_agent.py Landmark retrieval · form-handling.js Case form · lawyer_finder_agent.py Lawyer lookup
Components 18
Intake and UI
- Case form
frontend/form-handling.js - Results display
frontend/results-display.js - Analysis API
api/main.py
Legal analysis
- Arbitrability engine
agents/arbitrability_agent.py - Dispute classifier
agents/dispute_classifier.py - Landmark retrieval
agents/landmark_retrieval_agent.py - Landmark registry
config.py - Local case index
- IndiaKanoon
- Legal drafting
agents/gemini_agents.py - Adversarial analysis
agents/adversarial_legal_agent.py
Reports
- DOCX assembly
agents/report_generator.py
Lawyer finder
- Lawyer search UI
frontend/lawyer-finder.js - Lawyer lookup
agents/lawyer_finder_agent.py - Google Places
Other components
- Arbitrator
- LLM services
- Web search fallback
Connections 20
- Arbitrator → Case form: enters facts
README.md - Case form → Analysis API: submits form
frontend/form-handling.js - Analysis API → Arbitrability engine: evaluates
api/main.py - Analysis API → Landmark retrieval: retrieves cases
api/main.py - Landmark retrieval → Landmark registry: uses registry
agents/landmark_retrieval_agent.py - Landmark retrieval → Local case index: searches locally
README.md - Landmark retrieval → IndiaKanoon: fetches judgments
README.md - Landmark retrieval → Dispute classifier: uses classifier
agents/landmark_retrieval_agent.py - Analysis API → Legal drafting: drafts sections
api/main.py - Legal drafting → LLM services: calls with fallback
README.md - Analysis API → Adversarial analysis: generates analysis
api/main.py - Adversarial analysis → LLM services: uses Gemini
agents/adversarial_legal_agent.py - Analysis API → DOCX assembly: assembles report
api/main.py - Analysis API → Results display: returns results
api/main.py - Case form → Results display: displays response
frontend/form-handling.js - Arbitrator → Lawyer search UI: requests lawyers
README.md - Lawyer search UI → Analysis API: queries endpoints
README.md - Analysis API → Lawyer lookup: looks up lawyers
api/main.py - Lawyer lookup → Google Places: searches nearby
README.md - Lawyer lookup → Web search fallback: returns fallback link
README.md