Metadata-Version: 2.4
Name: syeedalireza-billcycle
Version: 0.1.0
Summary: BillCycle package
Author-email: Alireza Aminzadeh <syeedalireza@example.com>
Project-URL: Homepage, https://github.com/syeedalireza/BillCycle
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# BillCycle: Subscription & Usage-based Billing Engine

**BillCycle** handles complex recurring billing, plan upgrades/downgrades, and usage metering for SaaS and subscription box e-commerce.

Developed by **Alireza Aminzadeh** ([@syeedalireza](https://github.com/syeedalireza)).

## Architecture
- **API:** FastAPI
- **Database:** PostgreSQL (SQLAlchemy)
- **Background Jobs:** Celery Beat
- **Pattern:** State Machine Pattern, Event Sourcing

*(Technical implementation pending in next iteration)*
