fraim-framework 2.0.55 → 2.0.56

package/dist/registry/workflows/startup-credits/google-cloud-application.md

@@ -0,0 +1,647 @@
+# Google Cloud for Startups Application Guide
+
+**Complete step-by-step guide with Playwright automation instructions for applying to Google Cloud for Startups credits (up to $350K for AI Tier).**
+
+---
+
+## ⚠️ IMPORTANT: Collect User Information First
+
+**Before starting automation, you MUST ask the user for the following information:**
+
+- **Company Name**
+- **Founder/Contact Name** (first and last name)
+- **Business Email** (MUST match website domain)
+- **Phone Number** (format: digits only, no dashes)
+- **Company Website** (full URL)
+- **Founded Date** (month and year)
+- **Location:** City, State, Zip Code
+- **State/Province**
+- **Country**
+- **Industry**
+- **Job Role**
+- **Job Title**
+- **Funding Level** (e.g., "Bootstrapped", "Pre-seed", "Seed")
+- **Founded Date Range** (e.g., "3-12 months", "1-2 years")
+- **Accelerators** (usually "NONE" if not part of an accelerator)
+- **Google Cloud Billing Account ID** (format: `XXXXXX-XXXXXX-XXXXXX`, 18 characters)
+  - User can find this in: https://console.cloud.google.com/billing
+  - **CRITICAL:** Billing account admin email domain must match website domain
+
+**Store these values in variables and use them throughout the automation steps below.**
+
+---
+
+## Overview
+
+**Program:** Google Cloud for Startups Cloud Program  
+**Credits:** Up to $350,000 USD (AI Tier) or $200,000 USD (Scale Tier)  
+**URL:** https://cloud.google.com/startup/apply  
+**Processing Time:** 3-5 business days (or 7-10 days for new billing accounts)
+
+---
+
+## Prerequisites
+
+### Required Information
+- **Company Name:** [ASK USER]
+- **Founder Name:** [ASK USER]
+- **Business Email:** [ASK USER] (MUST match website domain)
+- **Phone:** [ASK USER] (format: digits only)
+- **Website:** [ASK USER] (full URL)
+- **Founded:** [ASK USER] (month and year)
+- **Location:** [ASK USER - City, State, Zip]
+- **State:** [ASK USER]
+- **Country:** [ASK USER]
+- **Industry:** [ASK USER] (e.g., Technology)
+- **Job Role:** [ASK USER]
+- **Job Title:** [ASK USER]
+- **Funding Level:** [ASK USER] (e.g., Bootstrapped)
+- **Founded Date Range:** [ASK USER] (e.g., 3-12 months)
+- **Accelerators:** [ASK USER] (usually "NONE")
+
+### Required Accounts & Setup
+- **Google Account:** For signing in
+- **Business Email:** [ASK USER] (must be set up and match website domain)
+- **Google Cloud Billing Account ID:** [ASK USER] (format: `XXXXXX-XXXXXX-XXXXXX`)
+  - Find in: https://console.cloud.google.com/billing
+  - **Important:** Billing account admin email domain must match website domain
+
+### Pre-Application Setup
+
+**If business email doesn't exist:**
+1. Set up email service (Zoho Mail, Google Workspace, etc.) for user's domain
+2. Create business email address
+3. Configure DNS records (MX, SPF, TXT)
+4. Verify email is working
+
+**If billing account admin email doesn't match domain:**
+1. Navigate to: https://console.cloud.google.com/billing
+2. Open billing account (user will provide ID)
+3. Go to Account Management
+4. Add business email as Billing Account Administrator
+5. Wait for email verification (may require Google Cloud Identity setup)
+
+---
+
+## Playwright Automation Steps
+
+### Step 1: Navigate to Google Cloud for Startups Application Page
+
+```javascript
+// Navigate to application page
+await page.goto('https://cloud.google.com/startup/apply');
+await page.waitForTimeout(3000);
+```
+
+**Expected Result:** Page loads showing application form.
+
+---
+
+### Step 2: Sign In with Google Account
+
+```javascript
+// If sign-in required, wait for user to sign in manually
+// Or automate if credentials available
+await page.waitForURL(/accounts.google.com|cloud.google.com/, { timeout: 30000 });
+
+// After sign-in, wait for form to load
+await page.waitForSelector('input[type="text"], input[type="email"]', { timeout: 10000 });
+```
+
+**Note:** User must sign in manually with Google Account. Wait for navigation to application form.
+
+---
+
+### Step 3: Fill Personal Information
+
+```javascript
+// Use user-provided information - REPLACE WITH ACTUAL VALUES FROM USER
+const firstName = '[USER_FIRST_NAME]'; // ASK USER
+const lastName = '[USER_LAST_NAME]'; // ASK USER
+const businessEmail = '[USER_BUSINESS_EMAIL]'; // ASK USER (must match website domain)
+const phone = '[USER_PHONE]'; // ASK USER (digits only)
+
+// Fill first name
+await page.getByRole('textbox', { name: /first name/i }).fill(firstName);
+await page.waitForTimeout(500);
+
+// Fill last name
+await page.getByRole('textbox', { name: /last name/i }).fill(lastName);
+await page.waitForTimeout(500);
+
+// Fill business email (CRITICAL: must match website domain)
+await page.getByRole('textbox', { name: /business email/i }).fill(businessEmail);
+await page.waitForTimeout(1000);
+
+// Verify no error appears (personal emails like @gmail.com will be rejected)
+const emailError = page.locator('text=/personal email|business email required/i');
+if (await emailError.isVisible()) {
+  throw new Error('Business email validation failed - must use domain matching website');
+}
+
+// Fill business phone (format: digits only)
+await page.getByRole('textbox', { name: /business phone|phone/i }).fill(phone);
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Personal information filled, no email validation errors.
+
+---
+
+### Step 4: Fill Company Information
+
+```javascript
+// Use user-provided information - REPLACE WITH ACTUAL VALUES FROM USER
+const companyName = '[USER_COMPANY_NAME]'; // ASK USER
+const website = '[USER_WEBSITE]'; // ASK USER (full URL)
+
+// Fill company name
+await page.getByRole('textbox', { name: /company name|startup name/i }).fill(companyName);
+await page.waitForTimeout(500);
+
+// Fill startup website domain (full URL)
+await page.getByRole('textbox', { name: /website|domain/i }).fill(website);
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Company information filled.
+
+---
+
+### Step 5: Select Industry (Dropdown)
+
+```javascript
+// Use user-provided industry - REPLACE WITH ACTUAL VALUE FROM USER
+const industry = '[USER_INDUSTRY]'; // ASK USER (e.g., "Technology")
+
+// Click industry dropdown
+await page.getByRole('combobox', { name: /industry/i }).click();
+await page.waitForTimeout(1000);
+
+// Type industry name
+await page.keyboard.type(industry);
+await page.waitForTimeout(1000);
+
+// Select industry from dropdown
+await page.getByRole('option', { name: new RegExp(`^${industry}$`, 'i') }).click();
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** Industry selected.
+
+---
+
+### Step 6: Select Job Role (Dropdown)
+
+```javascript
+// Use user-provided job role - REPLACE WITH ACTUAL VALUE FROM USER
+const jobRole = '[USER_JOB_ROLE]'; // ASK USER
+
+// Click job role dropdown
+await page.getByRole('combobox', { name: /job role/i }).click();
+await page.waitForTimeout(1000);
+
+// Type job role
+await page.keyboard.type(jobRole.split('/')[0].trim()); // Type first part (e.g., "CEO")
+await page.waitForTimeout(1000);
+
+// Select job role from dropdown
+await page.getByRole('option', { name: new RegExp(jobRole, 'i') }).click();
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** Job role selected.
+
+---
+
+### Step 7: Fill Job Title
+
+```javascript
+// Use user-provided job title - REPLACE WITH ACTUAL VALUE FROM USER
+const jobTitle = '[USER_JOB_TITLE]'; // ASK USER
+
+// Fill job title
+await page.getByRole('textbox', { name: /job title/i }).fill(jobTitle);
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Job title filled.
+
+---
+
+### Step 8: Select AI Startup (Radio Button)
+
+```javascript
+// ASK USER if their startup is AI-first
+// If yes, select AI startups for up to $350K credits
+// If no, skip this step (will get Scale Tier up to $200K)
+
+// Select "AI startups" radio button (if applicable)
+const isAIStartup = '[USER_IS_AI_STARTUP]'; // ASK USER (true/false)
+if (isAIStartup === 'true' || isAIStartup === true) {
+  await page.getByRole('radio', { name: /AI startups|AI.*startup/i }).click();
+  await page.waitForTimeout(500);
+}
+```
+
+**Expected Result:** AI Startup option selected (if applicable).
+
+---
+
+### Step 9: Click "Submit & Continue"
+
+```javascript
+// Click submit/continue button
+await page.getByRole('button', { name: /submit.*continue|continue|next/i }).click();
+await page.waitForTimeout(3000);
+```
+
+**Expected Result:** Form progresses to next page.
+
+---
+
+### Step 10: Fill Additional Company Details (Page 2)
+
+```javascript
+// Use user-provided information - REPLACE WITH ACTUAL VALUES FROM USER
+const businessEmail = '[USER_BUSINESS_EMAIL]'; // ASK USER
+const website = '[USER_WEBSITE]'; // ASK USER
+
+// Fill business email again (if required on second page)
+const businessEmailField = page.getByRole('textbox', { name: /business email/i });
+if (await businessEmailField.isVisible()) {
+  await businessEmailField.fill(businessEmail);
+  await page.waitForTimeout(500);
+}
+
+// Fill startup website domain (if required again)
+const websiteField = page.getByRole('textbox', { name: /website|domain/i });
+if (await websiteField.isVisible()) {
+  await websiteField.fill(website);
+  await page.waitForTimeout(500);
+}
+```
+
+---
+
+### Step 11: Enter Google Cloud Billing Account ID
+
+```javascript
+// Use user-provided billing account ID - REPLACE WITH ACTUAL VALUE FROM USER
+const billingAccountId = '[USER_BILLING_ACCOUNT_ID]'; // ASK USER (format: XXXXXX-XXXXXX-XXXXXX)
+
+// Fill billing account ID
+await page.getByRole('textbox', { name: /billing.*account.*ID|billing account/i }).fill(billingAccountId);
+await page.waitForTimeout(1000);
+
+// Verify no error appears
+const billingError = page.locator('text=/invalid.*billing|billing.*domain.*match/i');
+if (await billingError.isVisible()) {
+  const errorText = await billingError.textContent();
+  console.error(`Billing account error: ${errorText}`);
+  
+  // If error says admin email domain must match, need to:
+  // 1. Add business email as billing account admin
+  // 2. Or set up Google Cloud Identity for user's domain
+  throw new Error('Billing account admin email domain must match website domain');
+}
+```
+
+**Expected Result:** Billing account ID accepted, no validation errors.
+
+---
+
+### Step 12: Select Funding Level
+
+```javascript
+// Use user-provided funding level - REPLACE WITH ACTUAL VALUE FROM USER
+const fundingLevel = '[USER_FUNDING_LEVEL]'; // ASK USER (e.g., "Bootstrapped", "Pre-seed")
+
+// Select funding level radio button
+await page.getByRole('radio', { name: new RegExp(fundingLevel, 'i') }).click();
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Funding level selected.
+
+---
+
+### Step 13: Select Founded Date Range
+
+```javascript
+// Use user-provided founded date range - REPLACE WITH ACTUAL VALUE FROM USER
+const foundedRange = '[USER_FOUNDED_RANGE]'; // ASK USER (e.g., "3-12 months", "1-2 years")
+
+// Select founded date range radio button
+await page.getByRole('radio', { name: new RegExp(foundedRange.replace('-', '.*'), 'i') }).click();
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Founded date range selected.
+
+---
+
+### Step 14: Fill Address Information
+
+```javascript
+// Use user-provided address - REPLACE WITH ACTUAL VALUES FROM USER
+const city = '[USER_CITY]'; // ASK USER
+const zipCode = '[USER_ZIP_CODE]'; // ASK USER
+const streetAddress = '[USER_STREET_ADDRESS]'; // ASK USER (if required)
+
+// Fill street address (if required)
+const streetField = page.getByRole('textbox', { name: /street|address/i });
+if (await streetField.isVisible() && streetAddress) {
+  await streetField.fill(streetAddress);
+  await page.waitForTimeout(500);
+}
+
+// Fill city
+await page.getByRole('textbox', { name: /city/i }).fill(city);
+await page.waitForTimeout(500);
+
+// Fill postal code
+await page.getByRole('textbox', { name: /postal|zip/i }).fill(zipCode);
+await page.waitForTimeout(500);
+```
+
+---
+
+### Step 15: Select State (Dropdown)
+
+```javascript
+// Use user-provided state - REPLACE WITH ACTUAL VALUE FROM USER
+const state = '[USER_STATE]'; // ASK USER (e.g., "Washington" or "WA")
+
+// Click state dropdown
+await page.getByRole('combobox', { name: /state|province/i }).click();
+await page.waitForTimeout(1000);
+
+// Type state name
+await page.keyboard.type(state);
+await page.waitForTimeout(1000);
+
+// Select state from dropdown
+await page.getByRole('option', { name: new RegExp(`^${state}$|^${state}$`, 'i') }).click();
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** State selected.
+
+---
+
+### Step 16: Select Accelerators (Dropdown)
+
+```javascript
+// Use user-provided accelerators - REPLACE WITH ACTUAL VALUE FROM USER
+// Usually "NONE" if not part of an accelerator
+const accelerators = '[USER_ACCELERATORS]'; // ASK USER (usually "NONE")
+
+// Click accelerators dropdown
+await page.getByRole('combobox', { name: /accelerator|incubator|partner/i }).click();
+await page.waitForTimeout(1000);
+
+// Type accelerator name
+await page.keyboard.type(accelerators);
+await page.waitForTimeout(1000);
+
+// Select from dropdown
+const acceleratorOption = page.getByRole('option', { name: new RegExp(`^${accelerators}$`, 'i') });
+if (await acceleratorOption.isVisible()) {
+  await acceleratorOption.click();
+} else {
+  // Try clicking outside to close if already selected
+  await page.keyboard.press('Escape');
+}
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** Accelerators selected (usually "NONE").
+
+---
+
+### Step 17: Accept Terms and Conditions
+
+```javascript
+// Check terms checkbox
+const termsCheckbox = page.getByRole('checkbox', { name: /terms|agreement/i });
+if (await termsCheckbox.isVisible()) {
+  await termsCheckbox.check();
+  await page.waitForTimeout(500);
+}
+
+// Check credits deposit checkbox (if present)
+const creditsCheckbox = page.getByRole('checkbox', { name: /credits|deposit/i });
+if (await creditsCheckbox.isVisible()) {
+  await creditsCheckbox.check();
+  await page.waitForTimeout(500);
+}
+```
+
+**Expected Result:** All required checkboxes checked.
+
+---
+
+### Step 18: Submit Application
+
+```javascript
+// Click final submit button
+await page.getByRole('button', { name: /submit.*application|submit/i }).click();
+await page.waitForTimeout(5000);
+
+// Wait for confirmation page or success message
+await page.waitForSelector('text=/success|submitted|thank you|application.*received/i', { timeout: 10000 });
+```
+
+**Expected Result:** Application submitted successfully, confirmation page appears.
+
+---
+
+## Handling Billing Account Domain Mismatch Error
+
+### Error: "Your Billing account ID admin email domain must match the website domain"
+
+**Solution Steps:**
+
+#### Option 1: Add Business Email as Billing Account Administrator
+
+```javascript
+// Use user-provided billing account ID - REPLACE WITH ACTUAL VALUE FROM USER
+const billingAccountId = '[USER_BILLING_ACCOUNT_ID]'; // ASK USER
+const businessEmail = '[USER_BUSINESS_EMAIL]'; // ASK USER
+
+// Navigate to billing account management
+await page.goto(`https://console.cloud.google.com/billing/${billingAccountId}/manage`);
+await page.waitForTimeout(3000);
+
+// Click "Add principal" button
+await page.getByRole('button', { name: /add principal/i }).click();
+await page.waitForTimeout(2000);
+
+// Enter business email
+await page.getByRole('textbox', { name: /new principal|email/i }).fill(businessEmail);
+await page.waitForTimeout(2000);
+
+// Select role: Billing Account Administrator
+await page.getByRole('combobox', { name: /role/i }).click();
+await page.waitForTimeout(1000);
+await page.getByRole('option', { name: /billing.*account.*administrator/i }).click();
+await page.waitForTimeout(1000);
+
+// Click Save
+await page.getByRole('button', { name: /save/i }).click();
+await page.waitForTimeout(3000);
+```
+
+**Note:** This may require Google Cloud Identity to be set up for user's domain first.
+
+#### Option 2: Set Up Google Cloud Identity
+
+```javascript
+// Use user-provided information - REPLACE WITH ACTUAL VALUES FROM USER
+const companyName = '[USER_COMPANY_NAME]'; // ASK USER
+const firstName = '[USER_FIRST_NAME]'; // ASK USER
+const lastName = '[USER_LAST_NAME]'; // ASK USER
+const currentEmail = '[USER_CURRENT_EMAIL]'; // ASK USER (for verification)
+const domain = '[USER_DOMAIN]'; // ASK USER (extract from website, e.g., "example.com")
+const username = '[USER_USERNAME]'; // ASK USER (for business email, e.g., "founder")
+const password = '[USER_PASSWORD]'; // ASK USER (or generate secure password)
+const phone = '[USER_PHONE]'; // ASK USER (for verification)
+
+// Navigate to Cloud Identity signup
+await page.goto('https://workspace.google.com/gcpidentity/signup?sku=identitybasic');
+await page.waitForTimeout(3000);
+
+// Fill business name
+await page.getByRole('textbox', { name: /business name/i }).fill(companyName);
+await page.waitForTimeout(500);
+
+// Select number of employees
+await page.getByRole('radio', { name: /one|just you/i }).click();
+await page.waitForTimeout(500);
+
+// Click Next
+await page.getByRole('button', { name: /next/i }).click();
+await page.waitForTimeout(2000);
+
+// Fill contact info
+await page.getByRole('textbox', { name: /first name/i }).fill(firstName);
+await page.getByRole('textbox', { name: /last name/i }).fill(lastName);
+await page.getByRole('textbox', { name: /current email/i }).fill(currentEmail);
+await page.getByRole('button', { name: /next/i }).click();
+await page.waitForTimeout(2000);
+
+// Enter domain
+await page.getByRole('textbox', { name: /domain name/i }).fill(domain);
+await page.getByRole('button', { name: /next/i }).click();
+await page.waitForTimeout(2000);
+
+// Confirm domain
+await page.getByRole('button', { name: /next/i }).click();
+await page.waitForTimeout(2000);
+
+// Create username and password
+await page.getByRole('textbox', { name: /username/i }).fill(username);
+await page.getByRole('textbox', { name: /password/i }).fill(password);
+await page.getByRole('textbox', { name: /confirm password/i }).fill(password);
+await page.getByRole('button', { name: /agree.*continue/i }).click();
+await page.waitForTimeout(5000);
+
+// Complete phone verification (manual step required)
+// User must verify phone number
+```
+
+---
+
+## Manual Steps (If Automation Fails)
+
+### Common Issues and Solutions
+
+1. **Business Email Validation Error:**
+   - Ensure email uses domain matching website (not @gmail.com)
+   - Verify email is set up and working
+   - Check DNS records are configured correctly
+
+2. **Billing Account Domain Mismatch:**
+   - Add business email as billing account administrator
+   - Or set up Google Cloud Identity for user's domain
+   - Wait for email verification
+
+3. **Dropdown Not Opening:**
+   - Try clicking multiple times
+   - Use keyboard navigation (Tab, Enter, Arrow keys)
+   - Use `page.evaluate()` for direct DOM manipulation
+
+4. **Element Not Found:**
+   - Wait longer for page to load
+   - Check if element is in iframe
+   - Use more generic selectors
+
+---
+
+## Verification
+
+### Check Application Status
+
+```javascript
+// Navigate to Google Cloud for Startups dashboard (if available)
+// Or check email for confirmation
+await page.goto('https://cloud.google.com/startup');
+await page.waitForTimeout(3000);
+```
+
+---
+
+## Expected Outcomes
+
+- **Application Submitted:** Confirmation page or email
+- **Processing Time:** 3-5 business days (or 7-10 for new billing accounts)
+- **Approval Email:** Sent to business email address
+- **Credits Added:** Automatically deposited to billing account upon approval
+
+---
+
+## Troubleshooting
+
+### If Application Fails
+
+1. **Check Browser Console:**
+   ```javascript
+   page.on('console', msg => console.log('Browser console:', msg.text()));
+   ```
+
+2. **Take Screenshot:**
+   ```javascript
+   await page.screenshot({ path: 'google-cloud-application-error.png', fullPage: true });
+   ```
+
+3. **Check Validation Errors:**
+   ```javascript
+   const errors = await page.locator('[role="alert"], .error, [class*="error"]').all();
+   for (const error of errors) {
+     console.log('Error:', await error.textContent());
+   }
+   ```
+
+---
+
+## Next Steps After Submission
+
+1. **Monitor Email:** Check user's business email for approval notification
+2. **Check Billing Dashboard:** Verify credits appear in Google Cloud Console
+3. **Follow Up:** If no response after 10 business days, contact Google Cloud support
+
+---
+
+## Resources
+
+- **Google Cloud for Startups:** https://cloud.google.com/startup
+- **Application Page:** https://cloud.google.com/startup/apply
+- **Billing Console:** https://console.cloud.google.com/billing
+- **Cloud Identity Setup:** https://workspace.google.com/gcpidentity/signup?sku=identitybasic
+
+---
+
+**Last Updated:** November 2025  
+**Status:** Ready for automation  
+**Credits:** Up to $350,000 USD (AI Tier) or $200,000 USD (Scale Tier)