ComfyUI Jobs
The next ComfyUI portal is intentionally limited to authenticated, read-only remote job monitoring. It does not expose prompt submission, workflow authoring, imports, or admin mutation routes.
Local development
npm ci
ADMIN_USERNAME=admin ADMIN_PASSWORD='set-locally' npm run dev
The first run seeds data/users.json from ADMIN_USERNAME and ADMIN_PASSWORD; subsequent runs use the persisted hashed record. Do not commit data/ or credentials.
Deployment
Gitea Actions deploys develop, qa, and main to the existing ComfyUiPortal target directories and preserves the existing 7002/6002/5002 port contract. On first startup of a fresh data directory, provide ADMIN_USERNAME and ADMIN_PASSWORD in the deployment host environment. Existing target data is retained during repository cutover.
After validation succeeds, the workflow builds one immutable image tagged with the source commit SHA on the Docker host and publishes it to the Gitea container registry. The deploy stage only pulls that exact image and restarts the service; it does not build. If the SHA-tagged image already exists, the workflow reuses it instead of rebuilding. Configure the masked REGISTRY_USERNAME and REGISTRY_PASSWORD repository Actions secrets with a Gitea account/token that can write container packages. Compose receives the exact image reference through IMAGE_REF, so the same artifact can be redeployed or promoted without rebuilding.
Persistent job and model history
Each successful /api/jobs read synchronises the returned ComfyUI history and currently running job into data/job-history.json. The prompt ID is the stable key, so repeated polling and server restarts do not count the same job twice. The deployment Compose files mount data/ from the environment-specific host directory and the deployment cleanup explicitly preserves it.
The store retains job status, title, timestamps, output count, and the distinct model names extracted from each prompt. Model usage is counted once per model per prompt ID. GET /api/model-stats returns the tracked job count and model ranking used by the Most used models panel. This endpoint is authenticated and read-only. Removing the environment's data/job-history.json intentionally resets the history.
Automated testing
The project maintains both server tests and Playwright browser tests. The browser suite runs after deployment on develop and qa only; production is never browser-tested automatically. It covers authentication, protected-route redirects, persistent model statistics, server/job/asset states, Manager UI behavior using mocked control requests, sign-out, and mobile layout overflow.
Configure these masked repository Actions secrets before enabling the browser job:
- COMFYUI_PORTAL_E2E_USERNAME — a dedicated admin test account
- COMFYUI_PORTAL_E2E_PASSWORD — its password
- COMFYUI_PORTAL_ISSUE_TOKEN — a Gitea token that can create, update, comment on, and close issues
Failed tests are fingerprinted by environment and test name. The workflow reuses the matching Gitea issue instead of creating duplicates, closes it after a later passing run, and blocks the QA gate while automated UI blockers remain open. Screenshots and video are disabled; Playwright traces are retained only on failure.