Glossario

Termini tecnici e agronomici usati nell'applicazione

Agronomia & biologia seme

Germinabilità: Percentuale di semi che germinano sul totale seminato (es. 85 su 100 = 85%). Indicatore di qualità del seme. Soglia commerciale tipica: ≥ 85%.
Conta: Misurazione del numero di semi germinati/duri/anormali/morti in una capsula Petri o alveolo.
Prima conta (giorni_1): Lettura parziale a metà prova (es. giorno 5). Serve a vedere l'andamento iniziale.
Seconda conta (giorni_2): Lettura finale (es. giorno 10 o 14, dipende dalla specie). Quella che conta per la germinabilità finale.
Ripetizione: Una delle 4 capsule Petri (A, B, C, D) seminate in parallelo, con 100 semi ciascuna. La media delle 4 dà il risultato.
Seme duro: Seme con tegumento impermeabile, non germina. In alcune leguminose può arrivare al 30% — non è seme "morto", germinerebbe con scarificazione.
Seme fresco: Non germinato, ma vitale (giovane, non ancora pronto). Tipicamente < 5%.
Plantula anormale: Seme germinato ma con sviluppo difettoso (radice o cotiledone malformati). Non conta come "germinato" ai fini commerciali.
Vigore: Valutazione soggettiva della forza di germinazione (SCARSO / MEDIO / OTTIMO). Osservata sul campo dal tecnico.
UR (Umidità Relativa): Percentuale di umidità nell'aria del germinatoio. Tipicamente 30-60% a seconda della specie.
Tipologia seme: Lavorazione applicata al seme. Livelli progressivi: Natura (grezzo) → Selezionato (pulito) → Calibrato (dimensione uniforme) → Pillolato/Film coated (rivestito). Anche Trattato (fungicida) e Portaseme (destinato a riproduzione).

Workflow Semiorto

FT (Fattura Tecnica): Numero progressivo annuale assegnato a ciascuna analisi. Formato NNN/YY. Non è una fattura commerciale, è solo un identificativo.
Lotto: Un batch di seme ricevuto in laboratorio. Identificato da un codice testuale assegnato dal produttore/magazziniere. Es. VSF012/E-C.
Esaurito: Stato di un lotto quando il seme è finito (in laboratorio o commercialmente). Flag booleano, con data associata.
In Corso: Analisi aperta (data NULL): iniziata ma non ancora chiusa. Il tecnico deve ancora registrare conte o validare risultato.
Da Analizzare: Lotto che dovrebbe essere rianalizzato questo mese secondo il calendario specie, ma non ha analisi chiuse recenti. Badge rosso nella navbar.
Chiusa: Analisi con data compilata: risultato definitivo, pronta per stampa certificato.
Cancellata: Soft delete: campo cancella compilato con motivo. Non più visibile nelle liste, ma recuperabile da admin.
Certificato: Documento DOCX generato per il cliente a conclusione analisi. Template modello-certificato-{azienda}.docx.
Scheda di controllo: Documento PDF interno con dati completi dell'analisi. Usato come "scheda tecnica" di laboratorio.

Tecnico (stack)

Spring MVC: Framework Java web-based. Controller riceve HTTP, delega a service, restituisce vista JSP.
Hibernate: ORM (Object-Relational Mapper): mappa classi Java (VO) a tabelle DB. Usa Criteria API o HQL per query.
Spring Security: Framework autenticazione/autorizzazione per Spring. Gestisce login, sessioni, ruoli.
JSP (JavaServer Pages): Template HTML con tag Java e JSTL. Compilate da Tomcat in servlet.
JSTL: JSP Standard Tag Library. <c:forEach>, <c:if>, <c:url>: evitano Java inline nelle JSP.
VO (Value Object): Classe Java mappata alla tabella DB con Hibernate (entità JPA). Nel progetto: SemiortoAnalisi, SemiortoLotto, ecc.
BO (Business Object): Classe Java usata per binding con form Spring. Ha campi aggiuntivi come dataArrivoS (stringa) accanto a dataArrivo (Date) per gestire l'I/O con JSP.
DAO (Data Access Object): Layer tra service e DB. Incapsula query Hibernate o SQL.
@Transactional: Annotazione Spring che apre una transazione DB per la durata del metodo. readOnly=true ottimizza le SELECT.
Criteria API: Modo Hibernate di costruire query dinamicamente in Java (no SQL string). createCriteria + Restrictions.eq().
ShaPasswordEncoder: Encoder password Spring Security basato su SHA-1. Deprecato, da sostituire con bcrypt.
JSESSIONID: Cookie sessione HTTP di Tomcat, contiene l'ID della sessione server-side. Passato in URL quando i cookie non sono accettati.

Stampa documenti

docx4j: Libreria Java per manipolare file Microsoft Word (.docx). Usata per sostituire placeholder $$_NOME_$$ nei template.
Apache POI: Libreria Java per Excel (.xlsx). Usata dal WAR semiorto-report per export report.
Placeholder: Stringhe nel template (es. $$_NOME_SPECIE_$$) che vengono sostituite con valori a runtime prima di inviare al client.

Infrastruttura

Tomcat: Application server Java. Esegue WAR files. Versione legacy qui: 7.0.106 (richiede Java 8).
WAR (Web Application Archive): File zip con l'app Java pronta per deploy. Contiene classi compilate + risorse + WEB-INF/web.xml.
ROOT webapp: Il WAR caricato in /ROOT diventa accessibile senza path (es. http://host/ invece di http://host/miapp/). Diego lo usa così.
Docker compose: Strumento per definire stack multi-container. In questo progetto: tomcat + mysql.
nginx: Web server che fa da reverse proxy davanti a Tomcat. Gestisce HTTPS, caching static, rewriting.
reverse proxy: Server che inoltra richieste a un altro server backend. Il client vede solo il proxy.
sub_filter (nginx): Modulo nginx che sostituisce stringhe nel response body. Usato per riscrivere path assoluti quando si fa proxy di un'app che non sa di essere sotto un prefisso.

Ruoli utente

Amministrazione: Super-user: gestisce altri utenti, vede analisi cancellate. In TopSeed → ADMIN.
Laboratorio: Tecnico che esegue le analisi di germinabilità. In TopSeed → GENETISTA.
Magazzino: Accettazione merce e gestione lotti. In TopSeed → MAGAZZINIERE.

Sigle e codici

POM: Codice specie Pomodoro (esempio)
SF: Codice produttore Schiavone Fernando (esempio)
PETRI: Tipo prova: germinazione in capsula Petri su carta assorbente. Il più comune.
TORBA: Tipo prova: germinazione in pane di torba. Per specie che richiedono substrato.
CONTENITORI ALVEOLATI: Tipo prova: germinazione in vassoi con alveoli separati. Per sementi grosse o che richiedono spazio radicale.
STANDARD: Categoria analisi "standard", test di routine.
COMMERCIALE: Categoria analisi più stringente, per emettere certificato destinato al mercato.
POSITIVO/NEGATIVO: Esito dell'analisi: POS se germinabilità supera soglia per quella specie, NEG altrimenti. Decisione tecnico, non automatica.
REGOLARE/IRREGOLARE: Indica se la prova è stata eseguita senza anomalie (REGOLARE) o con problemi (IRREGOLARE, es. contaminazione o UR non mantenuta).