---
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**.

*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**.

*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.

*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**.

*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).

*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)