API کیف پول و تراکنشها با Flask
بکاند کیف پول: افزایش/کاهش موجودی، تاریخچهٔ تراکنش و شناسهٔ پیگیری. امکانات کلیدی: ثبت تراکنش واریز/برداشت، گزارش گردش حساب هر کیف پول، شناسهٔ پیگیری یکتا. سورس کامل + راهنمای فارسی نصب و اجرا.
توضیحات محصول
بکاند کیف پول: افزایش/کاهش موجودی، تاریخچهٔ تراکنش و شناسهٔ پیگیری.
🚀 این بسته شامل چه چیزهایی است؟
• **سورس کامل و خوانا** با کامنتهای فارسی در همهٔ فایلها
• فایل `requirements.txt` (فهرست پکیجهای لازم)
• فایل نمونهٔ `.env.example` برای تنظیمات (بدون اطلاعات محرمانه)
• فایل `schema.sql` برای ساخت جدولهای دیتابیس
• اسکریپت اجرای آماده برای ویندوز (`run.bat`) و لینوکس (`run.sh`)
• **راهنمای فارسی** نصب، تنظیمات و اجرا در `README.md`
🧩 امکانات
• ثبت تراکنش واریز/برداشت
• گزارش گردش حساب هر کیف پول
• شناسهٔ پیگیری یکتا
• جمع موجودی هر کاربر
• گزارش تراکنشهای امروز
• تراکنش اتمیک با commit/rollback
🗄 دیتابیس
این پروژه با **SQLite** کار میکند؛ دیتابیس یک فایل روی سیستم شماست و هیچ سروری لازم نیست.
ساختار جدول (فایل `schema.sql`) و لایهٔ دیتابیس جدا نوشته شده است؛ برای تغییر دیتابیس فقط مقدار `DATABASE_URL` را عوض کنید.
⚙️ پیشنیازها
• پایتون ۳٫۱۰ یا بالاتر
• pip و دسترسی به اینترنت برای نصب پکیجها (فقط در مرحلهٔ نصب)
• دیتابیس SQLite در صورت استفاده از حالت سروری
🛠 نصب و اجرا
۱) پکیجها را نصب کنید:
```bash
pip install -r requirements.txt
```
۲) فایل نمونهٔ تنظیمات را کپی کنید و مقادیر را بگذارید:
```bash
cp .env.example .env
```
۳) اجرا:
```bash
python app.py # http://127.0.0.1:5001
```
📁 ساختار پروژه
```
py-flaskapi-wallet/
README.md
requirements.txt
schema.sql
.env.example
run.bat | run.sh
app.py api.py database.py auth.py
```
💡 نکتههای اجرایی
• همهٔ مقدارهای پیشفرض طوری انتخاب شدهاند که پروژه بدون تنظیمات هم بالا بیاید (حالت محلی با SQLite).
• کد کاملاً ماژولار است: هر فایل یک وظیفهٔ مشخص دارد و میتوانید بدون دستزدن به بقیه، بخش دلخواه را تغییر دهید.
• برای اجرا روی سرور، همان مراحل کافی است؛ پیشنهاد میشود پشت Nginx و با systemd یا supervisor اجرا شود.
💬 پشتیبانی
اگر در نصب یا اجرا سؤال یا مشکلی داشتید از پنل کاربری تیکت بزنید؛ در اولین فرصت پاسخ میدهیم و در صورت نیاز راهنمایی نصب انجام میشود.
این بسته چه چیزی به پروژهٔ شما اضافه میکند؟
محصول «API کیف پول و تراکنشها با Flask» ۶ ویژگیِ کلیدی دارد. یکی از آنها «ثبت تراکنش واریز/برداشت» است. هدفِ این بسته این است که کدِ آمادهٔ پایتون برای پروژهٔ شما فراهم کند. پیش از تهیه، فهرستِ ویژگیها را با نیازِ پروژهٔ خود تطبیق دهید. توضیحاتِ تکمیلی در صورت نیاز همراهِ فایل قرار داده شده است. میتوانید این محصول را در پروژههای شخصی و تجاری بهکار بگیرید.
پیشنیازها و نحوهٔ دریافت فایل
برای اجرای این محصول به پایتون نسخهٔ ۳ یا بالاتر نیاز دارید. فایلِ اصلی این محصول با نام py-flaskapi-wallet.zip ارائه میشود. پس از تکمیل سفارش، فایل در بخش دانلودهای حساب شما قرار میگیرد. دسترسی به فایل بلافاصله پس از پرداخت فعال میشود. فایل را از حالت فشرده خارج کنید و در محیط توسعه باز کنید. این محصول برای استفاده مستقیم در پروژه آماده شده است.
پرسشهای پرتکرار دربارهٔ این محصول
- فایل را چطور دریافت کنم؟ پس از تکمیل سفارش، فایل در بخش دانلودهای حساب کاربری شما قرار میگیرد.
- استفاده در پروژهٔ تجاری مجاز است؟ بله؛ استفاده در پروژهٔ شخصی یا تجاری مجاز است، اما بازنشرِ خودِ فایل مجاز نیست.
- اگر به مشکل برخوردم چه کنم؟ از بخش پشتیبانی یا تیکت در حساب کاربری پیام بدهید تا راهنمایی شوید.
ویژگیهای کلیدی
- ثبت تراکنش واریز/برداشت
- گزارش گردش حساب هر کیف پول
- شناسهٔ پیگیری یکتا
- جمع موجودی هر کاربر
- گزارش تراکنشهای امروز
- تراکنش اتمیک با commit/rollback