convez.ai
PluginFinanceiroIntermediário
noamrazbuilds

Obligation Tracker - Rastreador de Obrigações Contratuais

noamrazbuilds/obligation-tracker

IA para extração e rastreamento de obrigações contratuais com dashboard visual

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin Python que extrai e rastreia obrigações contratuais, prazos, SLAs e entregáveis usando análise alimentada por IA. Oferece dashboard com visualização em calendário, scores de conformidade e tabelas filtráveis para equipes jurídicas internas.

Instalação

$npx convez-ai noamrazbuilds/obligation-tracker

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 8 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Departamentos jurídicos rastreando prazos e SLAs em múltiplos contratos
  • Análise de risco de conformidade e health scores de portfólio contratual
  • Automação de extração de obrigações em PDFs e DOCXs via Claude AI

Veredito

Ferramenta robusta e bem estruturada para compliance contratual. Combina extração IA (Claude) com dashboard intuitivo, deploy facilitado via Railway, e modo offline com dados sintéticos. Ideal para equipes jurídicas que precisam automação sem configuração complexa.

README

A tradução para o português deste README ainda está na fila.

Contract Obligation Tracker & Compliance Dashboard

Extract and track contract obligations, deadlines, SLAs, and deliverables. Upload contracts (PDF/DOCX), get AI-powered obligation extraction, and monitor compliance through a visual dashboard with calendar views, health scores, and filterable tables.

Getting Started

Option 1: Hosted Version

Coming soon — a hosted version will be available at a public URL.

Option 2: Run Locally (Recommended)

./start.sh        # macOS / Linux
start.bat         # Windows

This automatically sets up Python, installs dependencies, starts the API and dashboard, and opens your browser. No configuration needed to explore with sample data.

Option 3: Docker

docker compose up

Then open http://localhost:8501.

Optional: Enable AI Extraction

To extract obligations from your own contracts using AI, set your Anthropic API key:

# Create a .env file
echo "ANTHROPIC_API_KEY=your-key-here" > .env

Without an API key, you can still:

  • Load and explore sample data (8 synthetic contracts, ~45 obligations)
  • Manually add contracts and obligations
  • Use all dashboard and calendar features

Features

  • Upload contracts — PDF and Word (.docx) formats, up to 50 MB
  • AI-powered extraction — Automatically identifies obligations, deadlines, SLAs, penalties, and responsible parties
  • Dashboard — Portfolio summary with health scores, status breakdowns, and risk analysis
  • Calendar view — Visual month/week/day view of upcoming obligations, color-coded by risk
  • Filterable tables — Filter by contract, type, status, risk level, responsible party, and date range
  • Health scores — Per-contract compliance score based on completion rate, overdue penalties, and risk exposure
  • Status tracking — 6 statuses (Pending, In Progress, Completed, Overdue, Waived, Escalated) with full audit trail
  • Manual entry — Add contracts and obligations manually; records indicate AI vs. manual source
  • Sample data — 8 synthetic contracts with ~45 pre-built obligations for immediate exploration

Deploy Your Own

Railway (One-Click Cloud Deploy)

  1. Fork this repo
  2. Connect to Railway
  3. Set environment variables: ANTHROPIC_API_KEY (optional)
  4. Deploy — Railway uses Dockerfile.railway automatically

For Developers

API Documentation

With the API running, visit http://localhost:8000/docs for interactive Swagger documentation.

Project Structure

obligation-tracker/
├── ot_app/                  # FastAPI backend
│   ├── main.py              # App entry point
│   ├── config.py            # Settings (pydantic-settings)
│   ├── database.py          # SQLAlchemy engine and session
│   ├── models/              # ORM models (Contract, Obligation, StatusHistory)
│   ├── schemas/             # Pydantic request/response schemas
│   ├── routers/             # API route modules
│   ├── services/            # Business logic (extraction, scoring, demo)
│   └── utils/               # Document parsing, section detection, file handling
├── ot_frontend/             # Streamlit dashboard
│   ├── app.py               # Main entry point
│   ├── api_client.py        # HTTP client for API
│   └── pages/               # Dashboard, Contracts, Obligations, Calendar, Settings
├── tests/                   # pytest test suite
├── data/sample/             # Synthetic sample contracts and obligations
├── pyproject.toml           # Dependencies and project config
├── start.sh / start.bat     # One-command launch scripts
├── Dockerfile               # API container
├── docker-compose.yml       # Multi-service orchestration
└── Dockerfile.railway       # Single-container cloud deploy

Tech Stack

  • Backend: Python 3.11+, FastAPI, SQLAlchemy 2.0, Pydantic v2
  • AI: Anthropic API (Claude) for obligation extraction
  • Document parsing: python-docx, PyMuPDF
  • Database: SQLite (prototype), designed for PostgreSQL migration
  • Frontend: Streamlit with streamlit-calendar
  • Deployment: Docker, Railway

Running Tests

pip install -e ".[dev]"
pytest

Key API Endpoints

MethodEndpointDescription
GET/api/v1/contractsList contracts
POST/api/v1/contracts/uploadUpload contract file
POST/api/v1/contracts/{id}/extractAI extraction
GET/api/v1/obligationsList/filter obligations
PATCH/api/v1/obligations/{id}/statusChange status
GET/api/v1/obligations/calendarCalendar events
GET/api/v1/dashboard/summaryPortfolio stats
POST/api/v1/demo/loadLoad sample data

License

MIT License — Copyright (c) 2026 Noam Raz and Pleasant Secret Labs

Ver o original no GitHub

Bom para

Relacionados