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
```
For device operations, the app exposes provider-routing adapters:
For ABSDK-backed device operations, the app exposes provider-routing adapters:
```text
RoutingDeviceCatalog
RoutingSocketGateway
RoutingTemperatureHumidityGateway
RoutingInfraredGateway
```
Each adapter observes or reads the active `ProviderProfile` and delegates:
Each adapter reads the active `ProviderProfile` and delegates:
```text
ABOX -> real AbsdkBridge 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.
## 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`.
- 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.
- 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.
### Integration and build verification