Adriano/TieMeasureFlow
1
0
Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

docs(readme,claude): Quick Start ricostruibile — sottomodulo e VISION_ENGINE_VERSION (#18)

Browse Source 
README Quick Start: clone con --recurse-submodules (nota sulla chiave SSH per
git.tielogic.xyz:222), VISION_ENGINE_VERSION valorizzata prima di up --build,
comando già descritto più sotto nel documento e ora portato qui.

CLAUDE.md: titolo del layout V2.0.0 -> V3.0.0, aggiunti src/vision,
src/vision_worker, vendor/visionsuite all'albero; nuova sezione «Visione
(V3.0.0)» con sottomodulo, variabile, worker Python 3.13, comando dei test.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
AdrianoDev
2026-09-21 22:41:23 +02:00
parent 1c5292d1e0
commit 0ec5988581
2 changed files with 47 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+13 -4
View File
@@ -127,16 +127,25 @@ reparto.
Docker Compose è il metodo raccomandato. Gestisce database, migrazioni, build delle immagini con `uv` e configurazione Nginx in un solo comando.
```bash
# 1. Clona il repository
git clone ssh://git@git.tielogic.xyz:222/Adriano/TieMeasureFlow.git
# 1. Clona il repository CON il sottomodulo di VisionSuite (vendor/visionsuite):
# senza --recurse-submodules la cartella resta vuota e la build del worker di
# visione fallisce. Il sottomodulo è su ssh://git.tielogic.xyz:222: serve una
# chiave SSH autorizzata su quel repo, sia sulla macchina di sviluppo sia sulla
# VPS che farà la build.
git clone --recurse-submodules ssh://git@git.tielogic.xyz:222/Adriano/TieMeasureFlow.git
cd TieMeasureFlow
# Chi ha già clonato senza il sottomodulo:
# git submodule update --init
# 2. Configura le variabili d'ambiente
cp .env.example .env
# Modifica .env: credenziali DB, chiavi segrete, SETUP_PASSWORD, STATION_CODE per ogni tablet
# 3. Avvia i servizi (ambiente di sviluppo)
docker compose -f docker-compose.dev.yml up -d --build
# 3. Valorizza VISION_ENGINE_VERSION PRIMA della build: il worker di visione
# (Dockerfile.vision) rifiuta di costruirsi senza — vedi "Il worker di
# visione" più sotto per il motivo. Poi avvia i servizi (ambiente di sviluppo).
VISION_ENGINE_VERSION=$(git -C vendor/visionsuite rev-parse HEAD) \
docker compose -f docker-compose.dev.yml up -d --build
# 4. Verifica lo stato dei container
docker compose -f docker-compose.dev.yml ps