YAP - Yet Another Panel

A usage-based panel for proxy subscriptions and AI access

Highlights • Stack • Quick-Start • Routes • Upgrade-Status

---

About

YAP (Yet Another Panel) is a Laravel-based panel for selling and managing proxy subscriptions, usage-based account balances, and optional AI access.

It combines a React + Inertia frontend for customers with a Filament admin panel for daily operations.

Highlights

• customer-facing dashboard, recharge, package purchase, payment history, balance detail, usage statistics, and profile flows
• proxy subscription delivery via /clash/{uuid}/yap.yaml
• optional AI key access using the same account balance
• admin management for users, Vmess servers, relay servers, payments, packages, and operational metrics
• payment support for cards, Alipay, USDT, and GitHub Sponsors where configured
• GitHub OAuth account linking, sponsor webhook support, and account unlink flow
• English and Japanese customer-facing translations
• Laravel 12, React 18, Filament 5, Livewire 4, Tailwind CSS 4
• affiliate program with referral tracking, VIP commission levels, package-based commission release, and Filament management resources

Stack

Backend

• PHP 8.3+
• Laravel 12
• Filament 5
• Livewire 4
• Laravel Sanctum
• Laravel Socialite
• Laravel Telescope
• Sentry Laravel

Frontend

• React 18
• Inertia.js
• Tailwind CSS 4
• Headless UI
• Vite 8
• Chart.js

Tooling

• Pest 4
• Pest Browser plugin with Playwright
• Laravel Pint

Quick Start

Requirements

• PHP 8.3+
• Composer
• Node.js 18+
• npm
• MariaDB/MySQL-compatible database
• PHP extensions required by composer.json, including bcmath and yaml

Install

composer install
npm install
php artisan key:generate
php artisan migrate
php artisan serve
npm run dev

If you are developing from WSL on a Windows-mounted workspace, prefer Windows-native php, composer, node, and npm binaries.

Browser Testing Setup

Browser tests use Pest 4's browser plugin and Playwright. After npm install, install the browser binary on each development machine or CI runner:

npx playwright install chromium

On a Windows-mounted WSL workspace, run it through Windows-native tooling:

powershell.exe -Command "npx playwright install chromium"

Environment

Minimum example:

APP_NAME=YAP
APP_URL=http://localhost:8000

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=yap
DB_USERNAME=root
DB_PASSWORD=

YAP_ADMIN_PANEL_PATH=admin
YAP_UNIT_PRICE=0.02
YAP_RESET_SUBSCRIPTION_PRICE=0.5
YAP_USD_RMB_RATE=7.3

AFFILIATE_ENABLED=true
AFFILIATE_COOKIE_DAYS=30
AFFILIATE_ATTRIBUTION_TYPE=first_click
AFFILIATE_ALLOWED_GATEWAYS=stripe,alipay,usdt,github
AFFILIATE_MINIMUM_REFERRER_PAID_AMOUNT=5
AFFILIATE_MINIMUM_REFERRED_FIRST_PAYMENT_AMOUNT=5
AFFILIATE_MINIMUM_COMMISSION_AMOUNT=0.01
AFFILIATE_PENDING_DAYS=7
AFFILIATE_COMMISSION_EXPIRES_DAYS=90

Common optional integrations:

GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_REDIRECT_URI=
GITHUB_WEBHOOK_SECRET=

ALIPAY_APP_ID=
ALIPAY_PRIVATE_KEY=
ALIPAY_PUBLIC_KEY=

STRIPE_KEY=
STRIPE_SECRET=
STRIPE_WEBHOOK_SECRET=

BEPUSDT_APP_ID=
BEPUSDT_API_KEY=
BEPUSDT_SECRET=

SENTRY_LARAVEL_DSN=

Main Routes

Frontend

• /
• /dashboard
• /recharge
• /package
• /payment
• /balance/detail
• /customer/service
• /profile
• /ai
• /affiliate
• /stat
• /policy
• /tos
• /commercial-disclosure

Subscription, Payments, and Webhooks

• /clash/{uuid}/yap.yaml
• /alipay/*
• /bepusdt/*
• /stripe/*
• /github/sponsor/webhook

Admin

• /{YAP_ADMIN_PANEL_PATH}

Default admin path is admin.

Admin Access

Filament access is currently restricted in App\Models\User::canAccessPanel().

Current default:

• only the user with id === 1 can access the admin panel

Review this rule before production use.

Development Commands

php artisan test
./vendor/bin/pint
npm run build

php artisan test runs the Unit and Feature suites. Browser tests are intentionally run separately because they require Playwright's browser binary:

./vendor/bin/pest tests/Browser --browser chrome

For Windows-mounted WSL workspaces:

powershell.exe -Command "./vendor/bin/pest tests/Browser --browser chrome"

Upgrade Status

The project has been upgraded to:

• Filament 5
• Livewire 4
• Tailwind CSS 4
• Pest 4 with Pest Browser plugin

Customer-facing routes and Inertia page structure were kept intact. The main frontend impact is the Tailwind 4 build migration.

Validated locally with:

• php artisan test
• ./vendor/bin/pest tests/Browser --browser chrome
• npm run build

License

This project is licensed under the MIT License. See LICENSE for details.

---

Built with Laravel, Inertia, React, and Filament