Division Integration Template

⚠️ IMPORTANT FOR AI AGENT: This is an IMPLEMENTATION request, NOT a documentation page request.
You must IMPLEMENT these features in actual working code, not create a guide or documentation page.

# SphereUs Nation (SUN) Network Integration - IMPLEMENTATION INSTRUCTIONS

## OVERVIEW
IMPLEMENT (code, not document) these features to connect this division to the SphereUs ecosystem at sphereus.com for unified authentication, SU Coin rewards, and shared services.

## REQUIREMENTS

### 1. SSO Authentication
- Redirect login to: https://sphereus.com/auth/login?redirect=https://[YOUR-DOMAIN]/callback
- Handle callback to receive authentication token
- Store user session locally
- On logout, clear local session

### 2. User Profile Integration
When user logs in, fetch their profile from SphereUs:
- User ID
- Full name
- Email
- SU Coin balance
- Solana wallet address (if provided)

### 3. Transaction Reporting (for SU Coin Rewards)
After ANY confirmed revenue transaction (purchase, service payment, etc.):
- Report to SphereUs API: 
  {
    "user_id": "[user_id]",
    "amount": [transaction_amount_usd],
    "type": "purchase" or "sale" or "service",
    "division": "[YOUR DIVISION NAME]",
    "description": "[transaction description]"
  }
- This automatically awards 10% in SU Coins ($10 = 1 SU)
- 5% goes to SphereUs Foundation automatically

### 4. Display SU Coin Balance
Show user's current SU balance in your app's header/dashboard:
- Fetch from SphereUs API: GET /api/coins/:userId
- Update on page load and after transactions
- Link to full wallet at: https://sphereus.com/my-coin

### 5. Marketplace Integration (Optional but Recommended)
Allow users to create listings that appear in SphereUs Marketplace:
- POST to SphereUs API: /api/listings
- Include division name, price, description, images
- Listings appear on sphereus.com/marketplace

### 6. Cross-Division Links
Add links in your app to:
- SphereUs Dashboard: https://sphereus.com/dashboard
- SphereUs Marketplace: https://sphereus.com/marketplace
- Other divisions (optional): https://sphereus.com/divisions

## IMPLEMENTATION CHECKLIST
☐ SSO login redirect to sphereus.com
☐ Callback handler for authentication token
☐ Fetch and display user profile
☐ Report transactions for SU Coin rewards
☐ Display SU Coin balance in UI
☐ Add cross-division navigation links
☐ Test full auth flow (login, use app, logout)

## TECHNICAL NOTES
- All division apps use Base44 infrastructure
- Authentication tokens should be JWT-based
- API calls require bearer token authentication
- SU Coins are awarded automatically upon transaction confirmation
- Foundation receives 5% of all revenue automatically

## EXAMPLE USER FLOW
1. User visits [your division].com
2. Clicks "Sign In" → redirects to sphereus.com/auth
3. Logs in once on SphereUs (or already logged in)
4. Returns to [your division] with authenticated session
5. Uses your division's services
6. Makes purchase/payment → transaction reported to SphereUs
7. Earns SU Coins automatically (10% of transaction)
8. Can view SU balance in your app or go to sphereus.com/my-coin

## SUPPORT
Questions? Contact technical support at sphereus.com/contact