Bravura Admin Pro - Customer Guide

Version 1.1.0

Welcome to Bravura Admin Pro! This guide will help you get started with your production-ready licensing infrastructure.

---

🎉 What You've Purchased

Bravura Admin Pro is a complete, production-ready licensing infrastructure that includes:

✅ Beautiful Admin Panel - Manage licenses, customers, and subscriptions

✅ Customer Self-Service Portal - Let customers manage their own licenses

✅ Stripe Integration - Accept payments and manage subscriptions

✅ Email Automation - Automatic license delivery and notifications

✅ System Health Monitoring - Real-time diagnostics and performance tracking

✅ Audit Logging - Complete activity tracking for compliance

✅ Version Management - Control software releases and downloads

This is not a framework or library—it's a complete web application ready to deploy.

---

📦 What's Included

Your purchase includes:


bravura-admin-pro/
├── admin_panel/          # Admin dashboard (web interface)
├── core/                 # Core business logic
│   ├── auth.py          # Authentication & JWT
│   ├── database.py      # Database connection
│   ├── email_service.py # Email automation
│   ├── licensing_service.py # License management
│   ├── models.py        # Database models
│   └── schemas.py       # API schemas
├── database/
│   └── migrations/      # Database setup scripts
├── deployment/          # Server configuration files
├── docs/                # This documentation
├── examples/            # Sample configuration
├── main.py              # Application entry point
├── requirements.txt     # Python dependencies
├── .env.example         # Configuration template
└── README.md            # Quick reference

---

🚀 Quick Start (15 Minutes)

Step 1: Install Dependencies


# Navigate to your Bravura Admin Pro directory
cd bravura-admin-pro

# Install Python dependencies
pip install -r requirements.txt

Step 2: Setup Database


# Login to MySQL
mysql -u root -p

# Run the setup script
source database/migrations/001_initial_schema.sql
source database/migrations/002_add_license_types.sql
# ... (run all migration files in order)

Or use the consolidated setup script:


mysql -u root -p < database/migrations/complete_setup.sql

Step 3: Configure Environment


# Copy the example environment file
cp .env.example .env

# Edit with your settings
nano .env

Required Configuration:


# Database
DB_HOST=localhost
DB_NAME=bravura_licensing
DB_USER=bravura_api
DB_PASSWORD=your_secure_password_here

# JWT Secret (generate with: python -c "import secrets; print(secrets.token_hex(32))")
JWT_SECRET_KEY=your_secret_key_here

# Admin Password (generate hash with: python -c "import bcrypt; print(bcrypt.hashpw(b'your_password', bcrypt.gensalt()).decode())")
ADMIN_PASS=$2b$12$...

# Stripe
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_PUBLISHABLE_KEY=pk_live_...

# Email
EMAIL_HOST=smtp.yourprovider.com
EMAIL_PORT=587
EMAIL_USER=noreply@yourdomain.com
EMAIL_PASSWORD=your_email_password
EMAIL_FROM=noreply@yourdomain.com

Step 4: Run the Application


# Development mode (testing)
python main.py

# Production mode (see deployment docs)
gunicorn main:app --workers 4 --worker-class uvicorn.workers.UvicornWorker

Step 5: Access the Admin Panel

Open your browser to http://localhost:8000/admin/login
Login with username admin and the password you set in .env
Start managing licenses!

---

💳 Stripe Setup

Create Products & Prices

Log into Stripe Dashboard
Create Products:

- Standard Edition

- Professional Edition

- Enterprise Edition

Create Prices for each product:

- One-time payment (perpetual)

- Monthly subscription (optional)

- Annual subscription (optional)

Copy Price IDs and add them to your .env:


# Perpetual License Price IDs
STRIPE_PRICE_STANDARD_PERPETUAL=price_xxx
STRIPE_PRICE_PROFESSIONAL_PERPETUAL=price_xxx
STRIPE_PRICE_ENTERPRISE_PERPETUAL=price_xxx

# Monthly Subscription Price IDs
STRIPE_PRICE_STANDARD_MONTHLY=price_xxx
STRIPE_PRICE_PROFESSIONAL_MONTHLY=price_xxx
STRIPE_PRICE_ENTERPRISE_MONTHLY=price_xxx

# Annual Subscription Price IDs
STRIPE_PRICE_STANDARD_ANNUAL=price_xxx
STRIPE_PRICE_PROFESSIONAL_ANNUAL=price_xxx
STRIPE_PRICE_ENTERPRISE_ANNUAL=price_xxx

Configure Webhooks

In Stripe Dashboard, go to Developers → Webhooks
Add endpoint: https://yourdomain.com/api/webhooks/stripe
Select events:

- payment_intent.succeeded

- charge.refunded

- customer.subscription.created

- customer.subscription.updated

- customer.subscription.deleted

- invoice.payment_succeeded

- invoice.payment_failed

Copy webhook secret to .env:


STRIPE_WEBHOOK_SECRET=whsec_...

---

🎨 Customization

Branding (Professional & Enterprise Only)

Edit core/config_base.py:


# Application Branding
app_name: str = "Your App Name"
company_name: str = "Your Company"
logo_url: str = "/static/logo.png"

# Colors (hex codes)
primary_color: str = "#2c3e50"
secondary_color: str = "#0d6efd"
accent_color: str = "#20C6B7"

Email Templates

Email templates are in core/email_service.py. You can customize:

Welcome email
License delivery email
Receipt email
Subscription notifications
Trial reminders

License Tiers

Define your tiers in core/config_base.py:


tier_names: dict = {
    "STANDARD": "Starter",
    "PROFESSIONAL": "Professional",
    "ENTERPRISE": "Enterprise"
}

tier_max_activations: dict = {
    "STANDARD": 1,
    "PROFESSIONAL": 5,
    "ENTERPRISE": -1  # unlimited
}

---

📊 Using the Admin Panel

Dashboard Overview

The dashboard shows:

Total licenses (active, expired, revoked)
Revenue tracking (total revenue, refunds)
Recent activity (latest transactions and events)
License distribution (by tier)

Managing Licenses

View Licenses: /admin/licenses

Search by license key or customer email
Filter by tier, status, date range
Export to CSV

Create License: Click "Create License"

Enter customer email
Select tier (Standard, Professional, Enterprise)
Set expiration (optional)
Set max activations

Edit License: Click "Edit" on any license

Change status, tier, expiration
Update activation counts
Change machine ID
Add notes

Revoke License: Click "Revoke"

Provide reason for revocation
License immediately becomes invalid
Customer receives notification email

Resend Email: Click "Resend Email"

Resends the original license delivery email
Useful when customers lose their license key

Managing Customers

View Customers: /admin/customers

See all customers and their licenses
Search by email or name
View purchase history

Customer Details: Click on any customer

View all licenses
See subscription status
Access transaction history

Viewing Audit Logs

Audit Logs: /admin/logs

See all system activity
Filter by action type, user, date
Track security events
Export for compliance

System Health

Health Dashboard: /admin/health

Database connection status
API health checks
Connection pool metrics
Recent errors and warnings

Version Management

Versions: /admin/versions

Add new software versions
Upload release files
Set update eligibility
Mark latest version

---

👥 Customer Portal

Your customers can access their portal at: https://yourdomain.com/subscription-portal

Portal Features

Login Options:

Email + Password
License Key only

Self-Service:

View all licenses
Download software
Manage subscriptions
Update payment method
View invoices
Update profile

Password Setup

Customers receive a password setup link in their welcome email. They can also:

Request password reset
Set password after purchase
Change password in portal

---

🔐 Security Best Practices

Production Deployment

Use HTTPS: SSL/TLS certificates required
Strong Passwords: Use long, random passwords
Secure JWT Secret: Generate with secrets.token_hex(32)
Database Security: Limit database user permissions
IP Whitelisting: Restrict admin panel access (optional)
Regular Backups: Automate database backups
Update Dependencies: Keep Python packages updated

Recommended Security Settings


# Security
HASH_ROUNDS=12  # bcrypt rounds
MAX_LOGIN_ATTEMPTS=5
LOCKOUT_DURATION_MINUTES=30

# CORS (adjust for your domains)
ALLOWED_ORIGINS=https://yourdomain.com,https://www.yourdomain.com

# Rate Limiting
API_RATE_PER_MIN=60
API_RATE_BURST=10

---

🚀 Production Deployment

Server Requirements

OS: Linux (Ubuntu 20.04+ recommended)
Python: 3.10 or higher
Database: MySQL 8.0+ or MariaDB 10.5+
RAM: 2GB minimum (4GB recommended)
Storage: 10GB minimum
SSL: Required (Let's Encrypt recommended)

Deployment Steps

Setup Server:


# Update system
sudo apt update && sudo apt upgrade -y

# Install dependencies
sudo apt install python3.10 python3-pip mysql-server nginx certbot -y

Configure Nginx:


# Copy nginx configuration
sudo cp deployment/nginx_template.conf /etc/nginx/sites-available/bravura
sudo ln -s /etc/nginx/sites-available/bravura /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Setup Systemd Service:


# Copy service file
sudo cp deployment/systemd_template.service /etc/systemd/system/bravura.service
sudo systemctl enable bravura
sudo systemctl start bravura

Setup SSL:


# Get Let's Encrypt certificate
sudo certbot --nginx -d yourdomain.com

Configure Firewall:


sudo ufw allow 'Nginx Full'
sudo ufw enable

Complete deployment instructions: See INSTALLATION_GUIDE.md

---

🆘 Troubleshooting

Common Issues

Database Connection Errors


Error: Can't connect to MySQL server

Solution: Check database credentials in .env and ensure MySQL is running

Stripe Webhook Failures


Error: Webhook signature verification failed

Solution: Verify STRIPE_WEBHOOK_SECRET matches Stripe dashboard

Email Not Sending


Error: SMTP authentication failed

Solution: Check email credentials and ensure SMTP port is correct

License Validation Fails


Error: Invalid license key

Solution: Check license status in admin panel, verify database connection

Debug Mode

Enable debug mode for detailed error messages:


DEBUG=true
ENVIRONMENT=development

⚠️ Never enable debug mode in production!

Logs

Check application logs:


# View real-time logs
tail -f /opt/bravura/logs/api.log

# View systemd service logs
sudo journalctl -u bravura -f

---

📚 Additional Resources

Documentation Files

INSTALLATION_GUIDE.md - Complete deployment guide
QUICK_START.md - Get up and running fast
CHANGELOG.md - Version history and changes
LICENSE_COMMERCIAL.txt - License terms

Support

Email: support@wigleystudios.com
Documentation: https://wigleystudios.com/docs
Website: https://wigleystudios.com

Your License

Product: Bravura Admin Pro

Tier: [Your Tier - Starter/Professional/Enterprise]

License Key: [Your License Key]

Support Period: [Your Support Period]

---

✅ Getting Help

Before Contacting Support

Check this documentation
Review the FAQ in INSTALLATION_GUIDE.md
Check application logs for error messages
Verify your configuration in .env

When Contacting Support

Please provide:

Your license tier and key
Error messages (from logs)
Steps to reproduce the issue
Your environment (Python version, OS, database version)
Any relevant configuration (with secrets redacted)

Support Response Times

Starter: Email support within 48 hours
Professional: Priority email support within 24 hours
Enterprise: Dedicated support within 4 hours

---

🎯 Next Steps

Now that you have Admin Pro installed:

✅ Test License Creation - Create a test license and verify it works
✅ Test Stripe Integration - Process a test payment
✅ Test Customer Portal - Login as a customer
✅ Configure Email - Send test emails
✅ Customize Branding - Add your logo and colors
✅ Deploy to Production - Follow deployment guide
✅ Go Live! - Start selling your software

---

Congratulations on your purchase of Bravura Admin Pro!

We're excited to see what you build with it. If you have any questions or need help, don't hesitate to reach out to our support team.

Happy Building!

The Wigley Studios Team

---

Bravura Admin Pro v1.0.0