QR-TAX-SYS

Transforming Financial Workflows with Seamless QR Solutions

Built with the tools and technologies:

---

Table of Contents

• Overview
• Getting Started
• Features
• Project Structure
• API Endpoints
• License

---

📖 Overview

QR Invoice System is a full-stack system designed to streamline financial workflows using QR code technology. The backend is built with Go and Gin, while the frontend is a cross-platform Flutter application.

---

⚙️ Getting Started

Backend (Go)

cd api
cp .env.example .env # create and configure your environment file
go mod tidy
go run main.go

Example .env:

DB_USER=root
DB_PASSWORD=yourpassword
DB_HOST=localhost
DB_PORT=3306
DB_NAME=qrfatura

Frontend (Flutter)

flutter pub get
flutter run

💡 Use an emulator or connect a physical device

---

✨ Features

• ✅ User authentication (JWT)
• ✅ Invoice creation and listing
• ✅ Product management
• ✅ QR Code generation for invoices
• ✅ Cross-platform support (Web, Android, iOS, Desktop)

---

📁 Project Structure

qr-tax-sys/
├── lib/                 # Flutter UI and logic
│   ├── main.dart
│   └── screen/
│       ├── login.dart
│       ├── signup.dart
│       ├── homescreen.dart
│       └── scan.dart
├── api/                 # Go backend
│   ├── main.go
│   ├── controllers/
│   ├── models/
│   ├── db/
│   └── initializers/
├── pubspec.yaml
├── go.mod, go.sum
└── platform folders     # android/, ios/, web/, etc.

---

📡 API Endpoints

Method	Endpoint	Description
POST	/signup	Register user
POST	/login	User login
GET	/users	Get all users
POST	/products	Add new product
GET	/products	List products
POST	/fatura	Create invoice
GET	/fatura	List invoices
GET	/qrcode/:fatura_id	Generate QR code

---

📄 License

This project is licensed under the MIT License.

---

🤝 Contribution

Feel free to fork the project and submit pull requests.