chore: aggiungi CLAUDE.md e rimuovi skill UX locale

Aggiunta documentazione per Claude Code (comandi, architettura, testing, pipeline Android). Rimossa la skill UX da .claude/skills/ non più necessaria. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 16:38:23 +02:00
parent febf2efb86
commit 6293743fa1
4 changed files with 66 additions and 185 deletions
@@ -0,0 +1,66 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+BitePlan is a mobile-first Vue 3 PWA for meal planning, raw↔cooked weight conversion, and shopping list management. It targets Android via Capacitor and is designed for a 480px-max viewport. All UI strings and documentation are in **Italian**.
+
+## Commands
+
+```bash
+npm run dev          # Dev server at http://localhost:5173
+npm run build        # Production build → dist/
+npm run preview      # Preview built app
+
+npm test             # Vitest unit + integration tests (watch mode)
+npm run test:coverage  # Coverage report (v8 provider)
+npm run test:e2e     # Playwright e2e (requires dev server running)
+npm run test:e2e:ui  # Playwright interactive UI mode
+
+# Single test file
+npx vitest run tests/unit/conversion.test.js
+
+# Android APK
+bash docker/build.sh           # Debug APK
+bash docker/build.sh --release # Signed release APK
+```
+
+E2E tests simulate iPhone 14 Pro viewport (393×852) with Italian locale.
+
+## Architecture
+
+**App.vue** is the root router — it conditionally renders three pages based on a `currentPage` ref (`meal`, `convert`, `shop`) and hosts the portrait-lock transform, `InfoPanel`, and `DocsPanel`.
+
+**Three pages** in `src/pages/`:
+- `MealPlanner.vue` — 7-day plan (Mon–Sun), 3 meal slots each (colazione/pranzo/cena), per-day accordion via `MealCard.vue`, QR share, and "generate shopping list" export
+- `Converter.vue` — real-time food search → select food+method → bidirectional raw↔cooked calculation using yield coefficients from `src/data/conversions.json`
+- `ShoppingList.vue` — checklist with add/remove/check, importable from meal planner
+
+**State & persistence**: No Pinia/Vuex — pages use Vue composables + direct `localStorage` via the wrappers in `src/utils/storage.js` (`save(key, val)` / `load(key, default)`).
+
+**Conversion logic** lives entirely in `src/utils/conversion.js`:
+```js
+rawToCooked(food, method, rawGrams, db) = rawGrams * db[food][method].yield
+cookedToRaw(food, method, cookedGrams, db) = cookedGrams / db[food][method].yield
+```
+`yield = cooked_weight / raw_weight`. The database in `src/data/conversions.json` has 50+ foods × 1–4 cooking methods with coefficients sourced from CREA, SINU, USDA (see `docs/conversioni.md`).
+
+**CSS**: Vanilla CSS only, no framework. Design tokens are CSS variables in `:root` in `src/style.css` (`--color-primary: #2d6a4f`, `--nav-height: 64px`, etc.). Buttons must be min 44px; layout is single-column.
+
+## Testing
+
+- **Unit** (`tests/unit/`): Pure function tests for `conversion.js` and `storage.js`
+- **Integration** (`tests/integration/`): Vue Test Utils component mounts with localStorage seeding
+- **E2E** (`tests/e2e/`): Playwright against the running dev server
+
+`tests/setup.js` clears localStorage before/after each test. Vitest uses `happy-dom` environment.
+
+## Android Build
+
+The Docker pipeline in `docker/` handles the full Android build:
+1. `npm run build` → `dist/`
+2. `cap sync` → copies dist into Android project
+3. Gradle builds the APK; release APK is signed with `docker/biteplan.jks` (gitignored)
+
+See `docker/README.md` for full APK build instructions.