سرویس آپلود و مدیریت فایل با آمار حجم، نوع فایل و مالکیت؛ مناسب اپ‌های اشتراک فایل.

🚀 این بسته شامل چه چیزهایی است؟

• **سورس کامل و خوانا** با کامنت‌های فارسی در همهٔ فایل‌ها

• فایل `requirements.txt` (فهرست پکیج‌های لازم)

• فایل نمونهٔ `.env.example` برای تنظیمات (بدون اطلاعات محرمانه)

• فایل `schema.sql` برای ساخت جدول‌های دیتابیس

• اسکریپت اجرای آماده برای ویندوز (`run.bat`) و لینوکس (`run.sh`)

• **راهنمای فارسی** نصب، تنظیمات و اجرا در `README.md`

🧩 امکانات

• ثبت متادیتای فایل (نام، حجم، نوع)

• تفکیک فایل‌های هر کاربر

• گزارش حجم مصرفی

• جست‌وجو بر اساس نام و نوع

• ساختار آمادهٔ اتصال به S3 یا فضای هاست

• تست‌های خودکار همراه پروژه

🗄 دیتابیس

این پروژه به **PostgreSQL** وصل می‌شود؛ رشتهٔ اتصال در فایل `.env` قرار می‌گیرد.

ساختار جدول (فایل `schema.sql`) و لایهٔ دیتابیس جدا نوشته شده است؛ برای تغییر دیتابیس فقط مقدار `DATABASE_URL` را عوض کنید.

⚙️ پیش‌نیازها

• پایتون ۳٫۱۰ یا بالاتر

• pip و دسترسی به اینترنت برای نصب پکیج‌ها (فقط در مرحلهٔ نصب)

• دیتابیس PostgreSQL در صورت استفاده از حالت سروری

🛠 نصب و اجرا

۱) پکیج‌ها را نصب کنید:

```bash

pip install -r requirements.txt

```

۲) فایل نمونهٔ تنظیمات را کپی کنید و مقادیر را بگذارید:

```bash

cp .env.example .env

```

۳) اجرا:

```bash

uvicorn app.main:app --reload # مستندات: http://127.0.0.1:8000/docs

```

📁 ساختار پروژه

```

py-fastapi-files/

README.md

requirements.txt

schema.sql

.env.example

run.bat | run.sh

app/main.py app/models.py app/schemas.py app/crud.py app/db.py tests/

```

💡 نکته‌های اجرایی

• همهٔ مقدارهای پیش‌فرض طوری انتخاب شده‌اند که پروژه بدون تنظیمات هم بالا بیاید (حالت محلی با SQLite).

• کد کاملاً ماژولار است: هر فایل یک وظیفهٔ مشخص دارد و می‌توانید بدون دست‌زدن به بقیه، بخش دلخواه را تغییر دهید.

• برای اجرا روی سرور، همان مراحل کافی است؛ پیشنهاد می‌شود پشت Nginx و با systemd یا supervisor اجرا شود.

💬 پشتیبانی

اگر در نصب یا اجرا سؤال یا مشکلی داشتید از پنل کاربری تیکت بزنید؛ در اولین فرصت پاسخ می‌دهیم و در صورت نیاز راهنمایی نصب انجام می‌شود.

🖼️ تصاویر محیط برنامه

برای دیدن تصویر در اندازهٔ کامل روی آن بزنید — با کلیدهای جهت‌دار هم می‌توانید بین تصاویر جابه‌جا شوید.