---
suivi: 1790
date: 2026-10-05
sujet: Dépôt de documents et options sur l'acte
chantier: foncier / actes
type: evolution
statut: poussé
hash:
fichiers:
  - database/migrations/2026_10_05_174500_create_acte_options_table.php
  - app/Models/ActeOption.php
  - app/Models/ActeFoncier.php
  - app/Services/Foncier/ActeOptionService.php
  - app/Services/Foncier/ParcelleCreationUnitaireService.php
  - app/Http/Controllers/Foncier/ActeFoncierController.php
  - app/Http/Controllers/Foncier/ParcelleController.php
  - app/Http/Controllers/Foncier/Concerns/ManagesFoncierEntityDocuments.php
  - app/Support/Foncier/FoncierReferentiels.php
  - resources/js/Components/Foncier/EntityDocumentsPanel.vue
  - resources/js/Components/Foncier/ActeOptionsForm.vue
  - resources/js/Pages/Foncier/ActesFonciers/Create.vue
  - resources/js/Pages/Foncier/ActesFonciers/Show.vue
  - resources/js/Pages/Foncier/Parcelles/Create.vue
  - routes/web.php
  - database/data/journal_mises_a_jour_post_2026_06_12.php
  - tests/Unit/ActeOptions1790SourceTest.php
  - tests/Unit/Parcelle1510SourceTest.php
  - docs/suivi/SUIVI_1790_actes_documents_options.md
---

# SUIVI #1790 — documents et options d'un acte

Fiches lues : #1788 (document de servitude conservé dans Documents, marqueur de contexte, confirmation au retrait), #1789 (diagnostic valorisation, aucun code : prix, surfaces et liens acte-parcelle non touchés), #1510 (création unitaire : Non reste « détenue sans acte »). La clé étrangère est `acte_foncier_id`, comme les autres liens vers `actes_fonciers`. Pas d'index unique en base : une option figée retirée puis recochée restaure la ligne, « autre » peut être répété.

## PROMPT ENVOYÉ

Zone de dépôt habituelle sur Nouvel acte. Création de parcelle : infos avancées dépliées ; « Détenue par le groupe » affiche tout de suite la carte Acte d'acquisition ; « Propriétaire externe » ne poste aucun champ d'acte. Document joint à l'acte créé depuis la parcelle. Options figées sur Nouvel acte et la fiche, pas sur le formulaire parcelle. Décocher confirme. Historique. Acte verrouillé en lecture seule.

## Mapping

| Libellé affiché | Valeur postée | Libellé relu |
|---|---|---|
| Détenue par le groupe | propriete_mode=groupe | Détenue par le groupe |
| Propriétaire externe | propriete_mode=externe | Propriétaire externe, aucun champ acte |
| Non | acte_mode=non | Non (détenue sans acte) |
| Rattacher à un acte existant | acte_mode=rattacher + acte_id | Rattacher |
| Créer un nouvel acte | acte_mode=creer + champs acte_* | Créer |
| Servitude | code=servitude | Servitude |
| Bien occupé | code=bien_occupe | Bien occupé |
| Complément de prix | code=complement_prix | Complément de prix |
| Réserve de jouissance | code=reserve_jouissance | Réserve de jouissance |
| Pacte de préférence | code=pacte_preference | Pacte de préférence |
| Autre | code=autre + titre (obligatoire, 150 max) | Autre |
| Décocher | code absent du payload | ligne retirée, commentaire effacé, document conservé |

## SYNTHÈSE

Le dépôt différé réutilise le panneau Documents (cadre pointillé, liste, Retirer). Limites inchangées : 15 fichiers, 10 Mo, mêmes types. Les documents d'option portent le code, ou `autre-{id}` pour Autre, et restent dans la liste de l'acte. L'historique de l'acte trace l'ajout, la modification et le retrait (champ Option). Les montants, surfaces, liens et statuts de parcelle ne sont pas modifiés.

Bundles : `Create-ftsc2ZRo.js` (Nouvel acte), `Show-DUu2eLLm.js` (fiche acte), `Create-DlcNSdyb.js` (création parcelle), `ActeOptionsForm-DE5ZOOAc.js`, `EntityDocumentsPanel-CtGlVjs4.js`.

## DÉPLOIEMENT-TEST

git pull origin main
php artisan view:clear
php artisan route:clear
php artisan migrate --force
php artisan journal:sync

1. Nouvel acte : zone de dépôt, deux fichiers, acte créé avec ses documents.
2. Parcelle détenue par le groupe : carte Acte visible d'emblée, créer un acte avec un document.
3. Propriétaire externe : pas de carte Acte.
4. Infos avancées dépliées à l'ouverture.
5. Fiche acte : Servitude + commentaire + document, Complément de prix, deux Autre avec titres ; historique ; décocher Servitude confirme, le document reste.
6. Ajout de document sur une parcelle et une promesse.
7. Compte sans droit : refus serveur.

## LEÇON

Le panneau Documents garde les chaînes déjà testées (Glisser-déposer, max Mo, contexte réponse). Le mode différé n'envoie rien tout seul : les fichiers partent avec le formulaire. Un propriétaire externe qui posterait des champs d'acte est ignoré côté serveur. `Parcelle1510SourceTest` échoue déjà sur `societeDetentriceEditable` dans la fiche parcelle, fichier non modifié par ce lot.