Skip to content
Markdownllms.txt

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 OverviewFigure 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 DirectoryFigure 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 ModalFigure 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.

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.

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 ScreenFigure 4: Billing & tariffs screen with Tariffs and Monthly Ft rates tabs.

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 LogFigure 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 ​

WattDee AMR & Private PPA Billing User Manual