updated best practice page

Author: bardram

docs/carp-mobile-sensing/best-practice.mdx

@@ -0,0 +1,40 @@
+%% CAMS software architecture Mermaid source
+%% Regenerate SVG (requires Mermaid CLI):
+%% npx -y @mermaid-js/mermaid-cli -i docs/carp-mobile-sensing/images/cams_architecture.mmd -o docs/carp-mobile-sensing/images/cams_architecture.svg
+
+flowchart LR
+  subgraph CL[Client manager layer]
+    SCM[SmartPhoneClientManager]
+    REG[Registries]
+    CTL[Controllers<br/>Device / AppTask / Notification]
+    SDC[SmartphoneDeploymentControllers]
+    SCM --> REG
+    SCM --> CTL
+    SCM --> SDC
+  end
+
+  subgraph SL[Service layer]
+    DS[DeploymentService]
+    DM[Data managers<br/>SQLite / File / Firebase / CAWS]
+  end
+
+  subgraph PL[Sampling layer]
+    SP[Sampling packages]
+    PB[Probes]
+    SRC[Flutter plugins / OS sensors / external devices]
+    SP --> PB
+    PB --> SRC
+  end
+
+  DS --> SCM
+  REG --> SP
+  SDC --> DM
+  PB --> DM
+
+  classDef client fill:#FFF4E5,stroke:#C30E32,stroke-width:1px,color:#3a2a1a;
+  classDef service fill:#EAF4FF,stroke:#2B6CB0,stroke-width:1px,color:#1A365D;
+  classDef sampling fill:#EAFBF2,stroke:#2F855A,stroke-width:1px,color:#1C4532;
+
+  class SCM,REG,CTL,SDC client;
+  class DS,DM service;
+  class SP,PB,SRC sampling;