feat(scanner): POC funcional (UI + leitura nativa + histórico)

[vagnerleitte]

POC de Scanner — Ionic + Capacitor

Esta PR entrega uma POC funcional do app de leitura de QR/Barcodes com foco em simplicidade e base sólida para evoluir amanhã com reorganização por design atômico.

✨ Visão Geral

• Tela Scanner (UI+UX): header, overlay com moldura tracejada, watermark do logo, FAB central, barra de ações inferior.
• Leitura nativa: integração com @capacitor/barcode-scanner@^2.1.0 (API CapacitorBarcodeScanner.scanBarcode).
• Histórico: persistência via @capacitor/preferences, listagem com copy/limpar.
• Permissões: Android (CAMERA) e iOS (NSCameraUsageDescription).
• Tema: tokens refinados (cores, surfaces, elevação, scan-outline) e dark mode.
• Build iOS: melhorias para arquivar em ambiente sem device support atualizado.

🔧 Alterações Principais

• Scanner UI
  • src/app/scan/scan.page.{ts,html,scss}
  • FAB inicia/cancela fluxo local; resultado salvo no histórico.
  • Watermark do logo (src/assets/logo.png) e overlay com --scan-outline.
• Serviço de leitura
  • src/app/services/qr.ts: uso do CapacitorBarcodeScanner.scanBarcode(...) (retorna ScanResult).
• Histórico
  • src/app/services/storage.ts: salva {content, timestamp} com Preferences.
  • src/app/history/*: lista, limpa e copia.
• Navegação / Tabs
  • src/app/tabs/*: imports corrigidos (standalone) para IonTabs/TabBar/TabButton/Icon/Label.
• Tema / Estilos
  • src/theme/variables.scss: tokens completos (primary/secondary/tertiary/status), --surface, --surface-2, --elevation-1, --scan-outline.
  • src/global.scss: suporte a background transparente durante o scan quando necessário.
• Permissões nativas
  • Android: android/app/src/main/AndroidManifest.xml — CAMERA + features opcionais.
  • iOS: ios/App/App/Info.plist — NSCameraUsageDescription.
• Logo / Splash / Favicon
  • Watermark e favicon usam src/assets/logo.png.
  • Script scripts/apply-splash.mjs para copiar o logo às pastas nativas.
• Build / Patch iOS
  • build.sh: usa npm run build, aplica patch iOS, -destination 'generic/platform=iOS' no archive.
  • scripts/patch-cap-ios.mjs + postinstall: corrige MSEC_PER_SEC (→ 1000.0) e return no getter do Encoder em @capacitor/ios (hotfix em node_modules para viabilizar a POC).

🧪 Como Validar

• Web (UI): npm start e abrir /scan (leitura nativa não funciona no browser).
• Android / iOS:
  1. npm run native:sync
  2. npx cap run android ou npx cap run ios
  3. Permitir acesso à câmera quando solicitado.

📦 Build iOS (CI / Mac na nuvem)

• bash build.sh
• Usa destino genérico do iOS (não depende do device plugado) e aplica patches conhecidos do Capacitor.

✅ Pronto para Merge

• Mantive a POC simples e isolada. Você pode mesclar quando quiser.

▶️ Próximos Passos (amanhã)

• Reorganizar páginas e componentes obedecendo o Design Atômico (atoms → molecules → organisms → templates → pages).
• Implementar ações pendentes na barra inferior (Flash, Gallery, Create).
• Agrupar histórico por período e ícones por tipo de conteúdo.
• Gerar assets nativos definitivos com @capacitor/assets.