The reasoning behind the software

Admins may queue jobs with watermark=0 to skip prompt branding instructions.

Watermark application Administrator exceptions

Workers consume an image credit after inserting arcana_renders; failure rolls back the render row.

Credit balances Background render processing

Secrets and integration endpoints are loaded from a .env file via config/load_env.php.

Stripe checkout Transactional emails Local and Backblaze B2 storage

Plan capabilities are derived from users.plan_type via arcana.plan_tiers.php.

User plans and feature access

Images are stored under uploads/dble and uploaded to Backblaze B2 for public URLs.

Local and Backblaze B2 storage User render gallery

Song analysis and image generation call Google Gemini generateContent APIs.

Song and lyric analysis Gemini image generation

Application state lives in MySQL/MariaDB accessed primarily through PDO in auth_lib.

Login and logout Credit balances

Arcana is built as plain PHP 8.2 pages runnable on XAMPP and Hostinger-style hosts without a Node build.

Background render processing Public landing page

HTTP requests enqueue work; workers perform slow Gemini calls asynchronously.

Queue submission Background render processing

Styles may be DB prompt fragments or a special ANALYZE_BAND_STYLE Gemini StyleMap path.

Static visual styles Dynamic band-style analysis

Registration requires a code from access_codes.

Account registration

Runtime assumes PHP 8.2 with cron capability.

Background render processing

Verification, reset, and gallery email prefer PHPMailer/SMTP; without it, mail() fallback is weak.

Transactional emails Email verification Password reset

Production cron likely runs arcana.queue.processor.cron.parallel.v3.dynamicstyle.php because it has the broadest feature set.

Background render processing Parallel worker execution

stripe_products and related tables exist in production even though CREATE is absent from the repo.

Stripe checkout Subscription plans

Registration and admin settings depend on access_codes but no CREATE TABLE was found.

Account registration

Active queue table is assumed; only opportunistic ALTERs found.

Queue submission

auth_lib CREATE columns differ from stripe_lib insert columns (transaction_type/subscription_id).

Credit-pack purchases

path.php, B2 debug/test, admin test, notification debug may be web-reachable.

Local and Backblaze B2 storage Administrator exceptions

webhook.php and arcana.stripe.endpoint.php both exist; live target uncertain.

Stripe webhook processing

arcana.login.php and login.php can diverge; auth_check defaults to login.php.

Login and logout

Account profile email updates do not reset email_verified.

Account profile management

Notification system expects a table with no in-repo CREATE.

In-app notifications

No rate limiter observed on forgot-password requests.

Password reset

Helper supports three tiers; admin UI largely free/paid; some files check paid directly.

User plans and feature access

Purchase success page and webhooks can both attempt grants.

Credit-pack purchases

users.status can be set in admin but auth_attempt_login does not check it.

Login and logout Administrator exceptions

stripe_products, stripe_checkout_sessions, user_subscriptions referenced without creation scripts.

Stripe checkout Subscription plans

Workers implement ANALYZE_BAND_STYLE but main generator default style key is empty.

Dynamic band-style analysis

Feedback reads SMTP settings but sends via PHP mail().

Public feedback

Despite filename, processor.cron.gpt.php calls Gemini endpoints/models.

Background render processing

index.php, index.mobile.php, index.gemini.php, index.four.tiers.php coexist.

Public landing page

cron.nowatermark.php applies Imagick physical watermarks despite its name.

Watermark application

Multiple versioned/named queue processors coexist (sequential, parallel, v3 dynamicstyle, gpt, nowatermark, backups).

Background render processing Parallel worker execution Dynamic band-style analysis

Recent repository history replaced hardcoded secrets with .env.example placeholders.

Replaced the older custom static HTML guide workflow with the current VibeKB guide/tools, explainable diagrams, and generate-static.php snapshot under /docs.