Kill_LIFE/web

YiACAD Web

This directory hosts the web-facing YiACAD scaffold:

• app/ provides the Next.js frontend and GraphQL route handler.
• components/ holds the Excalidraw canvas, KiCanvas viewer shell, project tree, and realtime status cards.
• project/ is the Git-tracked source-of-truth for .excalidraw diagrams and local KiCad inputs.
• realtime/server.mjs launches the separate Yjs websocket server with persistence.

Product routes:

• / project dashboard
• /diagram Excalidraw editor
• /pcb KiCanvas viewer lane
• /review PR review surface

Key commands:

• npm install
• npm run dev
• npm run dev:realtime
• npm run worker:eda
• npm run vendor:kicanvas

The current realtime layer exposes a Yjs room and transport status. Binding Excalidraw scene data into the CRDT document is intentionally left as the next incremental lot.

AI / intelligence overlay:

• keep Git as the source of truth
• keep Yjs as collaboration transport only
• keep workers as the execution boundary
• introduce review assist only as a read-only overlay once Git/CI/artifact read models are real

Queue and workers:

• GraphQL enqueues EDA jobs through Redis-backed BullMQ
• npm run worker:eda consumes the queue and calls existing repo tools
• worker heartbeat is published to web/project/.ci/worker-health.json
• kicad-headless uses tools/cad/yiacad_backend_client.py in service-first mode
• kibot now routes through tools/cad/yiacad_backend_client.py and emits a normalized YiACAD manufacturing package
• kiauto-checks now routes through tools/cad/yiacad_backend_client.py and emits normalized YiACAD validation output

Ops probes:

• GET /api/ops/platform exposes next-js, yjs-realtime, eda-queue, and eda-worker
• GET /api/ops/queue distinguishes REDIS_URL misconfiguration from Redis reachability failures
• GET /api/ops/worker reports worker heartbeat, last job, and stale or absent worker state

Environment:

• copy values from .env.example
• REDIS_URL is required for the queue/worker path
• KIBOT_CONFIG is optional until a real KiBot recipe is added to the project