effort_report

Overview

L’outil effort_report genere des rapports structures d’effort R&D sur une periode, essentiels pour les credits d’impot (CIR/CII/JEI).

Parametres

project string requis

Project ID, ou * pour tous les projets

period_start string requis

Date ISO de debut (inclusive)

period_end string requis

Date ISO de fin (exclusive)

format string défaut: summary

Format	Description
`summary`	Métriques clés uniquement
`detailed`	Listing par entrée (supporte `limit`)
`valorisation`	Structure complète pour valorisation CIR/CII
`markdown`	Template document structuré pour contrôle fiscal
`dossier`	Ventilation mois par mois (utile audits multi-période)

Formats de sortie

summary

{
  "project": "mon-api",
  "period": {"start": "2026-01-01", "end": "2026-07-01"},
  "total_hours": 127.5,
  "total_entries": 42,
  "by_category": {"CODE": 30, "RESEARCH": 12}
}

valorisation

Structure complète pour la valorisation CIR/CII :

{
  "project": "mon-api",
  "period": {...},
  "total_hours": 127.5,
  "objectives": [
    {
      "name": "Optimisation latence API",
      "hours": 45.5,
      "entries": 12,
      "timeline": ["2026-01", "2026-02", "2026-03"]
    }
  ],
  "asset_types_breakdown": {
    "logiciel": 100.0,
    "base_donnees": 27.5
  },
  "cir_indicators": {
    "has_research_activity": true,
    "has_defined_objectives": true,
    "has_continuous_effort": true,
    "research_ratio": 0.28
  },
  "proof_chain": {
    "attestation_count": 42,
    "first_attestation": "2026-01-05T10:00:00Z",
    "last_attestation": "2026-06-28T16:30:00Z"
  }
}

markdown

Génère un document structuré pour contrôle fiscal :

# Rapport R&D - mon-api
## Periode : 2025-01-01 au 2025-07-01

### Synthese
- **Heures totales** : 127.5h
- **Entrees certifiees** : 42
- **Ratio R&D** : 28%

### Indicateurs CIR
- [x] Activite de recherche documentee
- [x] Objectifs techniques definis
- [x] Effort continu (>3 mois)

### Objectifs R&D
| Objectif | Heures | Periode |
|----------|--------|---------|
| Optimisation latence API | 45.5h | Jan-Mar 2025 |
...

Exemples

Rapport de valorisation CIR

Génère le rapport de valorisation du premier semestre 2026 pour mon-api

Rapport global multi-projets

Rapport R&D de tous mes projets pour 2026

effort_report(project="*", period_start="2026-01-01", period_end="2027-01-01", format="summary")

Dossier mensuel (audit)

Génère le dossier mensuel R&D pour mon-api sur 2026

effort_report(project="mon-api", period_start="2026-01-01", period_end="2027-01-01", format="dossier")