androidlover5842/TrisolarisPMS
1
0
Fork 0
Code Issues 22 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Guest Docs API: QR-first ingest (decode QR, fallback to AI extraction) #20

New Issue
Open
opened 2026-02-09 17:40:05 +05:30 by androidlover5842 · 0 comments
androidlover5842 commented 2026-02-09 17:40:05 +05:30
Owner
Copy Link

Goal

  • When an uploaded image contains a QR code, the server should try QR decoding first (fast + deterministic).
  • If QR decode fails or QR not present, fall back to AI/OCR-based extraction.

API behavior

  • On document upload:
    1. Detect QR presence.
    2. Attempt decode with strict timeout.
    3. If decoded:
      • parse payload (format-specific parser chain)
      • populate extracted fields
      • mark extraction method = QR
    4. Else:
      • run AI/OCR pipeline
      • mark extraction method = AI/OCR

UX implications (mobile)

  • Show extraction source + confidence.
  • If QR parse succeeded, show structured fields immediately.
  • If fallback AI, show "needs review" when confidence low.

Security/Compliance

  • Avoid storing raw images longer than required.
  • Do not log QR payload contents in plaintext.
  • Audit: who uploaded, when, and extraction method.

Acceptance

  • QR documents (e.g., ID/receipts with QR) extract reliably without AI latency.
  • AI fallback works when QR is absent/invalid.
Goal - When an uploaded image contains a QR code, the server should try QR decoding first (fast + deterministic). - If QR decode fails or QR not present, fall back to AI/OCR-based extraction. API behavior - On document upload: 1) Detect QR presence. 2) Attempt decode with strict timeout. 3) If decoded: - parse payload (format-specific parser chain) - populate extracted fields - mark extraction method = QR 4) Else: - run AI/OCR pipeline - mark extraction method = AI/OCR UX implications (mobile) - Show extraction source + confidence. - If QR parse succeeded, show structured fields immediately. - If fallback AI, show "needs review" when confidence low. Security/Compliance - Avoid storing raw images longer than required. - Do not log QR payload contents in plaintext. - Audit: who uploaded, when, and extraction method. Acceptance - QR documents (e.g., ID/receipts with QR) extract reliably without AI latency. - AI fallback works when QR is absent/invalid.
androidlover5842 added this to the TrisolarisPMS Roadmap project 2026-02-09 17:40:21 +05:30
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai-ocr
AI / OCR / parsing automation
 api
API / contract / retrofit
 availability
Availability / inventory / allocation
 bug
Bug / regression
 compliance
Compliance / audit / legal requirements
 feature
User-facing functionality
 finance
Cashbook / expenses / settlements
 guest
Guest profile & identity flows
 guest-docs
Guest documents (upload/view/delete)
 hr-payroll
Staff, attendance, payroll
 integration
3rd party integrations / automation
 privacy
Privacy, consent, sensitive data handling
 room-db-sync
Must follow Room DB sync rule
 room-stay
Room stay management
 security
Security / permissions / sensitive data
 telephony
Call-related UX/integrations
 ux
User experience / UI polish
 voice-ai
Speech-to-text / voice extraction
No Label ai-ocr api compliance feature guest-docs integration security
Milestone
No items
No Milestone
Projects
Clear projects
No project TrisolarisPMS Roadmap
Assignees
Clear assignees
androidlover5842
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: androidlover5842/TrisolarisPMS#20
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?