📦 Subscription Service Microservice

A simple, clean microservice for managing user subscriptions and plans in a SaaS platform.
Built with Flask, SQLAlchemy, JWT auth, and SQLite (zero-config DB).

---

📝 Table of Contents

1. Features
2. Tech Stack
3. Getting Started
   • Prerequisites
   • Installation
   • Environment Variables
   • Initialize Database
   • Run the Service
4. API Documentation
   • Authentication
   • Plans
   • Subscriptions
5. Demo GIF / Video
6. Future Enhancements
7. License

---

🚀 Features

• JWT Authentication
• Plan Management: create & list subscription plans
• Subscription CRUD: subscribe, retrieve, update, cancel
• Status Handling: ACTIVE, CANCELLED (plus end_date)
• Zero-config DB: uses SQLite file subscriptions.db
• Clean Architecture: Flask blueprints, SQLAlchemy models, Marshmallow schemas
• Error Handling & Validation with Marshmallow

---

🛠 Tech Stack

• Framework: Flask
• ORM: Flask-SQLAlchemy
• Auth: Flask-JWT-Extended
• Validation: Marshmallow
• DB: SQLite (via SQLAlchemy)
• Config: python-dotenv

---

🏁 Getting Started

Prerequisites

• Python 3.8+ installed
• Git (to clone repo)
• (optional) Virtual environment tool