Skip to content

Milestones

Detailed breakdown of each milestone with included features, completion criteria, and dependencies.

Objective: Transform Juca from a fullstack monolith to a lightweight frontend hub with a professional UI and Valter integration.

Features:

FeatureIssuePriorityStatus
UI reset (Fintool/Perplexity-style, Liquid Legal design)#273P0Planned
Adapter layer for external agentsNewP0Planned
Juca → Valter integration (search, verify, graph)NewP0Planned
Fix 72 failing test files#270P1Planned
Clean phantom dependenciesP1Done
Update README.mdNewP1Planned

Completion criteria:

  • Juca renders results from Valter API (not local backend)
  • UI follows Fintool-inspired design with composer, result cards, citation panel
  • Tests passing in CI (0 failures)
  • README reflects hub architecture

Objective: Deliver the full 4-phase briefing flow with the new UI, consuming Valter as backend.

Features:

FeatureIssuePriorityValter Endpoint
F1: Interactive Diagnosis#285P1/v1/factual/*
F2: Interactive Precedents#286P1/v1/retrieve, /v1/similar_cases
F3: Risks & Opportunities#287P1/v1/graph/optimal-argument
F4: Contextual Delivery#288P1— (client-side generation)
Personalized Briefing PDF#289P1
Remove duplicated backend (src/lib/backend/)NewP1
Timeout + AbortController end-to-end#238P2

Completion criteria:

  • Full F1→F2→F3→F4 flow functional with real Valter data
  • PDF reflects user selections across all 4 phases
  • Zero dependency on local backend for core features
  • E2E tests cover the briefing flow

Dependencies: v0.3 (adapter layer and Valter integration must be complete)


Objective: Stabilize, expand graph capabilities, and resolve technical debt.

Features:

FeatureIssuePriority
Divergence/trend comparison via Valter graph#155P2
Advanced selection criteria#160P2
Export legal memo (PDF + DOCX)#158P2
Post-generation validation via Valter /v1/verify#207P2
Data consistency fixes#268, #274P2
Hallucination reduction (prompt/schema adjustments)#210P2
E2E tests in CI (Playwright in GitHub Actions)P2

Completion criteria:

  • Valter graph features accessible via UI
  • Consistent data (no orphan decisions)
  • E2E running in CI

Objective: Expand the hub to support multiple agents and prepare for scale.

Features:

FeatureIssuePriority
Leci integration (federal legislation)P2
KG exploration screen (MinistroProfile, CompareMinistros)#281P2
LLM cost ledger#232P3
SQLite → PostgreSQL migration#231P3
BOLA fix (session ownership validation)#227P3
Inject Q7/Q14/Q19 fields#280P3

Completion criteria:

  • Juca consumes 2+ agents (Valter + Leci)
  • Cost tracking functional
  • Sessions protected by ownership checks

Objective: Production-ready product for external users.

Features:

FeatureIssuePriority
Skills Platform (modular legal skills)#193P3
Multi-tenancy and billingP3
PWA configurationP3
Corpus expansion (TJs, TRFs, TST via agents)P3
Complete public documentationP3

Completion criteria:

  • External users can sign up and use the product
  • Billing functional
  • Documentation published