Ricardo Grangeia

ATCUD PDF QR Code Reader

Tue, 14 Apr 2026 00:00:00 +0000

HTTP service that reads and decodes QR codes from Portuguese fiscal documents (PDFs), returning structured JSON with issuer tax IDs, buyer information, document types, VAT lines, and totals.

No PDF files are stored on the server — files are written to temporary OS storage, processed, and immediately deleted.

Live Prodution

Try it online — no account needed:

qrcode.appa8.com

Features

PDF upload via HTTP multipart
QR code detection across all pages
ATCUD validation per AT specification
Raw scan endpoint (/scan) and structured parse endpoint (/parse)
Embedded Portuguese web interface
Interactive OpenAPI 3.1 / Swagger documentation
Docker and Portainer ready

API Endpoints

Endpoint	Description
`POST /api/v1/document/scan`	Raw QR code content
`POST /api/v1/document/parse`	Structured fiscal data
`GET /api/v1/version`	Service metadata
`GET /health`	Health check
`GET /docs`	Swagger documentation

Tech Stack

Go
Gin (HTTP framework)
Huma v2 (OpenAPI/Swagger)
gozxing (QR detection)
poppler-utils / pdftoppm (PDF rendering)
HTML + Tailwind CSS + Vanilla JS (frontend)
Docker / Docker Compose

Architecture

Follows a simplified Domain-Driven Design with separate layers for configuration, domain entities, application services, infrastructure adapters, HTTP interfaces, and embedded UI.

MailFlow Engine

Thu, 01 Jan 2026 00:00:00 +0000

AI-powered email automation and classification engine, part of the Appa8 AI Process Automation Hub.

MailFlow ingests emails from IMAP or Microsoft 365, classifies them using a hybrid rule + LLM approach, automatically routes them to the correct folders, and provides full supervision via a web dashboard. Designed for on-premise deployments where data privacy is critical.

Features

IMAP and Microsoft Graph / Outlook ingestion
RFC822 email parsing with attachment handling
Hybrid classification: rule-based matching + local LLM validation (Qwen 2.5)
Auto-move to classified folders
PDF export with customisable path templates
Invoice worker: PDF QR extraction and payment data parsing
Learning Mode: human review and approval before filing
Natural language search via Telegram (“send invoices from vendor X in January”)
Encrypted credential storage (Fernet)
Redis job queues with AOF persistence
PostgreSQL persistence (async SQLAlchemy 2.0)
Streamlit supervision dashboard
Docker-based deployment with Traefik reverse proxy
CI/CD via GitHub Actions + Portainer auto-deployment

Architecture

Email Inbox (IMAP / Microsoft 365)
 │
 ▼
 email-worker
 (poll, parse, route)
 │
 ▼
 Redis Queue
 │
 ┌──────┴───────┐
 ▼ ▼
 ai-worker invoice-worker
 (LLM classify) (QR + finance)
 │
 ┌────┴────────────────────┐
 ▼ ▼ ▼
folder review-worker query-worker
 move (Learning Mode) (NL search)
 │
 telegram-bot
 (approvals + search)

Worker	Description
email-worker	Polls IMAP / M365, routes by worker type
ai-worker	Main classification engine with Redis job processing
invoice-worker	Financial document extraction from PDF QR codes
review-worker	Learning Mode human review cards
query-worker	Natural language search processing
telegram-bot	User interface for commands and approvals

Dashboard

The Streamlit interface provides multi-tab supervision:

INCENTEA – Tecnologia de Gestão

Mon, 17 Mar 2025 00:00:00 +0000

Solutions Developer at INCENTEA in Lisbon, extending Primavera ERP with custom C# integrations, SQL Server optimizations, and WebServices for business clients.

Sabores do Futuro – Restauração

Sat, 01 Feb 2025 00:00:00 +0000

Internal management platform for Sabores do Futuro restaurant group, covering foodcost, HR, documents, equipment, and fleet. Built with PHP Yii2, Vue, Docker.

Equipment Gest Assets

Fri, 24 Mar 2023 00:00:00 +0000

🏗️ Equipment Gest Assets

A logistics, maintenance, and chain-of-custody tracking system for industrial and construction assets.

📋 Overview

Equipment Gest Assets is designed to eliminate the “black hole” of equipment tracking in the construction and industrial sectors. It provides a centralized source of truth for every tool and machine in your fleet, ensuring managers know exactly where an asset is, who is responsible for it, and what its current operational health is.

RRGEST

Sat, 01 May 2021 00:00:00 +0000

Updated website for RRGEST – Apoio à Gestão, an accounting and consulting firm in Leiria. Redesigned in 2021 through TecPc – Serviços de Informática.

AUTOROMAO

Mon, 01 Mar 2021 00:00:00 +0000

Redesigned website for Autoromão, an automotive business in Leiria. Updated version developed in 2021 through TecPc – Serviços de Informática.

FV Music Banda

Sat, 01 Jun 2019 00:00:00 +0000

Website for FV Music Banda, a music band based in Leiria, Portugal. Created in 2019 as a freelance project through TecPc – Serviços de Informática.

Solicitadora Denise Ferreira

Wed, 01 Aug 2018 00:00:00 +0000

Professional website for Solicitadora Denise Ferreira, a legal services professional in Leiria. Developed in 2018 through TecPc – Serviços de Informática.

Primavida

Sat, 01 Apr 2017 00:00:00 +0000

Website for Primavida, a business in Leiria, Portugal. Built in 2017 through TecPc – Serviços de Informática as a freelance web development project.

Zen Family

Thu, 01 Dec 2016 00:00:00 +0000

Website for Zen Family, a wellness or lifestyle brand in Lisbon. Developed in 2016 through TecPc – Serviços de Informática using PHP and WordPress.

Sucatas Pedrosa

Fri, 01 Apr 2016 00:00:00 +0000

Website for Sucatas Pedrosa, a scrap and recycling business in Aveiro. Built in 2016 as part of TecPc freelance work, using PHP and WordPress.

Carroçarias Ilídio

Sun, 01 Feb 2015 00:00:00 +0000

Website for Carroçarias Ilídio, a vehicle bodywork business in Leiria. Developed in 2015 through TecPc – Serviços de Informática using PHP and WordPress.

Autoromão

Tue, 01 Jul 2014 00:00:00 +0000

Business website for Autoromão, an automotive company in Leiria, Portugal. Built in 2014 via TecPc – Serviços de Informática using PHP and MySQL.

Frutas LizCentro

Sun, 01 Jun 2014 00:00:00 +0000

Website for Frutas LizCentro, a fruit and produce business in Leiria. Developed in 2014 through Hosting 4 Web with PHP, MySQL, and WordPress.

Fernando Vieira

Sun, 01 Sep 2013 00:00:00 +0000

Personal or business website created for Fernando Vieira, developed while working at TecPc – Serviços de Informática in Leiria, Portugal in 2013.

Hosting Site

Thu, 01 Aug 2013 00:00:00 +0000

Hosting services website built for Hosting 4 Web, a self-employed venture providing web hosting, server management, and domain services in Leiria.

Brightstar

Mon, 01 Nov 2010 00:00:00 +0000

Corporate website for Brightstar – Instrumentos Científicos, developed in 2010 in Aveiro, Portugal. Built with PHP, MySQL, and Joomla.

BS-Astro E-commerce Platform

Mon, 01 Feb 2010 00:00:00 +0000

Custom e-commerce platform built for BS-Astro at Brightstar, Aveiro. PHP and MySQL solution with full hosting infrastructure developed in 2010.

RRGEST – Apoio à Gestão

Tue, 01 Jan 2008 00:00:00 +0000

Company website and IT support for RRGEST, an accounting and consulting firm in Leiria. Built with PHP and MySQL as part of an early career role from 2008 to 2010.

RRGEST – Apoio à Gestão

Tue, 01 Jan 2008 00:00:00 +0000

RSINOX client website developed at RRGEST in Leiria. A web project from 2008 built during an IT technician and web programmer role.

About

Mon, 01 Jan 0001 00:00:00 +0000

Software developer with nearly 20 years of experience in backend systems, DevOps, and AI services. Skilled in PHP, Docker, and Linux infrastructure.

Contact

Mon, 01 Jan 0001 00:00:00 +0000

Get in touch with Ricardo Grangeia for remote opportunities, technical consulting, or collaboration. Based in Portugal, open to remote EU roles.

Path

Mon, 01 Jan 0001 00:00:00 +0000

Professional timeline of Ricardo Grangeia: software developer, full stack engineer, and IT specialist with experience across Portugal since 2008.

Thanks

Mon, 01 Jan 0001 00:00:00 +0000

March 2026

Thanks to my Parents

I have my parents to thank for everything.

I said farewell to both of them this month, March 2026 —
I lost my father and my mother.

They left too early, but together.
I wish they continue their journey in the next life
and keep watching over me and my sister.

I hope to honor them until the end.

Mother and Father, thank you for all you have done for me.