Initial commit: add .gitignore and README

OMADA_CUSTOMER_ID_SETUP.md

@@ -0,0 +1,63 @@
+# Finding Your Omada Customer ID (omadac_id)
+
+## The Problem
+
+If you're seeing this error:
+```
+Omada login failed: Controller ID not exist.
+```
+
+It means you're using the **wrong value** for `omadac_id` in the login request.
+
+## The Solution
+
+You need to find the **correct Customer/Controller ID** from your Omada OpenAPI settings.
+
+## Step-by-Step Instructions
+
+1. **Log into your Omada Cloud Controller** (using the same region as your URL, e.g., `euw1`)
+
+2. **Navigate to OpenAPI Settings**:
+   - Go to **Settings** → **Platform Integration** → **Open API**
+   - Or: **Global View** → **Settings** → **Platform Integration** → **Open API**
+
+3. **Find Your Application**:
+   - Look for your application in the list (the one with your `TP_LINK_CLIENT_ID`)
+   - Click **View** or **Details** on that application
+
+4. **Find the Customer/Controller ID**:
+   - On the details screen, you should see:
+     - **Client ID** (this is your `TP_LINK_CLIENT_ID`)
+     - **Client Secret** (this is your `TP_LINK_CLIENT_SECRET`)
+     - **Customer ID** or **MSP ID** or **Controller ID** or **Omada ID / OmadacId**
+       - ⚠️ **This is the value you need!**
+
+5. **Update Your `.env` File**:
+   ```env
+   # Use the Customer/Controller ID from step 4
+   OMADA_CUSTOMER_ID=the-exact-value-from-openapi-settings
+   
+   # Or for backward compatibility:
+   OMADA_ID=the-exact-value-from-openapi-settings
+   ```
+
+6. **Restart Your Application**:
+   ```bash
+   pnpm run dev
+   ```
+
+## Important Notes
+
+- The `OMADA_CUSTOMER_ID` is **different** from your `TP_LINK_CLIENT_ID`
+- The `OMADA_CUSTOMER_ID` is the ID of your **controller/customer**, not your application
+- This value is used as the `omadac_id` query parameter in the login request
+- If you're using an MSP (Managed Service Provider) account, you might see "MSP ID" instead
+
+## Verification
+
+After updating, you should see:
+- ✅ Login succeeds, OR
+- ✅ A different error like "invalid username/password" (which means the ID is correct!)
+
+If you still see "Controller ID not exist", double-check that you copied the **exact value** from the OpenAPI settings page.
+