BioScanCheck¶

Paused — not deployed

BioScanCheck is not on the apps VPS and is excluded from active CI wiring, DefectDojo bootstrap lists, and Uptime Kuma monitors. The Forgejo repo may still exist for local/historical use. To re-onboard, see Onboard project.

Eco & Bio Product Certification Scanner — React frontend + MCP backend.

Repository¶

Field	Value
Forgejo	`bioscan/bioscancheck`
Plane prefix	`BIOS`
Profile	`fullstack`
Woodpecker label	`location: apps-vps`
App repo path	`C:\Users\anik0z\Documents\bioscancheck`

Stack¶

Frontend: React 19 + TypeScript + Vite
Data: Open Food Facts API + local mock fallback
MCP server: BioScanCheck tools for Cursor IDE
Tests: Vitest

Deploy flow¶

flowchart LR
  Push[push main] --> WP[Woodpecker apps-vps agent]
  WP --> Test[npm test]
  Test --> FE[SFTP dist to IONOS]
  Test --> Docker[build MCP image]
  Docker --> Registry[Forgejo registry]
  Registry --> SSH[SSH docker compose]
  SSH --> Apps[/opt/apps/bioscan on apps VPS]

Woodpecker pipeline (app repo)¶

Add top-level labels in bioscancheck/.woodpecker.yml:

labels:
  location: apps-vps

Steps in bioscancheck/.woodpecker.yml:

Step	When	Action
install	all	`npm ci`, `mcp:build`
test	all	frontend + mcp-server tests
build	all	`npm run build`
deploy-frontend	main	SFTP `dist/` to IONOS
build-push-backend	main	Docker image → Forgejo registry
deploy-backend	main	SSH + `docker compose up -d` on VPS
notify-ci-*	all	Plane comment on `BIOS-N` in branch

Woodpecker secrets¶

Per-repo secrets (via onboard):

SFTP: ftp_host, ftp_user, ftp_pass, frontend_remote_path
Registry: docker_registry_user, docker_registry_token
Apps VPS: ssh_host (82.165.177.110), ssh_user (deploy), ssh_key
Plane: plane_api_key, plane_workspace, plane_project_id, plane_api_url, plane_issue_prefix

Apps VPS backend path¶

/opt/apps/bioscan/

Public URL (when live): https://bioscan.rafaelgonzalezalbes.com

Image: git.rafaelgonzalezalbes.com/bioscan/bioscancheck-mcp:latest

Legacy

A temporary backend on the infra VPS (:3100) may still appear in Kuma as BioScanCheck API (legacy) until migration completes. See Migrate app to apps VPS.

MCP (app-level)¶

Built from app repo — not infra-ops:

cd bioscancheck
npm run mcp:build

Tools: lookup_barcode, get_bio_score, list_known_products

Onboard¶

bash scripts/onboard-project.sh \
  --profile fullstack \
  --forgejo-owner bioscan \
  --repo bioscancheck \
  --plane-prefix BIOS \
  --plane-name "BioScanCheck"

Monitoring¶

BioScanCheck API monitor (TCP :3100) is in Kuma manifest — enabled after backend deploy.

See Monitoring.