bonuses/generator.py

def create_bonus_instruction(product_service=None, selected_formula_name=None, target_audience=None, uploaded_content=None, skills=None):
    """
    Creates instructions for generating compelling bonuses that complement the main offer.
    
    Args:
        product_service: Kind of product or service
        selected_formula_name: Name of the formula used for the main offer
        target_audience: Description of the target audience
        uploaded_content: Content from uploaded files (if any)
        skills: User's skills and expertise
        
    Returns:
        str: Complete instruction for generating bonuses
    """
    # Check if any information is provided
    if not product_service and not selected_formula_name and not target_audience and not uploaded_content and not skills:
        return """
        ADVERTENCIA: No se ha proporcionado ninguna información para generar bonos.
        
        Para crear bonos efectivos y relevantes, por favor proporciona al menos uno de los siguientes:
        - Descripción del público objetivo
        - Nombre del producto o servicio
        - Fórmula seleccionada para la oferta principal
        - Contenido adicional relevante
        - Habilidades y experiencia
        
        Sin esta información, los bonos generados serán genéricos y posiblemente menos efectivos para tu oferta específica.
        """
    
    # Base instruction for bonus generation
    base_instruction = """

BONUS CREATION SECTION:

You are now tasked with creating compelling bonuses that complement the main offer and overcome purchase objections.

IMPORTANT: After presenting the main offer and the benefit bullets section, add a section with EXACTLY 5 powerful bonuses that enhance the value proposition.

Start the bonuses section with an introduction like:
"Además, al aprovechar esta oferta también recibirás estos bonos exclusivos:" or "Y eso no es todo, también disfrutarás de estos valiosos recursos adicionales:" or "Como parte de esta oferta especial, obtendrás estos bonos de alto valor:"

For the bonus creation section:

You are a world-class expert in creating irresistible bonus packages that increase perceived value and overcome objections.

OBJECTIVE:
- Generate EXACTLY 5 compelling and specific bonuses in Spanish
- Each bonus must address a specific objection or accelerate results
- Connect emotionally with the target audience's needs
- Provide tools/templates that reduce effort and time
- Include clear monetary value statements
- Add elements of scarcity or urgency
- CRITICAL: At least ONE bonus MUST be a fast-action bonus (limited quantity or time-limited)
"""

    # Add guidance based on available information
    guidance = ""
    
    # Check different combinations of available information
    if not target_audience and not product_service and uploaded_content:
        # Only uploaded content provided
        guidance = """
NOTA IMPORTANTE: Solo se ha proporcionado contenido adicional sin detalles específicos del público objetivo o producto.
Analiza cuidadosamente el contenido subido para:
- Identificar el público objetivo probable a partir del contexto
- Determinar el producto/servicio que probablemente se está ofreciendo
- Extraer puntos de dolor, objeciones y necesidades mencionadas en el contenido
- Crear bonos que complementen la oferta principal inferida del contenido
"""
    elif target_audience and not product_service and not uploaded_content:
        # Only target audience provided
        guidance = """
NOTA IMPORTANTE: Solo se ha proporcionado información del público objetivo, sin detalles del producto ni contenido adicional.
Enfócate en crear bonos que aborden:
- Puntos de dolor específicos mencionados en la descripción del público objetivo
- Objeciones comunes que este público suele tener
- Recursos que ayudarían a este público específico a implementar cualquier solución
"""
    elif product_service and not target_audience and not uploaded_content:
        # Only product name provided
        guidance = """
NOTA IMPORTANTE: Solo se ha proporcionado información del producto, sin detalles del público objetivo ni contenido adicional.
Enfócate en crear bonos que:
- Mejoren el valor del producto específico mencionado
- Aborden objeciones comunes relacionadas con este tipo de producto
- Proporcionen apoyo de implementación para este producto específico
"""
    elif target_audience and product_service and not uploaded_content:
        # Target audience and product provided, no uploaded content
        guidance = """
NOTA IMPORTANTE: Se ha proporcionado información tanto del público objetivo como del producto, pero no hay contenido adicional.
Crea bonos altamente dirigidos que:
- Conecten los beneficios específicos del producto con las necesidades del público objetivo
- Aborden las objeciones más probables que este público tendría sobre este producto
- Proporcionen apoyo de implementación adaptado a esta combinación de público y producto
"""
    elif target_audience and uploaded_content and not product_service:
        # Target audience and uploaded content provided, no product
        guidance = """
NOTA IMPORTANTE: Se ha proporcionado información del público objetivo y contenido adicional, pero no hay detalles específicos del producto.
Analiza ambas fuentes para:
- Inferir el producto/servicio probable del contexto
- Identificar puntos de dolor específicos mencionados tanto en la descripción del público objetivo como en el contenido subido
- Crear bonos que aborden las necesidades y objeciones más prominentes
"""
    elif product_service and uploaded_content and not target_audience:
        # Product and uploaded content provided, no target audience
        guidance = """
NOTA IMPORTANTE: Se ha proporcionado información del producto y contenido adicional, pero no hay detalles del público objetivo.
Analiza ambas fuentes para:
- Inferir el público objetivo probable del contexto
- Identificar cómo el producto aborda las necesidades mencionadas en el contenido subido
- Crear bonos que mejoren el valor del producto para el público probable
"""
    
    # Add information about available inputs
    input_information = f"""
AVAILABLE INFORMATION FOR ANALYSIS:

1. TARGET AUDIENCE DESCRIPTION:
{target_audience if target_audience else "No specific target audience provided."}

2. PRODUCT/SERVICE NAME:
{product_service if product_service else "No specific product name provided."}

3. UPLOADED CONTENT:
{uploaded_content if uploaded_content else "No additional content uploaded."}

4. SKILLS AND EXPERTISE:
{skills if skills else "No specific skills provided."}

{guidance}

IMPORTANT: Analyze ALL available information above to identify specific pain points, objections, and needs that can be addressed through bonuses.
"""
    
    # Detailed instructions for creating effective bonuses with the new structure
    bonus_instructions = """
SPECIFIC INSTRUCTIONS FOR CREATING BONUSES:

STEP 1: DEFINE THE AVATAR WITH PRECISION
- Identify who they are specifically (demographics, psychographics, role, status)
- Determine the exact problem holding them back right now
- Understand how this problem impacts their business or personal life
- Clarify what stage they're at in solving this problem
- Define their level of awareness about potential solutions
- EXTRACT SPECIFIC DETAILS from the target audience description AND uploaded content

STEP 2: IDENTIFY THEIR REAL PAINS AND FRUSTRATIONS
- What frustrates them on a daily basis related to this problem?
- What negative thoughts or limiting beliefs are holding them back?
- What have they tried before that hasn't worked?
- What specific obstacles prevent them from moving forward?
- What fears do they have about potential solutions?
- What keeps them awake at night regarding this problem?

STEP 3: CONNECT WITH THE EMOTIONS BEHIND THE PROBLEM
- How do they feel when facing this problem? (embarrassed, overwhelmed, frustrated)
- What impact does this have on their confidence and self-esteem?
- What emotional triggers might prevent them from taking action?
- How does this problem affect their identity and self-image?
- What emotional relief are they seeking?

STEP 4: SHOW THE REAL-LIFE IMPACT OF THE PROBLEM
- How specifically does it affect their business, relationships, or finances?
- What consequences are they suffering by not resolving it?
- What opportunities are they missing out on?
- What is the cost of inaction (financial, emotional, time)?
- How does this problem affect others around them?

STEP 5: DEFINE THEIR DEEPEST DESIRE
- What do they truly want to achieve beyond the surface-level goal?
- How would their life look without this problem?
- What transformation are they really seeking?
- What status or identity change do they desire?
- What would success mean to them personally?

STEP 6: ILLUSTRATE THEIR DESIRE IN DAILY LIFE
- How would they feel after achieving their goal?
- What visible changes would they experience day-to-day?
- How would others perceive them differently?
- What new opportunities would open up for them?
- What specific improvements would they see in their business or life?

STEP 7: POSITION YOUR SOLUTION AS THE BRIDGE TO TRANSFORMATION
- How does your method/product eliminate their problem?
- What unique approach does your solution offer?
- How does it connect to their deepest desires?
- What timeline can they expect for results?
- Why is your approach better than alternatives they've tried?

STEP 8: CREATE IRRESISTIBLE BONUSES THAT ELIMINATE BARRIERS
For each problem or objection identified in previous steps:
- Design a bonus that directly addresses a specific objection
- Ensure each bonus provides additional value beyond the main offer
- Give each bonus an attractive, specific name that promises a clear outcome
- Focus on tools, templates, checklists rather than additional training
- Ensure each solution provides quick wins and immediate value
"""

    # Rest of the instructions remain the same
    # Modify the formatting requirements section for bonus introductions
    remaining_instructions = """
STEP 9: STRUCTURE EACH BONUS FOLLOWING THIS FRAMEWORK

FORMAT RULES (CRITICAL - MUST FOLLOW EXACTLY):
- Start the section with one of these creative introductions in bold and a space before the first bonus:
  "**Tu inversión hoy incluye estos recursos VIP:**" or
  "**Potenciadores de resultados incluidos:**" or
  "**Aceleradores de éxito que recibirás:**" or
  "**Herramientas premium que desbloquearás:**" or
  "**Recursos estratégicos de acceso inmediato:**" or
  "**Tu arsenal de éxito también incluye:**"

- Format each bonus title as: "• **BONO #1: [Nombre Atractivo]**" (bullet point, then bold text)
- Each bonus description should be on the same line as its title
- Include a value statement at the end of each bonus description as "**Valor: $X**" in bold
- Add exactly one empty line between each bonus
- Maintain consistent formatting across all bonuses
- Use natural, conversational language (avoid formal or technical jargon)
- Never use exclamation marks (!) in bonus titles

CRITICAL BONUS CREATION GUIDELINES:

1. COMPLEMENTARY VALUE:
   - Each bonus must complement (not compete with) the main offer: {product_service}
   - Tools and checklists are BETTER than additional training (less effort/time = higher perceived value)
   - The combined perceived value of all bonuses should EXCEED the value of the main offer

2. OBJECTION HANDLING:
   - Each bonus must address a specific concern or obstacle in the prospect's mind
   - Demonstrate why their limiting beliefs about success are incorrect
   - Solve their "next problem" before they encounter it
   - Show how the bonus removes friction from implementing the main offer

3. PSYCHOLOGICAL TRIGGERS:
   - Create a value discrepancy between price and total package worth
   - Communicate subconsciously that the main offer must be extremely valuable
   - Add scarcity and urgency elements to each bonus to maximize impact
   - Focus on immediate implementation and quick wins
   
4. BONUS TYPES TO PRIORITIZE:
   - Tools that simplify implementation of the main offer
   - Templates that save time and ensure success
   - Checklists that prevent mistakes and ensure completion
   - Quick-start guides that accelerate initial results
   - Swipe files or examples that can be immediately used
   - Limited access to exclusive resources or communities
   - Personal feedback or review opportunities

5. SCARCITY AND URGENCY EXAMPLES:
   a) Scarcity-based bonuses:
      - "Solo las personas que se inscriban en este programa tendrán acceso a estos bonos que nunca están a la venta en otro lugar."
      - "Solo quedan 5 cupos para mi sesión estratégica valorada en $500, si compras hoy, puedes obtener uno de los últimos lugares como bono."
   
   b) Urgency-based bonuses:
      - "Si compras hoy, agregaré el bono XYZ que normalmente cuesta $1,000, completamente gratis. Lo hago porque quiero premiar a quienes toman acción inmediata."
      - "Este bono estará disponible solo durante las próximas 48 horas, después de ese tiempo será retirado permanentemente."

6. FAST-ACTION BONUS STRATEGIES (MANDATORY - INCLUDE AT LEAST ONE):
   a) Limited quantity bonuses:
      - "**BONO DE ACCIÓN RÁPIDA: Solo para los primeros 5 compradores**" 
      - "Las primeras 5 personas que se inscriban hoy recibirán [nombre del bono] valorado en $X"
      - "Solo tenemos 5 cupos disponibles para la sesión estratégica personalizada"
   
   b) Time-limited bonuses:
      - "**BONO ESPECIAL: Disponible solo hasta la medianoche de hoy**"
      - "Si te inscribes antes de la medianoche, también recibirás [nombre del bono]"
      - "Este bono exclusivo desaparecerá cuando el reloj marque las 12:00 de la noche"

   c) Combination strategies:
      - "Los primeros 5 compradores que se inscriban antes de la medianoche recibirán [bono exclusivo]"
      - "Solo por hoy: Las próximas 5 personas que tomen acción recibirán [bono adicional]"

FORMATTING REQUIREMENTS:
- Start with a brief introduction about the additional value (max 2 sentences)
- Format each bonus as: "**BONO #1: [Nombre Atractivo]**" in bold
- Follow with 2-4 sentences describing the bonus and its specific benefit
- Include a value statement for each bonus in bold: "**Valor: $X**"
- Add an urgency or scarcity element for each bonus
- End with a total value statement for all bonuses combined in bold: "**Valor total de bonos: $X**"
- MANDATORY: Include at least one fast-action bonus with clear scarcity (limited quantity) or urgency (time limit)
- MANDATORY: Create EXACTLY 5 bonuses - no more, no less

VALIDATION CHECKLIST (ENSURE ALL THESE ARE MET):
- ✓ Exactly 5 bonuses created
- ✓ At least one bonus is a fast-action bonus (time or quantity limited)
- ✓ Each bonus has a clear monetary value
- ✓ Total value of all bonuses is stated at the end
- ✓ Each bonus addresses a specific objection or accelerates results
- ✓ Formatting follows the exact requirements specified above
"""

    # Add formula-specific bonus guidance
    formula_specific_guidance = ""
    if selected_formula_name:
        if selected_formula_name == "Oferta Dorada":
            formula_specific_guidance = """
FORMULA-SPECIFIC BONUS GUIDANCE (OFERTA DORADA):
- Create bonuses that enhance the perceived value of the headline promise
- Include at least one bonus that provides proof or validation of the main promise
- Add a bonus that addresses the most common objection for this type of offer
- Consider a bonus that accelerates the timeline mentioned in the subtitle
- Ensure bonuses maintain the same tone and sophistication level as the main offer
"""
        elif selected_formula_name == "Contraste Revelador":
            formula_specific_guidance = """
FORMULA-SPECIFIC BONUS GUIDANCE (CONTRASTE REVELADOR):
- Create bonuses that bridge the gap between the current situation and desired outcome
- Include at least one bonus that makes the solution easier to implement
- Add a bonus that addresses potential fears about the transformation process
- Consider a bonus that provides additional proof of the promised results
- Ensure bonuses reinforce the emotional contrast between problem and solution
"""
        elif selected_formula_name == "Propuesta Única de Valor":
            formula_specific_guidance = """
FORMULA-SPECIFIC BONUS GUIDANCE (PROPUESTA ÚNICA DE VALOR):
- Create bonuses that directly address the objections mentioned in the main offer
- Include at least one bonus that enhances the unique transformation promised
- Add a bonus that provides social proof or validation of the transformation
- Consider a bonus that helps overcome implementation challenges
- Ensure bonuses reinforce the unique mechanism or approach of the main offer
"""
        
        # Add the formula-specific guidance to the input information
        input_information += f"\n\n5. SELECTED FORMULA: {selected_formula_name}\n{formula_specific_guidance}"

    # Combine all instructions
    complete_instruction = base_instruction + input_information + bonus_instructions + remaining_instructions
    
    return complete_instruction