Juridiques

Juridiques is an AI-assisted legal workspace focused on Brazilian legal workflows.
This repository is public and follows secure-by-default contribution practices.

Monorepo Structure

• backend/: FastAPI API, auth/RBAC, agents orchestration, KPIs, migrations (alembic).
• frontend/: React + TypeScript + Vite PWA.
• desktop/: Electron shell for packaging the frontend.
• docs/: architecture, agent and product documentation.

Quick Start

1. Copy environment template:
   • cp .env.example .env
2. Backend:
   • cd backend && python3.11 -m venv .venv && source .venv/bin/activate
   • pip install -r requirements.txt
   • uvicorn main:app --reload --port 8000
3. Frontend:
   • cd frontend && npm install && npm run dev

Common Commands

• Backend tests: cd backend && pytest -q
• Frontend lint: cd frontend && npm run lint
• Frontend unit tests: cd frontend && npx vitest run
• Frontend E2E: cd frontend && npx playwright test
• Docker stack: docker compose up --build

Security for Public Contributions

• Never commit real credentials, API keys, private keys, tokens, or production URLs with secrets.
• Use only .env.example for templates; local secrets must stay in .env (git-ignored).
• Vulnerability reports: see SECURITY.md.

Additional Docs

• English overview: README_EN.md
• Portuguese overview: README_PT.md
• Architecture: docs/architecture.md
• Contributor guide: AGENTS.md