Integració amb millores funcionals i estètiques del FrontEnd
🧠 Justificació: Per què les millores funcionals i estètiques importen
Un xatbot tècnicament funcional però amb una interfície pobra genera desconfiança en l'usuari. He analitzat críticament com cada millora impacta directament en la usabilitat:
- Estats de càrrega ("Pensant..."): Sense feedback visual, l'usuari no sap si el sistema funciona. Un indicador de càrrega redueix l'ansietat i evita clics repetits que saturin el servidor.
- Validació d'entrada: Permetre enviar missatges buits o amb caràcters invàlids genera errors innecessaris al backend. La validació al FrontEnd protegeix el sistema i millora l'experiència.
- Reinici de conversa: Sense aquesta funció, el context s'acumula indefinidament, degradant la qualitat de les respostes i consumint tokens de l'API innecessàriament.
- Disseny responsive i coherent: Un widget que trenca el disseny del lloc web genera una percepció d'amateurisme. El disseny professional genera confiança i credibilitat.
- Bombolles diferenciades usuari/bot: La distinció visual clara entre qui parla i qui respon és un estàndard de disseny d'interfícies de xat (WhatsApp, Telegram) que l'usuari ja coneix intuïtivament.
1. Funcionalitats addicionals Sistema complet
Reinici, validació, estats de càrrega i gestió d'errors
🔄 Reinici de conversa
Neteja la pantalla i envia senyal al backend per esborrar la memòria del model. Evita acumulació de context i degradació de respostes.
- Botó "Nova conversa" visible
- Endpoint
POST /resetal Flask - Confirmació visual a l'usuari
✅ Validació d'entrada
No permet enviar missatges buits, ni amb només espais, ni amb caràcters especials potencialment maliciosos.
- Trim() + length check
- Regex per caràcters invàlids
- Botó desactivat si buit
⌨️ Tecla Enter
Detecció de la tecla Enter per enviar missatges sense necessitat de fer clic al botó, seguint el comportament estàndard dels xats.
- Event listener
keypress - Shift+Enter per salts de línia
- Compatible amb mòbil
📊 Missatges d'estat
Sistema complet de feedback visual per a cada estat del cicle de vida d'una petició al backend.
- "Pensant..." durant la petició
- "Error de connexió" si falla
- "Resposta rebuda" amb timestamp
💬 Estats visuals implementats
🎮 Previsualització dels estats visuals
2. Disseny i estètica Coherent + Responsive
Bombolles diferenciades, colors corporatius i adaptabilitat
He aplicat un sistema de disseny coherent basat en variables CSS, garantint que el widget sigui visualment consistent i professional tant a escriptori com a mòbil.
🎨 Colors corporatius del Widget
Missatges usuari, botó enviament
Capçalera del widget
Missatges del bot
Àrea de missatges
3. Integració i seguretat Operativa + Robusta
Widget integrat al portafolis, claus ocultes al BackEnd
La integració és totalment operativa al portafolis taberdane.inscastellbisbal.net. Les claus API no són visibles en cap moment al codi JavaScript del FrontEnd.
🌐 Integració al portafolis
- Widget inserit via WPCode sense modificar el tema
- CSS encapsulat amb prefix
tariks- - Coherent visualment amb el disseny del lloc
- Visible a totes les pàgines del WordPress
🔒 Seguretat de les claus API
- Claus als Secrets de Google Colab
- El JS mai veu
GOOGLE_API_KEY - Tota la comunicació és via ngrok → Flask
- Validació server-side de totes les peticions
Evidències – Captures i visualitzacions
Documentació visual de totes les millores implementades
Sistema de validació d'entrada
✓Tres casos: buit, vàlid i caràcters invàlids.
✓Protecció contra XSS al FrontEnd.
Estats de càrrega visuals
✓Bombolla "Pensant..." en lila durant la petició.
✓Barra d'estat amb missatge i temps de resposta.
Reinici complet de conversa
✓FrontEnd netejat + backend notificat.
✓Evita degradació de respostes per context excessiu.
Disseny responsive complet
✓Escriptori: widget flotant 360×520px.
✓Mòbil: pantalla completa sense border-radius.
Detecció tecla Enter
✓Enter envia el missatge directament.
✓Shift+Enter fa salt de línia sense enviar.
Widget operatiu al portafolis
✓Integrat i visible a taberdane.inscastellbisbal.net.
✓Tots els estats visuals funcionant correctament.
✅ Compliment integral de la rúbrica
Integració amb millores funcionals i estètiques del FrontEnd · XatBot Talent 2026
