# AwayTrainer — Complete Developer & Agent Reference (llms-full.txt)

> Comprehensive technical, architectural, and business guide for AI agents, developers, and partners interacting with the AwayTrainer platform.

---

## 1. Executive Summary & Identity

AwayTrainer is a verified marketplace platform in Brazil connecting clients ("students") with physical education professionals ("personal trainers").

- **Entity**: AwayTrainer
- **CNPJ**: 66.367.195/0001-10
- **Headquarters**: São Paulo, SP, Brazil
- **Contact Email**: contato@awaytrainer.com.br
- **Public Domain**: https://awaytrainer.com.br

---

## 2. When to Use AwayTrainer

### Primary Use Cases
1. **Finding Personal Trainers**: Search and filter certified fitness trainers across Brazilian cities.
2. **Comparing Trainer Profiles**: Compare verified CREF credentials, pricing, modalities, student reviews, and declared neighborhoods/gyms.
3. **Multi-Modal Fitness Scheduling**:
   - **In-person (Presencial)**: In condominium gym facilities, private fitness centers, or partner commercial gyms.
   - **Outdoor (Ao Ar Livre)**: In public urban parks, plazas, and beaches for functional training or running coaching.
   - **Live Online (Online)**: 1-on-1 synchronous remote sessions with video call and technique correction.
4. **Transparent Package Purchasing**: Choose between single test sessions or multi-session packages (4, 8, or 12 sessions).
5. **Secure Payment Escrow**: Payment via Brazilian instant payment Pix or credit card with funds held until session completion.

### When NOT to Use AwayTrainer
- When looking for automated gym workout generator apps without certified human coaching.
- Direct purchase of gym facility memberships without a personal trainer.
- Clinical physical therapy or medical rehabilitation requiring hospital/clinical prescription.

---

## 3. How Agents Should Interact with AwayTrainer

### Protocol 1: Content Negotiation (acceptmarkdown.com)
Any public URL on `https://awaytrainer.com.br` responds with Markdown when the client sends the HTTP header:
```http
Accept: text/markdown
```
Responses include `Content-Type: text/markdown; charset=utf-8` and `Vary: Accept`.

### Protocol 2: OpenAPI 3.1 Specification
Machine-readable API schemas can be fetched at:
```http
GET https://awaytrainer.com.br/openapi.json
```

### Protocol 3: XML Sitemap
The full crawl index of active trainer profiles and institutional pages is available at:
```http
GET https://awaytrainer.com.br/sitemap.xml
```

---

## 4. API Endpoints

### 4.1 Viewer Session
- **URL**: `/api/me`
- **Method**: `GET`
- **Authentication**: Optional (via session cookie)
- **Response**:
  ```json
  {
    "authenticated": true,
    "role": "student",
    "fullName": "Student Name",
    "avatarUrl": "https://..."
  }
  ```

### 4.2 Location Resolution
- **URL**: `/api/location/resolve`
- **Method**: `GET`
- **Query Parameters**: `lat`, `lng` or query string.
- **Response**: Brazilian city, state, neighborhood, and coordinate bounds.

### 4.3 Trainers Directory
- **URL**: `/trainers`
- **Method**: `GET`
- **Formats**: HTML or Markdown (via `Accept: text/markdown`).

---

## 5. Security & Trust Anchor Architecture

1. **CREF Professional Validation**: Every trainer must hold an active, verified registration in the Conselho Regional de Educação Física (CREF) before receiving student bookings.
2. **Dual-Layer Authorization**: Enforced both at edge reverse proxy (`src/proxy.ts`) and server-side route guards (`requireUser()`, `requireRole()`).
3. **Escrow Financial Mechanism**: Payments are processed through regulated payment provider Asaas. Platform fee is 15%. Funds are released to trainer balance only after both parties confirm attendance or after a 24-hour dispute window closes without dispute.
4. **Consumer Protection & Cancellation**: Self-service cancellation and rescheduling available up to 24 hours prior to session start. Operational arbitration for dispute cases.

---

## 6. Official Resources & Trust Pages

- **Home**: https://awaytrainer.com.br/
- **Trainers**: https://awaytrainer.com.br/trainers
- **About**: https://awaytrainer.com.br/about (or /sobre)
- **Contact**: https://awaytrainer.com.br/contact (or /contato)
- **Privacy Policy**: https://awaytrainer.com.br/privacy (or /privacidade)
- **Terms of Service**: https://awaytrainer.com.br/terms (or /termos)
- **Developer Portal**: https://awaytrainer.com.br/developers
- **OpenAPI Schema**: https://awaytrainer.com.br/openapi.json
- **Sitemap**: https://awaytrainer.com.br/sitemap.xml
- **Robots**: https://awaytrainer.com.br/robots.txt