feat: Athena Features

assets/images/COPYRIGHT_NOTICE

@@ -0,0 +1,12 @@
+ORA Logos Copyright Notice
+
+The ORA logos (including, but not limited to, "open_resin_alliance_logo_darkmode.png") are NOT covered by the Apache License, Version 2.0 that applies to this project. The logos are protected by copyright and may also be protected as trademarks. All rights are reserved by Ada Phillips.
+
+You MAY NOT copy, distribute, modify, publish, display, or otherwise use the logos except as explicitly permitted in writing by the copyright/trademark owner.
+
+Repository source code and other content are licensed under the Apache License, Version 2.0 unless otherwise stated. This notice applies only to the logo artwork referenced above.
+
+To request permission to use the ORA logos, contact the project maintainers or:
+contact@openresin.org
+
+© 2025 Open Resin Alliance. All rights reserved.

lib/backend_service/backend_client.dart

@@ -0,0 +1,105 @@
+/*
+* Orion - Backend Client
+* Copyright (C) 2025 Open Resin Alliance
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+import 'dart:typed_data';
+import 'dart:async';
+
+/// Minimal abstraction over the Backend API used by providers. This allows
+/// swapping implementations (real HTTP client, mock, or unit-test doubles)
+/// while keeping providers free from direct dependency on ApiService.
+abstract class BackendClient {
+  Future<Map<String, dynamic>> listItems(
+      String location, int pageSize, int pageIndex, String subdirectory);
+
+  Future<bool> usbAvailable();
+
+  Future<Map<String, dynamic>> getFileMetadata(
+      String location, String filePath);
+
+  Future<Map<String, dynamic>> getConfig();
+
+  Future<String> getBackendVersion();
+
+  Future<Uint8List> getFileThumbnail(
+      String location, String filePath, String size);
+
+  Future<void> startPrint(String location, String filePath);
+
+  Future<Map<String, dynamic>> deleteFile(String location, String filePath);
+
+  // Status-related
+  Future<Map<String, dynamic>> getStatus();
+
+  /// Stream of status updates from the server. Implementations may expose
+  /// an SSE / streaming endpoint. Each emitted Map corresponds to a JSON
+  /// object parsed from the stream's data payloads.
+  Stream<Map<String, dynamic>> getStatusStream();
+
+  /// Fetch recent notifications from the backend. Returns a list of JSON
+  /// objects representing notifications. Some backends (e.g. NanoDLP)
+  /// expose a `/notification` endpoint that returns an array.
+  Future<List<Map<String, dynamic>>> getNotifications();
+
+  /// Disable / acknowledge a notification on the backend when supported.
+  /// The timestamp argument is the numeric timestamp provided by the
+  /// notification payload (e.g. NanoDLP uses an integer timestamp).
+  Future<void> disableNotification(int timestamp);
+
+  // Print control
+  Future<void> cancelPrint();
+  Future<void> pausePrint();
+  Future<void> resumePrint();
+
+  // Manual controls and hardware commands
+  Future<Map<String, dynamic>> move(double height);
+
+  /// Send a relative Z move in millimeters (positive = up, negative = down).
+  /// This maps directly to the device's relative move endpoints when
+  /// available (e.g. NanoDLP /z-axis/move/.../micron/...).
+  Future<Map<String, dynamic>> moveDelta(double deltaMm);
+
+  /// Whether the client supports a direct "move to top limit" command.
+  Future<bool> canMoveToTop();
+  Future<bool> canMoveToFloor();
+
+  /// Move the Z axis directly to the device's top limit if supported.
+  Future<Map<String, dynamic>> moveToTop();
+  Future<Map<String, dynamic>> moveToFloor();
+  Future<Map<String, dynamic>> manualCure(bool cure);
+  Future<Map<String, dynamic>> manualHome();
+  Future<Map<String, dynamic>> manualCommand(String command);
+  Future<Map<String, dynamic>> emergencyStop();
+  Future<void> displayTest(String test);
+
+  /// Fetch a specific 2D layer PNG from a NanoDLP-style plates endpoint.
+  /// plateId is the numeric plate identifier and layer is the layer index
+  /// (as reported by the backend). Implementations that don't support this
+  /// may return a placeholder image or empty bytes.
+  Future<Uint8List> getPlateLayerImage(int plateId, int layer);
+
+  /// Fetch recent analytics entries. `n` requests the last N entries.
+  /// Returns a list of JSON objects with keys like 'ID', 'T', 'V'.
+  Future<List<Map<String, dynamic>>> getAnalytics(int n);
+
+  /// Fetch a single analytic value by metric id (e.g. /analytic/value/6).
+  /// Returns the raw value (number or string) or null on failure.
+  Future<dynamic> getAnalyticValue(int id);
+
+  /// Tare the force sensor if supported by the backend.
+  /// Returns a boolean indicating success or failure.
+  Future<dynamic> tareForceSensor();
+}

lib/backend_service/backend_service.dart

@@ -1,29 +1,49 @@
+/*
+* Orion - Backend Service
+* Copyright (C) 2025 Open Resin Alliance
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
 import 'dart:typed_data';
-import 'package:orion/backend_service/odyssey/odyssey_client.dart';
+import 'package:orion/backend_service/backend_client.dart';
 import 'package:orion/backend_service/odyssey/odyssey_http_client.dart';
 import 'package:orion/backend_service/nanodlp/nanodlp_http_client.dart';
+import 'package:orion/backend_service/nanodlp/helpers/nano_simulated_client.dart';
 import 'package:orion/util/orion_config.dart';
 
 /// BackendService is a small façade that selects a concrete
-/// `OdysseyClient` implementation at runtime. This centralizes the
+/// `BackendClient` implementation at runtime. This centralizes the
 /// point where an alternative backend implementation (different API)
 /// can be swapped in without changing providers or UI code.
-class BackendService implements OdysseyClient {
-  final OdysseyClient _delegate;
+class BackendService implements BackendClient {
+  final BackendClient _delegate;
 
   /// Default constructor: picks the concrete implementation based on
   /// configuration (or defaults to the HTTP adapter).
-  BackendService({OdysseyClient? delegate})
+  BackendService({BackendClient? delegate})
       : _delegate = delegate ?? _chooseFromConfig();
 
-  static OdysseyClient _chooseFromConfig() {
+  static BackendClient _chooseFromConfig() {
     try {
       final cfg = OrionConfig();
-      final backend = cfg.getString('backend', category: 'advanced');
-      if (backend == 'nanodlp') {
+      // Developer-mode simulated backend flag (developer.simulated = true)
+      final simulated = cfg.getFlag('simulated', category: 'developer');
+      if (simulated) {
+        return NanoDlpSimulatedClient();
+      }
+      if (cfg.isNanoDlpMode()) {
         // Return the NanoDLP adapter when explicitly requested in config.
-        // Add a small log to aid debugging in cases where config isn't applied.
-        // Note: avoid bringing logging package into this file if not used
         return NanoDlpHttpClient();
       }
     } catch (_) {
@@ -32,7 +52,7 @@ class BackendService implements OdysseyClient {
     return OdysseyHttpClient();
   }
 
-  // Forward all OdysseyClient methods to the selected delegate.
+  // Forward all BackendClient methods to the selected delegate.
   @override
   Future<Map<String, dynamic>> listItems(
           String location, int pageSize, int pageIndex, String subdirectory) =>
@@ -71,6 +91,14 @@ class BackendService implements OdysseyClient {
   @override
   Stream<Map<String, dynamic>> getStatusStream() => _delegate.getStatusStream();
 
+  @override
+  Future<List<Map<String, dynamic>>> getNotifications() =>
+      _delegate.getNotifications();
+
+  @override
+  Future<void> disableNotification(int timestamp) =>
+      _delegate.disableNotification(timestamp);
+
   @override
   Future<void> cancelPrint() => _delegate.cancelPrint();
 
@@ -115,4 +143,18 @@ class BackendService implements OdysseyClient {
 
   @override
   Future<void> displayTest(String test) => _delegate.displayTest(test);
+
+  @override
+  Future<Uint8List> getPlateLayerImage(int plateId, int layer) =>
+      _delegate.getPlateLayerImage(plateId, layer);
+
+  @override
+  Future<List<Map<String, dynamic>>> getAnalytics(int n) =>
+      _delegate.getAnalytics(n);
+
+  @override
+  Future<dynamic> getAnalyticValue(int id) => _delegate.getAnalyticValue(id);
+
+  @override
+  Future<dynamic> tareForceSensor() => _delegate.tareForceSensor();
 }

lib/backend_service/nanodlp/helpers/nano_analytics_config.dart

@@ -0,0 +1,39 @@
+// Mapping of NanoDLP analytic metric ids (T) to canonical keys used by the UI.
+const List<Map<String, dynamic>> allChartConfig = [
+  {'key': 'LayerHeight', 'id': 0},
+  {'key': 'SolidArea', 'id': 1},
+  {'key': 'AreaCount', 'id': 2},
+  {'key': 'LargestArea', 'id': 3},
+  {'key': 'Speed', 'id': 4},
+  {'key': 'Cure', 'id': 5},
+  {'key': 'Pressure', 'id': 6},
+  {'key': 'TemperatureInside', 'id': 7},
+  {'key': 'TemperatureOutside', 'id': 8},
+  {'key': 'LayerTime', 'id': 9},
+  {'key': 'LiftHeight', 'id': 10},
+  {'key': 'TemperatureMCU', 'id': 11},
+  {'key': 'TemperatureInsideTarget', 'id': 12},
+  {'key': 'TemperatureOutsideTarget', 'id': 13},
+  {'key': 'TemperatureMCUTarget', 'id': 14},
+  {'key': 'MCUFanRPM', 'id': 15},
+  {'key': 'UVFanRPM', 'id': 16},
+  {'key': 'DynamicWait', 'id': 17},
+  {'key': 'TemperatureVat', 'id': 18},
+  {'key': 'TemperatureVatTarget', 'id': 19},
+  {'key': 'PTCFanRPM', 'id': 20},
+  {'key': 'AEGISFanRPM', 'id': 21},
+  {'key': 'TemperatureChamber', 'id': 22},
+  {'key': 'TemperatureChamberTarget', 'id': 23},
+  {'key': 'TemperaturePTC', 'id': 24},
+  {'key': 'TemperaturePTCTarget', 'id': 25},
+  {'key': 'VOCInlet', 'id': 26},
+  {'key': 'VOCOutlet', 'id': 27},
+];
+
+String? idToKey(int id) {
+  for (final e in allChartConfig) {
+    final val = e['id'];
+    if (val is int && val == id) return e['key'] as String?;
+  }
+  return null;
+}