Skip to content

Commit f9b1a11

Browse files
committed
Update diagrams
1 parent 8a68a44 commit f9b1a11

4 files changed

Lines changed: 41 additions & 38 deletions

docs/policy/architecture_policy_composition.mmd

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ flowchart LR
33
CP["ClickablePolicy"]
44
TP["TypeablePolicy"]
55
SP["ScrollablePolicy"]
6+
SelP["SelectablePolicy"]
67
EP["EnabledPolicy"]
78
BP["BlockedPolicy"]
89
WFP["WidgetFilterPolicy"]
@@ -14,6 +15,7 @@ flowchart LR
1415
CCP["CompositeClickablePolicy<br/>semantics: ANY"]
1516
CTP["CompositeTypeablePolicy<br/>semantics: ANY"]
1617
CSP["CompositeScrollablePolicy<br/>semantics: ANY"]
18+
CSelP["CompositeSelectablePolicy<br/>semantics: ANY"]
1719
CEP["CompositeEnabledPolicy<br/>semantics: ALL"]
1820
CBP["CompositeBlockedPolicy<br/>semantics: ANY"]
1921
CWFP["CompositeWidgetFilterPolicy<br/>semantics: ALL"]
@@ -22,16 +24,17 @@ flowchart LR
2224
end
2325

2426
subgraph GenericEnginePolicyImplementations["generic policy implementations"]
25-
TEP["TagEnabledPolicy"]
26-
TBP["TagBlockedPolicy"]
27-
ConfWFP["ConfiguredWidgetFilterPolicy"]
28-
ZITLP["ZIndexTopLevelPolicy"]
27+
TEP["TagEnabledPolicy <br> set in platform/state logic"]
28+
TBP["TagBlockedPolicy <br> set in platform/state logic"]
29+
ConfWFP["ConfiguredWidgetFilterPolicy <br> set in settings/state logic"]
30+
ZITLP["ZIndexTopLevelPolicy <br> set in state logic"]
2931
end
3032

3133
subgraph PlatformPolicyImplementations["platform policy implementations"]
3234
PCP["PlatformClickablePolicy (WindowsClickablePolicy / WebdriverClickablePolicy / AndroidClickablePolicy)"]
3335
PTP["PlatformTypeablePolicy (WindowsTypeablePolicy / WebdriverTypeablePolicy / AndroidTypeablePolicy)"]
3436
PSP["PlatformScrollablePolicy (WindowsScrollablePolicy / WebdriverScrollablePolicy / AndroidScrollablePolicy)"]
37+
PSelP["PlatformSelectablePolicy (WindowsSelectablePolicy / WebdriverSelectablePolicy / AndroidSelectablePolicy)"]
3538
PVP["PlatformVisiblePolicy (WindowsVisiblePolicy / WebdriverVisiblePolicy / AndroidVisiblePolicy)"]
3639
end
3740

@@ -52,6 +55,7 @@ flowchart LR
5255
PCP -. implements .-> CP
5356
PTP -. implements .-> TP
5457
PSP -. implements .-> SP
58+
PSelP -. implements .-> SelP
5559
PVP -. implements .-> VP
5660

5761
TEP -. implements .-> EP
@@ -65,6 +69,7 @@ flowchart LR
6569
CP -- "1..n policies" --> CCP
6670
TP -- "1..n policies" --> CTP
6771
SP -- "1..n policies" --> CSP
72+
SelP -- "1..n policies" --> CSelP
6873
EP -- "1..n policies" --> CEP
6974
BP -- "1..n policies" --> CBP
7075
WFP -- "1..n policies" --> CWFP
@@ -74,6 +79,7 @@ flowchart LR
7479
CCP --> PPC
7580
CTP --> PPC
7681
CSP --> PPC
82+
CSelP --> PPC
7783
CEP --> PPC
7884
CBP --> PPC
7985
CWFP --> PPC
Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,48 @@
1-
flowchart LR
1+
flowchart TB
22

33
Main["Main"]
4-
ComposedProtocol["ComposedProtocol"]
54
TestingServices["TestingServices"]
65
ScriptlessCapabilities["ScriptlessCapabilities"]
6+
ComposedProtocol["ComposedProtocol"]
77
GenerateMode["GenerateMode"]
88

9-
subgraph ScriptlessFlow["testar scriptless generate flow"]
9+
subgraph ScriptlessFlow["scriptless generate flow"]
10+
direction TB
11+
12+
SettingsCapability["SettingsCapability"]
13+
TestSessionCapability["TestSessionCapability"]
14+
TestSequenceCapability["TestSequenceCapability"]
15+
1016
SystemService["SystemService"]
1117
StateService["StateService"]
1218
OracleEvaluationService["OracleEvaluationService"]
1319
ScriptlessOracleComposer["ScriptlessOracleComposer"]
20+
StopCriteriaCapability["StopCriteriaCapability"]
21+
1422
ActionDerivationService["ActionDerivationService"]
1523
ActionSelectorService["ActionSelectorService"]
1624
ActionExecutionService["ActionExecutionService"]
17-
18-
SettingsCapability["SettingsCapability"]
19-
TestSessionCapability["TestSessionCapability"]
20-
TestSequenceCapability["TestSequenceCapability"]
21-
StopCriteriaCapability["StopCriteriaCapability"]
2225
end
2326

2427
Main --> ComposedProtocol
2528
TestingServices --> ComposedProtocol
2629
ScriptlessCapabilities --> ComposedProtocol
2730
ComposedProtocol --> GenerateMode
2831

29-
GenerateMode -. uses services .-> SystemService
30-
GenerateMode -. uses capabilities .-> SettingsCapability
31-
32-
SettingsCapability -. test settings .-> TestSessionCapability
33-
TestSessionCapability -. session lifecycle .-> TestSequenceCapability
34-
TestSequenceCapability -. sequence lifecycle .-> SystemService
35-
36-
SystemService -. start system .-> StateService
37-
38-
StateService -. current state .-> OracleEvaluationService
39-
OracleEvaluationService -. base verdicts .-> ScriptlessOracleComposer
32+
GenerateMode -. "uses services" .-> SystemService
33+
GenerateMode -. "uses capabilities" .-> SettingsCapability
4034

41-
ScriptlessOracleComposer -. composed verdicts .-> StopCriteriaCapability
42-
StopCriteriaCapability -. continue inner loop .-> ActionDerivationService
35+
SettingsCapability -. "test settings" .-> TestSessionCapability
36+
TestSessionCapability -. "session lifecycle" .-> TestSequenceCapability
37+
TestSequenceCapability -. "sequence lifecycle" .-> SystemService
4338

44-
ActionDerivationService -. derived actions .-> ActionSelectorService
39+
SystemService -. "start system" .-> StateService
4540

46-
ActionSelectorService -. selected action .-> ActionExecutionService
41+
StateService -. "current state" .-> OracleEvaluationService
42+
OracleEvaluationService -. "base verdicts" .-> ScriptlessOracleComposer
43+
ScriptlessOracleComposer -. "composed verdicts" .-> StopCriteriaCapability
4744

48-
ActionExecutionService -. next state cycle .-> StateService
45+
StopCriteriaCapability -. "continue inner loop" .-> ActionDerivationService
46+
ActionDerivationService -. "derived actions" .-> ActionSelectorService
47+
ActionSelectorService -. "selected action" .-> ActionExecutionService
48+
ActionExecutionService -. "next state cycle" .-> StateService

docs/service/architecture_action_derivation_service_pipeline.mmd

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -35,19 +35,17 @@ flowchart LR
3535
StateActionDeriver["StateActionDeriver"]
3636
end
3737

38-
subgraph PlatformPlanProviders["platform plan providers"]
38+
subgraph PlatformPlanProviders["platform deriver and plan providers"]
3939
direction TB
40+
PlatformWidgetActionDeriver["PlatformWidgetActionDeriver (WindowsWidgetActionDeriver/ WebdriverWidgetActionDeriver/ AndroidWidgetActionDeriver)"]
41+
ForcedActions["Forced derivers <br> (generic or platform-specific)"]
4042
PlatformPlan["PlatformActionDerivationPlan (WindowsActionDerivationPlan/ WebdriverActionDerivationPlan/ AndroidActionDerivationPlan)"]
43+
FallbackActions["Fallback derivers <br> (generic or platform-specific)"]
4144
end
4245

4346
subgraph CustomPlanProviders["custom plan providers"]
4447
direction TB
45-
CustomPlan["CustomActionDerivationPlan"]
46-
end
47-
48-
subgraph PlatformDerivers["platform widget derivation"]
49-
direction TB
50-
PlatformWidgetActionDeriver["PlatformWidgetActionDeriver (WindowsWidgetActionDeriver/ WebdriverWidgetActionDeriver/ AndroidWidgetActionDeriver)"]
48+
CustomPlan["CustomActionDerivationPlan <br> (advanced internal extension)"]
5149
end
5250

5351
Orchestrator --> PolicyContexts
@@ -74,12 +72,11 @@ flowchart LR
7472

7573
ComposedActionDerivationService -- "produces identified actions" --> derivedActions
7674

77-
%% horizontal row nudges
75+
%% horizontal row nudges
7876
PluginComposition ~~~ SharedContexts
7977
SharedContexts ~~~ ComposedDerivation
8078
ComposedDerivation ~~~ CoreDerivation
8179
PluginComposition ~~~ ComposedDerivation
8280

83-
PlatformDerivers ~~~ EngineDerivation
8481
EngineDerivation ~~~ PlatformPlanProviders
8582
PlatformPlanProviders ~~~ CustomPlanProviders

docs/service/architecture_state_service_pipeline.mmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ flowchart LR
4040

4141
subgraph CustomPlanProviders["custom plan providers"]
4242
direction TB
43-
CustomPlan["CustomStateCompositionPlan"]
43+
CustomPlan["CustomStateCompositionPlan <br> (advanced internal extension)"]
4444
end
4545

4646
subgraph PlatformStateProviders["platform state providers"]

0 commit comments

Comments
 (0)