Repository navigation
Oracle Java Bot — Notas de versión
Version: v1.0.0
Release Date: 22 de mayo de 2026
Audience: Usuarios finales — Managers (web dashboard) y Developers (Telegram bot)
Status: Lanzamiento público inicial
Overview
Oracle Java Bot v1.0.0 es el primer lanzamiento de producción de la plataforma. Agrupa el trabajo completado durante Sprint 1 (gestión principal de proyectos en el web dashboard y el Telegram bot) y Sprint 2 (generación de tareas asistida por AI y detección de duplicados) en un único lanzamiento para usuarios finales.
Como este es el lanzamiento inicial, las secciones Improvements y Bug Fixes no aplican: no hay una versión anterior con la cual comparar. Los lanzamientos posteriores usarán v1.0.0 como línea base.
New Features
Web Dashboard for Managers
El web dashboard (React 18 / TypeScript) proporciona gestión completa de proyectos, equipos y tareas en cinco páginas integradas.
Inicio — Portfolio Dashboard
- Visualiza todos los proyectos activos con barras de progreso en vivo en la tabla Proyectos en curso; de un vistazo, ve cómo avanza cada proyecto sin abrirlo.
- Obtén totales de todo el portafolio desde cuatro tarjetas KPI (Proyectos activos, Equipos, Proyectos, Completados), para que el liderazgo pueda responder "¿dónde estamos?" en una sola pantalla.
- Haz clic en cualquier fila de proyecto para saltar directamente a su KPI dashboard.
Tareas — Task Management
- Filtra el tablero de tareas por proyecto y sprint, para que un solo Manager que maneja múltiples sprints vea únicamente lo que importa ahora.
- Crea nuevas tareas con título, proyecto, prioridad, fecha límite, horas estimadas y responsable en un solo formulario.
- Visualiza y edita los detalles de la tarea en línea; no hay una pantalla de edición separada que cargar.
- Actualiza el estado de la tarea (Por hacer · En progreso · Completada · Cancelada) y haz que el cambio se refleje en el Telegram bot en tiempo real.
- Elimina tareas que ya no sean necesarias.
Proyectos — Project Management
- Explora y filtra todos los proyectos entre equipos.
- Crea nuevos proyectos vinculados a un equipo, con fechas de inicio y fin.
- Abre un KPI dashboard por proyecto, incluyendo Estimation Precision (horas estimadas vs. horas reales).
- Edita los detalles del proyecto o elimina proyectos cuando se hayan cerrado.
Equipos — Team Management
- Explora todos los equipos con conteos resumidos de miembros y proyectos vinculados.
- Crea nuevos equipos con nombre, descripción y owner.
- Agrega o elimina miembros del equipo directamente desde la página de detalle del equipo.
- Edita la descripción de un equipo directamente en la página.
Telegram Bot for Developers
El Telegram bot da a los developers control completo de tareas desde cualquier dispositivo donde ya tengan Telegram; no hay una aplicación separada que instalar ni una cuenta que crear.
- Vincula una cuenta de Telegram con un usuario pre-registrado usando
/start, para que el onboarding sea de un toque una vez que el Manager haya registrado el Telegram ID. - Cambia el proyecto activo con
/projectpara mantener las listas de tareas limitadas a aquello en lo que el developer realmente está trabajando. - Lista las tareas asignadas para el proyecto activo con
/tasklist. - Actualiza el estado de una tarea a IN PROGRESS, DONE o CANCELLED con un solo toque de botón; el cambio se refleja en tiempo real en el Kanban board del web dashboard, para que los Managers vean el progreso sin pedir actualizaciones de estado.
- Crea nuevas tareas al momento con
/addtask, mediante un flujo guiado de prompts que no requiere salir de Telegram.
AI-Powered Automation (Agent)
La página Agent lleva flujos asistidos por AI directamente al dashboard del Manager, reduciendo el tiempo de preparación y limpieza del sprint.
- Auto-generate tasks with AI — proporciona contexto del proyecto y el AI service genera un borrador de lista de tareas candidatas (título, descripción, prioridad, horas estimadas), para que los Managers comiencen la planeación del sprint desde un borrador en lugar de una página en blanco.
- Review, edit, and approve AI suggestions — refina cada tarea sugerida y aprueba solo las que encajan con el sprint, en un único flujo por lotes.
- Duplicate task analysis — ejecuta un pipeline de tres motores que usa semantic embeddings para marcar tareas que podrían ser duplicadas (umbral de similitud predeterminado: 0.88), para que los backlogs no acumulen trabajo redundante silenciosamente.
- Review and delete duplicate tasks — inspecciona comparaciones lado a lado de cada motor y elimina los duplicados que no correspondan.
Known Issues
Los siguientes issues se rastrean en el project backlog on Jira y tienen workarounds validados. No bloquean el uso normal del producto.
| # | Issue | Workaround | Tracking |
|---|---|---|---|
| 1 | Telegram bot está limitado a una sola instancia de backend. La implementación actual usa long polling (getUpdates) para recibir mensajes de Telegram, lo que solo permite un proceso de polling por bot token; Telegram devuelve un error 409 Conflict si dos instancias hacen polling al mismo tiempo. Ejecutar múltiples instancias también causa procesamiento duplicado contra la base de datos. Esto limita el escalamiento horizontal del nivel del bot. |
Ninguno a nivel de usuario final. Planned fix: migrar el bot de long polling a una integración de webhook (Telegram envía actualizaciones al backend mediante HTTPS POST), que puede estar detrás de un load balancer y escalar entre múltiples instancias. | KAN-XXX |
| 2 | Es posible que el Manager no vea inmediatamente el cambio de estado de Telegram de un developer en el Kanban board de Tareas. | Recarga la página Tareas en el navegador para obtener el estado más reciente. | KAN-XXX |
| 3 | Agent → Generar tareas puede quedarse en estado de carga cuando el AI service está lento o temporalmente no disponible. | Quédate en la página y espera hasta 60 segundos. Si no aparece ningún resultado, regresa y vuelve a ejecutar el flujo. | KAN-XXX |
| 4 | Duplicate detection puede mostrar Error en uno de los tres paneles de motores mientras los otros dos devuelven resultados. |
Los motores son independientes: revisa los resultados de los paneles que funcionan y vuelve a ejecutar el pipeline desde Agent si se necesita un resultado completo de tres motores. | KAN-XXX |
| 5 | Eliminar una tarea desde los resultados de duplicate-analysis falla con No se puede eliminar una tarea completada cuando el estado de la tarea es Completada. |
Abre la tarea desde Tareas, cambia su estado a algo distinto de Completada y luego vuelve a intentar la eliminación. | KAN-XXX |
| 6 | Los botones de estado del Telegram bot (IN PROGRESS / DONE / CANCELLED) ocasionalmente no responden después de que una sesión ha expirado. | Escribe /start en el chat del bot para refrescar la sesión, vuelve a ejecutar /tasklist e intenta de nuevo la actualización de estado. |
KAN-XXX |
Reemplaza cada
KAN-XXXcon el ID de ticket de Jira correspondiente una vez registrado.
Documentation & Links
- User Guide — documentación completa de instrucciones para Managers y Developers:
USER_GUIDE_2.md - Repository — código fuente y release tag
v1.0.0: <REPO_URL> - Release page — GitHub Release para v1.0.0: <RELEASE_URL>
- Issue tracker (Jira) — issues conocidos, backlog y trabajo futuro: KAN board
- Upgrade guide — no aplica para el lanzamiento inicial. Las upgrade guides se publicarán con futuras versiones menores y mayores.
Reemplaza cada placeholder
<...URL>con el enlace final publicado antes de publicar el release.
Environment
| Item | Details |
|---|---|
| Application release | Oracle Java Bot v1.0.0 |
| Backend | Spring Boot 3 · Java 21 |
| Frontend | React 18 · TypeScript · Vite |
| AI Service | Python 3 · FastAPI |
| Database | Oracle Autonomous Database (ATP) |
| Supported browsers | Chrome 124+, Firefox 125+, Edge 124+ |
| Telegram client | Cualquier versión actual (Android, iOS, Desktop) |
Oracle Java Bot · v1.0.0 · Released May 22, 2026 · Team 43
Alfredo Carmona · Clay Gutiérrez · Emilio Hernández · Luis Díaz