anhtuanst1/robopath-ai-workshop

Última atividade de origem registrada: 9 de novembro de 2026 às 02:56

Catálogo do SkillsMP atualizado: 12 de novembro de 2026 às 12:52

skills coletadas: 20

Estrelas no GitHub: 0
Forks no GitHub: 0

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/anhtuanst1/robopath-ai-workshop.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# RoboPath RoboPath is an educational maze game that introduces programming logic through robot challenges. Players arrange command blocks—move forward, turn, and repeat—to guide a robot to the goal. The FastAPI backend simulates programs and saves per-level progress; the Next.js frontend presents the game. ## See the game ![RoboPath gameplay: the player selects a maze and builds a robot program](docs/evidence/robopath-intro.png) The game currently includes 10 mazes, from basic sequencing to forks, dead ends, loops, bridges, and a spiral maze. Every challenge has a tested three-star solution. ## Features - Build, reorder, and remove command blocks using mouse, touch, or keyboard. - Use `repeat` blocks to practice patterns and concise programs. - Run a deterministic simulation and see the robot follow its trace. - Earn up to three stars and keep progress in SQLite. - Play a responsive interface designed for desktop and mobile. ## Technology - **Backend:** Python 3.12, FastAPI, SQLite - **Frontend:** Next.js, React, TypeScript - **Deployment:** Docker Compose (`web` + `api`) - **Tests:** pytest, Vitest, Playwright ## Quick start with Docker Compose The supported Docker workflow uses WSL2. Clone the repository into the WSL2 filesystem, then run: ```bash git clone https://github.com/anhtuanst1/robopath-ai-workshop.git cd robopath-ai-workshop docker compose up --build -d ``` Open [http://localhost:3000](http://localhost:3000) to play. ```bash docker compose ps # check service health docker compose down # stop services; progress volume is retained docker compose down -v # stop services and delete saved progress ``` | Service | Address | Purpose | |---|---|---| | `web` | `http://localhost:3000` | Game UI and same-origin API proxy | | `api` | `http://127.0.0.1:8000` | FastAPI, published on loopback for local debugging | Progress is stored in the `robopath-data` Docker volume. The frontend proxies `/api/*` to the backend, so browser requests stay on the web origin. ## Local development ### Backend Use Python 3.12.8. From `backend/`: ```powershell py -3.12 -m venv .venv .\.venv\Scripts\Activate.ps1 pip install -e ".[dev]" $env:ROBOPATH_DB_PATH = ".\robopath.db" uvicorn maze_game.main:app --reload --port 8000 ``` ### Frontend Use Node.js 24. From `frontend/`, with the backend running: ```powershell npm ci $env:API_PROXY_TARGET = "http://127.0.0.1:8000" npm run dev ``` If Node.js is not installed on the host, use Docker for the frontend workflows; see [frontend/README.md](frontend/README.md). ## Quality checks Run backend commands from `backend/`: ```powershell ruff check . ruff format --check . pytest --cov=maze_game coverage report --include='*simulator.py' --fail-under=90 ``` Run frontend commands from `frontend/`: ```powershell npm run lint npm run typecheck npm test -- --coverage npm run build npm run test:e2e ``` ## Project documentation - [Project plan and file inventory](PROJECT-PLAN.md) - [Requirements](aidlc/spaces/default/intents/261107-robopath/inception/requirements-analysis/requirements.md) - [Architecture](aidlc/spaces/default/intents/261107-robopath/inception/domain-design/architecture.md) - [API contract](aidlc/spaces/default/intents/261107-robopath/inception/contract-design/contract.md) - [QC test plan and results](aidlc/spaces/default/intents/261107-robopath/construction/build-and-test/test-results.md) - [Conditional-blocks proposal](docs/conditional-blocks-plan.md) - [File changelog](docs/FILE-CHANGELOG.md) The implementation and automated verification are recorded in the project artifacts. G3 integration review and G4 release-readiness approval remain human review gates.

Carregando o README do repositório…

Skills neste repositório

classificação pendente

skill

ocupação

descrição

atualizado

api-and-interface-design

sem classificação

Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.