2 Commits

Author SHA1 Message Date
29687c8094 Aggiungi prontuario Git per installazione remota 2026-06-19 10:15:30 +02:00
bd844ce056 Stabilizza barcode e UDC non scaffalate 2026-06-18 18:19:00 +02:00
5 changed files with 401 additions and 35 deletions

View File

@@ -48,6 +48,7 @@ def _build_bypass_session():
class BarcodeClientApp: class BarcodeClientApp:
"""Single-window Tk barcode client modeled after the C# legacy form.""" """Single-window Tk barcode client modeled after the C# legacy form."""
PALLET_BARCODE_LENGTH = 6
NON_SCAFFALATA_BARCODE = "9001000" NON_SCAFFALATA_BARCODE = "9001000"
SHIPPED_BARCODE = "9000000" SHIPPED_BARCODE = "9000000"
BARCODE_MAX_WIDTH = 320 BARCODE_MAX_WIDTH = 320
@@ -65,6 +66,7 @@ class BarcodeClientApp:
self.service = BarcodeService(self.repository, session.operator_id) self.service = BarcodeService(self.repository, session.operator_id)
self._pending: Future | None = None self._pending: Future | None = None
self._auto_advance_id: str | None = None self._auto_advance_id: str | None = None
self._pallet_auto_focus_id: str | None = None
self._status_colors = { self._status_colors = {
"red": "#f4cccc", "red": "#f4cccc",
"green": "#d9ead3", "green": "#d9ead3",
@@ -234,7 +236,7 @@ class BarcodeClientApp:
parent.columnconfigure(1, weight=1) parent.columnconfigure(1, weight=1)
if scanned: if scanned:
self.pallet_entry = entry self.pallet_entry = entry
self.scanned_var.trace_add("write", lambda *_: self._limit_var(self.scanned_var, 8)) self.scanned_var.trace_add("write", lambda *_: self._on_scanned_var_changed())
else: else:
self.destination_entry = entry self.destination_entry = entry
self.destination_var.trace_add("write", lambda *_: self._limit_var(self.destination_var, 8)) self.destination_var.trace_add("write", lambda *_: self._limit_var(self.destination_var, 8))
@@ -244,6 +246,32 @@ class BarcodeClientApp:
if len(value) > max_len: if len(value) > max_len:
variable.set(value[:max_len]) variable.set(value[:max_len])
def _on_scanned_var_changed(self) -> None:
self._limit_var(self.scanned_var, 8)
if self._pallet_auto_focus_id is not None:
try:
self.root.after_cancel(self._pallet_auto_focus_id)
except Exception:
pass
self._pallet_auto_focus_id = None
pallet = str(self.scanned_var.get() or "").strip()
if len(pallet) < self.PALLET_BARCODE_LENGTH:
return
self._pallet_auto_focus_id = self.root.after(80, self._auto_focus_destination_after_scan)
def _auto_focus_destination_after_scan(self) -> None:
self._pallet_auto_focus_id = None
pallet = str(self.scanned_var.get() or "").strip()
if not pallet:
return
if self._pending is not None and not self._pending.done():
return
if getattr(self.service.state, "mode", "") == "confirm":
return
if bool(getattr(self.service.state, "destination_readonly", False)):
return
self._focus_destination_input()
def _apply_responsive_geometry(self) -> None: def _apply_responsive_geometry(self) -> None:
"""Adapt the window size to barcode-sized or desktop-sized screens.""" """Adapt the window size to barcode-sized or desktop-sized screens."""
@@ -331,6 +359,12 @@ class BarcodeClientApp:
except Exception: except Exception:
pass pass
self._auto_advance_id = None self._auto_advance_id = None
if self._pallet_auto_focus_id is not None:
try:
self.root.after_cancel(self._pallet_auto_focus_id)
except Exception:
pass
self._pallet_auto_focus_id = None
self.queue_var.set(state.queue_label) self.queue_var.set(state.queue_label)
self.destination_var.set(state.destination_barcode) self.destination_var.set(state.destination_barcode)
self.scanned_var.set(state.scanned_pallet) self.scanned_var.set(state.scanned_pallet)
@@ -425,7 +459,7 @@ class BarcodeClientApp:
def _start_queue(self, id_stato: int) -> None: def _start_queue(self, id_stato: int) -> None:
self._run_async( self._run_async(
lambda: self.service.start_priority_queue(id_stato), lambda: self.service.start_priority_queue(id_stato),
busy_message="Carico la coda selezionata...", busy_message="In preparazione...",
) )
def _submit(self) -> None: def _submit(self) -> None:
@@ -434,7 +468,7 @@ class BarcodeClientApp:
scanned_pallet=self.scanned_var.get(), scanned_pallet=self.scanned_var.get(),
destination_barcode=self.destination_var.get(), destination_barcode=self.destination_var.get(),
), ),
busy_message="Eseguo il movimento...", busy_message="In esecuzione...",
) )
def _run_async(self, coro_factory: Callable[[], object], busy_message: str) -> None: def _run_async(self, coro_factory: Callable[[], object], busy_message: str) -> None:

View File

@@ -0,0 +1,256 @@
# Prontuario Git per installare/aggiornare Warehouse da remoto
Repository Gitea:
https://gitea.alessandrobonvicini.it/administrator/ware_house.git
Cartella consigliata sul PC di produzione:
C:\flywms
Ramo principale da usare in produzione:
main
Ultimo tag stabile al momento della stesura:
alpha7-stabilizzazione-non-scaffalate
1. Prima installazione su PC nuovo
----------------------------------
Aprire PowerShell nella macchina di produzione ed eseguire:
cd C:\
git clone https://gitea.alessandrobonvicini.it/administrator/ware_house.git C:\flywms
cd C:\flywms
git switch main
git pull origin main
Installare le dipendenze Python:
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
Avvio applicazione desktop:
python main.py
Oppure senza finestra console:
pythonw warehouse.pyw
Avvio applicazione barcode:
python barcode_client.py
Oppure senza finestra console:
pythonw barcode.pyw
2. Aggiornare un'installazione gia' esistente
--------------------------------------------
Sul PC di produzione:
cd C:\flywms
git fetch --all --tags
git switch main
git pull origin main
python -m pip install -r requirements.txt
Poi rilanciare l'applicazione.
2.bis Aggiornare produzione dopo merge su main gia' fatto
---------------------------------------------------------
Questo e' il caso piu' normale:
- sul PC di sviluppo hai gia' fatto merge del ramo di lavoro dentro main;
- hai gia' fatto push su Gitea;
- sul PC di produzione devi solo scaricare l'ultima versione ufficiale.
Sul PC di produzione eseguire:
cd C:\flywms
git fetch --all --tags
git switch main
git pull origin main
python -m pip install -r requirements.txt
Poi chiudere e riaprire l'applicazione.
Controllo consigliato dopo l'aggiornamento:
git log --oneline --decorate -3
git describe --tags --abbrev=0 main
3. Controllare che versione/tag si sta usando
---------------------------------------------
Dentro C:\flywms:
git status
git log --oneline --decorate -5
Vedere l'ultimo tag raggiungibile da main:
git describe --tags --abbrev=0 main
Vedere tutti i tag, dal piu' recente:
git tag --sort=-creatordate
Vedere graficamente branch, commit e tag:
git log --oneline --decorate --graph --all -20
4. Installare esattamente una versione taggata
---------------------------------------------
Usare questa modalita' quando si vuole installare una fotografia precisa e non
necessariamente l'ultima versione di main.
Esempio:
cd C:\
git clone --branch alpha7-stabilizzazione-non-scaffalate https://gitea.alessandrobonvicini.it/administrator/ware_house.git C:\flywms_alpha7
Nota:
Un tag e' una fotografia ferma. Non avanza con git pull come un branch.
Per produzione ordinaria e' piu' comodo usare main.
5. Portare l'ultimo sviluppo dentro main
---------------------------------------
Da fare sulla macchina di sviluppo, non sul PC di produzione.
Se l'ultima versione buona e' su sviluppo3 e vuoi renderla ufficiale su main:
cd C:\devel\python\ware_house
git fetch --all --tags
git status
git switch main
git pull origin main
git merge sviluppo3
git push origin main
Se vuoi anche creare un tag stabile:
git tag nome-del-tag
git push origin nome-del-tag
Esempio:
git tag alpha8-nome-breve-della-modifica
git push origin alpha8-nome-breve-della-modifica
6. Se il PC di produzione ha modifiche locali
---------------------------------------------
Prima di aggiornare controllare:
cd C:\flywms
git status
Se compaiono file modificati che non devono essere conservati, NON fare comandi
distruttivi senza sapere cosa sono. Prima copiare o rinominare i file modificati.
File che normalmente NON devono essere messi nel repository:
db_connection.json
*.log
__pycache__
*.pyc
*.zip
7. Script SQL
-------------
Gli script SQL sono nel repository e vanno lanciati in SSMS solo quando serve
preparare o aggiornare il database per le funzioni Python.
Patch principali:
apply_python_parallel_pickinglist_patch.sql
apply_python_pickinglist_history_views.sql
apply_online_history_forms_patch.sql
Rollback principali:
rollback_python_parallel_pickinglist_patch.sql
rollback_python_pickinglist_history_views.sql
rollback_online_history_forms_patch.sql
Nota:
Prima di lanciare patch SQL in produzione, fare sempre backup o snapshot del
database, oppure verificare di avere una procedura di rollback sicura.
8. Comando rapido piu' usato
----------------------------
Aggiornamento standard del PC di produzione:
cd C:\flywms
git fetch --all --tags
git switch main
git pull origin main
python -m pip install -r requirements.txt
9. Per vedere cosa ho installato
------------------------------------------------------
git log --oneline --decorate -3
git describe --tags --abbrev=0 main
10. Salvare questo prontuario su Gitea
-------------------------------------
Da fare sul PC di sviluppo, dentro la cartella del repository:
cd C:\devel\python\ware_house
git status
git add comandi_git_per_installare.txt
git commit -m "Aggiungi prontuario Git per installazione remota"
git push origin main
Dopo il push, il file sara' disponibile anche sui PC di produzione al prossimo:
cd C:\flywms
git pull origin main
11. Aggiornare il prontuario se lo modifico in locale
----------------------------------------------------
Se modifichi questo file sul PC di sviluppo e vuoi sincronizzarlo su Gitea:
cd C:\devel\python\ware_house
git status
git diff -- comandi_git_per_installare.txt
git add comandi_git_per_installare.txt
git commit -m "Aggiorna prontuario Git installazione"
git push origin main
Se invece lo hai modificato su un PC di produzione e vuoi prima recuperare
eventuali aggiornamenti online:
cd C:\flywms
git status
git pull origin main
Se Git segnala conflitti, fermarsi e risolverli prima di rilanciare
l'applicazione. Per evitare confusione, e' meglio modificare questo prontuario
solo sul PC di sviluppo e poi fare push su Gitea.

View File

@@ -19,6 +19,7 @@ from typing import Any, Callable, Optional
import customtkinter as ctk import customtkinter as ctk
from async_loop_singleton import get_global_loop from async_loop_singleton import get_global_loop
from runtime_support import log_exception
from version_info import module_version from version_info import module_version
__version__ = module_version(__name__) __version__ = module_version(__name__)
@@ -128,21 +129,53 @@ class AsyncRunner:
busy.show(message) busy.show(message)
fut = asyncio.run_coroutine_threadsafe(awaitable, self.loop) fut = asyncio.run_coroutine_threadsafe(awaitable, self.loop)
def _widget_alive() -> bool:
try:
return bool(self.widget.winfo_exists())
except tk.TclError:
return False
def _dispatch_success(res: Any) -> None:
try:
on_success(res)
except BaseException as ex:
log_exception(__name__, ex, context="AsyncRunner on_success")
def _dispatch_error(ex: BaseException) -> None:
if on_error:
try:
on_error(ex)
except BaseException as callback_ex:
log_exception(__name__, callback_ex, context="AsyncRunner on_error")
else:
log_exception(__name__, ex, context="AsyncRunner unhandled error")
def _poll(): def _poll():
if not _widget_alive():
return
if fut.done(): if fut.done():
if busy: if busy:
try:
busy.hide() busy.hide()
except Exception as ex:
log_exception(__name__, ex, context="AsyncRunner hide busy")
try: try:
res = fut.result() res = fut.result()
except BaseException as ex: except BaseException as ex:
if on_error: try:
self.widget.after(0, lambda e=ex: on_error(e)) self.widget.after(0, lambda e=ex: _dispatch_error(e))
except tk.TclError:
log_exception(__name__, ex, context="AsyncRunner error after destroyed")
else: else:
print("[AsyncRunner] Unhandled error:", repr(ex)) try:
else: self.widget.after(0, lambda r=res: _dispatch_success(r))
self.widget.after(0, lambda r=res: on_success(r)) except tk.TclError as ex:
log_exception(__name__, ex, context="AsyncRunner success after destroyed")
else: else:
try:
self.widget.after(60, _poll) self.widget.after(60, _poll)
except tk.TclError:
return
_poll() _poll()

View File

@@ -11,6 +11,7 @@ import customtkinter as ctk
from busy_overlay import InlineBusyOverlay from busy_overlay import InlineBusyOverlay
from gestione_aree import AsyncRunner from gestione_aree import AsyncRunner
from locale_text import load_locale_catalog, text as loc_text from locale_text import load_locale_catalog, text as loc_text
from runtime_support import log_exception
from ui_tables import style_treeview, zebra_tag from ui_tables import style_treeview, zebra_tag
from ui_theme import theme_color, theme_font, theme_section, theme_value from ui_theme import theme_color, theme_font, theme_section, theme_value
from version_info import module_version, versioned_title from version_info import module_version, versioned_title
@@ -20,7 +21,7 @@ __version__ = module_version(__name__)
SQL_NON_SCAFFALATE = """ SQL_NON_SCAFFALATE = """
WITH trace AS ( WITH trace_rows AS (
SELECT SELECT
Pallet, Pallet,
MIN(Lotto) AS Lotto, MIN(Lotto) AS Lotto,
@@ -39,7 +40,7 @@ SELECT
FROM dbo.XMag_GiacenzaPallet AS g FROM dbo.XMag_GiacenzaPallet AS g
LEFT JOIN dbo.Celle AS c LEFT JOIN dbo.Celle AS c
ON c.ID = g.IDCella ON c.ID = g.IDCella
LEFT JOIN trace AS t LEFT JOIN trace_rows AS t
ON t.Pallet COLLATE Latin1_General_CI_AS = ON t.Pallet COLLATE Latin1_General_CI_AS =
g.BarcodePallet COLLATE Latin1_General_CI_AS g.BarcodePallet COLLATE Latin1_General_CI_AS
WHERE g.IDCella = 1000 WHERE g.IDCella = 1000
@@ -72,6 +73,7 @@ class UDCNonScaffalateWindow(ctk.CTkToplevel):
self._locale_catalog = load_locale_catalog() self._locale_catalog = load_locale_catalog()
self._async = AsyncRunner(self) self._async = AsyncRunner(self)
self._busy = InlineBusyOverlay(self, self._theme) self._busy = InlineBusyOverlay(self, self._theme)
self._load_in_progress = False
self.title(versioned_title(loc_text("non_shelved.title", catalog=self._locale_catalog, default="UDC non scaffalate"), __name__)) self.title(versioned_title(loc_text("non_shelved.title", catalog=self._locale_catalog, default="UDC non scaffalate"), __name__))
self.geometry(str(theme_value(self._theme, "window_geometry", "1000x650"))) self.geometry(str(theme_value(self._theme, "window_geometry", "1000x650")))
@@ -85,6 +87,18 @@ class UDCNonScaffalateWindow(ctk.CTkToplevel):
self._build_ui() self._build_ui()
self.after(250, self._load) self.after(250, self._load)
def _is_alive(self) -> bool:
try:
return bool(self.winfo_exists())
except tk.TclError:
return False
def _hide_busy_safe(self) -> None:
try:
self._busy.hide()
except Exception as exc:
log_exception(__name__, exc, context="hide busy UDC non scaffalate")
def _build_ui(self) -> None: def _build_ui(self) -> None:
self.grid_rowconfigure(1, weight=1) self.grid_rowconfigure(1, weight=1)
self.grid_columnconfigure(0, weight=1) self.grid_columnconfigure(0, weight=1)
@@ -145,14 +159,32 @@ class UDCNonScaffalateWindow(ctk.CTkToplevel):
sx.grid(row=1, column=0, sticky="ew") sx.grid(row=1, column=0, sticky="ew")
def _load(self) -> None: def _load(self) -> None:
if self._load_in_progress or not self._is_alive():
return
async def job(): async def job():
return await self.db_client.query_json(SQL_NON_SCAFFALATE, as_dict_rows=True) return await self.db_client.query_json(SQL_NON_SCAFFALATE, as_dict_rows=True)
self._load_in_progress = True
try:
self._busy.show(loc_text("non_shelved.busy", catalog=self._locale_catalog, default="Carico UDC non scaffalate...")) self._busy.show(loc_text("non_shelved.busy", catalog=self._locale_catalog, default="Carico UDC non scaffalate..."))
self._async.run(job(), self._on_loaded, self._on_error) self._async.run(job(), self._on_loaded, self._on_error)
except Exception as exc:
self._load_in_progress = False
self._hide_busy_safe()
log_exception(__name__, exc, context="avvio caricamento UDC non scaffalate")
messagebox.showerror(
loc_text("non_shelved.title", catalog=self._locale_catalog, default="UDC non scaffalate"),
str(exc),
parent=self if self._is_alive() else None,
)
def _on_loaded(self, res: dict[str, Any] | None) -> None: def _on_loaded(self, res: dict[str, Any] | None) -> None:
self._busy.hide() self._load_in_progress = False
self._hide_busy_safe()
if not self._is_alive():
return
try:
rows = _rows_to_dicts(res) rows = _rows_to_dicts(res)
self.tree.delete(*self.tree.get_children("")) self.tree.delete(*self.tree.get_children(""))
for index, row in enumerate(rows): for index, row in enumerate(rows):
@@ -169,9 +201,20 @@ class UDCNonScaffalateWindow(ctk.CTkToplevel):
), ),
tags=(zebra_tag(index),), tags=(zebra_tag(index),),
) )
except Exception as exc:
log_exception(__name__, exc, context="render UDC non scaffalate")
messagebox.showerror(
loc_text("non_shelved.title", catalog=self._locale_catalog, default="UDC non scaffalate"),
str(exc),
parent=self,
)
def _on_error(self, exc: BaseException) -> None: def _on_error(self, exc: BaseException) -> None:
self._busy.hide() self._load_in_progress = False
self._hide_busy_safe()
log_exception(__name__, exc, context="query UDC non scaffalate")
if not self._is_alive():
return
messagebox.showerror( messagebox.showerror(
loc_text("non_shelved.title", catalog=self._locale_catalog, default="UDC non scaffalate"), loc_text("non_shelved.title", catalog=self._locale_catalog, default="UDC non scaffalate"),
str(exc), str(exc),
@@ -183,5 +226,5 @@ def open_udc_non_scaffalate_window(parent: tk.Misc, db_client, session=None) ->
"""Open the non-shelved UDC window.""" """Open the non-shelved UDC window."""
win = UDCNonScaffalateWindow(parent, db_client, session=session) win = UDCNonScaffalateWindow(parent, db_client, session=session)
place_window_fullsize_below_parent_later(win, parent) place_window_fullsize_below_parent_later(parent, win)
return win return win

View File

@@ -13,12 +13,12 @@ MODULE_VERSIONS: dict[str, str] = {
"async_msssql_query": "1.0.0", "async_msssql_query": "1.0.0",
"audit_log": "1.0.0", "audit_log": "1.0.0",
"main": "1.0.1", "main": "1.0.1",
"barcode_client": "1.0.10", "barcode_client": "1.0.12",
"barcode_repository": "1.0.3", "barcode_repository": "1.0.3",
"barcode_service": "1.0.7", "barcode_service": "1.0.7",
"busy_overlay": "1.0.0", "busy_overlay": "1.0.0",
"db_config": "1.0.0", "db_config": "1.0.0",
"gestione_aree": "1.0.0", "gestione_aree": "1.0.1",
"gestione_layout": "1.0.0", "gestione_layout": "1.0.0",
"gestione_pickinglist": "1.0.2", "gestione_pickinglist": "1.0.2",
"gestione_scarico": "1.0.0", "gestione_scarico": "1.0.0",
@@ -31,7 +31,7 @@ MODULE_VERSIONS: dict[str, str] = {
"storico_pickinglist": "1.0.3", "storico_pickinglist": "1.0.3",
"storico_udc": "1.0.0", "storico_udc": "1.0.0",
"tooltips": "1.0.0", "tooltips": "1.0.0",
"udc_non_scaffalate": "1.0.0", "udc_non_scaffalate": "1.0.1",
"ui_theme": "1.0.0", "ui_theme": "1.0.0",
"user_session": "1.0.0", "user_session": "1.0.0",
"view_celle_multi_udc": "1.0.0", "view_celle_multi_udc": "1.0.0",