Skip to content

About

PWA de SmartPot: monitoreo y control de cultivos hidropónicos en React

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SmartPot-Web-React (Legacy Stack A Reference)

Warning

Deprecated (Legacy Stack A Reference Implementation)
This repository contains the legacy Stack A (v1.0) Progressive Web App implemented in React 19 and Vite with pnpm. It has been deprecated and superseded in production by the canonical modern Stack B PWA: SmartPot-Web (SolidJS 1.9 + Bun + Vite, with live SSE, deep dark mode, HttpOnly cookies, and reactive i18n). Preserved solely for historical reference.

Project Status

Node.js CI Publish Docker Images

Description

SmartPot-Web-React is the original user interface of SmartPot: a Progressive Web App (PWA) built with React 19, Vite, Tailwind CSS, and Lucide Icons that allowed growers to monitor hydroponic crops in real time, control actuators, simulate virtual crops, and review AI insights.

Tecnologías

React 19 · TypeScript 6 · Vite 8 · Tailwind CSS 4 · React Router 7 · Recharts · Lucide · Vitest · Testing Library · pnpm 11.

Project Structure

SmartPot-Web/
├── public/
│   ├── icons/                  # Íconos SVG fuente y PNG de la PWA
│   ├── manifest.webmanifest    # Instalación como app
│   ├── sw.js                   # Service worker: app shell en caché, API siempre en red
│   ├── robots.txt, sitemap.xml # SEO
│   ├── og-image.svg / .png     # Imagen para redes sociales
│   └── config.js               # URL de la API en desarrollo (el contenedor lo reescribe)
├── src/
│   ├── app/                    # Enrutador y páginas generales
│   ├── components/             # Marca, layouts y componentes de interfaz
│   ├── config/env.ts           # URL de la API en tiempo de ejecución
│   ├── features/
│   │   ├── auth/               # Sesión, ingreso, registro y recuperación
│   │   ├── overview/           # Panel general: ranking, comparativas y análisis de la IA
│   │   ├── control/            # Control general: modo automático y órdenes en bloque
│   │   ├── actions/            # Acciones sugeridas e historial de todos los cultivos
│   │   ├── crops/              # Creación real o virtual, ilustración, resumen, asistente, control, historial, dispositivo, simulación y ajustes
│   │   ├── learning/           # Aprendizaje de la IA: calidad, comparación de modelos, estados y atípicos
│   │   ├── landing/            # Página pública y preguntas frecuentes
│   │   ├── notifications/      # Alertas
│   │   ├── profile/            # Perfil, canales de notificación (Telegram), contraseña y borrado de cuenta
│   │   └── pwa/                # Registro del service worker e instalación
│   ├── hooks/                  # Metadatos por página, recursos con refresco y conexión
│   ├── lib/                    # Cliente de la API, tipos, catálogos y formato en español
│   └── styles/index.css        # Paleta SmartPot como tokens de Tailwind
├── nginx/                      # Servidor de la imagen: CSP, caché y configuración en tiempo de ejecución
├── scripts/generate-icons.mjs  # PNG de la PWA a partir de los SVG
└── Dockerfile

Identidad Visual

Token Color Uso
leaf-900 #0B3D2B Barra lateral, navegación, encabezados y color del tema de la PWA
leaf-700 #067A52 Acciones principales
leaf-500 #00B074 Verde de marca
water-500 #2D9CDB Agua, información y señal del logo
sun-500 #F2B632 Luz y advertencias
clay-500 #D9734E Maceta de la ilustración y temperatura
danger-500 #D64545 Errores
ink / muted / line / surface #17261F / #5B6B63 / #D5E3DC / #F2F7F4 Texto, bordes y superficies

Tipografías: Outfit para títulos e Inter para el cuerpo, servidas desde la propia app (sin CDNs).

Las comparativas entre cultivos usan una paleta categórica de 8 colores en orden fijo (tonos de la marca más un violeta solo para gráficos), validada para daltonismo y contraste entre vecinos. Cada cultivo conserva su color mientras siga en la comparación, y los gráficos van acompañados de leyenda y de la tabla de últimas lecturas.

SEO y PWA

  • index.html trae descripción, palabras clave, URL canónica, Open Graph, Twitter Card y datos estructurados JSON-LD ( Organization, WebSite, SoftwareApplication y FAQPage), además de contenido estático que leen los rastreadores sin JavaScript.
  • Cada página ajusta su título y robots: la landing, el ingreso y el registro se indexan; /app no.
  • El manifiesto declara íconos normales y adaptables, accesos directos y el color #0B3D2B. El botón «Instalar app» aparece cuando el navegador lo permite; en iPhone se explica «Compartir → Agregar a inicio».
  • El service worker guarda el app shell y los recursos con hash; la API y /config.js nunca se guardan en caché.

Seguridad

  • CSP estricta (script-src 'self', style-src 'self', connect-src limitado a la API), X-Frame-Options: DENY, nosniff, Referrer-Policy y Permissions-Policy (solo la geolocalización del propio sitio, para ubicar un cultivo virtual en modo clima; nunca se envía sin que la persona toque «Usar mi ubicación»).
  • El token JWT se guarda en localStorage solo si el usuario marca «Mantener sesión iniciada»; si no, en sessionStorage. Un 401 cierra la sesión.
  • La clave del dispositivo se muestra una sola vez, al crear un cultivo real o al rotarla.

Guía de Instalación

Despliegue en un comando

La imagen es pública: ghcr.io/smartpottech/smartpot-web. La plataforma completa, con este servicio incluido, se levanta con un solo comando y sin descargar el código:

curl -fsSL https://raw.githubusercontent.com/SmartPotTech/.github/main/docker/demo/compose.yaml | docker compose -f - up -d --wait

Abre http://localhost:5173 e ingresa con demo@smartpot.app / SmartPot2026. Se detiene con docker compose -p smartpot-demo down (con -v borra también los datos). Más detalle en la demo.

Solo este servicio, con la imagen publicada:

docker run -d --name smartpot-web -p 5173:8080 -e API_URL=http://localhost:8091 \
  --read-only --tmpfs /tmp --tmpfs /etc/nginx/conf.d:uid=101,gid=101 \
  ghcr.io/smartpottech/smartpot-web:latest

Prerequisites

  • Node.js 22 o 24 y pnpm 11 (corepack enable)
  • La API de SmartPot en http://localhost:8091 (el entorno completo está en SmartPotTech/.github)

Desarrollo

pnpm install
pnpm dev

Calidad

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Las pruebas cubren el cliente HTTP y sus errores en español, la sesión, las validaciones, el ingreso, los componentes del cultivo, el panel del asistente, lo aprendido y la comparación de modelos, los canales de Telegram, la ilustración del cultivo (formas, especies, actuadores, clima y conexión), la creación real o virtual, la guía de conexión y los requisitos de SEO y PWA.

Imagen Docker

docker build -t smartpot-web .
docker run --rm -p 5173:8080 -e API_URL=http://localhost:8091 \
  --read-only --tmpfs /tmp --tmpfs /etc/nginx/conf.d:uid=101,gid=101 smartpot-web

API_URL se inyecta al arrancar en /config.js y en la CSP, así la misma imagen sirve para cualquier entorno. Imagen publicada: ghcr.io/smartpottech/smartpot-web:latest.

Cada cambio en main pasa por el CI, publica la imagen en GHCR (y en Docker Hub como réplica cuando el repositorio tiene credenciales) y pide el despliegue al workflow central de SmartPotTech/.github, que actualiza producción de a uno y verifica /health.

Íconos

Tras cambiar los SVG de public/icons o public/og-image.svg:

pnpm icons

Documentación

La PWA es la cara de la plataforma: todo lo que muestra viene de la API. Su documentación propia está en docs/ (también en DOCX y PDF), con sus diagramas en docs/diagrams: el general del componente y los de creación de un cultivo, su ilustración y sesión y caché. La documentación técnica describe cada pantalla, la identidad visual, el SEO y la seguridad web. Los diagramas generales muestran la plataforma completa en una sola imagen ampliable:

License

Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.

About

PWA de SmartPot: monitoreo y control de cultivos hidropónicos en React

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages