Flutter Camera Session Manager

A healthcare-focused Flutter mobile application designed for session-based image capture workflows with SQLite metadata storage and efficient session management capabilities.

📱 Overview

This application enables healthcare professionals to capture and organize patient images in structured sessions, storing essential metadata for easy retrieval and documentation purposes. Built specifically for Android platforms with an offline-first architecture.

✨ Key Features

📸 Session-Based Image Capture

• Start and manage photo capture sessions
• Capture multiple images within a single session
• Real-time camera preview with smooth 30+ FPS performance
• Image counter and thumbnail preview during capture
• Session completion with metadata entry

💾 Data Storage & Organization

• Local Image Storage: Android/media/<AppName>/Sessions/<SessionID>/IMG_timestamp.jpg
• SQLite Database: Session metadata storage (SessionID, Name, Age, Timestamp)
• Organized file structure by SessionID for easy management
• Offline-only storage (no cloud dependency)

🔍 Search & Retrieval

• Search sessions by SessionID
• Display complete session metadata
• View all images captured in selected sessions
• Gallery view for session image browsing

🎨 User Interface

• Material 3 design system implementation
• Healthcare-optimized UI/UX design
• Clean, professional interface
• Responsive design for various screen sizes

🛠️ Technical Stack

Flutter Dependencies

dependencies:
  flutter:
    sdk: flutter
  camera: ^0.10.5+2          # Camera functionality
  sqflite: ^2.3.0           # SQLite database operations
  path_provider: ^2.0.15    # Device storage paths
  permission_handler: ^10.4.3 # Camera and storage permissions

Architecture

• Clean code structure with separation of concerns
• State management using Provider/Bloc pattern
• Material 3 design system
• Modular component architecture

🚀 Getting Started

Prerequisites

• Flutter SDK (3.0.0 or higher)
• Android Studio or VS Code with Flutter extensions
• Android device or emulator (API level 21+)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/flutter-camera-session-manager.git
   cd flutter-camera-session-manager

2. Install dependencies

   flutter pub get

3. Run the application

   flutter run

Permissions Setup

The app requires the following permissions (automatically handled):

• Camera access for image capture
• Storage access for saving images
• No internet permission required (offline app)

📱 Usage Workflow

Starting a New Session

1. Tap "Start Session" on the main screen
2. Camera preview opens with live feed
3. Capture multiple images using the capture button
4. View captured images in thumbnail preview
5. Tap "End Session" when complete

Session Completion

1. Fill in the metadata form:
   • SessionID: Unique alphanumeric identifier
   • Name: Patient/subject name (minimum 2 characters)
   • Age: Numeric value (1-120 range)
2. Tap "Save Session" to store data
3. Images are organized in dedicated session folder

Searching Sessions

1. Navigate to "Search Sessions"
2. Enter SessionID in search field
3. View session metadata and captured images
4. Browse images in gallery view

📁 File Structure

lib/
├── main.dart                 # App entry point
├── models/                   # Data models
│   ├── session.dart
│   └── session_database.dart
├── screens/                  # UI screens
│   ├── home_screen.dart
│   ├── camera_screen.dart
│   ├── session_form_screen.dart
│   └── search_screen.dart
├── widgets/                  # Reusable components
│   ├── session_card.dart
│   └── image_gallery.dart

✅ Validation Rules

• SessionID: Required, alphanumeric, must be unique
• Name: Required, minimum 2 characters
• Age: Required, numeric, range 1-120
• Images: Minimum 1 image required per session

🔧 Error Handling

The application handles various error scenarios:

• Camera permission denied
• Storage permission denied
• Invalid SessionID format
• Database connection errors
• Image save failures
• Empty search results
• Network connectivity issues

📈 Performance Optimization

• Smooth camera preview (30+ FPS)
• Fast image capture and save operations
• Responsive UI during database operations
• Efficient image loading in gallery view
• Optimized SQLite queries
• Memory management for large image sets

🎥 Demo & Resources

For demo screenshots, APK file, and additional resources, visit: https://drive.google.com/drive/folders/1ed2Dq2lW6Y7B-etLz7c7FzTO8CO459JW?usp=sharing

🏗️ Build Instructions

Debug Build

flutter build apk --debug

Release Build

flutter build apk --release

Split APKs by ABI

flutter build apk --split-per-abi

🧪 Testing

Unit Tests

flutter test

Integration Tests

flutter drive --target=test_driver/app.dart

🔮 Future Enhancements

• iOS platform support
• Cloud storage integration
• Advanced image editing features
• Batch session operations
• Export functionality (PDF reports)
• Session analytics and reporting
• Multi-language support

Built with ❤️ using Flutter for healthcare professionals