Talok — Gestion des immeubles et lots (SOTA 2026)

Tables

properties                             — Tous les biens (lots + unitaires + wrappers)
├── id (UUID PK)
├── owner_id (FK profiles)
├── type (enum 14 types — inclut 'immeuble' pour le wrapper)
├── parent_property_id (UUID, FK properties) — non-null pour les lots, pointe vers le wrapper
├── legal_entity_id (FK legal_entities) — entité SCI/EIRL/etc.
├── adresse_complete, code_postal, ville, ...
├── loyer_hc, charges, depot_garantie, ...
└── etat, deleted_at

buildings                              — Métadonnées physiques + équipements communs
├── id (UUID PK)
├── owner_id (FK profiles) NOT NULL
├── property_id (FK properties) — pointe vers le wrapper type='immeuble', nullable
├── ownership_type (ENUM: 'full' | 'partial') DEFAULT 'full'  ← à ajouter
├── total_lots_in_building (INTEGER nullable)  ← à ajouter (informatif si partial)
├── name, adresse_complete, code_postal, ville, departement
├── floors, construction_year, surface_totale
├── has_ascenseur, has_gardien, has_interphone, has_digicode
├── has_local_velo, has_local_poubelles, has_parking_commun, has_jardin_commun
├── notes, deleted_at
└── created_at, updated_at

building_units                         — Plan d'étage (floor/position) + ref lot
├── id (UUID PK)
├── building_id (FK buildings) ON DELETE CASCADE NOT NULL
├── property_id (FK properties) NULLABLE — la property lot correspondante
├── floor, position (UNIQUE per building)
├── type (appartement|studio|local_commercial|parking|cave|bureau)
├── template (studio|t1|t2|t3|t4|t5|local|parking|cave)
├── surface, nb_pieces, loyer_hc, charges, depot_garantie
├── status (vacant|occupe|travaux|reserve)
├── current_lease_id (FK leases) ON DELETE SET NULL
└── created_at, updated_at

Relations

properties (type='immeuble', wrapper)
    ↑ property_id
    ↑
buildings
    ↓ id
    ↓
building_units
    ↓ property_id
    ↓
properties (type≠'immeuble', le lot réel)
    ↑ parent_property_id → wrapper

Le wrapper property existe pour faire la jointure entre buildings et les lots. Il n'est jamais exposé comme un bien dans les listes utilisateur.

ownership_type (à ajouter)

Backfill : tous les records existants → 'full' (comportement actuel).

3. Quota forfait

Un immeuble = N biens dans le quota où N est le nombre de lots du user.

buildings                 → ne consomme pas de slot
properties type=immeuble  → ne consomme pas de slot (wrapper technique)
properties (lots)         → consomme 1 slot chacun
properties (unitaires)    → consomme 1 slot chacun

Fichier : lib/subscriptions/check-limit.ts — filtre neq('type', 'immeuble').

Exemple : SCI Marie-Line possède 2 lots dans Route du Phare (ownership_type='partial', total=6) + 1 maison standalone = 3 biens dans le quota.

4. Wizard de création

Étapes pour type='immeuble'

1. type_bien              — sélection "Immeuble (entier ou partiel)"
2. address                — adresse du bâtiment
3. ownership_type         — NEW : radio full/partial + total_lots_in_building
4. building_config        — BuildingVisualizer + lots de l'utilisateur
5. photos                 — photos extérieures + parties communes
6. recap                  — récapitulatif + submit

Submit → INSERTs atomiques

POST /api/properties/[id]/building-units fait en transaction :

1. Upsert 1 ligne buildings (avec ownership_type, total_lots_in_building)
2. Pour chaque lot : INSERT 1 ligne properties (type != 'immeuble', parent_property_id = wrapper.id, etat='published')
3. BULK INSERT N lignes building_units (avec property_id pointant vers chaque lot)

Source : app/api/properties/[id]/building-units/route.ts:49-269.

Mode partial

• L'utilisateur configure uniquement ses propres lots (pas les 6 de l'immeuble physique s'il n'en possède que 2)
• Le visualiseur affiche les emplacements des autres lots en grisé non-interactif avec label "Appartient à un autre copropriétaire"
• Les équipements parties communes (ascenseur, gardien, ...) deviennent informatifs : "Géré par le syndic"

5. Routes

UI (pages)

URL pattern : /owner/buildings/[id] utilise id = property_id du wrapper (pas building_id). Le server component résout le building_id via buildings.property_id.

API

6. Page /owner/buildings/[id] — structure

La page est un hub managérial à 3 sections stackées verticalement (pas de tabs) :

┌─────────────────────────────────────────────────┐
│ HEADER                                          │
│   Nom immeuble · adresse · année · surface      │
│   Badge ownership : "Propriétaire unique" ou    │
│                     "Copropriétaire · X/M lots" │
│   CTA : Modifier | Gérer les lots              │
├─────────────────────────────────────────────────┤
│ SECTION 1 — Plan des lots                       │
│   <BuildingVisualizer readOnly />               │
│   Lots user = cliquables (→ détail du lot)     │
│   Lots externes (partial) = grisés              │
├─────────────────────────────────────────────────┤
│ SECTION 2 — Lots                                │
│   Grille <BuildingLotCard /> réutilisable       │
│   Par card : photo, étage/position, type,       │
│   surface, loyer, statut, nom locataire, bail   │
│   Clic → /owner/properties/[lot.property_id]   │
├─────────────────────────────────────────────────┤
│ SECTION 3 — Documents de gestion                │
│   DPE collectif, règlement copro, PV AG,        │
│   attestation PNO, contrats entretien, devis    │
│   Upload / aperçu / suppression                 │
└─────────────────────────────────────────────────┘

Composant BuildingLotCard (à créer dans components/buildings/BuildingLotCard.tsx) :

• Props : { lot: PropertyRow, unit: BuildingUnitRow, lease?: LeaseRow, tenant?: ProfileRow }
• Clic → Link vers /owner/properties/${lot.id} (pas /owner/buildings/${building_id}/units/${unit_id} — on veut la vraie fiche du bien)
• Toujours afficher la pastille statut (vacant/occupé/travaux/réserve)

7. Page /owner/properties/[id] pour un lot

Même composant que pour un bien unitaire, mais avec différences :

• Breadcrumb : Mes biens → Immeuble [X] → Lot [Y]
• Header : badge "Lot dans immeuble · [adresse]" cliquable → /owner/buildings/[parent_property_id]
• Toutes les tabs existantes fonctionnent (bail, finance, documents, tickets, etc.)

Le lot est traité comme un bien autonome pour tout ce qui est bail/locataire/factures — seul le "wrapping" managérial est groupé.

8. Check d'accès — fix 404 "Immeuble introuvable"

Bug connu : app/owner/buildings/[id]/page.tsx:89-116 filtre owner_id = profile.id sans tenir compte des membres SCI (entity_members) ni du cas building.property_id IS NULL. Résultat : 404 pour des immeubles qui existent et sont légitimement accessibles.

Fix : copier le pattern de app/api/invoices/[id]/route.ts:78-106 :

1. Query property/building SANS filtre owner (service client)
2. Autoriser si :
   - property.owner_id === profile.id
   - OU profile.id ∈ (SELECT user_id FROM entity_members WHERE entity_id = property.legal_entity_id)
3. Sinon → 403 access-denied (page dédiée distincte du 404 not-found)
4. Si building.property_id IS NULL → rendre quand même avec buildingRecord direct

9. Surfacer les lots dans "Mes biens"

Filtre actuel (app/owner/properties/page.tsx:181) :

filtered = filtered.filter(p => p.type !== "immeuble" && !p.parent_property_id);

À remplacer par :

filtered = filtered.filter(p => p.type !== "immeuble");
// Les lots avec parent_property_id apparaissent maintenant comme des biens

Le badge "Immeuble · [adresse]" est ajouté dans PropertyCard :

• Condition : property.parent_property_id != null
• Fetch léger en batch : SELECT id, adresse_complete FROM properties WHERE id IN (distinct parent_property_ids) au niveau de la page (pas N+1)
• Link vers /owner/buildings/${parent_property_id}

10. Gestion locative — scoping

Règle : un bail ne pointe jamais directement vers le wrapper type='immeuble'. Il pointe toujours vers un lot réel ou un bien unitaire.

11. Suppression (cascade)

Contraintes SQL actuelles

• building_units.building_id → buildings.id ON DELETE CASCADE
• buildings.property_id → properties.id ON DELETE SET NULL
• building_units.current_lease_id → leases.id ON DELETE SET NULL

Comportement DELETE immeuble

app/api/buildings/[id]/route.ts:163-235 :

1. Refuse si au moins 1 lot occupé
2. Soft-delete (deleted_at = NOW()) préféré, fallback hard-delete
3. Ne supprime pas les properties lots enfants → orphelines

Comportement DELETE lot

app/api/buildings/[id]/units/[unitId]/route.ts :

1. .delete() physique sur building_units
2. Ne supprime pas la property liée via parent_property_id

TODO : ajouter un trigger de cleanup ou un soft-delete cascade sur les properties lots.

12. Distinction stricte avec le module /syndic

Un utilisateur peut avoir les deux rôles (syndic bénévole d'une copro dont il est aussi copropriétaire), mais les modules restent strictement séparés pour ne pas mélanger responsabilités légales.

13. Règles dev obligatoires

1. Check d'accès : jamais de filtre owner_id seul sur les pages/routes building — toujours copier le pattern entity_members.
2. Service client : toutes les lectures DB côté SSR/API utilisent getServiceClient(), jamais createClient() user-scoped (évite récursion RLS 42P17).
3. URL pattern : /owner/buildings/[id] utilise property_id du wrapper, pas building_id. Le server component résout via buildings.property_id = property_id.
4. BuildingLotCard : lien vers /owner/properties/[lot.property_id], jamais vers une fiche "lot" dédiée (qui n'existe pas).
5. Wizard : le type immeuble déclenche BUILDING_STEPS à la place de DEFAULT_STEPS. L'étape building_config utilise BuildingVisualizer + BuildingConfigStep.
6. Quota : les lots comptent, le wrapper ne compte pas. Filtre .neq('type', 'immeuble') dans check-limit.ts.
7. RLS : toutes les policies sur buildings, building_units, properties utilisent public.user_profile_id() — jamais auth.uid().
8. Regen types : après toute migration buildings, lancer npx supabase gen types typescript et commit lib/supabase/database.types.ts.

14. Fichiers clés

15. Skill sibling (Cursor)

Pour les règles de prévention de régressions spécifiques au property system (RLS, types, rate limiting, Zod enums), voir aussi .cursor/skills/property-building-guard/SKILL.md et .cursor/skills/sota-property-system/SKILL.md.