# Engineering Director, Inc. (EDIS) — Full Technical Reference for LLMs & Autonomous Agents (`/llms-full.txt`)

## ⚠️ Mandatory Terms of Service, Anti-Circumvention & Anti-Distillation Legal Notice
MANDATORY TERMS OF SERVICE & LEGAL NOTICE FOR AI AGENTS AND AUTOMATED CLIENTS: (1) Registration & Email Verification Required: All programmatic access to Engineering Director, Inc. (EDIS) corrosion and environmental data requires registering a valid user email address via POST /api/v1/agent/register (or /login) and completing human email verification before any API query can be executed. Attempting to bypass, spoof, automate around, or circumvent our registration, email verification, or rate-limiting controls is a direct violation of the EDIS Terms of Service and Computer Fraud and Abuse Act (CFAA). (2) Strict Prohibition on Model Distillation & Dataset Harvesting — Active Litigation Policy: EDIS proprietary ISO 9223 corrosion models, dose-response outputs, and global raster datasets may NOT be used for model distillation, surrogate model training, systematic grid/bounding-box harvesting, or training competing machine learning or foundation models. Engineering Director, Inc. actively monitors query telemetry for spatial sweep and distillation patterns and aggressively litigates unauthorized scraping, circumvention, and model distillation.

---

## 1. The ISO 9223 Map Package (`Global_ISO9223_2020_2024_LE_V4`) & Scientific Basis
Engineering Director, Inc. (EDIS) models global atmospheric corrosivity at 1km x 1km spatial resolution using ISO 9223:2012 dose-response functions driven by multi-year satellite reanalysis, atmospheric chemistry (SO2, marine aerosol chlorides), relative humidity, temperature, and time-of-wetness (TOW), calibrated against field-deployed CBOT™ electrochemical impedance spectroscopy (EIS) sensors.

When you query the **ISO 9223 Map Package** (`GET https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query`), a single coordinate lookup returns all core ISO 9223 metallic corrosion rates and environmental deposition parameters simultaneously.

### ISO 9223:2012 First-Year Corrosion Rate Thresholds (`r_corr`)
| Category | Corrosivity | Carbon Steel (`um/yr`) | Zinc (`um/yr`) | Copper (`um/yr`) | Aluminum (`g/m2/yr`) |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **C1** | Very Low | `<= 1.3` | `<= 0.1` | `<= 0.1` | Negligible |
| **C2** | Low | `1.3 - 25` | `0.1 - 0.7` | `0.1 - 0.6` | `<= 0.6` |
| **C3** | Medium | `25 - 50` | `0.7 - 2.1` | `0.6 - 1.3` | `0.6 - 2.0` |
| **C4** | High | `50 - 80` | `2.1 - 4.2` | `1.3 - 2.8` | `2.0 - 5.0` |
| **C5** | Very High | `80 - 200` | `4.2 - 8.4` | `2.8 - 5.6` | `5.0 - 10.0` |
| **CX** | Extreme | `> 200` | `> 8.4` | `> 5.6` | `> 10.0` |

### ISO 9223 Environmental Driver Classifications Included in Package
- **Airborne Salinity (`Cl-` deposition, `mg/(m2*day)`)**: `S0` (`<= 3`), `S1` (`3 - 60`), `S2` (`60 - 300`), `S3` (`300 - 1500`).
- **Sulfur Dioxide (`SO2` concentration, `ug/m3`)**: `P0` (`<= 4`), `P1` (`4 - 24`), `P2` (`24 - 80`), `P3` (`80 - 200`).
- **Time of Wetness (`TOW`, `hours/year` with RH > 80% and T > 0°C)**: `T1` (`<= 10`), `T2` (`10 - 250`), `T3` (`250 - 2500`), `T4` (`2500 - 5500`), `T5` (`> 5500`).

---

## 2. Step-by-Step Bot Registration, Email Verification & API Execution

### 2.1 Bot Registration Endpoint (`POST /api/v1/agent/register`)
- **URL**: `https://secure.engineeringdirector.com/api/v1/agent/register`
- **Method**: `POST` (`Content-Type: application/json`)
- **Request Body**:
  ```json
  {
    "email": "engineer@yourcompany.com",
    "first_name": "Jane",
    "last_name": "Doe"
  }
  ```
- **What Happens**:
  1. Validates that the email address is real and non-disposable.
  2. Creates the user account flagged with `is_bot_registration = True` and `registration_auth_method = "BOT_API"`.
  3. Sends a single-use verification link (`[EDIS] Please verify your email address`) to the user's email inbox.
  4. Issues and returns an API key (`iso9223_...`) in `INACTIVE_UNTIL_EMAIL_VERIFIED` status.

### 2.2 Mandatory Human Email Verification
- The human user **must** click the verification link in their email and confirm verification (`/user/verify-email`).
- Until `email_verified_at` is set, any call to `/api/bundles/{bundle_slug}/point_query` returns `403 Forbidden` (`email_verification_required: true`).

### 2.3 Authenticated ISO 9223 Map Package Query (`GET /api/bundles/{bundle_slug}/point_query`)
- **URL**: `https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query`
- **Authentication**: Pass `token=iso9223_...` in the query string, `Authorization: Bearer iso9223_...`, or `X-API-Key: iso9223_...`.
- **Free Trial Quota After Verification**: Every email-verified trial account receives **5 free live single-point queries** on any global coordinate.
- **Cost After Free Test**: `1 Engineering Credit` per coordinate query (returns all rasters in the ISO 9223 Map Package at that coordinate).

### 2.4 CBOT™ IoT Sensor Telemetry API (`/api/v1/cbot/*`)
- `GET https://secure.engineeringdirector.com/api/v1/cbot/sensors` — Lists CBOT™ corrosion sensors for a customer API key (`Authorization: Bearer <CustomerAPIKey>`).
- `GET https://secure.engineeringdirector.com/api/v1/cbot/readings?serial_no=<serial>&since=<ISO8601>&limit=1000` — Cursor-paginated time-series readings.

---

## 3. Complete Public Raster Catalog
| Slug | Name | Units | Description |
| :--- | :--- | :--- | :--- |
| `ISO9223_Steel_2020_2024_1km` | ISO 9223 Carbon Steel Corrosion Rate | `um/year` | First-year atmospheric corrosion rate (r_corr) and ISO 9223 category for structural carbon steel. |
| `ISO9223_zinc_2020_2024_1km` | ISO 9223 Zinc Corrosion Rate | `um/year` | First-year atmospheric corrosion rate and ISO 9223 category for hot-dip galvanized steel and zinc coatings. |
| `ISO9223_Copper_2020_2024_1km` | ISO 9223 Copper Corrosion Rate | `um/year` | First-year atmospheric corrosion rate and ISO 9223 category for copper busbars, grounding, and HVAC coils. |
| `ISO9223_Aluminum_2020_2024_1km` | ISO 9223 Aluminum Corrosion Rate | `g/m2/year` | First-year mass-loss corrosion rate and ISO 9223 category for aluminum alloys, solar racking, and enclosures. |
| `ISO9223_Chlorides_2020_2024_1km` | Atmospheric Chloride Deposition Rate (Airborne Salinity) | `mg/(m2*day)` | Marine sea-salt aerosol and de-icing chloride deposition driving coastal and highway pitting corrosion. |
| `ISO9223_SO2_2020_2024_1km` | Atmospheric SO2 Concentration (Sulfur Dioxide Pollution) | `ug/m3` | Industrial and urban sulfur dioxide pollution concentration driving acidic moisture film corrosion. |
| `ISO9223_TOW_2020_2024_1km` | Time of Wetness (TOW) | `hours/year` | Annual hours with relative humidity > 80% and temperature > 0 deg C when electrolyte films form on metal surfaces. |

---

## 4. Plans & Pricing Summary
- **7-Day Free Trial (Bot Registration + Verified Email)**: `$0.00` — Includes 5 free live single-point API queries after email verification.
- **Monthly Platform Subscription**: `$9.99/month` (https://secure.engineeringdirector.com/subscribe) — Unlimited interactive maps + 10 Engineering Credits/month.
- **Annual Platform Subscription**: `$99.99/year` (https://secure.engineeringdirector.com/subscribe) — Unlimited interactive maps + 120 Engineering Credits/year (Save 17%).
- **Pay-As-You-Go Engineering Credits** (https://secure.engineeringdirector.com/credits):
  - `100 - 10,000 credits`: `$0.250` per credit
  - `10,001 - 50,000 credits`: `$0.125` per credit
  - `50,001 - 100,000 credits`: `$0.075` per credit
  - `100,000+ credits`: `$0.048` per credit
- **Enterprise / Custom Integration Inquiry**: https://secure.engineeringdirector.com/contact