MALEK19977/auctus-microservices

Cheque validation platform for Tunisian banking agents — Spring Boot microservices + Angular # AUCTUS — Cheque Validation Platform An internal banking platform for validating Tunisian cheques under the 2025 banking reform (QR code, ceiling amount, expiry date), built as Spring Boot microservices behind an Angular front end. Where TuniChèque serves the public, AUCTUS is the tool for **banking agent** works in: it validates a cheque end to end, then carries the everyday branch work that follows — the client file, credit applications, and the queue of tasks passed between agents and their administrator. --- ## What it does ### Cheque validation A cheque image is taken through five checks, and the agent is shown the verdict of each rather than a single opaque answer: | # | Check | Question it answers | |---|-------|--------------------| | 1 | **Document type** | Is this a cheque at all, or a photo of something else? | | 2 | **QR extraction** | What does the printed QR code declare? | | 3 | **Cross-validation** | Does the QR agree with the text printed on the cheque? | | 4 | **Signature** | Does the signature match the one the bank holds for this account? | | 5 | **Funds & compliance** | Can the account cover it, and is the cheque still valid? | The QR and the printed fields are compared field by field, because a mismatch between them is the signature of a tampered cheque. ### Signature verification Three complementary measures are blended, because no single one separates a skilled forgery on its own: - **Shape correlation** — alignment-tolerant, so a small offset does not fail a genuine signature - **Stroke direction** — the path the pen travelled, which forgers reproduce least faithfully - **Local overlap** — block-by-block agreement, since a forgery matches globally but drifts locally Measured over the full generated dataset: **every genuine signature accepted, no forgery and no other signer accepted.** ### Branch operations - **Client register** — search by RIB, name or account number; balance, signature specimen, cheque history - **Five bank o …