frontend readme + removed unnecessary comments

Author: alexandraontica

README.md

@@ -38,7 +38,7 @@ flutter run
 ```
 
 ## AI Model
-A Google AI gesture recognition model was used for ASL image recognition. This model was trained on a 2.7GB curated dataset compiled from various Kaggle repositories.
+A Google AI gesture recognition model was used for American Sign Language (ASL) image recognition. This model was trained on a 2.4GB dataset compiled from various Kaggle repositories.
 The model achieves an accuracy of 93.6% and a loss of 0.1563. 
 In practice, the lighting of the environment significantly affects the accuracy of classification because the training data primarily consists of images with good to excellent lighting conditions.
 Other Hugging Face alternatives tested were slower and less accurate overall, based on our evaluations. Additionally, the training data predominantly features right-handed photos, so ASL letter recognition is expected to perform better for right-handed gestures.
@@ -49,6 +49,9 @@ A Mistral alternative was tested but found to be less effective. The OpenAI solu
 
 ## Frontend
 
+- the `sign_language_translator/` directory
+
+### Structure
 ```
 lib/
 ├── main.dart 
@@ -57,6 +60,22 @@ lib/
 │   ├── camera.dart
 │   └── instructions_pop_up.dart
 └── services/
-    └── network.dart
+    └── network.dart   # handles API requests for image upload and translation retrieval.
 ```
 
+### Components
+The app consists of one page with the following components:
+- camera, used to capture the signs that will be translated
+    - button to change the camera in use (rear/frontal camera)
+- button to start/stop the translation
+- button that opens a pop-up with the usage instructions for the app
+- a text component, where the translation will be displayed
+
+
+### Translation Workflow
+1. Open the app.
+2. Tap **Start Translation** to begin.
+3. The app captures images periodically and sends them to the backend for processing.
+4. Tap **Stop Translation** to end the process.
+5. View the translation result displayed on the screen.
+

sign_language_translator/lib/components/camera.dart

@@ -1,4 +1,4 @@
-import 'dart:async'; // pentru a folosi Timer-ul
+import 'dart:async';
 import 'package:camera/camera.dart';
 import 'package:flutter/material.dart';
 import 'package:sign_language_translator/services/network.dart';
@@ -16,10 +16,9 @@ class CameraState extends State<Camera> {
   late List<CameraDescription> cameras;
   late CameraController cameraController;
   bool isRearCamera = true;
-  Timer? _timer; // Timer pentru trimiterea imaginilor
-  bool _isTranslationActive = false; // Flag pentru a controla procesul de traducere
+  Timer? _timer;
+  bool _isTranslationActive = false;
 
-  // Initialize Network instance
   final Network network = Network();
 
   void startCamera(int camera) async {
@@ -54,7 +53,7 @@ class CameraState extends State<Camera> {
 
   @override
   void dispose() {
-    _timer?.cancel(); // Oprire timer când widget-ul este distrus
+    _timer?.cancel();
     cameraController.dispose();
     super.dispose();
   }
@@ -127,7 +126,7 @@ class CameraState extends State<Camera> {
 
   void _startSendingImages() {
     _isTranslationActive = true;
-    _timer?.cancel(); // Oprire timer existent
+    _timer?.cancel();
     _timer = Timer.periodic(const Duration(milliseconds: 500), (timer) async {
       if (_isTranslationActive &&
           cameraController.value.isInitialized &&
@@ -149,7 +148,7 @@ class CameraState extends State<Camera> {
 
   Future<String> stopAndGetTranslation() async {
     _isTranslationActive = false;
-    _timer?.cancel(); // Oprire timer
+    _timer?.cancel();
 
     // asigura ca se opreste upload-ul
     await Future.delayed(const Duration(milliseconds: 50));