#Seven Up Link · 7UL.ir

سرویس کوتاه‌کننده لینک با آمار، QR و پنل مدیریت
URL shortener with analytics, QR codes, and admin panel

فارسی · English

---

#فارسی

#درباره

Seven Up Link (7UL.ir) یک سرویس کوتاه‌کننده لینک است که به کاربران امکان می‌دهد لینک‌های طولانی را کوتاه کنند، آمار کلیک را ببینند، QR تولید کنند و از طریق API لینک بسازند. ورود با OTP موبایل، گزارش لینک‌های مشکوک و پنل ادمین کامل از دیگر بخش‌های سامانه است.

#قابلیت‌ها

• کوتاه‌سازی لینک — ایجاد لینک ۸ کاراکتری با QR قابل دانلود
• انواع لینک — link، utm، iframe، code، text
• آمار بازدید — IP، دستگاه، مرورگر و سیستم‌عامل
• ورود با OTP — احراز هویت با شماره موبایل و پیامک
• پنل کاربری — مدیریت لینک‌ها، آمار و توکن API
• REST API — ایجاد و مشاهده لینک‌ها با توکن اختصاصی
• گزارش لینک — ثبت و پیگیری لینک‌های مشکوک
• پنل ادمین — کاربران، لینک‌ها، گزارش‌ها، تنظیمات، پشتیبان‌گیری و اجرای دستورات

#فناوری‌ها

#پیش‌نیازها

• PHP 8.4+
• Composer
• Node.js 20+ و npm
• MySQL 8+
• Redis (اختیاری)

#نصب

git clone <repository-url> 7ul
cd 7ul
composer setup

یا به‌صورت دستی:

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install
npm run build

#پیکربندی

فایل .env را ویرایش کنید:

APP_NAME="Seven Up Link"
APP_URL=https://7ul.ir

DB_DATABASE=7ul
DB_USERNAME=root
DB_PASSWORD=

# ارسال OTP
SMS_TOKEN=
SMS_GATEWAY=
SMS_URL=https://srscrm.ir/api/sms/send

#ایجاد ادمین

php artisan app:set-user-as-admin
# یا با شماره موبایل:
php artisan app:set-user-as-admin 09123456789

دستور کاربر را ایجاد می‌کند (در صورت نبود) و نقش admin را به او اختصاص می‌دهد.

#توسعه

composer dev

این دستور سرور Laravel، صف، لاگ و Vite را هم‌زمان اجرا می‌کند.

php artisan serve          # فقط سرور
npm run dev                # فقط Vite

#تست

composer test
# یا
php artisan test --compact

#API

پایه: {APP_URL}/api/v1

احراز هویت با هدر:

Authorization: Bearer {api_token}

توکن API از پنل کاربری (/user/api) قابل مشاهده و تولید مجدد است.

---

#English

#About

Seven Up Link (7UL.ir) is a URL shortening service that lets users shorten long links, track click analytics, generate QR codes, and create links via API. Mobile OTP login, suspicious link reporting, and a full admin panel are included.

#Features

• Link shortening — 8-character short codes with downloadable QR codes
• Link types — link, utm, iframe, code, text
• Visit analytics — IP, device, browser, and OS tracking
• OTP login — mobile number authentication via SMS
• User dashboard — manage links, stats, and API tokens
• REST API — create and inspect links with a personal token
• Link reporting — submit and track suspicious links
• Admin panel — users, links, reports, settings, backups, and command runner

#Tech stack

#Requirements

• PHP 8.4+
• Composer
• Node.js 20+ and npm
• MySQL 8+
• Redis (optional)

#Installation

git clone <repository-url> 7ul
cd 7ul
composer setup

Or step by step:

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install
npm run build

#Configuration

Edit .env:

APP_NAME="Seven Up Link"
APP_URL=https://7ul.ir

DB_DATABASE=7ul
DB_USERNAME=root
DB_PASSWORD=

# OTP delivery
SMS_TOKEN=
SMS_GATEWAY=
SMS_URL=https://srscrm.ir/api/sms/send

#Create an admin

php artisan app:set-user-as-admin
# or with a mobile number:
php artisan app:set-user-as-admin 09123456789

The command creates the user if needed and assigns the admin role.

#Development

composer dev

Runs the Laravel server, queue worker, log tail, and Vite together.

php artisan serve          # server only
npm run dev                # Vite only

#Testing

composer test
# or
php artisan test --compact

#API

Base URL: {APP_URL}/api/v1

Authenticate with:

Authorization: Bearer {api_token}

The API token is available in the user panel at /user/api.

---

#License

This project is open-source software licensed under the MIT license.