docs: clarify provider-scoped device catalog boundary

This commit is contained in:
2026-08-24 14:58:14 +08:00
parent 7645f60b9c
commit 45601d94fa
@@ -120,22 +120,23 @@ SessionGateway -> AbsdkBridge
LocalSessionGateway -> SimulationSessionGateway LocalSessionGateway -> SimulationSessionGateway
``` ```
For device operations, the app exposes provider-routing adapters: For ABSDK-backed device operations, the app exposes provider-routing adapters:
```text ```text
RoutingDeviceCatalog
RoutingSocketGateway RoutingSocketGateway
RoutingTemperatureHumidityGateway RoutingTemperatureHumidityGateway
RoutingInfraredGateway RoutingInfraredGateway
``` ```
Each adapter observes or reads the active `ProviderProfile` and delegates: Each adapter reads the active `ProviderProfile` and delegates:
```text ```text
ABOX -> real AbsdkBridge implementation ABOX -> real AbsdkBridge implementation
LOCAL_EXPERIENCE -> simulation implementation LOCAL_EXPERIENCE -> simulation implementation
``` ```
`DeviceCatalog` is not implemented by ABSDK 0630. The ABox catalog remains a provider-scoped local persistence responsibility owned by the device-catalog module; `SimulationDeviceCatalog` supplies only the built-in local-experience catalog. This change does not invent a remote discovery API or take ownership of the final ABox catalog implementation from its module owner.
No feature UI selects Real or Fake directly. No feature UI selects Real or Fake directly.
## Session and Credential Rules ## Session and Credential Rules
@@ -201,7 +202,8 @@ All compatibility-backend copy, status labels, and branches are removed from Eng
- `SessionCoordinator` routes ABox to `SessionGateway` and local experience to `LocalSessionGateway`. - `SessionCoordinator` routes ABox to `SessionGateway` and local experience to `LocalSessionGateway`.
- Arbitrary ABox credentials do not succeed unless the injected real/fake test gateway returns success. - Arbitrary ABox credentials do not succeed unless the injected real/fake test gateway returns success.
- Local experience selection creates a session without calling the ABox gateway or credential store. - Local experience selection creates a session without calling the ABox gateway or credential store.
- Each routing adapter delegates ABox calls to the real test double and local calls to simulation. - Each socket, temperature/humidity, and infrared routing adapter delegates ABox calls to the real test double and local calls to simulation.
- The local-experience device catalog is supplied by simulation without asserting that ABSDK provides ABox device discovery.
- Switching providers logs out the previous session and isolates state. - Switching providers logs out the previous session and isolates state.
### Integration and build verification ### Integration and build verification