355 lines
16 KiB
Markdown
355 lines
16 KiB
Markdown
# TASKS.md - EZSCALE Site Task Tracker
|
|
|
|
## Phase 1: Foundation & Core Setup ✅
|
|
- [x] Initialize Laravel 12 project with Vue + Inertia starter kit (base install in `website/`)
|
|
- [x] Configure domain routing (ezscale.dev, account.ezscale.dev, admin.ezscale.dev)
|
|
- [x] Set up MySQL 8.x database (ezscale_billing + test DB)
|
|
- [x] Configure Redis (cache, queue, sessions)
|
|
- [x] Install core dependencies (cashier, fortify, passport, paypal, spatie, inertia, vue3)
|
|
- [x] Create complete database schema (30 migrations, 15 custom tables)
|
|
- [x] Set up Laravel Fortify with Vue/Inertia auth pages (7 pages: login, register, forgot/reset password, verify email, confirm password, 2FA challenge)
|
|
- [x] Implement 2FA (TOTP via Fortify)
|
|
- [x] Configure spatie roles: `admin` and `customer`
|
|
- [x] Set up middleware: auth, role-based, rate limiting, HandleInertiaRequests, EnsureUserNotSuspended
|
|
- [x] Create 14 Eloquent models with factories, relationships, and casts
|
|
- [x] Create seeders (roles/permissions, plans, admin user)
|
|
- [x] Build customer dashboard + admin dashboard (placeholder)
|
|
- [x] Set up Pest testing framework (24 Phase 1 tests passing)
|
|
- [x] Dark mode UI across all pages
|
|
- [x] Migrate frontend from Tailwind CSS to Vuetify 3 (Vuexy design system) with TypeScript
|
|
- [ ] Configure Cloudflare Zero Trust for admin panel
|
|
- [ ] Set up GitHub Actions CI/CD pipeline
|
|
- [ ] Create staging environment (staging.account.ezscale.cloud)
|
|
- [ ] Configure Mailgun or SendGrid for emails
|
|
|
|
## Phase 2: Billing & Subscriptions ✅
|
|
- [x] Implement `BillingServiceInterface` abstraction
|
|
- [x] Build `StripeBillingService` (wraps Laravel Cashier)
|
|
- [x] Build `PayPalBillingService` (wraps srmklive/laravel-paypal)
|
|
- [x] Create plan catalog with seeder (6 sample plans across VPS, dedicated, hosting, game)
|
|
- [x] Implement subscription creation flow (plan browsing → checkout → payment → coupon support)
|
|
- [x] Build payment method management (add/remove/set default via Stripe)
|
|
- [x] Build invoice and transaction history pages (paginated, download support)
|
|
- [x] Set up webhook handlers for Stripe and PayPal
|
|
- [x] Build subscription management (cancel/resume/swap plan)
|
|
- [x] Build dunning system (DunningService + scheduled ProcessDunning command)
|
|
- [x] Implement coupon system (validation, redemption, percentage/fixed discounts)
|
|
- [x] Automatic suspension policy (grace period → suspend → terminate)
|
|
- [x] Event-driven architecture (PaymentSucceeded/Failed, SubscriptionCreated/Cancelled)
|
|
- [x] 8 Vue pages for billing flow (plans, checkout, subscriptions, billing/invoices/transactions)
|
|
- [x] 29 Phase 2 tests (53 total passing)
|
|
- [ ] Invoice PDF generation (dedicated package)
|
|
- [ ] Multi-currency support (EUR, GBP, USD, etc.)
|
|
- [ ] Tax calculation integration (TaxJar/Avalara or manual rates)
|
|
- [ ] Proration logic for upgrades/downgrades (Cashier swap method)
|
|
- [ ] Admin coupon management CRUD
|
|
- [ ] Email notifications for payment events
|
|
|
|
## Frontend Migration: Tailwind → Vuetify/Vuexy ✅
|
|
- [x] Install Vuetify 3, TypeScript, Pinia, Sass, vite-plugin-vuetify
|
|
- [x] Remove Tailwind CSS
|
|
- [x] Configure TypeScript (tsconfig.json, path aliases, strict mode)
|
|
- [x] Set up Vuetify plugin (theme, defaults, icons)
|
|
- [x] Rename resources/js → resources/ts, convert to TypeScript
|
|
- [x] Copy Vuexy @core SCSS overrides (38 files — base + template + 25 components)
|
|
- [x] Create @layouts stubs for Vuexy SCSS compatibility
|
|
- [x] Configure Vite aliases (@core-scss, @configured-variables, @layouts)
|
|
- [x] Create 4 layouts: AccountLayout, AdminLayout, AuthLayout, MarketingLayout
|
|
- [x] Create shared components: FlashMessages, StatCard, StatusChip, ThemeSwitcher
|
|
- [x] Create AppTextField, AppSelect, AppTextarea wrapper components (Vuexy pattern)
|
|
- [x] Migrate all 19 existing pages to Vuetify + TypeScript
|
|
- [x] Create 9 marketing pages (Home, Products, VPS, Dedicated, Web, Game, Pricing, About, Contact)
|
|
- [x] Create navigation configs (account.ts, admin.ts, marketing.ts)
|
|
- [x] Set purple primary color (#7367F0) matching Vuexy demo
|
|
- [x] All 114 tests passing, build clean (Phase 1-5 + Frontend + Notifications)
|
|
|
|
## Notifications System ✅
|
|
- [x] Create notification classes (PaymentSucceeded, PaymentFailed, SubscriptionCreated, SubscriptionCancelled, ServiceProvisioned, InvoiceGenerated)
|
|
- [x] Configure mail and database notification channels
|
|
- [x] Wire notifications to relevant events (PaymentSucceeded, PaymentFailed, SubscriptionCreated, SubscriptionCancelled, ServiceProvisioned, InvoiceGenerated)
|
|
- [x] Build NotificationBell component in Account and Admin layouts
|
|
- [x] Implement NotificationController (index, markAsRead, markAllAsRead)
|
|
- [x] FlashMessages supports info alerts
|
|
- [x] Inertia shared data includes impersonation state
|
|
|
|
## Phase 3: Provisioning Automation
|
|
- [x] Create `ProvisioningServiceInterface` abstraction
|
|
- [x] Build VirtFusion provisioning service:
|
|
- [x] Create VPS via API
|
|
- [x] Suspend/unsuspend VPS
|
|
- [x] Terminate VPS
|
|
- [x] Get status and resource usage
|
|
- [x] Credential generation and secure storage
|
|
- [ ] Build Pterodactyl provisioning service:
|
|
- [ ] Create game server via API
|
|
- [ ] Suspend/unsuspend server
|
|
- [ ] Delete server
|
|
- [ ] Get server status and resources
|
|
- [x] Build SynergyCP provisioning service:
|
|
- [x] Provision dedicated server
|
|
- [x] Suspend/unsuspend server
|
|
- [x] Terminate server
|
|
- [x] Get server details
|
|
- [x] Handle limited hardware inventory (waitlist/semi-auto)
|
|
- [x] Build Enhance provisioning service:
|
|
- [x] Create web hosting account
|
|
- [x] Suspend/delete account
|
|
- [x] Get account status
|
|
- [x] Implement event-driven provisioning (listen to `PaymentSucceeded` events)
|
|
- [ ] Build provisioning failure handling and retry logic
|
|
- [ ] Send credentials email on successful provisioning
|
|
- [x] Log all provisioning actions to `provisioning_logs` table
|
|
|
|
## Support Ticket System (Standalone) ✅
|
|
- [x] TicketReply model with relationships
|
|
- [x] Updated SupportTicket model with replies() relationship and department field
|
|
- [x] Migration: ticket_replies table + department column on support_tickets
|
|
- [x] Customer TicketController (index, create, store, show, reply, close)
|
|
- [x] Admin TicketController (index with filters, show, reply, updateStatus)
|
|
- [x] SupportTicketFactory with open/closed/urgent states
|
|
- [x] TicketReplyFactory with staffReply state
|
|
- [x] Customer Vue pages: Tickets/Index, Tickets/Create, Tickets/Show
|
|
- [x] Admin Vue pages: Admin/Tickets/Index, Admin/Tickets/Show
|
|
- [x] Ticket status/priority color resolvers
|
|
- [x] TypeScript interfaces for SupportTicket and TicketReply
|
|
- [x] Navigation items for both account and admin sidebars
|
|
- [x] Routes for both account and admin subdomains
|
|
- [x] 30 Pest tests (144 total, 775 assertions)
|
|
|
|
## Phase 4: Customer Dashboard (account.ezscale.cloud)
|
|
- [x] Build service overview dashboard:
|
|
- [x] Active services list with status indicators
|
|
- [ ] Resource usage widgets (CPU, RAM, disk, bandwidth)
|
|
- [x] Next invoice and payment due date
|
|
- [ ] Recent support tickets
|
|
- [x] Quick actions (renew, upgrade, create ticket)
|
|
- [ ] Build service detail pages:
|
|
- [ ] VPS details (IP, credentials, resource graphs, control buttons)
|
|
- [ ] Game server details (connect info, resource usage, restart button)
|
|
- [ ] Dedicated server details (IPs, access info, bandwidth graph)
|
|
- [ ] Web hosting details (domain, cPanel/Enhance link, disk usage)
|
|
- [ ] Bandwidth usage graphs (from ElastiFlow integration)
|
|
- [ ] Billing section:
|
|
- [ ] Invoice history (with PDF download)
|
|
- [ ] Payment history
|
|
- [ ] Manage payment methods (add/remove cards, set default)
|
|
- [ ] Upcoming renewals
|
|
- [x] Plan upgrade/downgrade flow (self-service with proration)
|
|
- [ ] Subscription cancellation flow (with optional survey)
|
|
- [x] Profile and account settings:
|
|
- [x] Contact information
|
|
- [x] Billing/shipping addresses
|
|
- [x] Tax ID
|
|
- [x] Password change
|
|
- [x] 2FA setup (TOTP, passkeys)
|
|
## Phase 5: Admin Panel (admin.ezscale.cloud)
|
|
- [x] Analytics dashboard:
|
|
- [x] MRR (Monthly Recurring Revenue) graph
|
|
- [ ] ARR (Annual Recurring Revenue)
|
|
- [ ] Churn rate calculation and graph
|
|
- [ ] Customer growth chart
|
|
- [ ] Revenue trends (daily, monthly, yearly)
|
|
- [x] Popular plans and conversion rates
|
|
- [x] Outstanding invoices total
|
|
- [ ] Overdue accounts list
|
|
- [x] Customer management:
|
|
- [x] Customer list (searchable, filterable)
|
|
- [x] Customer detail view (profile, services, billing history, notes)
|
|
- [x] Edit customer information
|
|
- [x] Impersonate customer (with audit logging)
|
|
- [x] Add admin notes to customer account
|
|
- [ ] View customer audit log
|
|
- [x] Service management:
|
|
- [x] All services list (filter by type, status, platform)
|
|
- [ ] Manually provision service
|
|
- [x] Suspend/unsuspend service
|
|
- [x] Terminate service
|
|
- [ ] Modify service (change plan, extend expiry)
|
|
- [x] View provisioning logs
|
|
- [x] Order management:
|
|
- [x] Pending orders list
|
|
- [x] Approve/reject orders (for semi-automated provisioning)
|
|
- [x] View order details
|
|
- [x] Invoice management:
|
|
- [x] All invoices list (filter by status, date, customer)
|
|
- [ ] Create manual invoice
|
|
- [ ] Edit invoice (before sending)
|
|
- [x] Void/refund invoice
|
|
- [ ] Resend invoice email
|
|
- [x] Coupon management:
|
|
- [x] Create coupon (percentage, fixed, applies to plans)
|
|
- [x] Edit coupon details
|
|
- [ ] View redemption history
|
|
- [x] Deactivate/delete coupon
|
|
- [x] Plan management:
|
|
- [x] Create new plan (set pricing, features, billing cycle)
|
|
- [x] Edit existing plan
|
|
- [x] Archive/hide plan
|
|
- [x] Set stock quantity (for limited dedicated servers)
|
|
- [x] System configuration:
|
|
- [ ] Email template editor
|
|
- [ ] Tax rate configuration (by region)
|
|
- [x] Suspension policy settings (days before suspend/terminate)
|
|
- [ ] Bandwidth overage rates
|
|
- [ ] Discord webhook URLs
|
|
- [ ] API credentials (VirtFusion, Pterodactyl, etc.)
|
|
- [x] Audit log viewer:
|
|
- [x] Filter by user, action, date
|
|
- [ ] View changes (before/after state)
|
|
- [ ] Export logs
|
|
|
|
## Phase 6: Bandwidth Monitoring & Billing
|
|
- [ ] Set up NetFlow/sFlow export from Juniper switches
|
|
- [ ] Deploy ElastiFlow collector
|
|
- [ ] Build `BandwidthService` to query ElastiFlow API
|
|
- [ ] Create scheduled job to collect daily bandwidth data
|
|
- [ ] Store bandwidth usage in `bandwidth_usage` table
|
|
- [ ] Build bandwidth usage graphs for customer dashboard
|
|
- [ ] Implement multi-threshold alerts:
|
|
- [ ] 75% quota warning email
|
|
- [ ] 90% quota warning email
|
|
- [ ] 100% quota reached email
|
|
- [ ] Discord webhook for high usage customers
|
|
- [ ] Implement automatic overage billing:
|
|
- [ ] Calculate overages at end of billing cycle
|
|
- [ ] Generate overage invoice
|
|
- [ ] Email customer with overage details
|
|
- [ ] Build admin bandwidth reports:
|
|
- [ ] Top bandwidth users
|
|
- [ ] Total bandwidth by service type
|
|
- [ ] Overage revenue report
|
|
|
|
## Phase 8: Marketing Frontend (ezscale.cloud)
|
|
- [x] Homepage:
|
|
- [x] Hero section with value proposition
|
|
- [x] Featured services/plans
|
|
- [x] Trust indicators (uptime, customers, years in business)
|
|
- [x] Call to action (Get Started, View Plans)
|
|
- [x] Product pages:
|
|
- [x] VPS hosting page with plan comparison
|
|
- [x] Dedicated servers page with configurations
|
|
- [x] Web hosting page with features
|
|
- [x] Game server hosting page with supported games
|
|
- [x] Pricing page:
|
|
- [x] Interactive plan comparison table
|
|
- [ ] Currency selector (USD, EUR, GBP)
|
|
- [ ] Coupon code application
|
|
- [ ] Add to cart / checkout flow
|
|
- [x] About page
|
|
- [x] Contact page with form submission backend
|
|
- [ ] Blog/news section (optional, or use WordPress?)
|
|
- [ ] Knowledge base / FAQ:
|
|
- [ ] Getting started guides
|
|
- [ ] Tutorials
|
|
- [ ] Troubleshooting
|
|
- [ ] API documentation
|
|
- [x] Legal pages:
|
|
- [x] Terms of Service
|
|
- [x] Privacy Policy
|
|
- [x] Acceptable Use Policy
|
|
- [x] SLA (Service Level Agreement)
|
|
- [x] Footer links to legal pages
|
|
- [ ] Signup flow:
|
|
- [ ] Plan selection
|
|
- [ ] Account creation
|
|
- [ ] Payment information
|
|
- [ ] Order confirmation
|
|
- [ ] Redirect to account dashboard
|
|
|
|
## Phase 9: API Development
|
|
- [ ] Customer API (RESTful, Sanctum auth):
|
|
- [ ] GET /api/v1/services - List customer's services
|
|
- [ ] GET /api/v1/services/{id} - Service details
|
|
- [ ] POST /api/v1/services/{id}/reboot - Reboot server
|
|
- [ ] GET /api/v1/invoices - Invoice history
|
|
- [ ] GET /api/v1/invoices/{id}/pdf - Download invoice PDF
|
|
- [ ] GET /api/v1/bandwidth - Bandwidth usage
|
|
- [ ] POST /api/v1/subscriptions/{id}/cancel - Cancel subscription
|
|
- [ ] POST /api/v1/tickets - Create support ticket
|
|
- [ ] Admin API:
|
|
- [ ] GET /api/v1/admin/customers - List all customers
|
|
- [ ] GET /api/v1/admin/services - List all services
|
|
- [ ] POST /api/v1/admin/services/{id}/suspend - Suspend service
|
|
- [ ] GET /api/v1/admin/analytics - Analytics data
|
|
- [ ] API documentation (OpenAPI/Swagger)
|
|
- [ ] API rate limiting and throttling
|
|
- [ ] API versioning strategy
|
|
|
|
## Phase 10: Testing, Migration & Launch
|
|
- [ ] Unit tests for all services and models
|
|
- [ ] Feature tests for critical user flows:
|
|
- [ ] Signup and subscription creation
|
|
- [ ] Payment processing (Stripe + PayPal)
|
|
- [ ] Service provisioning (all platforms)
|
|
- [ ] Upgrades/downgrades
|
|
- [ ] Cancellations
|
|
- [ ] Invoice generation
|
|
- [ ] Bandwidth overage billing
|
|
- [ ] Integration tests:
|
|
- [ ] VirtFusion API integration
|
|
- [ ] Pterodactyl API integration
|
|
- [ ] SynergyCP API integration
|
|
- [ ] Enhance API integration
|
|
- [ ] ElastiFlow API integration
|
|
|
|
- [ ] Security testing:
|
|
- [ ] Penetration testing (OWASP Top 10)
|
|
- [ ] Dependency vulnerability scanning
|
|
- [ ] CSRF and XSS testing
|
|
- [ ] SQL injection testing
|
|
- [ ] Rate limiting testing
|
|
- [ ] Performance testing:
|
|
- [ ] Load testing (100+ concurrent users)
|
|
- [ ] Database query optimization
|
|
- [ ] Redis caching implementation
|
|
- [ ] CDN for static assets
|
|
- [ ] WHMCS migration:
|
|
- [ ] Create migration commands:
|
|
- [ ] `migrate:whmcs-customers`
|
|
- [ ] `migrate:whmcs-subscriptions`
|
|
- [ ] `migrate:whmcs-invoices`
|
|
- [ ] `migrate:whmcs-payments`
|
|
- [ ] `migrate:whmcs-services`
|
|
- [ ] `migrate:whmcs-tickets`
|
|
- [ ] Test migration in staging
|
|
- [ ] Verify data integrity
|
|
- [ ] Map WHMCS product IDs to new plan IDs
|
|
- [ ] Coordinate Stripe/PayPal subscription transfer
|
|
- [ ] Pre-launch checklist:
|
|
- [ ] Email customers about migration
|
|
- [ ] Set up WHMCS URL redirects
|
|
- [ ] Configure monitoring (Laravel Telescope, log aggregation)
|
|
- [ ] Set up error tracking (Sentry, Bugsnag)
|
|
- [ ] Configure backups (database, files, Redis)
|
|
- [ ] DNS configuration for all domains
|
|
- [ ] SSL certificates for all domains
|
|
- [ ] Cloudflare Zero Trust for admin panel
|
|
- [ ] Launch:
|
|
- [ ] Execute final WHMCS migration during maintenance window
|
|
- [ ] Enable production mode
|
|
- [ ] Monitor for errors and performance issues
|
|
- [ ] 30-day parallel operation (keep WHMCS read-only)
|
|
- [ ] Gather customer feedback
|
|
- [ ] Address bugs and issues
|
|
- [ ] Post-launch:
|
|
- [ ] Monitor analytics and revenue
|
|
- [ ] Track customer satisfaction
|
|
- [ ] Iterate based on feedback
|
|
- [ ] Plan future features
|
|
|
|
## Phase 11: Future Enhancements (Post-Launch)
|
|
- [ ] Mobile app (iOS/Android) using API
|
|
- [ ] Advanced analytics (cohort analysis, LTV predictions)
|
|
- [ ] Automated resource scaling (auto-upgrade when limits reached)
|
|
- [ ] Custom server configurations (customer can configure RAM, CPU, disk)
|
|
- [ ] Marketplace for add-ons (additional IPs, backups, snapshots)
|
|
- [ ] Advanced bandwidth analytics (top talkers, traffic patterns)
|
|
- [ ] Integration with accounting software (QuickBooks, Xero)
|
|
- [ ] Advanced reporting (custom reports, scheduled exports)
|
|
- [ ] Customer referral program (instead of affiliates)
|
|
- [ ] Live chat support integration
|
|
- [ ] Status page for service health
|
|
- [ ] Automated security scanning for customer servers
|
|
- [ ] Backup management interface
|
|
- [ ] Server snapshots and restoration
|