--- title: Platform Admin Guide --- ::: warning UAT release This guide describes the upcoming portal update. Some screens or actions may differ in the current UAT portal. ::: # Platform Admin Guide **Who is this for:** Platform Administrator (Platform ADMIN) Central Operations Team (Platform SERVICE, read/health tabs only) **Prerequisites:** - Signed in with a **Platform administrator** account under the platform organization (`Advanced Grid Co., Ltd.`). - Solar developer details (Thai/English names, 13-digit Tax ID) and official ERC/PEA monthly Ft rates and public holiday schedules. --- ## 1. Portfolio Dashboard Overview After signing in, the **Dashboard** (`Solar portfolio`) provides a real-time view across every solar developer and site: 1. **Scope with the top switcher:** Choose **All developers** to monitor the entire platform, or select a specific solar developer to inspect their fleet. 2. **Review the Health Strip:** Check live counts for `online`, `offline`, `not reporting`, `meters with alarms`, and HES data projection lag. Click any pill to jump straight to the filtered meter list. 3. **Check the 4 KPI cards:** - **Today Energy (kWh)** with Peak / Off-Peak / Holiday bar and comparison vs. the same time yesterday. - **Today Value (THB)** *(intentionally displays `-` when the selected portfolio spans sites on different tariff rates rather than guessing an average)*. - **Month Cumulative Energy (kWh)** and revenue. - **Total Installed Capacity (kWp)** and active site count. 4. **Act on the right-hand Action Queue:** - If the current billing month has no verified **Ft rate**, an item **Verify Ft rate for YYYY-MM** appears. Click it to confirm and publish the Ft rate right from the Dashboard. - Also lists urgent meter alarms, draft/checked invoices waiting on action, and late telemetry intervals. 5. **Analyze Generation Curves & Site List:** Switch between **Day** (15-minute kW curve against the dashed clear-sky expected ceiling), **Month** (daily bars), and **Year** (monthly bars). Click bars to drill down, expand the **TOU Day/Month Summary**, or toggle the site portfolio between **Table** and **Cards**. ![Platform Admin Portfolio Dashboard Overview](/screenshots/en/02-dashboard-overview.png) *Figure 1: Portfolio Dashboard showing Health Strip, TOU KPIs, generation curve, and Action Queue.* --- ## 2. Company Directory & Creating Solar Developers Only **Platform administrators** can create developer companies, delete companies, change organization types, and adjust active meter limits. ### Browsing the Company Directory 1. Click **Settings** > **Companies** in the left navigation sidebar. 2. Use **Search companies** to filter by company name or ID. 3. Organizations are grouped under **Platform administration**, **Developer companies**, and **Unassigned customers**. ![Settings Companies Directory](/screenshots/en/20-settings-companies-directory.png) *Figure 2: Companies directory grouped by tier, with the Add developer company action.* ### Creating a New Solar Developer Company 1. On **Settings > Companies**, click **Add developer company**. 2. Enter **Company name (Thai)** and **Company name (English)** *(required)*. 3. Ensure **Organization type** is set to **Solar developer**. 4. Enter tax and billing details: **Tax ID (13 digits)**, **Phone (shown on invoices)**, **Billing email**, and **Head office address (shown on tax invoices)**. 5. Optionally enter **Authorized signatory name**, **Signatory title**, and upload the **Authorized signature (transparent PNG/JPG/WebP)** and **Company logo**. 6. Click **Add company** to save. ![Create Developer Company Modal](/screenshots/en/21-settings-create-developer-modal.png) *Figure 3: Add company dialog for creating a new solar developer and configuring branding.* ### Setting Meter Limits & Creating the First Company Admin 1. Open the newly created developer company, go to **Company information**, and click **Edit company profile**. 2. Adjust **Active meter limit** (default is `100,000` active meters per company; inactive meters are excluded) and click **Save changes**. 3. Open the **People & access** tab and click **Add user** to create the developer's first **Company administrator** so they can onboard customers, sites, and staff. ::: tip Deleting a Company Clicking **Delete company** removes the company from active management while leaving previously issued invoices unchanged. ::: --- ## 3. Tariffs & Monthly Ft Rates (`Billing & tariffs`) Only **Platform administrators** can publish or update monthly Ft rates (`ftrate.write`). 1. Under **Settings** in the sidebar, click **Billing & tariffs**. ### Tab 1: Tariffs (`Tariff structures`) 1. Review the **Current billing rules** summary strip (billing cut-off day, decimal precision for energy/rate/amount, and power factor penalty rules). 2. Click **Add tariff** or **Edit** on an existing tariff schedule. 3. Set **Tariff category**, **Start date** / **End date**, **Peak / Off-peak / Holiday grid tariffs**, **Service charge**, and **Bill calculation type** (**With Ft** or **Without Ft**). 4. Expand **Advanced billing rules** to configure contracts tied to this tariff: - **Billing cut-off day (1–28)** *(e.g., `25` bills from the 25th to the 24th of the next month)* - **Payment due (days after cut-off)** (`0–120` days) - **Decimal places** for energy (`0–4`), rate (`2–6`), and amount (`0–4`) - **Power factor penalty (PEA)**: toggle on/off, **Minimum PF threshold** (PEA standard `0.85`), and **Penalty rate** (PEA standard `56.07` THB/kVAR). 5. Click **Save changes**, or click **CSV** to export the tariff table. ::: warning Billing Cut-Off Day Locks After First Invoice Once a site has any non-rejected invoice, its **Billing cut-off day** is locked (`409` on change) so billing periods never overlap or leave unbilled gaps. Other terms still update, and the portal lists which sites kept their existing cut-off day. ::: ### Tab 2: Monthly Ft Rates 1. Switch to the **Monthly Ft rates** tab. 2. Click **Publish Ft rate** (or **Edit** on an existing month). 3. Enter **Billing month** in `YYYY-MM` format (for example, `2026-10`). 4. Enter **Ft rate (THB/kWh)** (between `-2.0000` and `10.0000`, e.g. `0.3972`). 5. Click **Save Ft rate**. ![Tariffs and Monthly Ft Rates Screen](/screenshots/en/29-settings-tariff-ft-rates.png) *Figure 4: Billing & tariffs screen with Tariffs and Monthly Ft rates tabs.* ::: warning Missing Ft Rate Blocks Invoice Calculation Invoice calculation strictly rejects (`422`) any billing month that does not have a published Ft rate. Always publish or verify the month's Ft rate before billing run day. ::: --- ## 4. Bank Accounts, Holidays, Database Health & Audit Log ### Payment Bank Accounts (`Settings > Bank accounts`) 1. Open **Bank accounts** under Settings. 2. Click **Add bank account** (or **Edit** an existing row). 3. Fill in **Bank name**, **Branch**, **Seller (company receiving payments)** (choose **Platform (shared by all sellers)** or a specific **Solar developer** so invoices print that seller's own bank account), **Account name**, **Account number**, and **PromptPay / QR number**. 4. Click **Add account / Save changes**. ### Public Holiday Calendar (`Settings > Holidays`) Energy recorded on weekends and dates in this calendar is automatically classified as **Rate C (Holiday)**. 1. Open **Holidays** under Settings. 2. **Bulk annual load:** Select a year (`2025`, `2026`, or `2027`) under **Load annual public holidays (PEA / MEA calendar)** and click **Load annual holidays**. 3. **Add a single holiday:** Pick **Holiday date (YYYY-MM-DD)**, enter an optional **Holiday name**, and click **Add holiday**. ### Database & System Health (`Settings > Database & system`) *(Accessible to `Platform administrator`, `Central operations team`, and roles with `meter.network.read`.)* 1. Open **Database & system** to inspect: - **Database size** and PostgreSQL version. - **Monthly partitions** status (`Ready` vs `Partition needs extension`) and per-partition row counts and storage sizes. - **Meter data sync (HES)**: projection lag in seconds and meters waiting over 1 hour. - **System record counts**: Projects, Meters, Invoices, and Audit events. 2. Click **Refresh status** to pull the latest health metrics. ### System Audit Log (`Settings > Audit log`) *(Restricted to **Platform administrators** holding `org.admin`.)* 1. Open **Audit log** under Settings. 2. Filter across the whole platform by: - **Search audit events** (activity, record ID, or summary) - **Filter by actor email** - **Category:** `All categories`, `Meter data`, `Invoices`, `PPA contracts`, `Meters` - **From** and **To** dates 3. Click **Export current page** to download a CSV of the visible page (use filters and pagination to export older pages). ![Bank Accounts, Holidays, Database Health, and Audit Log](/screenshots/en/30-settings-bank-holiday-system-audit.png) *Figure 5: Platform reference and governance tools (Bank accounts, Holidays, Database health, and Audit log).* --- ## 5. Platform-Exclusive Meter & VPN Responsibilities Even when solar developers manage their own sites and meters, two cross-tenant safeguards remain exclusive to **Platform administrators**: 1. **VPN Profiles & Meter Assignment (`vpn.manage`):** Creating, editing, enabling/disabling WireGuard, IPsec, and OpenVPN profiles and assigning site meters under the site's **Connectivity** tab. 2. **Serial Overrides & HES Swap Confirmation (`meter.identity.override`):** Resolving pending/duplicate/mismatch meter identities by verifying the physical nameplate on site and entering a mandatory audit reason (at least 5 characters) to **Correct serial** or **Confirm swap**. --- ## Next Steps - [Developer Admin Guide: Customers, Sites, Meters & VPN](./04-developer-admin-guide) - [Meter & Telemetry Guide: Monitoring, Diagnostics & VEE](./05-meter-and-telemetry-guide) - [Billing and 3-Tier Approval Guide](./06-billing-and-approval-guide)