# Manual de Producto y Especificación Funcional — Radar GovTech **Radar** ([licitacion.co](https://licitacion.co)) es una plataforma de inteligencia de contratación pública y veeduría ciudadana de alta velocidad, diseñada para identificar, analizar y monitorear oportunidades de negocio con el Estado colombiano en tiempo real y sin fricciones burocráticas. --- ## 1. Visión y Propuesta de Valor Los portales oficiales de contratación pública en Colombia (Secop I y Secop II) sufren de sobrecarga visual, lentitud de respuesta, caídas recurrentes y barreras de acceso. Radar resuelve estos dolores mediante una experiencia de usuario instantánea y enfocada: * **Velocidad sin esperas:** Consulta paralela y federada en menos de 1 segundo sobre millones de registros oficiales de datos abiertos. * **Cero fricción de acceso:** Búsqueda libre e instantánea sin obligar al usuario a iniciar sesión para explorar convocatorias y pliegos. * **Inteligencia proponente:** Herramientas integradas de simulación financiera, checklist de habilitación jurídica, comparación cara a cara y agendamiento en calendario. * **Portabilidad y privacidad total:** Persistencia local de datos en el navegador (`localStorage`), eliminando la necesidad de almacenar información sensible en servidores externos. --- ## 2. Mapa Funcional del Sistema ```mermaid flowchart TD Inicio["Radar (licitacion.co)"] --> Buscador["Buscador Federado Secop I y Secop II"] Inicio --> Sonar["Auto-Sonar (Monitoreo en Segundo Plano)"] Inicio --> Fuentes["Catálogo de Fuentes Especiales (40+ Entidades)"] Inicio --> ZonaUsuario["Zona de Usuario & Perfil Proponente"] Buscador --> Filtros["Filtros Rápidos & Píldoras de 1-Clic"] Buscador --> Urgencia["Termómetro de Cierre (<48h, <7d)"] Buscador --> Ficha["Ficha Detallada de Licitación"] Ficha --> Checklist["Checklist Pre-Vuelo Habilitante"] Ficha --> Calc["Simulador Financiero (Estándar & AIU)"] Ficha --> Calendario["Agendamiento (Google Calendar & .ics)"] Ficha --> Comparador["Bandeja Comparadora (Hasta 3 Procesos)"] Ficha --> Gate["Guardar en Seguimiento (Control Freemium)"] ZonaUsuario --> Watchlist["Watchlist de Entidades Vigiladas (5+ / 10+)"] ZonaUsuario --> RUP["Códigos RUP & Palabras Clave"] ZonaUsuario --> Alertas["Alertas a la Medida & Competidores"] ``` --- ## 3. Módulos Funcionales Detallados ### 3.1. Buscador Federado y Hero Radar * **Consultas Socrata en Paralelo:** Consulta concurrente a Secop II (`p6dx-8zbt`) y Secop I (`f789-7hwg`). Si un servicio oficial experimenta lentitud, el otro sigue respondiendo. * **Telemetría en Vivo:** El botón de búsqueda y el indicador de cabecera muestran el estado del escaneo en tiempo real (consultando nodos de Secop, normalizando esquemas y ordenando por relevancia). * **Píldoras Rápidas de Nicho:** Atajos de un solo clic para sectores estratégicos: *Consultoría*, *Software / TI*, *Interventoría*, *Actuarial*, *Auditoría*, *Infraestructura* y *Pymes*. * **Píldoras de Estado Rápido:** Conmutación inmediata entre procesos *Borrador*, *Convocado*, *Seleccionado* y *En ejecución*. * **Mensajes Contextuales de Estado Vacío:** Si una búsqueda no arroja resultados, el sistema sugiere búsquedas alternativas basadas en nichos populares o permite ampliar el radio de escaneo con un solo clic. ### 3.2. Auto-Sonar (Monitoreo Continuo) * **Escaneo Periódico Silencioso:** Ejecuta sondeos automáticos en segundo plano para alertar sobre nuevas licitaciones que coincidan con la búsqueda activa. * **Frecuencias Configurables:** Opciones ergonómicas sin repeticiones innecesarias: * 10 minutos * 15 minutos (valor predeterminado) * 30 minutos * 1 hora * Pausar monitoreo * **Banner Reactivo de Nuevas Oportunidades:** Notificación flotante no invasiva indicando cuántos procesos nuevos entraron al radar, con botón para incorporarlos a la vista actual al instante. ### 3.3. Termómetro de Urgencia Clasifica algorítmicamente las convocatorias según la proximidad de su fecha límite de presentación de ofertas: * **Crítico (< 48 horas):** Badge ámbar/rojo con efecto de pulso visual que resalta las horas exactas restantes para el cierre. * **Semana (< 7 días):** Alerta preventiva para convocatorias que vencen en la semana en curso. * **Normal (> 7 días):** Procesos con holgura temporal para estructuración. * **Filtrado Reactivo:** Píldoras dedicadas para aislar licitaciones críticas con un solo toque. ### 3.4. Ficha de Licitación y Herramientas de Análisis #### A. Semáforo y Glosario Jurídico * Clasificación visual del estado del contrato (*Celebrado*, *Borrador*, *En ejecución*, *Liquidado*, *Terminado*, *Convocado*). * Explicación jurídica contextual para cada estado, permitiendo a empresas novatas comprender la etapa procesal del expediente. #### B. Checklist Pre-Vuelo Habilitante Herramienta interactiva para verificar el cumplimiento de los 6 requisitos habilitantes de la contratación estatal en Colombia: 1. **Capacidad jurídica:** Existencia y representación legal acorde al objeto contractual. 2. **Registro Único de Proponentes (RUP):** RUP vigente y en firme en Cámara de Comercio. 3. **Capacidad financiera:** Indicadores de liquidez, endeudamiento y razón de cobertura de intereses. 4. **Capacidad organizacional:** Rentabilidad del patrimonio y rentabilidad del activo. 5. **Experiencia acreditada:** Códigos Unspsc y contratos similares terminados y registrados en RUP. 6. **Cumplimiento de parafiscales:** Paz y salvo en aportes de seguridad social y parafiscales (Ley 789 de 2002). * **Personalización:** Capacidad de añadir requisitos específicos del pliego de condiciones (ej. certificaciones ISO, personal clave) con persistencia por licitación en `localStorage`. #### C. Simulador Financiero y Económico Permite modelar la rentabilidad antes de ofertar: * **Modo Estándar:** Calcula margen neto considerando retención en la fuente (2.5%), ICA municipal e impuestos locales/estampillas (ej. 3.5%). * **Modo AIU:** Diseñado para obras civiles, interventorías y servicios integrales: * Desglose paramétrico de Administración (A), Imprevistos (I) y Utilidad (U). * Liquidación automática de IVA (19%) aplicado exclusivamente sobre la porción de Utilidad (U), conforme al Estatuto Tributario colombiano. * Determinación precisa de costos directos disponibles para ejecución. #### D. Agendamiento en Calendario * **Google Calendar y Apple/Outlook (.ics):** Generación automática de eventos con la fecha y hora exacta de cierre del pliego. * **Atribución Institucional:** Cada evento incluye la etiqueta `[vía licitacion.co]`, enlace directo al expediente en Radar y nota explicativa para el equipo licitatorio. #### E. Impresión Ejecutiva * Generación instantánea de fichas resumen de licitación y de perfiles de contratista listas para imprimir o exportar a PDF con estilos optimizados de una sola página. ### 3.5. Comparador Cara a Cara * **Bandeja de Comparación:** Permite seleccionar hasta 3 licitaciones simultáneas desde las tarjetas de resultados o el pliego modal. * **Matriz Comparativa:** Despliega una tabla analítica comparando: * Entidad contratante y departamento * Objeto contractual y modalidad * Presupuesto oficial en COP * Fecha y hora límite de presentación * Estado contractual y estado del checklist pre-vuelo * Enlaces oficiales a Secop ### 3.6. Zona de Usuario y Perfil de Proponente * **Identidad Proponente:** Almacena nombre de la empresa, NIT, códigos RUP de interés y presupuesto de referencia. * **Watchlist de Entidades Vigiladas:** Selector interactivo de más de 40 entidades oficiales con control de umbral de actividad (10+ o 5+ convocatorias activas) y acceso a canales RSS unificados. * **Alertas a la Medida:** Configuración de palabras clave obligatorias, palabras excluidas y departamentos prioritarios. * **Monitoreo de Competidores:** Seguimiento de empresas rivales por NIT con simulación de notificaciones directas a WhatsApp. * **Onboarding Wizard:** Asistente paso a paso en 3 etapas para configurar la empresa y sus intereses de contratación en la primera visita. ### 3.7. Catálogo de Fuentes Especiales Módulo dedicado para acceder a procesos y convocatorias de más de 40 organismos internacionales y regímenes especiales que no siempre publican en la interfaz estándar de Secop: * **Bancos Multilaterales:** BID, Banco Mundial, CAF, BCIE. * **Agencias de Naciones Unidas:** PNUD, Unicef, Acnur, FAO, OPS/OMS. * **Regímenes Especiales y Empresas Estatales:** Ecopetrol, Cenit, EPM, Findeter, universidades públicas y patrimonios autónomos. ### 3.8. Modelo Freemium y Control de Acceso * **Acceso Público Gratuito:** Consulta sin límites, visualización de pliegos, cálculo financiero, checklist y uso de comparador abierto a cualquier visitante. * **Intercepción Amigable ("Guardar en Seguimiento"):** Si un usuario no registrado hace clic en el botón de guardar en seguimiento, se despliega una pantalla modal de invitación destacando los beneficios de contar con una cuenta (alertas automáticas, exportación masiva y sincronización multi-dispositivo), protegiendo la conversión sin entorpecer la consulta libre. * **Vista de Seguimiento Adaptable:** Si un visitante ingresa a la pestaña de seguimiento sin autenticación, la vista le ofrece una bienvenida clara con invitación a registrarse o iniciar sesión mediante SSO (Google / Microsoft). ### 3.9. Canales de Difusión y Exportación * **Enlaces Semánticos:** Generación de slugs legibles por humanos (`https://licitacion.co/#/licitacion/alcaldia-de-medellin-...`). * **Compartir en 1-Clic:** Integración optimizada para WhatsApp (con formato negrita y emojis ejecutivos), Telegram, Correo Electrónico y Web Share API nativo para teléfonos móviles. * **Exportación CSV:** Descarga estructurada con codificación UTF-8 con BOM para apertura inmediata en Microsoft Excel, PowerBI o Python. ### 3.10. Instalación PWA (Progressive Web App) * **Soporte Multiplataforma:** Instalable como aplicación nativa en Windows, macOS, Android e iOS. * **Offline-Ready:** Interfaz gráfica accesible sin conexión a internet y lectura de procesos guardados en caché local.