-
Notifications
You must be signed in to change notification settings - Fork 3
Open
Description
Summary
ApplicationInstallations now allows a valid pending state where Install without applicationToken leaves both Bitrix24Account and ApplicationInstallation in status new until OnAppInstall finishes the flow.
If Bitrix24 never delivers the finish-step, these installations can remain stuck in new indefinitely.
Goal
Design a background mechanism for detecting and handling stale pending installations.
Why this is needed
- synchronous install flow should stay SDK-compatible and not guess failure too early
- missing
ONAPPINSTALLshould not leave unbounded stalenewentities forever - operators need a deterministic recovery path for broken install attempts
Options to evaluate
- TTL worker that marks stale
newinstallations as failed/broken after a timeout - TTL worker with alert-only behavior and no state transition
- Reconciliation job that re-checks portal/app state before deciding what to do
- Manual operational flow with tooling/documented runbook
Design constraints
- preserve SDK contract compatibility
- do not introduce a second canonical finish-flow besides
OnAppInstall - keep auditability of why a pending installation was considered stale
- account for both master
Bitrix24AccountandApplicationInstallationstate transitions
Acceptance criteria
- proposed lifecycle for stale
newinstallations is documented - trigger conditions and TTL are defined
- target statuses/events are defined for both aggregates
- operational and observability requirements are captured
- chosen approach does not conflict with the current
Install/OnAppInstallcontract
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels