MyReceipt
MyReceipt is a full-stack SaaS platform for digital receipts that replaces paper receipts with shareable, trackable digital ones. Built with a Go backend using Gin and a Next.js 14 frontend, it serves merchants who create and manage digital receipts and customers who collect them in a digital wallet. The platform features AI-powered receipt scanning, real-time WebSocket notifications, multi-currency support, POS webhook integrations, and a comprehensive analytics dashboard.
Features
- Merchant Dashboard: Full receipt management with creation, voiding, PDF generation, QR codes, Apple Wallet passes, CSV export, and multi-location support.
- Customer Digital Wallet: Dedicated wallet app where customers collect receipts, link payment cards for auto-matching, track spending insights, and manage loyalty cards.
- AI Receipt Scanner: OCR-powered receipt scanning using Google Gemini 2.0 Flash that extracts merchant name, totals, line items, and payment method from uploaded photos.
- Real-Time Notifications: WebSocket connections with exponential backoff reconnection that deliver instant toast notifications when new receipts arrive.
- POS Webhook Integrations: API key-authenticated webhook endpoints supporting generic and Square POS formats with automatic receipt creation, retry logic, and delivery logging.
- Analytics Dashboard: Revenue time series, customer retention metrics, top products by quantity/revenue, payment method breakdowns, and period-over-period comparisons.
- Loyalty Programs: Merchant-created stamp card programs with automatic stamping on receipt delivery and manual redemption tracking.
- Two-Factor Authentication: TOTP-based 2FA for merchant accounts with authenticator app QR code setup and a two-step login flow.
- Multi-Currency Support: Automatic exchange rate fetching with cached rates and customer-level currency preferences for receipt display conversion.
- Team Management & RBAC: Role-based access control with owner, manager, and cashier roles, email invitations, and location-scoped permissions.
- n8n Workflow Automation: Automated notifications on new receipts, daily revenue report emails, and webhook failure monitoring workflows.
Stack
Backend
- Go - Backend language with Gin HTTP framework, raw SQL with pgx, and a clean service-layer architecture.
- PostgreSQL - Primary database with 14 tables across 18 migrations, analytics indexes, and connection pooling via pgxpool.
- JWT - Dual authentication system with separate merchant and customer token flows, refresh tokens, and TOTP 2FA.
- Google Gemini - Gemini 2.0 Flash for multimodal receipt OCR and structured data extraction.
- Resend - Transactional email delivery for receipt notifications, team invites, and void alerts.
Frontend
- Next.js - React 18 with App Router, server-side rendering for public receipt pages, and TypeScript throughout.
- Tailwind CSS - Utility-first CSS with themed layouts — green for merchant dashboard, indigo/violet for customer wallet.
- Recharts - Composable chart library for analytics visualizations including revenue trends and spending breakdowns.
DevOps & Automation
- Docker - Multi-service containerization with Docker Compose for local development and production deployment.
- GitHub Actions - CI/CD pipeline with linting, testing, building, and Docker health checks on the main branch.
- n8n - Workflow automation for Slack notifications, daily revenue reports, and webhook failure monitoring.
- Swagger - Interactive API documentation with OpenAPI 3.0 spec serving 50+ endpoints.