65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# Architectural Request
|
|
|
|
**Date:** 2026-04-12
|
|
**Topic:** Deploy Phase 11D to Dev Panel — Blueprint license integration
|
|
|
|
## 1. Current State
|
|
Phase 11D code pushed (8872f67). Blueprint extension has license activation UI, phone-home cron, and tier gating. Ready for testing on Dev Panel.
|
|
|
|
## 2. Deploy Target
|
|
**Dev Panel (64.50.188.128)** — NOT live Panel VPS.
|
|
|
|
## 3. Files Changed
|
|
|
|
**New files:**
|
|
- `blueprint-extension/app/Services/LicenseService.php`
|
|
- `blueprint-extension/app/Console/Commands/ValidateLicense.php`
|
|
|
|
**Modified files:**
|
|
- `blueprint-extension/admin/controller.php` — added LicenseService DI, license activation/deactivation handling
|
|
- `blueprint-extension/admin/view.blade.php` — license UI, status banners, dynamic tier gating
|
|
|
|
## 4. Dependencies
|
|
- No new Composer packages — uses Laravel's built-in `Http` facade (already available)
|
|
- No database migrations needed (license state stored in Blueprint's dbGet/dbSet)
|
|
|
|
## 5. Deployment Steps
|
|
|
|
1. Rebuild the .blueprint package:
|
|
```bash
|
|
cd /opt/mod-builds/firefrost-services/services/modpack-version-checker/blueprint-extension
|
|
bash build.sh
|
|
```
|
|
|
|
2. Install on Dev Panel:
|
|
```bash
|
|
blueprint -install modpackchecker
|
|
```
|
|
|
|
3. Register the daily cron (add to Panel's crontab):
|
|
```
|
|
0 4 * * * cd /var/www/pterodactyl && php artisan mvc:validate >> /dev/null 2>&1
|
|
```
|
|
|
|
4. For immediate testing, run manually:
|
|
```bash
|
|
cd /var/www/pterodactyl && php artisan mvc:validate
|
|
```
|
|
|
|
## 6. What "Working" Looks Like
|
|
|
|
1. **Admin page loads** — visit `/admin/extensions/modpackchecker`, no errors
|
|
2. **License section visible** — "BuiltByBit Order ID" text input + gray "Not Activated" badge
|
|
3. **Activate test** — enter a test order ID, click Save. Should show error "License not found" (expected — no real license exists yet). Confirms Arbiter connectivity.
|
|
4. **Pro fields locked** — Check Interval dropdown and Discord Webhook URL should be disabled (grayed out)
|
|
5. **Artisan command runs** — `php artisan mvc:validate` outputs "No license configured" (expected for fresh install)
|
|
6. **No PHP errors in logs** — `tail -f /var/www/pterodactyl/storage/logs/laravel.log`
|
|
|
|
## 7. Smoke Test with Real License
|
|
To fully test the flow, Chronicler can provision a test license directly in the DB:
|
|
```sql
|
|
INSERT INTO mvc_licenses (order_id, buyer_id, tier, max_activations)
|
|
VALUES ('TEST-001', 'chronicler', 'professional', 5);
|
|
```
|
|
Then enter `TEST-001` in the admin UI — should activate, show green badge, unlock pro fields.
|