manager-service/ManagerService/Data/ImmersiveBackground.cs
Thomas Fransolet b87e49d808 Cle d'API sur les routes visiteur, canal VR et contenu immersif
Securite
- RequireAppKey : filtre qui exige une cle d'API valide ou un utilisateur du
  manager. Pose sur les routes de contenu consommees par les apps visiteur
  (Configuration, Section, Resource, SectionMap, SectionEvent, SectionAgenda,
  SectionParcours, SectionQuiz, ApplicationInstance). Un [Authorize] d'action
  ne peut pas assouplir celui de la classe ; seul [AllowAnonymous] le
  court-circuite, et le filtre redevient le controle d'acces. Il ferme
  l'enumeration par identifiant, pas la confidentialite : la cle s'obtient
  par le slug ou le pincode.
- Instance/slug/{slug} rendait le pinCode, l'adresse de facturation, la TVA et
  les quotas a qui lit l'URL du site visiteur. StripCommercialFields est
  desormais applique sur slug et byPin ; isTrialActive reste expose pour le
  filigrane d'essai.
- Device.Create et Device/{id}/detail repondaient 403 a toute tablette depuis
  a452f4a (13/03) : la classe exige InstanceAdmin, une cle ne porte que
  AppRead. Ouverts a la cle, le cloisonnement par instance etait deja ecrit.

Canal VR
- Device.AppType (defaut Tablet, backfill a 1) ; Create resout
  l'ApplicationInstance sur ce type au lieu de Tablet en dur.
- Get filtre optionnellement par appType ; DeviceDetailDTO expose appVersion
  et lastSeen.
- PUT Device/{id}/heartbeat : batterie, version, connexion. Volontairement
  etroit, une app ne peut ni se renommer ni changer d'instance.
- ApiKeyAppType.VrApp en fin d'enum.

Contenu immersif
- ResourceType : Image360 (11), Video360 (12), Model3D (13), en fin d'enum.
- Section Scene3D : un modele GLB et ses points d'interet, en objet manipule
  ou en decor habite. Les points sont des GeoPoint, avec une LocalTransform
  en jsonb (convention glTF) ; CRUD dans SectionScene3DController.
- Instance.HasImmersiveContent : l'add-on ajoute 100 Go au quota de stockage,
  repose apres un changement de plan et retire a la desactivation.
- ImmersiveBackground (owned) sur Configuration et ApplicationInstance, avec
  une image de repli pour les canaux qui ne rendent pas l'immersif.

Export de configuration
- exportVersion (1) et generatedAt : le JSON devient un contrat, lu tel quel
  par l'app Unity.
- Section.ToDTO() n'etant pas virtuelle, l'export ne portait aucun champ
  specifique de sous-type. Passe par SectionFactory.ToDTO, et charge les
  points des Map et des Scene3D.
- Le fond immersif et son repli partent avec les ressources, URL resolues.

Migrations : AddAppTypeToDevice, AddScene3DSectionAndImmersiveAddon,
AddImmersiveBackground.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-13 16:54:10 +02:00

67 lines
2.5 KiB
C#

using ManagerService.DTOs;
using Microsoft.EntityFrameworkCore;
namespace ManagerService.Data
{
/// <summary>
/// Le fond d'un lieu — §4 de <c>DOCS/v2/immersif-frontiere-plan.md</c>.
///
/// <b>Un type, deux porteurs.</b> Une <c>Configuration</c> le porte pour le fond d'une
/// visite, l'<c>ApplicationInstance</c> VR pour le fond du menu général. Poser un
/// <c>BackgroundResourceId</c> à plat sur chacun aurait donné quatre champs
/// « background » incohérents dans six mois — c'est le travers que ce type évite.
///
/// ⚠️ <b>Le repli n'est pas optionnel.</b> Trois canaux sur quatre ne savent pas rendre
/// un panorama : web le fait tourner, mobile et kiosk retombent sur une image plate.
/// Sans <c>FallbackResourceId</c>, activer un fond immersif rendrait l'écran noir
/// partout ailleurs que dans le casque, <i>en silence</i>. À défaut, c'est
/// <c>Configuration.ImageId</c> qui sert de repli.
/// </summary>
[Owned]
public class ImmersiveBackground
{
/// <summary>Ressource immersive : une 360, une vidéo 360 ou un GLB.</summary>
public string ResourceId { get; set; }
/// <summary>
/// ⚠️ Persisté en <b>int</b>, comme tous les enums du projet : on ajoute en fin,
/// on ne réordonne jamais.
/// </summary>
public ImmersiveBackgroundKind Kind { get; set; }
/// <summary>Image plate pour les canaux qui ne rendent pas l'immersif.</summary>
public string FallbackResourceId { get; set; }
public ImmersiveBackgroundDTO ToDTO() => new ImmersiveBackgroundDTO
{
resourceId = ResourceId,
kind = Kind,
fallbackResourceId = FallbackResourceId
};
/// <summary>
/// Rend null quand aucune ressource n'est choisie : un fond sans ressource n'est
/// pas un fond, et le porter quand même obligerait chaque lecteur à tester deux
/// choses au lieu d'une.
/// </summary>
public static ImmersiveBackground FromDTO(ImmersiveBackgroundDTO dto)
{
if (dto == null || string.IsNullOrWhiteSpace(dto.resourceId)) return null;
return new ImmersiveBackground
{
ResourceId = dto.resourceId,
Kind = dto.kind,
FallbackResourceId = dto.fallbackResourceId
};
}
}
public enum ImmersiveBackgroundKind
{
Pano = 0,
Video360 = 1,
Scene3D = 2
}
}