Droit Article Lookup

Tier: Starter | Type: Tool | Category: Legal | Version: 1.0.0

Recherche et consultation d'articles dans les principaux codes juridiques francais. Permet aux avocats et juristes d'acceder rapidement au texte integral des articles du Code Civil, Code du Commerce, Code du Travail et Code de la Consommation.

1. Overview

Plugin Name: Droit Article Lookup Slug: droit-article-lookup Required Tier: starter Plugin Type: tool (REST API endpoints) Category: Legal Author: Dryade License: DSUL

What It Does

Fournit un acces structure aux articles des codes juridiques francais. Recherche par numero d'article ou par mots-cles, avec metadonnees completes (livre, titre, chapitre, references croisees).

Key Capabilities

Consultation d'article par numero dans 4 codes juridiques
Recherche par mots-cles dans le texte et les titres des articles
References croisees entre articles connexes
Index thematique par domaine juridique
Mode demo avec articles synthetiques realistes

2. User Stories

Primary User Stories

US-1: Consultation rapide d'un article

En tant qu'avocat, je veux consulter un article du Code Civil par son numero pour verifier une reference lors de la redaction d'un contrat.

Acceptance Criteria:

[ ] Saisie du code et du numero retourne le texte integral
[ ] Metadonnees (livre, titre, chapitre) affichees
[ ] References croisees listees

US-2: Recherche thematique

En tant que juriste, je veux rechercher des articles par mots-cles pour trouver les dispositions applicables a un dossier.

Acceptance Criteria:

[ ] Recherche par mots-cles retourne les articles pertinents
[ ] Filtrage possible par code juridique
[ ] Resultats ordonnes par pertinence

Edge Cases

Numero d'article inconnu : retourne message d'erreur clair
Code juridique inconnu : retourne la liste des codes disponibles
Recherche sans resultat : retourne success=true avec total=0

3. Architecture

Component Diagram

+------------------+     +------------------+     +------------------+
|   Plugin Router  | --> |  Lookup Logic    | --> |  Data Provider   |
|  /droit-article- |     |  routes.py       |     |  (mock / real)   |
|  lookup/*        |     +------------------+     +------------------+
+------------------+            |
                          +-----v------+
                          |  Demo Data |
                          |  data/*.json|
                          +------------+

Components

| Component | File | Responsibility | |-----------|------|----------------| | Router | routes.py | API endpoints, validation | | Plugin | plugin.py | Lifecycle, config management | | Data | data/ | Articles de demonstration (5 fichiers JSON) |

Dependencies

Internal: core.plugins.PluginProtocol, core.plugin_config_store.PluginConfigStore
External: None (standard library only in mock mode)
Plugin: None

4. API Spec

REST Endpoints

| Method | Path | Description | Auth | |--------|------|-------------|------| | GET | /api/plugins/droit-article-lookup/article/{code}/{numero} | Consulter un article | Yes | | POST | /api/plugins/droit-article-lookup/search | Recherche par mots-cles | Yes | | GET | /api/plugins/droit-article-lookup/codes | Lister les codes disponibles | No | | GET | /api/plugins/droit-article-lookup/status | Statut du plugin | No |

Request/Response Examples

Consulter un article

// GET /article/code_civil/1101
// Response
{
    "success": true,
    "article": {
        "code": "Code Civil",
        "numero": "1101",
        "titre": "Definition du contrat",
        "texte": "Le contrat est un accord de volontes...",
        "livre": "Livre III",
        "references_croisees": ["1102", "1103", "1104"]
    }
}

5. Data Flow

Processing Pipeline

1. Utilisateur soumet une requete (consultation ou recherche)
2. Router valide les parametres
3. Mode mock charge les articles depuis data/
4. Filtrage et formatage des resultats
5. Reponse JSON structuree avec metadonnees

Demo Data Description

Le repertoire data/ contient :

code_civil_articles.json : 5 articles du Code Civil (contrats, responsabilite)
code_commerce_articles.json : 3 articles du Code du Commerce (societes, concurrence)
code_travail_articles.json : 4 articles du Code du Travail (rupture, licenciement)
code_consommation_articles.json : 3 articles du Code de la Consommation (clauses abusives)
index_thematique.json : Index par domaine juridique

Total : 5 fichiers couvrant 15 articles dans 4 codes juridiques.

6. Security Considerations

Data Handling

PII: Non - donnees juridiques publiques synthetiques
Encryption: N/A en mode mock ; mode reel via HTTPS (Legifrance API)
Data Retention: Aucune donnee persistee ; requete/reponse stateless

External API Keys

Aucune cle API requise en mode mock. Mode reel necessite un acces Legifrance PISTE.

Isolation

Plugin execute dans le contexte sandboxe du core plugin loader
Pas d'acces direct a la base de donnees
Pas d'ecriture fichier hors du repertoire du plugin

7. Test Plan

Test Classes

| Class | Tests | Coverage Target | |-------|-------|----------------| | TestPluginAttributes | 7 | 100% champs manifeste | | TestPluginRouter | 9 | Tous les endpoints | | TestPluginConfig | 2 | Configuration | | TestDemoData | 9 | Tous les fichiers |

Running Tests

cd dryade-plugins
python -m pytest starter/droit-article-lookup/tests/ -x -v --tb=short

8. Deployment Notes

Requirements

Aucun package supplementaire requis au-dela de Dryade core.

Configuration

{
    "data_source": "mock"
}

Compatibility

Min Dryade Version: 1.0.0
Python: >=3.11

9. User Guide

Getting Started

Verifier que votre instance Dryade dispose d'une licence starter ou superieure
Installer le plugin via le marketplace ou dryade-pm push
Utiliser /article/{code}/{numero} pour consulter un article
Utiliser /search pour une recherche par mots-cles

Common Workflows

Workflow 1: Consulter un article du Code Civil

GET /article/code_civil/1104
Lire le texte integral avec references croisees
Suivre les references pour approfondir

Workflow 2: Recherche thematique dans le Code du Travail

POST /search avec query: "licenciement" et codes: ["code_travail"]
Parcourir les articles pertinents
Consulter les details de chaque article

10. Screenshots

Les captures d'ecran seront ajoutees apres l'integration UI.

11. Changelog

1.0.0 (2026-03-05)

Version initiale
Recherche dans Code Civil, Code du Commerce, Code du Travail, Code de la Consommation
Mode demonstration avec 15 articles synthetiques
Recherche par numero et par mots-cles
Index thematique

Future Roadmap

[ ] Mode reel via API Legifrance PISTE
[ ] Historique des modifications legislatives
[ ] Jurisprudence associee aux articles
[ ] Export PDF des articles

Droit-Article-Lookup

Description

Screenshots

Details