davide
6293743fa1
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>
67 lines
3.2 KiB
Markdown
67 lines
3.2 KiB
Markdown
# 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.
|