# MyWorldLines

> Professional astrocartography SaaS platform for astrologers. Client management, automated worldline calculations, and white-label PDF reports with Swiss Ephemeris precision.

## What is MyWorldLines?

MyWorldLines is a B2B SaaS platform that helps professional astrologers automate time-intensive worldline calculations and deliver branded reports to clients. Unlike consumer astrology apps, MyWorldLines focuses on **practice management** — providing tools for client CRM, automated report generation, and white-label exports.

## Target Audience

Professional astrologers and consulting practices seeking to:
- Automate Swiss Ephemeris worldline calculations
- Manage client birth data and session history
- Generate AI-powered interpretations in seconds
- Deliver white-label PDF reports with custom branding

## Core Capabilities

- **Client Management CRM**: Central database for all clients with birth data, session notes, and tags
- **Swiss Ephemeris Precision**: Same calculation engine trusted by professional astrologers worldwide
- **Interactive Planetary Lines Map**: Visualize worldlines globally on a real-time map
- **AI-Powered Interpretations**: Instant analysis using three AI personas (Luna, Stella, Orion)
- **White-Label PDF Reports**: Upload your logo, customize footers, remove all MyWorldLines branding
- **Batch Import**: CSV import for migrating existing client databases

## Subscription Tiers

| Tier | Price | Clients | Reports/Month | Key Features |
|------|-------|---------|---------------|--------------|
| Essentials | $29/mo | 25 | 5 | Basic branding, email support |
| Professional | $79/mo | Unlimited | 15 | White-label PDFs, priority support, custom logo |
| Studio | $149/mo | Unlimited | 50 | Report Studio, team seats (3), API access, email automation |

All plans include a **7-day free trial** with no credit card required.

## Technical Details

### Celestial Bodies Supported
- 10 planets: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto
- Points: Chiron, North Node, South Node
- 7 asteroids: Ceres, Pallas, Vesta, Juno, Toro, Eros, Pandora

### Angular Line Types
- AC (Ascendant): Self-expression, identity, how others perceive you
- MC (Midheaven): Career, public image, life direction
- DC (Descendant): Relationships, partnerships, collaborations
- IC (Imum Coeli): Home, roots, inner self, emotional foundation

### Influence Zones
- 1100km influence zone to the east of each line (stronger)
- 550km influence zone to the west of each line (weaker)
- Exponential decay formula for distance-based scoring

## API Documentation

### Swiss Ephemeris API

**Base URL**: `https://api.myworldlines.com`

**Authentication**: Bearer token required (obtained via Supabase auth)

**Endpoint**: `POST /calculate`

**Request Format**:
```json
{
  "year": 1990,
  "month": 6,
  "day": 15,
  "hour": 14.5,
  "latitude": 48.8566,
  "longitude": 2.3522
}
```

**Response Format**:
```json
{
  "lines": {
    "Sun": {
      "AC": {"type": "LineString", "coordinates": [[lng, lat], ...]},
      "MC": {"type": "LineString", "coordinates": [[lng, lat], ...]},
      "DC": {"type": "LineString", "coordinates": [[lng, lat], ...]},
      "IC": {"type": "LineString", "coordinates": [[lng, lat], ...]}
    }
  },
  "planets": {
    "Sun": {"longitude": 84.23, "latitude": 0.0, "distance": 1.016}
  }
}
```

**Rate Limits**: 100 requests/minute per authenticated user

## URLs

- Homepage: https://myworldlines.com
- Practice Dashboard: https://myworldlines.com/practice (authenticated)
- Interactive Map: https://myworldlines.com/map
- API Documentation: https://myworldlines.com/api-docs

## Bilingual Support

Full German (DE) and English (EN) localization for all reports and interface.

## Contact

- Support: via in-app messaging
- Languages: English, German
- Target audience: Professional astrologers and consulting practices