Rpa_Skills/rpa-dashboard-no-ai/SKILL.md

name, description

name

description

rpa-dashboard-no-ai

Builds a working dashboard page for an RPA bot that does not use AI. It always includes a sidebar and top bar with a dark toggle and status dot, KPI cards, a batch status donut, a run panel with steps and a live log, and a report table with search and Excel export. The page is wired to the bot through one data contract, or runs on sample data when there is no bot yet. Supports a desktop path (PyQt6 with an embedded page) and a web path. Use when the user asks for an "RPA dashboard", "automation dashboard", "bot dashboard", a dashboard "without AI", or a status/run/report page for a bot. For bots that use an LLM or OCR extraction, use rpa-dashboard-ai instead.

RPA dashboard (no AI)

Everything this skill needs is bundled in templates/. Never read the original source projects.

File	What it is
templates/dashboard.html	The single-file page: theme tokens, shell, KPI, donut, run panel, report, sample data. Works in PyQt (QWebChannel) or on the web (polling).
templates/bridge.py	Minimal PyQt6 host. It runs the bot as a child process and tails its output.
templates/contract.md	The data contract: events the bot sends, actions the page sends.
templates/themes.md	Theme presets (Tebra Sky, Superbill Ember) and the custom-colour steps.
templates/palette.py	Derives a custom palette from one brand hex and checks contrast.
templates/frontend.md	Existing frontend: detect it, report it, then keep or restyle. Shared with rpa-dashboard-ai.
templates/detect_frontend.py	Finds an existing frontend and prints its location, stack and token blocks.
templates/reference/	Raw Tebra extracts. Use them only to port optional sections.

Follow the steps in order. Ask one question at a time, and wait for the answer. If the user's request already answers a question, don't ask it again.

1. Scan the project

Before asking anything, look at the project:

• Frontend: run python templates/detect_frontend.py <project root>. It finds plain HTML, React/Vue/Angular/Svelte apps and PyQt web views, and prints each one's location, stack and colour tokens. templates/frontend.md says what it covers and what to do with its report.
• Bot: the entry point (for example main.py, a __main__ module or a run script), what it prints (step markers, status and error lines), and how it starts.

2. Report the frontend, then ask keep or restyle

Follow templates/frontend.md sections 2 to 5. In short:

• No frontend: say "No existing frontend found." and go to step 3. Don't describe a frontend that isn't there.
• Frontend found: say "Frontend found at <path>, stack <stack>, colours <main tokens>." Then ask: keep its look, or restyle it?
  • Keep: skip step 3. Build the page with the project's own tokens and fonts, and change no existing file.
  • Restyle: go to step 3. In the existing files, change only the token blocks, never layout or logic, and show the user the diff.

3. Ask for colours

Skip this if the user chose to keep the existing look. Offer:

1. Tebra Sky: blue glass cards on a sky gradient.
2. Superbill Ember: flat surfaces with a red-orange brand gradient.
3. Custom: the user gives one brand hex colour.

4. Ask desktop or web

Ask only if there is no frontend. If there is one, use its stack.

• Desktop: a PyQt6 window with the page embedded. The page talks to Python through a bridge, so no web server is needed.
• Web: the same page, served by a backend that it polls.

5. Ask which optional sections to build

Always built: the shell (sidebar, top bar, dark toggle, status dot), KPI cards, the status donut, the run panel and the report table.

Ask which extras to add (choose any, or none): checkpoint tracker, admin/roles screen, login page. Build only the ones chosen. Unchosen sections must leave no markup, script or style behind, so delete their <!-- OPTIONAL: ... --> markers.

6. Build

1. Copy templates/dashboard.html into the project:

   • Desktop: put it next to the host, for example dashboard/dashboard.html.
   • Web: put it in the backend's static folder. With no backend yet, use dashboard/dashboard.html.
   • Existing frontend: put it where templates/frontend.md section 3 says.

2. Fill every {{...}} placeholder:

   Placeholder	Value
   APP_NAME, APP_SUBTITLE	The project's name and a short tagline.
   LOGO_SRC	The logo's path, or empty if there is none.
   STEPS_JSON	The run steps as a JSON list, from the bot's real stages, for example ["Initializing","Login","Process items","Completed"].
   REPORT_COLUMNS_JSON	[{"key":..., "label":...}]. It must include a column with key status, which shows the bucket pill.
   API_BASE	Web only, for example /api. Leave it empty for desktop.

3. Apply the theme by replacing the body{...} and body.dark{...} token blocks with the preset from templates/themes.md. For Ember, also add its font link. For a custom colour, run python templates/palette.py "<hex>", paste the tokens it prints, and show the user its contrast table. If the user chose keep, fill the blocks from the project's tokens instead (templates/frontend.md section 4).

4. Desktop: also copy templates/bridge.py next to the page, and fill {{BOT_MODULE}}, the STEPS list (the same steps as the page), {{ORG}} and {{APP_NAME}}.

5. Search the output for {{. None may be left.

7. Wire the data

The contract is in templates/contract.md: one envelope, {event, data}, in both directions.

• No bot yet: keep SAMPLE_DATA = true and the SAMPLE DATA block. The page answers its own data actions, so it opens with sample batches and report rows, and Run plays a demo run. Tell the user which events their bot must send later.
• Bot exists: set SAMPLE_DATA = false and delete the SAMPLE DATA block. Then:
  • Desktop: in bridge.py, set BOT_CMD to start the bot as a child process. Fill STEP_MARKERS and FRIENDLY_RULES from lines the bot really prints. Use specific substrings (for example [step 3], not a bare word); the first match wins. Unmatched error lines must always reach the log.
  • Web: the backend serves GET {API_BASE}/dashboard, GET {API_BASE}/run/status (returning {running, events[]}) and POST {API_BASE}/<action-with-dashes>.
  • Apply the contract's derived rules: batch state from Pending plus date, and report buckets from status.

8. Verify

Open the page. On desktop run the host; otherwise open the file or the served URL. With sample data, opening the file in a browser is enough. Check:

• the light theme, the dark theme (use the toggle), and a window 820px wide or less;
• KPI cards, donut and legend, the Run tab's steps and log, and the Report tab's rows and pills all show data;
• no {{ placeholders are left and the console shows no script errors.

If Python Playwright is installed, take headless screenshots of each check and look at them. Otherwise, ask the user to open the page. Finish by telling the user where the files are, which theme and sections were built, and whether the page is on sample data or wired to the bot.