Référence API, RPC et base de données

4) Validation anti-chevauchement (même rang : croisement partiel interdit, imbrication tolérée). Fermetures exclues, périodes sans dates ignorées. Miroir SQL EXACT de la fonction pure TS periodsPartialOverlap : intersection ensembliste des jours couverts.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Function to add a legal record =====================================================

P2.1 §120 — Approuve : re-dispatch vers le writer structuré (metadata->>'rpc', whitelisté) puis status=applied.

== 4. Generic applicability trigger ======================================== Pattern B validator (cf. api.validate_object_taxonomy_assignment): SECURITY INVOKER, house search_path. Cost per row: 2 PK probes + 1 two-key PK probe -- hot-path safe (§37).

Déclenchée par
trigger:public.object_act:trg_assert_facet_applicable, trigger:public.object_fma:trg_assert_facet_applicable, trigger:public.object_fma_occurrence:trg_assert_facet_applicable, trigger:public.object_iti:trg_assert_facet_applicable, trigger:public.object_iti_associated_object:trg_assert_facet_applicable, trigger:public.object_iti_info:trg_assert_facet_applicable, trigger:public.object_iti_practice:trg_assert_facet_applicable, trigger:public.object_iti_profile:trg_assert_facet_applicable, trigger:public.object_iti_section:trg_assert_facet_applicable, trigger:public.object_iti_stage:trg_assert_facet_applicable, trigger:public.object_meeting_room:trg_assert_facet_applicable, trigger:public.object_menu:trg_assert_facet_applicable +1

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

== 5. Guard on object.object_type changes ==================================

Déclenchée par
trigger:public.object:trg_guard_object_type_change

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Function to audit legal compliance across all objects =====================================================

Déclenchée par
trigger:public.object:trg_auto_attach_object_to_creator_org

Déclenchée par
trigger:public.crm_interaction:trg_auto_populate_interaction_subject

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Génération d'ID si absent

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Déclenchée par
trigger:public.object:trg_before_insert_object_generate_id

5) Read path: emit the period type code (+ all_years) so the editor round-trips.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

5) Read path: emit the period type code (+ all_years) so the editor round-trips.

Suppression : réservée au rang admin le plus élevé de l'ORG (org_admin) ou au superuser plateforme.

Auteur, supérieur hiérarchique direct dans la même ORG, ou superuser plateforme. Utilisé pour modifier / archiver une note.

Boolean per-row predicate kept as the single gate used by api.can_read_object -> the ~40 object-child read policies (P0.3). Delegates to the set function above (one source of truth); MUST stay byte-equivalent to it. Was an inline 4-path WITH (see git history); set-based now.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

1) Single source of truth for "is this object's data readable by the current caller".

Retourne TRUE si l'utilisateur courant peut consulter les notes privées depuis le périmètre de son organisation active.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Retourne TRUE si l'utilisateur courant peut écrire une note privée pour l'objet dans le périmètre de son organisation active.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Brique 2: fige le panel de KPIs dashboard pour p_date dans metric_snapshot (upsert idempotent). Complétude via api.get_dashboard_completeness (pool publié), corpus net (tous statuts), classés (granted, global+commune), couverture durable/accessibilité, backlog CRM (provisoire avant Brique 3). Exécutée par le cron quotidien capture-metric-snapshots.

Trigger : garantit que org_object_id pointe vers un objet de type 'ORG'. Un CHECK constraint ne peut pas référencer une autre table en PostgreSQL ; le trigger est la solution correcte.

Déclenchée par
trigger:public.user_org_membership:check_membership_org_type

===================================================== Function to check if an object has all required legal records =====================================================

Trigger : garantit que org_object_id pointe vers un objet de type 'ORG'.

Déclenchée par
trigger:public.org_config:check_org_config_org_type

Trigger : garantit que org_object_id pointe vers un objet de type 'ORG'. Un CHECK constraint ne peut pas référencer une autre table en PostgreSQL ; le trigger est la solution correcte (même pattern que check_membership_org_type et check_org_config_org_type).

Déclenchée par
trigger:public.org_permission:check_org_permission_org_type

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Déclenchée par
trigger:public.incident_report:trg_incident_report_after_insert

6.3 Création (statique depuis une sélection, ou dynamique depuis des filtres)

§09: dedup-guarded GLOBAL tag creation. Gated per-object. Dedup on ref_tag.name_normalized; slug inline; gen_random_uuid; created_by set. Color is a HEX #rrggbb (global per tag); defaults to #64748b.

Retourne l'ORG active de l'utilisateur courant (id + nom), pour le libellé côté éditeur du sélecteur de périmètre des descriptions. Le serveur reste autoritaire ; le client n'utilise ce nom que pour l'affichage.

Retourne le rang admin actif du user courant dans son ORG active (NULL si aucun).

Retourne le code du rôle admin actif du user courant (NULL si pas de rôle admin). Traverse : user_org_membership → user_org_admin_role → ref_org_admin_role. Le rôle admin ne bypasse pas api.user_has_permission() (§2.6 du plan).

Retourne le code du rôle métier actif du user courant (NULL si aucun). Traverse : user_org_membership → user_org_business_role → ref_org_business_role. Usage : affichage, contexte session — pas de logique de permission ici.

===================================================== Capability check : "le user courant peut-il éditer des objets ?" ===================================================== TRUE quand l'utilisateur a au moins une voie d'édition sur le périmètre de son organisation active : 1. superuser plateforme (owner / super_admin / service_role / admin), 2. rôle admin actif dans son ORG (peu importe le rang), 3. permission métier d'édition sur n'importe quel objet : create_object, edit_canonical_when_publisher, edit_org_enrichment, publish_object. Usage : la fonction est consommée par le frontend Explorer pour décider s'il doit afficher les statuts non publiés (draft) des objets de l'ORG. Elle ne porte AUCUNE logique d'autorisation sur une fiche précise — la RLS (cf. api.can_read_extended) reste seule à gater l'accès ligne par ligne. Un membre simple en lecture seule (pas d'admin role, pas de permission métier d'édition) renvoie FALSE et n'a donc accès qu'aux fiches publiées. STABLE + SECURITY DEFINER : pour traverser ref_permission / org_permission / user_permission sans dépendre des policies RLS de ces tables.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Acteurs du périmètre CRM : liés (actor_object_role) à un objet du périmètre publisher, + arme défensive : acteurs portant une interaction sur un objet du périmètre (couvre un acteur dont le lien aurait été retiré mais dont l'historique reste rattaché à l'ORG).

---------- 7. Helpers d'autorisation (style current_user_extended_object_ids, §35) ---------- Périmètre CRM = objets dont une ORG du user (membership actif) est PUBLISHER. Volontairement plus étroit que extended (pas d'arme acteur, pas d'arme all_published) : le CRM est le pilotage interne de l'ORG publicatrice, pas un droit d'édition.

Email courant (JWT claims)

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Set form of api.can_read_extended: the current user's extended-readable object ids, computed once (RLS-bypassed). Used by the object SELECT policy as a hashed-set membership test to avoid per-row predicate evaluation. Keep byte-equivalent to can_read_extended's 4 paths.

1. Admin-gate helper — single source for the §22 front gate (mirrors the write gate exactly).

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Retourne l'org_object_id actif du user courant (NULL si aucun membership actif). Pour un tourism_agent, au plus une ORG active existe (contrainte enforce_single_active_org_membership). Pour un owner/super_admin, retourne la première trouvée (usage interne uniquement).

1) "Objects visible to me" = published ∪ my extended scope. Single source of truth for the object-level read visibility (the `object` table's own SELECT predicate, as a SET). SECURITY DEFINER so the published scan bypasses RLS; returns only object ids. Reuses §35's set fn.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Suppression d'un canal (gate par l'acteur de la ligne, mêmes erreurs P0002/42501).

Suppression d'une interaction (même gate d'écriture ; arme objet si contexte, sinon arme acteur — object_id nullable ⇒ existence par FOUND, pas par IS NULL).

6.6 Suppression

===================================================== Function to mark a document as delivered =====================================================

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Déclenchée par
trigger:public.actor_channel:trg_actor_channel_email

Déclenchée par
trigger:public.app_user_profile:enforce_app_user_profile_role_change

Email shape enforcement (object + actor)

Déclenchée par
trigger:public.contact_channel:trg_contact_channel_email

Trigger : contrainte "1 user tourism_agent = 1 ORG active". Un index partiel unique WHERE is_active = TRUE s'appliquerait à TOUS les users, y compris owner/super_admin. Le trigger permet d'appliquer la règle sélectivement. Durcissements par rapport à la version naïve : 1. pg_advisory_xact_lock(user_id) : sérialise les transactions concurrentes sur le même user_id — élimine le TOCTOU sur les INSERTs simultanés. 2. SELECT ... FOR NO KEY UPDATE : verrouille les lignes actives existantes pendant la vérification — empêche une transaction concurrente de désactiver/réactiver un membership pendant que la nôtre lit. 3. Le trigger se déclenche aussi sur UPDATE OF user_id : si user_id est modifié sur un membership actif, la contrainte est revérifiée pour le nouveau user_id. 4. id IS DISTINCT FROM NEW.id remplace la condition TG_OP redondante : en BEFORE INSERT la ligne n'existe pas encore, l'exclusion est toujours correcte.

Déclenchée par
trigger:public.user_org_membership:enforce_single_active_org_membership

Batch GPX export for multiple itineraries

Export full GPX with metadata and stages

===================================================== Publication export for print workflows (InDesign-ready) =====================================================

== 6. Violations report (ops/CI; legacy rows are NOT auto-deleted) =========

===================================================== Function to generate legal expiry notifications =====================================================

generate_object_id (HOTAQU000V5014ZU-like)

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Helper: Get enriched actor data with contacts =====================================================

===================================================== Optimized function to get all opening time slots for a period =====================================================

Returns the full branding payload used by the authenticated SPA, including marker styles.

Dashboard §10: per-type freshness breakdown against a configurable threshold. Tiers: up_to_date (< p_threshold_days old), to_review (threshold..2x threshold), stale (> 2x threshold). rate = percentage up_to_date. weekly_rates is NULL until Phase 2B adds the object_version time-series join. updated_at reflects meaningful business edits only (cache-only changes are excluded by the update_object_updated_at_business trigger). ORG objects excluded. p_updated_at_from/to scope the object pool (inclusive DATE boundaries).

Dashboard §2b: top cities by object count within the filtered pool. Reads is_main_location=true from object_location; excludes null/empty cities. delta_30d counts objects created (not updated) in that city in the last 30 days. ORG objects excluded. p_updated_at_from/to are inclusive DATE boundaries.

Returns a sorted TEXT[] of distinct cities present in object_location (is_main_location=true, non-null/non-empty) for all non-ORG objects, any status. No filter parameters. Used to populate the dashboard city filter dropdown. Represents the full corpus city domain, not the current filtered slice.

───────────────────────────────────────────────────── §Qualité Complétude « perçue visiteur » par type ───────────────────────────────────────────────────── Réplique côté portefeuille le bundle d'essentiels visiteur du modèle éditeur (bertel-tourism-ui/.../editor-completion.ts ; spec docs/.../2026-06-18-completude-par-type-design.md) : 8 essentiels (nom, sous-catégorie, lieu, contact public, descriptif+accroche, photos [richesse min(n/4,1), 4=plein], équipements/équivalent type, ≥1 tag). Par type : score moyen (richesse 0-100), % de fiches « complètes visiteur » (tous essentiels présents, ≥4 photos), essentiel le plus manquant, et la liste des fiches < 80 (plafonnée par p_below_limit, pas de troncature silencieuse au-delà). NB : le slot 7 exact et le score complet 80/15/5 restent autoritatifs côté éditeur ; cette vue mesure le bundle essentiels = le signal de pilotage « où sont les trous » (goulot live = photos). Approximation assumée : n_photos compte toutes les lignes media de l'objet (vidéos/docs inclus) — filtrage strict au type-photo différé (kind non fiable en base ; cf. invariant média).

Dashboard §5: overview of objects carrying at least one granted qualification, classification, or label. Scope is driven by ref_classification_scheme.is_distinction = TRUE — no hardcoded list. To add a new label, seed its scheme with is_distinction = TRUE; this function picks it up automatically. Typological schemes (type_hot, retail_category) keep is_distinction = FALSE and are excluded. Returns global rate + per-scheme breakdown sorted by count DESC. ORG objects excluded. p_updated_at_from/to are inclusive DATE boundaries.

Returns { cities: text[], lieu_dits: text[] } as jsonb — sorted, btrim-cleaned, distinct values from object_location (is_main_location=true) for all non-ORG objects, any status. Both arrays represent the full corpus domain (not the current filtered slice). Used to populate the city and lieu-dit filter dropdowns on the dashboard sidebar in one call.

Returns a sorted TEXT[] of distinct lieux-dits (btrim-cleaned, non-null/non-empty) from object_location (is_main_location=true) for all non-ORG objects, any status. No filter parameters. Used to populate the dashboard lieu-dit filter dropdown. Represents the full corpus lieu-dit domain, not the current filtered slice.

Dashboard §1: hero scorecard aggregates for the filtered object pool. Returns total/published counts, pending_change count (scoped to same pool), 30-day creation delta vs the prior 30 days, and average processing delay (COALESCE(applied_at, reviewed_at) - submitted_at) for resolved pending_changes. avg_completeness = weighted mean of api.get_dashboard_completeness avg_score per type (single source of truth for the 8-essential formula; NULL when the pool is empty). distinctions / distinctions_pct = objects holding >=1 granted official classement/label (ref_classification_scheme.is_distinction), scoped to the same dated pool. ORG objects excluded. p_updated_at_from/to are inclusive DATE boundaries.

Dashboard §2a: object count broken down by object_type within the filtered pool. Each row includes per-status counts and the type's share of the total. ORG objects excluded. p_updated_at_from/to are inclusive DATE boundaries.

===================================================== Function to get expiring legal records =====================================================

===================================================== Function to get expiring legal records in API format =====================================================

Get track with stages as GeoJSON FeatureCollection

Simplified track for map display (lightweight GeoJSON)

6.2 Détail d'une liste (compose)

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Get filtered media for web display (excludes internal/sensitive) =====================================================

Compact amenity code array for cards, maps and LCP/list payloads. Uses canonical cached_amenity_codes, never legacy wheelchair_access.

Compact badges from official classifications, sustainability actions and canonical acc_* accessibility amenities.

===================================================== Lightweight card read model (single + batch) =====================================================

Batch wrapper for get_object_resource_adapted. Returns adapted/FALC resources for multiple objects, preserving input order.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

2) cards_batch -> SECURITY DEFINER + authorize-once. Body is byte-identical to the step-5 definition in api_views_functions.sql EXCEPT THREE changes: (a) the SECURITY DEFINER clause below; (b) the `distinct_ids` CTE gains the authorize-once gate — `WHERE EXISTS(published) OR id IN (SELECT api.current_user_extended_object_ids())` (§38 published-only fast-path: the set-equivalent split of `… current_user_readable_object_ids()` that skips the extended scan for an all-published page; every downstream child CTE joins distinct_ids); and (c) `main_description` re-applies the object_description visibility RLS this DEFINER body bypasses (see the inline note there — the only field-level read gate among the tables read).

Compact environment tag payload for cards, maps and LCP/list payloads.

Partner i18n=all block (audit API C-5): object_description free-text family as {field:{lang:plain text}} (strip_markdown per language, public-visibility only, published-gated). service_role-only.

Partner interop serializer (audit API I4 §137): datatourisme/apidae/tourinsoft document for a PUBLISHED object; @type/class from ref_interop_crosswalk; service_role-only; core-fields subset.

Partner JSON-LD serializer (audit API I4): schema.org output for a PUBLISHED object, @type from ref_interop_crosswalk (table-driven), public-only contacts/media/web-channels, plain-text description (strip_markdown). service_role-only; unmapped/unpublished => NULL. §136.

===================================================== Function to get legal compliance in API format =====================================================

===================================================== Function to get legal data in API format =====================================================

===================================================== Function to get all legal records for an object =====================================================

===================================================== Function to get legal records filtered by visibility =====================================================

===================================================== Lightweight map view API - returns minimal object data =====================================================

===================================================== Function to get private legal records only (for parent org) =====================================================

===================================================== Function to get public legal records only =====================================================

Migration: Markdown D2 -- sub-place description (object_place_description) Manifest id: 15c Decision log: §112 Date: 2026-06-22 Summary: One body-only edit inside api.get_object_resource (CREATE OR REPLACE, signature unchanged): api.get_object_resource -- places block (~line 3878 in api_views_functions.sql): BEFORE: 'descriptions', COALESCE(( SELECT jsonb_agg((to_jsonb(pd) - 'place_id') <-- leaks all raw prose + *_i18n columns ORDER BY ... AFTER: 'descriptions', COALESCE(( SELECT jsonb_agg( -- §112 Markdown: explicit override. ONLY the flat scalar prose keys are -- dropped (the || override re-emits them stripped). §112 C1 fix: the raw -- *_i18n maps are NOT subtracted — the place editor loads from THIS block -- and reads them for its per-language values (editor leg; subtracting them -- NULLed translations on the next §16 save). (to_jsonb(pd) - 'place_id' - 'description' - 'description_chapo' - 'description_mobile' - 'description_edition' - 'description_adapted') || jsonb_build_object( 'description', api.strip_markdown(COALESCE(api.i18n_pick(...), pd.description)), 'description_md', COALESCE(api.i18n_pick(...), pd.description), 'description_raw', pd.description, -- editor round-trip base 'description_chapo', api.strip_markdown(COALESCE(...)), 'description_chapo_md', COALESCE(...), 'description_chapo_raw', pd.description_chapo, ... (same pattern for mobile/edition/adapted) ) ORDER BY ... Per field, the public keys are <col> (stripped) + <col>_md (resolved raw); the editor legs are <col>_raw (raw scalar base, read by parseDescriptionScope scope='place') AND the kept raw <col>_i18n map (per-language values). Only <col> (flat scalar) is dropped from to_jsonb so the stripped override wins; <col>_i18n stays raw (no flat consumer resolves it). No schema_unified.sql fold needed: api.get_object_resource body lives ONLY in api_views_functions.sql. Folded: api_views_functions.sql (canonical source, updated in place). Deploy: 1. Deploy api.get_object_resource via: node .tmp_pgapply/apply_range.cjs <start_line> <end_line>

FALC/Accessibility-friendly resource read model. Returns a simplified JSON with description_adapted preferred over regular description, essential location, primary phone/email contacts, main image, and LBL_TOURISME_HANDICAP accessibility labels (V5 canonical code).

===================================================== Batch wrapper for get_object_resource (performance optimization) Fetches resources for multiple objects while preserving order =====================================================

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Get object reviews with aggregates (external imports) =====================================================

===================================================== Get room types for accommodations =====================================================

Compact object tag payload for cards, maps and LCP/list payloads. Ordered by tag_link.position (§09 per-object priority).

Compact taxonomy payload for cards, maps and other LCP/list payloads.

(2) Single-version snapshot (the full data jsonb) for the detailed diff.

(1) Timeline + per-version changed_fields. The cache/meta ignore-list is the SAME set save_object_version() strips (plus identity/audit/generated keys), so a captured version never differs only on noise. Kept byte-identical to DIFF_IGNORE_KEYS in object-versions.ts.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Enhanced API function: Get objects by type with deep data =====================================================

===================================================== Enhanced API function: Get multiple objects with deep data =====================================================

===================================================== Optimized: get ALL opening time frames per weekday as arrays (unbounded) =====================================================

===================================================== Helper function to extract opening time slots for a specific day (legacy) =====================================================

===================================================== Helper: Get enriched organization data =====================================================

===================================================== Helper: Get enriched parent object data =====================================================

===================================================== Function to get pending document requests =====================================================

===================================================== Function to get pending document requests in API format =====================================================

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Returns public-safe brand settings for anonymous contexts such as the login page.

---------- 7. RPC PUBLIQUE (anon) : lecture par token ---------- Objets PUBLIÉS uniquement ; AUCUNE PII destinataire ; réponse indifférenciée (NULL) si token invalide / désactivé / expiré.

8) Status guard: status changes require publish_object (rpc_publish_object), not edit_canonical. service_role/admin and platform superuser are exempt. rpc_publish_object verifies the caller's publish right before its UPDATE, so the trigger re-check passes for it (auth.uid() is preserved under SECURITY DEFINER). Fires only when `status` is in the SET list.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Déclenchée par
trigger:public.object:trg_guard_object_status_change

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Déclenchée par
trigger:auth.users:on_auth_user_created_app_user_profile

Déclenchée par
trigger:public.object_membership:trg_membership_status_transition

I18N Helper: Get translation from EAV i18n_translation table with fallback Usage: api.i18n_get_text('object_description', 'desc-uuid-123', 'description', 'en', 'fr') Returns: Translated text from i18n_translation table with fallback support Used for advanced cases where JSONB columns are not available

I18N Helper (strict): EAV i18n without "any language" fallback

I18N Helper: Pick translation from JSONB with fallback Usage: api.i18n_pick('{"fr": "Bonjour", "en": "Hello"}', 'en', 'fr') Returns: "Hello" (or "Bonjour" if 'en' not found, or any available language as last resort) Language codes are normalized to lowercase following project conventions

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

I18N Helper (strict): Pick translation from JSONB without "any language" fallback Returns NULL if both requested and fallback are missing/empty

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Shared interop core reader (audit API I4 §137): flat gated core of a PUBLISHED object (public-only) for the profile serializers.

Vérifie si l'utilisateur est propriétaire (owner) de l'objet via un rôle actor_object_role lié à son email dans actor_channel

Batch refresh cached_is_open_now for all objects. Scheduled on live via pg_cron. NOTE (2026-06-04): heavy job (~18-22s/run on ~373 published objects: correlated EXISTS over the opening_* chain + per-object timezone LATERAL). To avoid periodic instance saturation it runs every 15 min, STAGGERED off the */5 mv_filtered_objects refresh: SELECT cron.alter_job(job_id := <id>, schedule := '3,18,33,48 * * * *'); (orig example: SELECT cron.schedule('refresh-open-status','*/5 * * * *',$$SELECT api.refresh_open_status()$$);) A set-based rewrite of this function (sub-second) is a tracked follow-up (lot1_mapping_decisions.md §35).

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Returns true when the current user can manage platform-level branding and UI theme settings, using app_user_profile or auth metadata.

Vérifie si l'utilisateur courant est owner plateforme (ou admin/service)

===================================================== Helper : autorité plateforme (owner OU super_admin) Distinct de api.is_platform_owner() qui ne couvre que 'owner'. Utilisé pour les opérations réservées à l'autorité plateforme : - écriture sur org_config.access_scope (§2.8 du plan maître) =====================================================

Clean JSON by removing newlines and extra whitespace

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== Object resource block helpers (decomposition layer) =====================================================

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

===================================================== JSON Helper: Prune empty top-level keys (arrays/objects) =====================================================

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.

Affecter un établissement à un acteur EXISTANT (demande PO 2026-06-14). Symétrique de la création d'acteur de save_crm_actor (qui crée acteur + lien), mais ici l'acteur existe déjà et on ajoute UNIQUEMENT le lien actor_object_role vers un objet. Gate = arme objet user_can_write_crm (il faut gérer le CRM de l'établissement pour y rattacher un acteur ; superuser bypasse via le helper). is_primary DÉRIVÉ comme save_crm_actor (uq_actor_object_role_primary est UNIQUE (object_id, role_id) WHERE is_primary). Idempotent : ON CONFLICT DO NOTHING ⇒ linked=FOUND (true si une ligne a été insérée, false si le lien existait déjà).

Fiche acteur (navigation acteur → objets → interactions tous contextes) : identité, objets liés du périmètre, canaux de contact (rectif PO 2026-06-11), TOUTES les interactions de l'acteur (contexte objet du périmètre OU générale), répartition des sujets. Superuser : sans restriction de périmètre.

Un référentiel public résolu i18n, forme {code,name,icon_url,parent_code,domain}. Audit API I1.

Assignataires possibles d'une tâche (demande PO 2026-06-12) : membres ACTIFS DISTINCTS des ORG du caller (eux-mêmes inclus). Peuple le select « attribuer à » de l'UI. display_name peut être NULL (profil non renseigné) ⇒ COALESCE vers un libellé court dérivé de l'uuid (jamais de ligne sans étiquette). Superuser sans membership : [] (assignation par user_can_assign_crm reste possible — documenté). Trié par display_name.

Tâches CRM du périmètre (échéance croissante, NULLS LAST).

Flux tombstone partenaire (§108/C-4) : suppressions définitives depuis object_deletion_log, projeté {object_id,type,deleted_at} (jamais report/performed_by/object_name). service_role-only.

---------- 5. Membres effectifs d'une liste (statique OU dynamique) ---------- Helper interne : jamais exposé (les callers DEFINER l'exécutent en tant qu'owner). Statique : object_list_item ordonné ; published_only filtre sur object.status. Dynamique : résolveur ci-dessus (ordinalité = position), notes NULL.

---------- 5b. Contacts publics des items (téléphone / site web) ---------- Enrichissement des items de liste pour les templates OTI (boutons « appeler » / « site web » du design). PUBLICS uniquement (is_public — le flag champ §49 compose, jamais de canal interne) : phone (repli mobile) + website. Set-based sur le jeu d'ids (borné 200 par le résolveur) — pas de fonction par ligne (§125). Helper interne : jamais exposé (les RPCs DEFINER l'exécutent en tant qu'owner).

6.1 Grille « Mes listes »

Suggestions de contacts pour l'authoring d'un acteur (demande PO 2026-06-12). Le caller crée/édite un acteur SOUS cet objet ⇒ gate = arme objet user_can_write_crm (même prédicat que save_crm_actor à la création). Combine les contacts de l'ÉTABLISSEMENT (contact_channel §03, source 'établissement') + les canaux des acteurs DÉJÀ liés (actor_channel via actor_object_role, source 'acteur lié'), dédupliqués par (kind_code, lower(btrim(value))) en préférant la source 'établissement' puis is_primary. ORDER final : e-mails d'abord, primaires, puis valeur. PII réservée au périmètre publisher (jamais en PostgREST direct).

Vue CRM d'un objet : interactions + tâches + répartition des sujets + acteurs liés (navigation objet → acteurs du modèle acteur-centré ; cf. en-tête point 5).

Explorer map markers: lightweight {id,type,name,image,open_now,location{lat,lon,city}} for ALL matching geolocated objects in one call. Authorize-once SECURITY DEFINER (§36): filtered set ∩ current_user_readable_object_ids() then object_location read RLS-free. Replaces the per-page card fetch as the map data source; avoids the per-row can_read_object scalar (§35) and per-row enrichment (cf. list_objects_map_view). See decision log §125.

Aucune lecture/écriture inférée par le graphe. Cas fréquent pour les helpers purs, triggers simples ou SQL dynamique non analysable.