BREAKING CHANGES: - Refactored monolithic manage.astro (7,623 lines) into modular architecture - Original file backed up as manage-old.astro NEW ARCHITECTURE: ✅ 5 Utility Libraries: - event-management.ts: Event data operations & formatting - ticket-management.ts: Ticket CRUD operations & sales data - seating-management.ts: Seating map management & layout generation - sales-analytics.ts: Sales metrics, reporting & data export - marketing-kit.ts: Marketing asset generation & social media ✅ 5 Shared Components: - TicketTypeModal.tsx: Reusable ticket type creation/editing - SeatingMapModal.tsx: Advanced seating map editor with drag-and-drop - EmbedCodeModal.tsx: Widget embedding with customization - OrdersTable.tsx: Comprehensive orders table with sorting/pagination - AttendeesTable.tsx: Attendee management with export capabilities ✅ 11 Tab Components: - TicketsTab.tsx: Ticket management with card/list views - VenueTab.tsx: Seating map management & venue configuration - OrdersTab.tsx: Sales data & order management - AttendeesTab.tsx: Attendee check-in & management - PresaleTab.tsx: Presale code generation & tracking - DiscountTab.tsx: Discount code management - AddonsTab.tsx: Add-on product management - PrintedTab.tsx: Printed ticket barcode management - SettingsTab.tsx: Event configuration & custom fields - MarketingTab.tsx: Marketing kit with social media templates - PromotionsTab.tsx: Campaign & promotion management ✅ 4 Infrastructure Components: - TabNavigation.tsx: Responsive tab navigation system - EventManagement.tsx: Main orchestration component - EventHeader.astro: Event information header - QuickStats.astro: Statistics dashboard BENEFITS: - 98.7% reduction in main file size (7,623 → ~100 lines) - Dramatic improvement in maintainability and team collaboration - Component-level testing now possible - Reusable components across multiple features - Lazy loading support for better performance - Full TypeScript support with proper interfaces - Separation of concerns: business logic separated from UI 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
10 KiB
Future Upgrades & Features
This document outlines planned features and upgrades for the Black Canyon Tickets platform that will be implemented over time.
🎫 Priority 1: TicketPrinting.com Physical Ticket Ordering Integration
Overview
Allow event organizers to order branded, pre-approved physical tickets for sponsors, VIPs, and comps directly through the Black Canyon Tickets website, using TicketPrinting.com as the print vendor.
Goal
Seamless physical ticket ordering while maintaining control over branding and order flow through BCT's corporate account.
Functional Requirements
1. Design Access & Limitation
- Custom design interface (or embedded TicketPrinting.com designer)
- Editable fields for organizers:
- Event name, date, location
- Ticket type (Sponsor, VIP, GA, etc.)
- Optional logo/image upload (with size/type validation)
- Restrict to template-based layouts only (no freeform design)
2. Order Flow
- All orders use Black Canyon Tickets corporate account at TicketPrinting.com
- Organizer workflow:
- Customizes ticket with allowed fields
- Selects quantity/shipping details
- Reviews mockup & confirms order
- Optional BCT admin approval before order submission
- Confirmation screen with final design, order details, and shipping info
3. Integration Options
If TicketPrinting.com API Exists:
- Direct integration:
- Use API to render ticket designer within BCT portal
- Submit orders programmatically under BCT's account
- Sync order status and shipping updates to BCT backend
If No API Exists:
- Fallback approaches:
- Embed design tool via iframe (if embeddable and restrictable)
- Build custom form-driven ticket builder in Astro
- Generate print-ready PDF/assets and submit via:
- Manual upload to TicketPrinting.com
- Automated email with order PDF and details
- Maintain internal approval queue (Supabase)
Technical Research Needed
- Does TicketPrinting.com offer an API or white-label/partner solution?
- Can iframe or custom UI control design limits?
- Should order approvals use webhooks or internal approval queue?
- Best backend stack for integration and PDF generation
Deliverables
A. Integration Architecture (If API Exists)
- Authentication: Organizer logs in to BCT, not vendor
- Designer UI: Either embedded API designer or controlled BCT UI
- Order Submission: API call from BCT backend
- Order Status: Webhook or polling from TicketPrinting.com
B. Fallback Solution (No API)
- Custom design form with restricted fields
- Store order details and design assets in Supabase
- Admin approval step (internal queue)
- Submit to vendor via manual upload or auto-email
C. Organizer UX Flow
- Step 1: Choose ticket template
- Step 2: Enter event details (name, date, location, ticket type, upload logo)
- Step 3: See live preview/mockup (enforce branding limits)
- Step 4: Enter quantity and shipping info
- Step 5: Review and confirm order
- Step 6: Order status page (pending approval, submitted, shipped, etc.)
D. Data Model
-- Physical ticket orders table
CREATE TABLE physical_ticket_orders (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
event_id UUID REFERENCES events(id),
organizer_id UUID REFERENCES users(id),
organization_id UUID REFERENCES organizations(id),
template_id TEXT,
editable_fields JSONB, -- Event name, date, type, location, etc.
logo_url TEXT,
preview_url TEXT,
quantity INTEGER,
status TEXT CHECK (status IN ('draft', 'pending', 'approved', 'submitted', 'printing', 'shipped', 'delivered', 'cancelled')),
shipping_address JSONB,
submitted_at TIMESTAMP,
approved_by UUID REFERENCES users(id),
vendor_order_id TEXT,
tracking_number TEXT,
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
);
Implementation Priority
High Priority - This feature adds significant value for premium events and sponsors.
Estimated Timeline
- Research & Planning: 1-2 weeks
- MVP Development: 4-6 weeks
- Testing & Refinement: 2-3 weeks
🎯 Priority 2: Advanced Analytics Dashboard
Overview
Enhanced analytics and reporting for event organizers with real-time insights, revenue tracking, and attendee demographics.
Features
- Real-time sales tracking with live charts
- Revenue forecasting based on historical data
- Attendee demographics and geographic distribution
- Marketing campaign effectiveness tracking
- Comparative event performance metrics
- Automated reporting via email/PDF exports
Technical Requirements
- Integration with existing analytics system
- Real-time data visualization (Chart.js or D3.js)
- Export functionality (PDF, CSV, Excel)
- Dashboard customization per organization
Estimated Timeline
- Development: 6-8 weeks
- Testing: 2-3 weeks
🎯 Priority 3: Mobile Event Management App
Overview
Dedicated mobile application for event organizers to manage events, scan tickets, and monitor sales on-the-go.
Features
- Event dashboard with key metrics
- QR code scanning for ticket validation
- Push notifications for sales milestones
- Offline capability for door scanning
- Guest list management and check-in
- Revenue tracking and reporting
Technical Requirements
- React Native or Flutter development
- Offline data synchronization
- Camera API integration for QR scanning
- Push notification service
- Secure authentication with existing BCT accounts
Estimated Timeline
- Development: 10-12 weeks
- Testing & Store Approval: 3-4 weeks
🎯 Priority 4: Event Collaboration Tools
Overview
Tools for event organizers to collaborate with team members, vendors, and sponsors in planning and managing events.
Features
- Team member invitations with role-based permissions
- Vendor management with contact tracking
- Sponsor portal with branded access
- Task management and deadlines
- Communication hub with event-specific messaging
- Document sharing and version control
Technical Requirements
- Role-based access control (RBAC) system
- Real-time messaging (WebSockets or similar)
- File upload and management system
- Calendar integration
- Email notification system
Estimated Timeline
- Development: 8-10 weeks
- Testing: 2-3 weeks
🎯 Priority 5: Advanced Seating Management
Overview
Enhanced seating management with interactive seat selection, accessibility options, and group booking capabilities.
Features
- Interactive seat maps with drag-and-drop editing
- Accessibility seating designation and booking
- Group booking with automatic seat assignment
- Seat hold and release functionality
- Premium seating with dynamic pricing
- Waitlist management for sold-out sections
Technical Requirements
- SVG or Canvas-based seat map rendering
- Real-time seat availability updates
- Complex pricing algorithms
- Inventory management enhancements
Estimated Timeline
- Development: 8-10 weeks
- Testing: 3-4 weeks
🎯 Priority 6: Marketing Automation Suite
Overview
Automated marketing tools to help event organizers promote their events and increase ticket sales.
Features
- Email campaign builder with templates
- Social media scheduling and posting
- Automated follow-up sequences for cart abandonment
- Referral program management
- Influencer tracking and commission management
- A/B testing for marketing messages
Technical Requirements
- Integration with email service providers
- Social media API integrations
- Campaign performance tracking
- Referral code generation and tracking
- A/B testing framework
Estimated Timeline
- Development: 10-12 weeks
- Testing: 3-4 weeks
🎯 Priority 7: Multi-Language Support
Overview
Internationalization support for events targeting diverse audiences or international markets.
Features
- Multi-language ticket pages with locale switching
- Currency conversion and international payments
- Localized date/time formatting
- Right-to-left language support
- Translation management for event organizers
Technical Requirements
- i18n framework implementation
- Currency conversion API integration
- Locale-specific formatting
- Translation file management
- Font and styling adjustments for different languages
Estimated Timeline
- Development: 6-8 weeks
- Testing: 2-3 weeks
🎯 Priority 8: API and Third-Party Integrations
Overview
Public API and enhanced third-party integrations for extended functionality.
Features
- Public REST API for developers
- Webhook system for real-time updates
- CRM integrations (Salesforce, HubSpot)
- Accounting software integration (QuickBooks, Xero)
- POS system integration for on-site sales
- Social media platform integrations
Technical Requirements
- API documentation and developer portal
- Rate limiting and security measures
- OAuth 2.0 authentication
- Webhook delivery and retry logic
- Third-party API client libraries
Estimated Timeline
- Development: 8-10 weeks
- Documentation & Testing: 2-3 weeks
Implementation Notes
Development Priorities
- User Value Impact: Features that directly improve organizer experience
- Revenue Generation: Features that can increase platform revenue
- Technical Complexity: Balance complexity with development resources
- Market Demand: Features requested by current and potential customers
Technical Considerations
- Scalability: All features must handle growth in user base and event volume
- Security: Maintain high security standards for all new features
- Performance: Optimize for mobile and slow network connections
- Accessibility: Ensure WCAG compliance for all user-facing features
- Integration: Work seamlessly with existing BCT architecture
Success Metrics
- User Adoption: Percentage of organizers using new features
- Revenue Impact: Direct revenue increase from premium features
- Support Reduction: Decrease in support tickets through improved UX
- Performance: Page load times and system responsiveness
- Customer Satisfaction: User feedback and retention rates
This document will be updated as priorities change and new features are identified.