Feature/api integration

.gitignore

@@ -46,3 +46,6 @@ app.*.map.json
 
 # Coverage related
 coverage/
+
+# API
+.env

integration_test/ocr_provider_test.dart

@@ -20,20 +20,16 @@ void main() {
 
   setUp(() {
     provider = OCRProviderImpl(
-      baseUrl: 'https://901b-39-115-116-188.ngrok-free.app',
+      baseUrl: 'https://b08b-165-194-27-212.ngrok-free.app',
     );
   });
 
   test('process()는 OCRResult를 반환해야 한다', () async {
     final pdfPath = await copyAssetToLocal('integration_test/assets/test.pdf');
     final result = await provider.process(pdfPath);
     expect(result, isA<OCRResult>());
-    expect(result.title, isNotEmpty);
-    expect(result.chapters, isNotEmpty);
     expect(result.pages, isNotEmpty);
-    expect(result.metadata.totalPages, isNotEmpty);
-    expect(result.metadata.processingTime, isNotEmpty);
-    expect(result.metadata.totalFigures, isNotEmpty);
+    expect(result.figures, isNotEmpty);
   }, timeout: const Timeout(Duration(minutes: 15)));
 
   test('process()에 잘못된 경로를 넣어도 예외가 발생하지 않는다', () async {

integration_test/pdf_provider_test.dart

@@ -20,12 +20,10 @@ Future<String> copyAssetToLocal(String assetPath) async {
 class DummyOcrService implements OCRProvider {
   @override
   Future<OCRResult> process(String pdfPath) async {
-    return OCRResult(
-      title: 'test',
-      chapters: [],
+    return const OCRResult(
+      metadata: Metadata(title: 'test', author: 'test', pages: 0),
       pages: [],
       figures: [],
-      metadata: Metadata(totalPages: 0, processingTime: 0, totalFigures: 0),
     );
   }
 }

lib/features/home/screens/home_widget.dart

@@ -36,6 +36,8 @@ class _HomeWidgetState extends State<HomeWidget> {
   }
 
   Widget _buildNavigationRail(BuildContext context) {
+    final theme = Theme.of(context);
+
     return NavigationRail(
       useIndicator: true,
       labelType: NavigationRailLabelType.all,
@@ -48,6 +50,31 @@ class _HomeWidgetState extends State<HomeWidget> {
         setState(() => _selectedIndex = index);
       },
       minWidth: 80,
+      trailing: Expanded(
+        child: Align(
+          alignment: Alignment.bottomCenter,
+          child: Padding(
+            padding: const EdgeInsets.only(bottom: 20),
+            child: Column(
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                IconButton(
+                  onPressed: () {
+                    Navigator.of(context).pushNamed('/ai-settings');
+                  },
+                  icon: Icon(Icons.smart_toy, color: theme.colorScheme.primary),
+                  tooltip: 'AI 설정',
+                  style: IconButton.styleFrom(
+                    backgroundColor: theme.colorScheme.primaryContainer,
+                    foregroundColor: theme.colorScheme.onPrimaryContainer,
+                    padding: const EdgeInsets.all(12),
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ),
+      ),
     );
   }
 

lib/features/pdf_viewer/models/pdf_data_viewmodel.dart

@@ -0,0 +1,212 @@
+import 'package:flutter/material.dart';
+import 'package:snapfig/shared/services/pdf_core/pdf_core.dart';
+import 'package:pdfrx/pdfrx.dart';
+import 'package:collection/collection.dart';
+import 'dart:ui' as ui;
+
+class PDFDataViewModel extends ChangeNotifier {
+  final PDFProvider _pdfProvider;
+  // Pdf Ocr result
+  BasePdf? _pdfModel;
+  List<BasePage> _pages = [];
+  Map<int, List<BaseLayout>> _layoutsByPage = {};
+  // Pdf data
+  PdfDocument? _pdfDocument;
+  bool _isDataLoaded = false;
+  bool _isLoading = true;
+  bool _isError = false;
+  String? _errorMessage;
+  List<PdfOutlineNode> _outlines = [];
+
+  bool get isDataLoaded => _isDataLoaded;
+  bool get isLoading => _isLoading;
+  bool get isFailed => _isError;
+  String? get errorMessage => _errorMessage;
+  List<PdfOutlineNode> get outlines => _outlines;
+  Map<int, List<BaseLayout>> get layoutsByPage => _layoutsByPage;
+  List<BasePage> get pages => _pages;
+  List<BaseLayout> get figures =>
+      _layoutsByPage.values
+          .expand((e) => e)
+          .where((e) => e.type == LayoutType.figure)
+          .toList();
+  String get pdfTitle => _pdfModel?.name ?? '';
+
+  PDFDataViewModel({required PDFProvider pdfProvider})
+    : _pdfProvider = pdfProvider;
+
+  @override
+  void dispose() {
+    super.dispose();
+  }
+
+  void loadPDFData(String path, PdfDocument pdfDocument) async {
+    if (_isDataLoaded) return;
+    _pdfDocument = pdfDocument;
+    _isLoading = true;
+    notifyListeners();
+    try {
+      // Load pdf model from database
+      final pdfModel = await _pdfProvider.getPDF(path);
+      if (pdfModel == null) {
+        _isError = true;
+        _errorMessage = 'OCR처리가 완료되지 않은 파일입니다.';
+        notifyListeners();
+        return;
+      }
+      _pages = await pdfModel.getPages();
+      _pdfModel = pdfModel;
+      _outlines = await _pdfDocument!.loadOutline();
+      _layoutsByPage = await Future.wait(
+        _pages.map((page) async {
+          final layouts = await page.getLayouts();
+          return {page.pageIndex: layouts.toList()};
+        }),
+      ).then((value) => Map.fromEntries(value.expand((e) => e.entries)));
+      _isLoading = false;
+      notifyListeners();
+    } catch (e) {
+      _isError = true;
+      _errorMessage = e.toString();
+    }
+    _isLoading = false;
+    _isDataLoaded = true;
+    notifyListeners();
+  }
+
+  int? getPageNumberForFigure(BaseLayout figure) {
+    if (figure.type != LayoutType.figure) return null;
+    return _layoutsByPage.entries
+        .firstWhereOrNull((entry) => entry.value.contains(figure))
+        ?.key;
+  }
+
+  int? getPageNumberForReference(BaseLayout reference) {
+    if (reference.type != LayoutType.figureReference) return null;
+    return _layoutsByPage.entries
+        .firstWhereOrNull((entry) => entry.value.contains(reference))
+        ?.key;
+  }
+
+  BaseLayout? findFigureByReference(BaseLayout reference) {
+    if (reference.type != LayoutType.figureReference) return null;
+    final referencedId = reference.referencedFigureId;
+    if (referencedId == null) return null;
+    return _layoutsByPage.entries
+        .expand((entry) => entry.value)
+        .firstWhereOrNull((layout) => layout.figureId == referencedId);
+  }
+
+  Future<ui.Image?> getFigureImage(BaseLayout figure) async {
+    if (figure.type != LayoutType.figure || _pdfDocument == null) {
+      print(
+        '❌ Invalid input: figure type=${figure.type}, pdfDocument=${_pdfDocument != null}',
+      );
+      return null;
+    }
+
+    final pageIndex = getPageNumberForFigure(figure);
+    if (pageIndex == null) {
+      print('❌ Could not find page for figure: ${figure.figureId}');
+      return null;
+    }
+
+    // Validate page index bounds
+    if (pageIndex < 0 || pageIndex >= _pages.length) {
+      print(
+        '❌ Page index out of bounds: $pageIndex (total pages: ${_pages.length})',
+      );
+      return null;
+    }
+
+    // Convert 0-based index to 1-based page number for PDF document lookup
+    final pageNumber = pageIndex + 1;
+    final pageDoc = _pdfDocument!.pages.firstWhereOrNull(
+      (p) => p.pageNumber == pageNumber,
+    );
+    if (pageDoc == null) {
+      print('❌ Could not find PDF page: $pageNumber');
+      return null;
+    }
+
+    print('✅ Processing figure on page $pageNumber (index: $pageIndex)');
+    print('   PDF page size: ${pageDoc.width}x${pageDoc.height}');
+    print(
+      '   OCR page size: ${_pages[pageIndex].width}x${_pages[pageIndex].height}',
+    );
+
+    // Calculate scale factors
+    final scaleX = pageDoc.width / _pages[pageIndex].width;
+    final scaleY = pageDoc.height / _pages[pageIndex].height;
+
+    print('   Scale factors: scaleX=$scaleX, scaleY=$scaleY');
+
+    final figureRect = figure.rect;
+
+    // Add padding around the figure to prevent cropping (10% of figure size, minimum 5 pixels)
+    final paddingX = (figureRect.width * 0.1).clamp(5.0, 20.0);
+    final paddingY = (figureRect.height * 0.1).clamp(5.0, 20.0);
+
+    // Apply padding to the original rectangle
+    final paddedLeft = (figureRect.left - paddingX) * scaleX;
+    final paddedTop = (figureRect.top - paddingY) * scaleY;
+    final paddedWidth = (figureRect.width + paddingX * 2) * scaleX;
+    final paddedHeight = (figureRect.height + paddingY * 2) * scaleY;
+
+    print('   Original rect: ${figureRect.toString()}');
+    print(
+      '   Padded rect: left=$paddedLeft, top=$paddedTop, width=$paddedWidth, height=$paddedHeight',
+    );
+
+    // Validate dimensions
+    if (paddedWidth <= 0 || paddedHeight <= 0) {
+      print('❌ Invalid dimensions after scaling and padding');
+      return null;
+    }
+
+    // Improved clamping that preserves as much of the figure as possible
+    final clampedLeft = paddedLeft.clamp(0.0, pageDoc.width.toDouble());
+    final clampedTop = paddedTop.clamp(0.0, pageDoc.height.toDouble());
+
+    // Calculate maximum available width/height from clamped position
+    final maxAvailableWidth = pageDoc.width - clampedLeft;
+    final maxAvailableHeight = pageDoc.height - clampedTop;
+
+    // Use the smaller of padded dimensions or available space
+    final clampedWidth = paddedWidth.clamp(1.0, maxAvailableWidth);
+    final clampedHeight = paddedHeight.clamp(1.0, maxAvailableHeight);
+
+    if (clampedLeft != paddedLeft ||
+        clampedTop != paddedTop ||
+        clampedWidth != paddedWidth ||
+        clampedHeight != paddedHeight) {
+      print(
+        '⚠️  Adjusted coordinates: left=$clampedLeft, top=$clampedTop, width=$clampedWidth, height=$clampedHeight',
+      );
+    }
+
+    // Use round() instead of toInt() for better precision
+    final renderX = clampedLeft.round();
+    final renderY = clampedTop.round();
+    final renderWidth = clampedWidth.round();
+    final renderHeight = clampedHeight.round();
+
+    print(
+      '   Final render params: x=$renderX, y=$renderY, width=$renderWidth, height=$renderHeight',
+    );
+
+    final image = await pageDoc.render(
+      x: renderX,
+      y: renderY,
+      width: renderWidth,
+      height: renderHeight,
+    );
+    if (image == null) {
+      print('❌ Failed to render image');
+      return null;
+    }
+    final imageData = await image.createImage();
+    print('✅ Successfully rendered figure image');
+    return imageData;
+  }
+}