StampSight — Official Guide V6

Outil de preuve terrain

Capturer, structurer et exporter des preuves fiables.

StampSight permet de créer des preuves photo locales, de les enrichir avec des métadonnées utiles, de les annoter, de les organiser dans une bibliothèque, puis de les exporter en image, PDF, CSV, JSON ou ZIP selon les cas.

Capture simple & multi-photo Date / heure / GPS / adresse Annotations non destructives OCR on-device PDF unitaires & groupés Intégrité locale SHA-256

Workflow principal

Capture terrain, contexte actif et bibliothèque locale dans un flux unique.

Vue d’ensemble

Cette section résume ce que StampSight permet réellement aujourd’hui, pour qui l’application est pensée et comment lire ce guide dans le bon ordre.

Mode

Local-first

Entrée

Photo

Sortie

PDF / Image

Usage

Terrain

Ce que fait réellement la V1

La V1 permet de capturer des preuves photo, de les enrichir avec date, heure, localisation si autorisée, contexte client/site, note, annotations et OCR, puis de les organiser localement et de les exporter rapidement.

Pour quel usage

Inspection, livraison, chantier, incident, inventaire et autres opérations terrain qui exigent un flux rapide de capture, consultation, vérification et export sans dépendre d’un back-office.

Lecture recommandée

Commencez par Démarrage, puis lisez Capture, Métadonnées et Bibliothèque. Revenez ensuite sur Exports, Intégrité et Premium pour affiner votre usage.

Démarrage et permissions

Avant de créer une première preuve, il faut comprendre comment les permissions influencent le résultat final, notamment pour la caméra et la localisation.

Caméra — pas à pas

Lancer la capture

Ouvrez le flux de capture depuis l’écran prévu pour créer une preuve.

Lire la pré-sheet

Avant l’appel à la caméra, StampSight peut afficher une sheet expliquant la permission et la demande à venir.

Autoriser la caméra

Acceptez la demande système pour permettre l’ouverture de la caméra native.

Gérer un refus

Si la permission a déjà été refusée, l’application peut proposer une redirection vers les réglages système.

Localisation — comment la comprendre

Savoir à quoi elle sert

La localisation permet d’enrichir une preuve avec latitude, longitude et adresse si disponibles.

Comprendre la logique actuelle

En confirmation, la localisation peut être récupérée silencieusement si la permission est déjà accordée, sans afficher de popup supplémentaire.

Après sauvegarde

Une tentative d’enrichissement peut avoir lieu après la sauvegarde de la preuve, avec GPS + reverse geocoding.

Utiliser Réglages si besoin

La page Réglages > Permissions permet de vérifier l’état caméra / localisation et d’ouvrir les réglages système.

Nuance importante

Deux stacks de permissions coexistent selon les zones : permission_handler dans Réglages et geolocator dans capture / enrichissement. Cela fonctionne, mais l’UX peut varier selon l’OS et l’état exact des permissions.

Créer une preuve

La capture est le cœur de StampSight. Vous pouvez créer une preuve simple ou une preuve multi-photo, puis la finaliser avant enregistrement.

Flux simple — une photo

Ouvrir la caméra

Lancez la capture et prenez une photo avec la caméra native.

Passer en confirmation

Après la capture, l’application vous amène à l’écran de confirmation.

Compléter la preuve

Ajoutez les informations utiles : type, contexte, note et autres métadonnées disponibles.

Sauvegarder

Une fois la preuve validée, les chemins de brouillon sont “committés” en chemins finaux.

Flux multi-photo — pas à pas

Prendre une première photo

Commencez par la vue la plus utile : générale ou contextuelle.

Choisir “Ajouter une autre photo”

Après chaque capture, une sheet propose de continuer ou d’ajouter une nouvelle photo.

Répéter si nécessaire

Ajoutez autant de photos que nécessaire pour couvrir contexte + détails.

Vérifier sur l’écran de confirmation

Vous pouvez encore ajouter une photo ou retirer une photo avec confirmation avant finalisation.

Ce qui se passe techniquement

Avant la sauvegarde finale, les images sont copiées sous forme de brouillon dans Documents/proofs/ avec un préfixe de type draft_. La validation finale confirme ensuite les chemins définitifs.

Bonnes pratiques de capture

Prendre une vue globale puis des détails.
Éviter les images floues ou trop éloignées.
Capturer immédiatement sur le terrain, pas plus tard.
Utiliser plusieurs photos dès que la situation est sensible.

Exemple de capture sur le terrain : prise de preuve dans un contexte réel.

Écran de confirmation : revue de la preuve, contexte et finalisation avant sauvegarde.

Métadonnées et contexte

Une preuve n’est pas seulement une image. StampSight stocke aussi des informations qui améliorent la compréhension, la recherche et l’export.

Élément	Ce que c’est	Comment l’utiliser
Date / heure	`createdAt` est figé à l’ouverture de la confirmation. Les overlays `dateText` et `timeText` reflètent ces données.	Utilisez ces informations comme ancrage temporel principal de la preuve.
Localisation	Si disponible, la preuve peut stocker `address`, `latitude` et `longitude`, ainsi qu’un overlay `addressText`.	Activez la localisation si vous voulez renforcer la valeur contextuelle de vos preuves terrain.
Type de preuve	Le type repose sur un enum : inspection, delivery, workProgress, incident, inventory, other.	Choisissez toujours un type cohérent : cela améliore les filtres, la lecture et les exports.
Texte	Les champs `title` et `description` sont utilisés dans l’affichage, la recherche et le filtrage.	Rédigez des descriptions factuelles et compréhensibles plus tard, pas seulement au moment de la capture.
Contexte métier	Les champs `clientId` et `siteMissionId` relient la preuve à un contexte exploitable dans la bibliothèque et certains exports.	Associez la preuve au bon client / site dès la création si vous voulez filtrer et exporter proprement ensuite.
Multi-photo	Les photos supplémentaires peuvent être persistées via `additionalImagePaths` ou `photoItems`.	Utilisez la multi-photo pour documenter une situation sous plusieurs angles sans créer plusieurs preuves isolées.

Conseil pratique

La combinaison la plus utile est généralement : type correct + contexte client/site + note claire + localisation autorisée + multi-photo si nécessaire.

Bibliothèque et organisation

La bibliothèque est l’espace où vous retrouvez, triez, filtrez, comparez et gérez vos preuves locales, aussi bien sur téléphone que sur tablette.

Comment retrouver une preuve

Ouvrir la bibliothèque

La liste des preuves locales s’affiche en grille, adaptée au format téléphone ou tablette.

Utiliser la recherche

La recherche locale peut matcher sur titre, description, type, date/heure overlay, adresse, client/société et site.

Utiliser le tri

Choisissez entre plus récentes, plus anciennes ou favoris d’abord selon votre objectif.

Utiliser les filtres

Affinez ensuite avec les filtres rapides et avancés pour réduire le nombre de résultats.

Filtres disponibles

Tous Non classé Par client Par site Favoris Coffre / sensible Par type

Les filtres avancés permettent aussi une plage de dates, des présélections, un tri-état “avec note”, “avec GPS”, “avec PDF déjà généré”, ainsi que des critères de classement client / site.

Mode sélection multi-preuves

Exporter un PDF groupé si vous êtes Pro et si l’option est disponible.
Comparer exactement deux preuves.
Basculer Favori en masse.
Basculer le marquage sensible / coffre en masse.
Supprimer plusieurs preuves en une fois.

Conseil d’usage

Le meilleur usage de la bibliothèque consiste à garder une nomenclature cohérente : même logique de type, même logique de contexte, notes courtes mais factuelles. C’est ce qui rend les filtres réellement puissants.

Nuance

Le filtre “Avec PDF” repose sur lastPdfGeneratedAt != null. Il indique qu’un PDF a déjà été généré, mais pas forcément que le fichier est encore présent ou valide au moment où vous appliquez ce filtre.

Bibliothèque locale avec recherche, filtres, session active et grille de preuves.

Détail d’une preuve

L’écran de détail permet de relire une preuve, de vérifier ses métadonnées, d’accéder aux actions, d’ouvrir les exports, d’annoter, d’utiliser l’OCR et de consulter les informations d’intégrité locale.

Ce qu’il faut vérifier en priorité

Les photos principales et additionnelles.
La date et l’heure de la preuve.
L’adresse, la latitude et la longitude si disponibles.
Le type, le contexte et la note.
La présence d’un dernier PDF généré et de ses métadonnées associées.

Actions typiques depuis le détail

Exporter ou partager.
Accéder aux actions “More” via la barre dédiée.
Lancer l’annotation.
Lancer l’OCR sur la photo active.
Vérifier l’intégrité locale.
Supprimer la preuve avec dialogue de confirmation.

Suppression

La suppression d’une preuve depuis l’interface est bien confirmée. En revanche, la suppression explicite des fichiers médias sur disque n’est pas confirmée dans ce périmètre d’audit.

Annotations, cachet, signature et OCR

StampSight ne se limite pas à la capture brute. L’application permet aussi d’enrichir visuellement chaque photo sans modifier l’original de manière destructive.

Outils d’annotation

Les outils confirmés dans le code sont : flèche, ellipse, rectangle, stylo et marqueur numéroté.

Nature des overlays

Les annotations sont persistées via photoItems et la compatibilité overlayData. Il s’agit d’un enrichissement non destructif.

Cachet et signature

Des modèles de cachet / signature sont présents et intégrés aux overlays consommés ensuite par les exports image et PDF.

OCR on-device — comment l’utiliser

Ouvrir une preuve

Accédez au détail de la preuve puis sélectionnez la photo pertinente si nécessaire.

Lancer l’OCR

L’OCR s’exécute sur la photo active.

Lire le résultat

Le texte détecté est affiché dans une bottom sheet.

Copier

Une action de copie permet de récupérer le texte pour un autre usage.

Comment bien utiliser les annotations

Utilisez la flèche pour désigner un point précis.
Utilisez rectangle ou ellipse pour encadrer une zone importante.
Utilisez le stylo avec retenue : il doit clarifier, pas surcharger.
Utilisez les marqueurs numérotés pour ordonner plusieurs points d’attention.

Exemple d’annotation : flèche, cercle, marqueurs, cachet et signature appliqués à une preuve.

Exports et partage

StampSight propose plusieurs sorties : image dérivée, PDF unitaire, PDF groupé, CSV, JSON et ZIP complet dans le cadre Pro. Cette section explique comment les utiliser correctement.

Export image — pas à pas

Ouvrir une preuve

Accédez au détail de la preuve que vous souhaitez exporter.

Lancer l’export image

L’application génère un dérivé watermarké avec overlays. L’original n’est pas modifié.

Choisir le mode de sortie

Le flux tente un “Save As” via file_selector. Si cela échoue sur certains appareils Android, un fallback vers la share sheet est prévu.

Partager ou enregistrer

Utilisez le fichier dérivé pour l’envoi ou l’archivage externe.

PDF unitaire — pas à pas

Ouvrir la preuve

Le flux part généralement du détail de la preuve.

Générer le PDF

Le PDF est généré localement avec les options d’export définies dans Réglages.

Exécuter la post-action

Selon les préférences, l’application peut ensuite ouvrir le PDF ou proposer un partage.

Retrouver la trace

Le modèle peut stocker le chemin du dernier PDF unitaire, son hash et sa date de génération.

PDF groupé

Le PDF groupé se lance depuis la bibliothèque en mode sélection. Il faut sélectionner plusieurs preuves, puis utiliser l’action d’export groupé. Cette fonction est réservée au mode Pro.

Exports structurés

Les exports CSV et JSON passent par la share sheet. Le JSON suit le schéma stampsight.proofs.export.v1. Ces exports contiennent des métadonnées et des chemins d’images, mais ne constituent pas un package média autonome.

Backup ZIP complet

Le ZIP complet, réservé au mode Pro, génère un bundle temporaire contenant un PDF unitaire par preuve, organisé par dossiers Client / Site / … puis partagé via la share sheet.

Branding et options d’export

Les réglages peuvent inclure : toutes les photos, style standard/premium, branding on/off, bloc crédibilité, localisation détaillée, QR web/doc et ordre de tri dans l’export.

Nuance Android

Le “Save As” de l’export image ou d’autres flux peut dépendre du comportement du picker SAF et de la ROM. Un fallback explicite vers la share sheet existe pour couvrir ces cas.

Export PDF professionnel : branding, contexte, métadonnées et visuels prêts à partager.

Vérification locale : hash, historique PDF, QR et état d’intégrité consultables depuis le détail.

Intégrité locale, hash et QR

StampSight inclut déjà une couche locale de traçabilité qui renforce la crédibilité technique des preuves et des PDF générés.

Hash image source

Le champ sourceImageSha256 est calculé à la sauvegarde. Il représente l’empreinte locale de l’image source.

Hash PDF

Le dernier PDF unitaire peut stocker son propre hash lastPdfSha256, sa date de génération et son chemin local.

Service de vérification

Un service de vérification locale permet de comparer l’empreinte attendue et l’état actuel de l’image / du PDF.

QR dans les PDF

Lors de la génération PDF, l’option QR peut insérer soit un QR “web” de type /v/<token> si la publication est disponible, soit un QR documentaire local basé sur un payload.

Comment utiliser cette partie

Générez un PDF après avoir finalisé proprement la preuve.
Consultez la section intégrité dans le détail de la preuve.
Utilisez les hashes comme indicateurs techniques locaux, pas comme preuve absolue universelle.

Nuance de production

Le pipeline de publication web et les champs liés à verificationToken, verificationPublishStatus et verificationLastPublishedAt existent dans le code, mais la disponibilité réelle du QR “web” dépend de l’infrastructure et ne peut pas être confirmée ici en production.

Section d’intégrité et de vérification accessible depuis le détail d’une preuve.

Clients, sessions et contexte de travail

StampSight permet de relier une preuve à un contexte métier, ce qui rend la bibliothèque et certains exports plus utiles dans un usage professionnel réel.

Session active

Une session active est confirmée côté UI et stockage local. Elle s’appuie sur une sheet dédiée et une datasource locale. Elle permet de conserver un contexte de travail immédiat pendant vos captures.

Lien preuve ↔ contexte

Chaque preuve peut contenir clientId et siteMissionId. Ces champs sont ensuite exploités dans les filtres de bibliothèque et, selon les options, dans les exports.

Nuance fonctionnelle

Le lien par identifiants est confirmé. En revanche, la totalité de l’UX CRUD pour créer, éditer, importer et gérer les entités client / site / mission n’est pas confirmée dans ce périmètre d’audit.

Réglages, maintenance et support

Les Réglages centralisent les permissions, les préférences d’export, le stockage, les opérations de maintenance et les liens d’aide ou légaux.

Pages confirmées

Réglages exports
Réglages permissions
Réglages stockage
Aide / légal / support

Comment utiliser les permissions

Vérifier caméra + localisation.
Utiliser les CTA vers les réglages système si nécessaire.
Contrôler l’état si la capture ou l’enrichissement ne se comporte pas comme attendu.

Maintenance / stockage

Vider le cache.
Supprimer les PDF temporaires.
Optimiser le stockage.
Réinitialiser les réglages sans effacer les données métier.
Exécuter un wipe total : purge SharedPreferences + sandbox.

Aide / légal / support

Support / bug report par email.
Liens Terms / Privacy / Legal.
FAQ basée sur les strings i18n, actuellement placeholder.

Attention

Le wipe total est une opération forte : elle efface les préférences persistées et purge la sandbox. À réserver aux cas de réinitialisation complète ou de maintenance avancée.

Premium, paywall et quota

Le modèle économique repose sur des entitlements stockés localement et sur plusieurs déclencheurs de paywall en fonction du type d’export ou du quota disponible.

Entitlements

Les états confirmés sont free, pro_subscription et pro_lifetime.

IAP confirmés

Les IDs produits confirmés sont pro_monthly, pro_annual et pro_lifetime.

Plateforme

L’initialisation Dart confirmée ici est limitée à Android. iOS n’est pas confirmé dans ce périmètre.

Déclencheurs de paywall confirmés

Plan gratuit : 5 exports PDF unitaires par mois, comptés uniquement si la génération réussit.
PDF groupé : Pro-only.
Backup ZIP complet : Pro-only.
“Save a copy” depuis le détail : Pro-only.

Comment l’expliquer à l’utilisateur

Le plan gratuit permet déjà de générer des PDF unitaires dans une limite mensuelle. Les usages batch, backup complet et certaines fonctions avancées basculent ensuite naturellement vers Pro.

Nuances, limites actuelles et lecture honnête du produit

Cette dernière section évite les promesses excessives. Elle explique clairement ce qui est partiellement confirmé, ce qui dépend de l’infrastructure et quelles limites techniques existent dans la V1 actuelle.

Fonctionnalités partielles / à nuancer

La logique de localisation peut varier selon l’OS et l’état exact des permissions.
La sheet LocationRationale existe mais semble non câblée.
La projection multi-photo combine une voie legacy additionalImagePaths et une voie plus récente photoItems.
Le QR “web” dépend d’une infra et d’un état de publication non confirmés ici en production.
La gestion complète CRUD des clients / sites / missions n’est pas confirmée dans ce périmètre.

Limites V1 constatables

Stockage 100% local-first via SharedPreferences JSON.
Pas de vraie base de données / transactions / indexation / pagination confirmées.
Recherche et filtres réalisés en mémoire.
Pas de vrai workflow produit d’archivage / restauration confirmé.
Exports CSV / JSON non autonomes avec médias intégrés.
Robustesse “au repos” du mode sensible / coffre dépendante du stockage local ; chiffrement non confirmé ici.
Édition texte post-création complète non confirmée dans ce périmètre.

Verdict produit honnête

StampSight V1 apporte déjà une vraie proposition de valeur : une preuve photo locale enrichie, consultable, exportable, annotable et vérifiable, avec une bonne puissance d’export et un mode batch côté Pro. Les limites actuelles tiennent surtout à l’absence de back-end confirmé, d’archivage avancé, d’une vraie base de données locale et d’une confirmation complète sur certaines fonctions annexes.

Field proof tool

Capture, structure, and export reliable proof.

StampSight lets you create local photo proof, enrich it with useful metadata, annotate it, organize it in a library, and then export it as an image, PDF, CSV, JSON, or ZIP depending on the use case.

Single & multi-photo capture Date / time / GPS / address Non-destructive annotations OCR on-device Single & grouped PDFs Local SHA-256 integrity

Main workflow

Field capture, active context, and local library in a single flow.

Overview

This section summarizes what StampSight actually allows today, who the app is built for, and how to read this guide in the right order.

Mode

Local-first

Input

Photo

Output

PDF / Image

Use case

Field

What V1 actually does

V1 lets you capture photo proof, enrich it with date, time, location when allowed, client/site context, notes, annotations, and OCR, then organize it locally and export it quickly.

Best for

Inspection, delivery, construction, incidents, inventory, and other field operations that require a fast flow for capture, review, verification, and export without depending on a back office.

Recommended reading

Start with Getting started, then read Capture, Metadata and Library. Then come back to Exports, Integrity and Premium to refine your use of the app.

Getting started and permissions

Before creating your first proof, it is important to understand how permissions affect the final result, especially for camera and location access.

Camera — step by step

Start capture

Open the capture flow from the screen designed to create a proof.

Read the pre-sheet

Before launching the camera, StampSight may display a sheet explaining the permission and the upcoming request.

Allow the camera

Accept the system request to allow the native camera to open.

Handle a refusal

If the permission has already been denied, the app may offer a redirect to the system settings.

Location — how to understand it

Understand what it is for

Location can enrich a proof with latitude, longitude, and address when available.

Understand the current logic

On the confirmation screen, location may be retrieved silently if permission is already granted, without showing an extra popup.

After saving

An enrichment attempt may happen after the proof is saved, using GPS plus reverse geocoding.

Use Settings if needed

The Settings > Permissions page lets you check camera / location status and open the system settings.

Important nuance

Two permission stacks coexist depending on the area: permission_handler in Settings and geolocator in capture / enrichment. It works, but the UX may vary depending on the OS and the exact permission state.

Create a proof

Capture is at the core of StampSight. You can create either a simple proof or a multi-photo proof, then finalize it before saving.

Simple flow — one photo

Open the camera

Start capture and take a photo with the native camera.

Go to confirmation

After the capture, the app takes you to the confirmation screen.

Complete the proof

Add the useful information: type, context, note, and any other available metadata.

Save

Once the proof is validated, draft paths are committed as final paths.

Multi-photo flow — step by step

Take a first photo

Start with the most useful shot: either a general view or a contextual view.

Choose “Add another photo”

After each capture, a sheet offers to continue or add another photo.

Repeat if needed

Add as many photos as needed to cover both context and details.

Review on the confirmation screen

You can still add a photo or remove a photo with confirmation before finalizing.

What happens technically

Before final save, images are copied as drafts into Documents/proofs/ with a prefix such as draft_The final validation then confirms the definitive paths.

Capture best practices

Take a wide shot first, then the details.
Avoid blurry or overly distant photos.
Capture immediately on site, not later.
Use multiple photos whenever the situation is sensitive.

Example of field capture: taking a proof in a real-world context.

Confirmation screen: proof review, context, and finalization before saving.

Metadata and context

A proof is not just an image. StampSight also stores information that improves understanding, search, and export.

Item	What it is	How to use it
Date / time	`createdAt` is frozen when the confirmation screen opens. The `dateText` and `timeText` overlays reflect this data.	Use this information as the main time anchor of the proof.
Location	If available, the proof can store `address`, `latitude` and `longitude`as well as an `addressText`.	Enable location if you want to strengthen the contextual value of your field proofs.
Proof type	The type relies on an enum: inspection, delivery, workProgress, incident, inventory, other.	Always choose a consistent type: it improves filtering, readability, and exports.
Text	The fields `title` and `description` are used for display, search, and filtering.	Write factual descriptions that still make sense later, not only at the moment of capture.
Business context	The fields `clientId` and `siteMissionId` link the proof to a usable context in the library and in some exports.	Associate the proof with the right client / site from the start if you want clean filtering and exports later.
Multi-photo	Additional photos can be persisted through `additionalImagePaths` ou `photoItems`.	Use multi-photo to document a situation from multiple angles without creating several isolated proofs.

Practical tip

The most useful combination is usually: correct type + client/site context + clear note + location enabled + multi-photo when needed.

Library and organization

The library is where you find, sort, filter, compare, and manage your local proofs, both on phone and tablet.

How to find a proof

Open the library

The list of local proofs is displayed in a grid adapted for phone or tablet.

Use search

Local search can match title, description, type, date/time overlay, address, client/company, and site.

Use sorting

Choose between newest first, oldest first, or favorites first depending on your goal.

Use filters

Then refine with quick and advanced filters to reduce the result set.

Available filters

All Unclassified By client By site Favorites Vault / sensitive By type

Advanced filters also allow a date range, presets, a tri-state for “with note,” “with GPS,” “with PDF already generated,” plus client / site classification criteria.

Multi-proof selection mode

Export a grouped PDF if you are Pro and the option is available.
Compare exactly two proofs.
Toggle Favorite in bulk.
Toggle the sensitive / vault flag in bulk.
Delete several proofs at once.

Usage tip

The best use of the library is to keep a consistent naming logic: same type logic, same context logic, short but factual notes. That is what makes the filters truly powerful.

Nuance

The “With PDF” filter relies on lastPdfGeneratedAt != nullIt indicates that a PDF has already been generated, but not necessarily that the file is still present or valid when you apply the filter.

Local library with search, filters, active session, and proof grid.

Proof detail

The detail screen lets you review a proof, check its metadata, access actions, open exports, annotate, use OCR, and inspect local integrity information.

What to check first

The main and additional photos.
The date and time of the proof.
The address, latitude, and longitude when available.
The type, context, and note.
Whether a latest generated PDF exists and its associated metadata.

Typical actions from the detail view

Export or share.
Access “More” actions through the dedicated bar.
Start annotation.
Run OCR on the active photo.
Check local integrity.
Delete the proof with a confirmation dialog.

Deletion

Deleting a proof from the interface is clearly confirmed. However, explicit deletion of media files on disk is not confirmed in this audit scope.

Annotations, stamp, signature, and OCR

StampSight is not limited to raw capture. The app also lets you visually enrich each photo without destructively modifying the original.

Annotation tools

The tools confirmed in the code are: arrow, ellipse, rectangle, pen, and numbered marker.

Nature of overlays

Annotations are persisted through photoItems and compatibility with overlayDataThese are non-destructive enrichments.

Stamp and signature

Stamp / signature templates are present and integrated into overlays that are then consumed by image and PDF exports.

On-device OCR — how to use it

Open a proof

Open the proof detail and select the relevant photo if needed.

Run OCR

OCR runs on the active photo.

Read the result

The detected text is displayed in a bottom sheet.

Copy

A copy action lets you reuse the text elsewhere.

How to use annotations well

Use the arrow to point to a precise spot.
Use rectangle or ellipse to frame an important area.
Use the pen sparingly: it should clarify, not overload.
Use numbered markers to organize several points of attention.

Annotation example: arrow, circle, markers, stamp, and signature applied to a proof.

Exports and sharing

StampSight offers several outputs: derived image, single PDF, grouped PDF, CSV, JSON, and full ZIP for Pro. This section explains how to use them correctly.

Image export — step by step

Open a proof

Open the detail screen of the proof you want to export.

Start image export

The app generates a watermarked derivative with overlays. The original is not modified.

Choose the output mode

The flow tries a “Save As” through file_selectorIf this fails on some Android devices, a fallback to the share sheet is provided.

Share or save

Use the derived file for sending or external archiving.

Single PDF — step by step

Open the proof

The flow usually starts from the proof detail screen.

Generate the PDF

The PDF is generated locally with the export options defined in Settings.

Run the post-action

Depending on preferences, the app can then open the PDF or offer sharing.

Find the trace

The model can store the path of the latest single PDF, its hash, and its generation date.

Grouped PDF

Grouped PDF is launched from the library in selection mode. You need to select several proofs, then use the grouped export action. This feature is reserved for Pro.

Structured exports

CSV and JSON exports go through the share sheet. The JSON follows the schema stampsight.proofs.export.v1These exports contain metadata and image paths, but they do not form a standalone media package.

Full ZIP backup

The full ZIP, reserved for Pro, generates a temporary bundle containing one single PDF per proof, organized by Client / Site / … folders and then shared through the share sheet.

Branding and export options

Settings can include: all photos, standard/premium style, branding on/off, credibility block, detailed location, web/doc QR, and export sort order.

Android nuance

“Save As” for image export or other flows may depend on SAF picker behavior and the ROM. An explicit fallback to the share sheet exists to cover these cases.

Professional PDF export: branding, context, metadata, and visuals ready to share.

Local verification: hash, PDF history, QR, and integrity status accessible from the detail screen.

Local integrity, hash, and QR

StampSight already includes a local traceability layer that strengthens the technical credibility of proofs and generated PDFs.

Source image hash

The field sourceImageSha256 is calculated at save time. It represents the local fingerprint of the source image.

PDF hash

The latest single PDF can store its own hash lastPdfSha256, its generation date, and its local path.

Verification service

A local verification service lets you compare the expected fingerprint and the current state of the image / PDF.

QR in PDFs

During PDF generation, the QR option can insert either a “web” QR of type /v/<token> if publication is available, or a local documentary QR based on a payload.

How to use this part

Generate a PDF after properly finalizing the proof.
Open the integrity section in the proof detail view.
Use hashes as local technical indicators, not as universal absolute proof.

Production nuance

The web publication pipeline and the fields related to verificationToken, verificationPublishStatus and verificationLastPublishedAt exist in the code, but real availability of the “web” QR depends on infrastructure and cannot be confirmed here in production.

Integrity and verification section accessible from a proof detail view.

Clients, sessions, and work context

StampSight lets you link a proof to a business context, which makes the library and some exports more useful in real professional use.

Active session

An active session is confirmed on both UI and local storage sides. It relies on a dedicated sheet and a local datasource. It keeps an immediate work context during your captures.

Proof ↔ context link

Each proof can contain clientId and siteMissionIdThese fields are then used in library filters and, depending on options, in exports.

Functional nuance

The link through IDs is confirmed. However, the full CRUD UX for creating, editing, importing, and managing client / site / mission entities is not confirmed in this audit scope.

Settings, maintenance, and support

Settings centralize permissions, export preferences, storage, maintenance operations, and help or legal links.

Confirmed pages

Export settings
Permission settings
Storage settings
Help / legal / support

How to use permissions

Check camera + location.
Use the CTAs to system settings if necessary.
Check the status if capture or enrichment does not behave as expected.

Maintenance / storage

Clear the cache.
Delete temporary PDFs.
Optimize storage.
Reset settings without erasing business data.
Run a full wipe: SharedPreferences purge + sandbox cleanup.

Help / legal / support

Support / bug report by email.
Terms / Privacy / Legal links.
FAQ based on i18n strings, currently placeholder.

Caution

A full wipe is a strong operation: it erases persisted preferences and purges the sandbox. Reserve it for full resets or advanced maintenance cases.

Premium, paywall, and quota

The business model relies on locally stored entitlements and several paywall triggers depending on export type or the available quota.

Entitlements

The confirmed states are free, pro_subscription and pro_lifetime.

Confirmed IAPs

The confirmed product IDs are pro_monthly, pro_annual and pro_lifetime.

Platform

The Dart initialization confirmed here is limited to Android. iOS is not confirmed in this scope.

Confirmed paywall triggers

Free plan: 5 single PDF exports per month, counted only when generation succeeds.
Grouped PDF: Pro-only.
Full ZIP backup: Pro-only.
“Save a copy” from the detail screen: Pro-only.

How to explain it to the user

The free plan already allows single PDF generation within a monthly limit. Batch use, full backup, and some advanced features then naturally shift to Pro.

Nuances, current limitations, and an honest reading of the product

This last section avoids excessive promises. It clearly explains what is only partially confirmed, what depends on infrastructure, and which technical limits exist in the current V1.

Partial features / points to frame carefully

Location logic may vary depending on the OS and the exact permission state.
The sheet LocationRationale exists but appears to be unwired.
Multi-photo projection combines a legacy path additionalImagePaths and a more recent path photoItems.
The “web” QR depends on infrastructure and publication state that are not confirmed here in production.
Full CRUD management for clients / sites / missions is not confirmed in this scope.

Observable V1 limitations

100% local-first storage through SharedPreferences JSON.
No real database / transactions / indexing / pagination confirmed.
Search and filters run in memory.
No real product-grade archive / restore workflow confirmed.
CSV / JSON exports are not standalone packages with embedded media.
At-rest robustness of sensitive / vault mode depends on local storage; encryption is not confirmed here.
Full post-creation text editing is not confirmed in this scope.

Honest product verdict

StampSight V1 already provides a real value proposition: enriched local photo proof that can be reviewed, exported, annotated, and verified, with strong export power and a Pro-side batch mode. Current limitations are mainly tied to the lack of confirmed backend, advanced archiving, a real local database, and full confirmation of some secondary features.