SummaPack
=========

Mapa global de los paquetes, ejecutables y flujos del proyecto: ../MAPA-FLUJOS.txt. Incluye el calculo, los graficos, la web y las herramientas de instalacion/publicacion, con sus archivos y pantallas.

Politica comun de todos los programas del conjunto, pendiente de implementar:
la salida nueva conserva el nombre original y la anterior se guarda como
NOMBRE_vN.EXT, con numeracion creciente y sin perder respaldos.
Regla completa y condiciones de seguridad: ../POLITICA-ARCHIVOS.txt.

La politica comun tambien fija entrada completa por stdin, resultados por stdout y generacion de archivos solo con -save; para graficos, X por defecto, -noX para no mostrar y -save para guardar SVG. Es una especificacion pendiente de aplicar, no una afirmacion sobre las opciones actuales de cada herramienta.

El proyecto tiene todavía un grado de avance pequeño: apenas lo necesario para instalar los paquetes del proyecto Simusol. Reúne construcción, descarga, preparación de dependencias, instalación y publicación; no es un gestor universal para cualquier sistema.

Componentes actuales
--------------------

  consulta          summapack, distro (distro.sh en las fuentes)
  instalación       sp (arranque público e interfaz instalada), bajar-paquetes (motor interno), instalar-tgz
  dependencias      preparar, packinstall, diccionariodepaquetes, fuentesexternas
  construcción      .summa, summa.py, hacer-pkg, hacer-pkg.inc, makefile.lib
  otras distros     distros/: Podman viejos para binarios y nuevos para
                    probar fuentes; armar-bibliotecas (proyecto "comunes",
                    /usr/lib/simusol), espejo-fuentes, compilar y entornos
  publicación       subir-paquetes, subir-doc, sp subir --bootstrap summapack
  escritorio        icon_install, findbinlib
  compatibilidad    templatesumma y enlaces hacer-deb -> hacer-pkg
  biblioteca C      mem_util: memoria, archivos, rutas, cadenas y fechas
  documentación     doc/summapack.tex y doc/web/ (HTML para TinyMCE)
  pruebas           pruebas/ y mem_util/tests o sus pruebas de src/

Paquetes producidos
-------------------

  summapack         herramientas y datos comunes (arquitectura all)
  libmem-util0      biblioteca C de ejecución
  libmem-util-dev   encabezados, enlace de desarrollo y mem_util.pc

Pedir summapack como paquete arrastra libmem-util-dev y la biblioteca. Las herramientas adicionales para construir, compilar fuentes, publicar o usar el escritorio dependen de la operación: ver el manual; no todas están garantizadas por instalar el paquete básico.

Inicio
------

La guía pública única y vigente es https://www.simusol.org/downloads/0-README-como-instalar. Describe los formatos, las dependencias y cómo revisar el recorrido sin instalar.

Para instalar Calcula directamente en Debian/Ubuntu:

    curl -fsSLO https://www.simusol.org/downloads/sp
    sh sp --para deb calcula

Es una sola orden de instalación: instala SummaPack, Calcula y sus dependencias. No hace falta instalar SummaPack antes ni ejecutar dos veces sp. Sin nombres de proyecto, sh sp --para deb instala sólo SummaPack.

Desde las fuentes, la opción preferida es sh sp --para fuentes calcula: compila en la máquina e instala mediante make install en /usr/local, o en --prefijo, con un registro para desinstalar mediante sp remove calcula. Para construir paquetes .deb o .rpm e instalarlos con el gestor de la distribución, usar --para fuentes-paquete. Son alternativas, no pasos sucesivos.

Con sp instalado: sp install calcula, sp remove calcula y sp search gsl. Los binarios se construyen en las bases de distribución previstas por el proyecto; su formato no garantiza compatibilidad con todas las bibliotecas del destino. Ver la guía canónica para elegir el recorrido.

Construir paquetes: ./hacer-pkg (DEB, RPM si hay rpmbuild, TGZ y fuentes tar.gz). Construir no instala ni publica. hacer-deb y hacer-deb.inc se conservan como enlaces compatibles.

Documentación
-------------

  doc/0-README-como-instalar      guía pública de descargas: cero, uno o varios proyectos
  doc/summapack.tex              manual completo y referencia de componentes
  BIN.md                        índice de herramientas y relevamiento histórico
  PAQUETES.md                   .summa, construcción, fuentes y publicación
  share/summapack/data/MAKEFILE-LIB.md  objetivos de makefile.lib y límites
  distros/README.md             compilación en Fedora, openSUSE y Arch
  mem_util/README               API C, integración y unidades de fechas
  doc/web/README.md             generación y pegado HTML en TinyMCE

Pruebas: make prueba; python3 pruebas/prueba-distro.py; python3 pruebas/prueba-subir-doc.py; make -C mem_util check una vez configurada y compilada la biblioteca.

Publicación: subir-paquetes publica software; ./subir-doc publica únicamente los PDF. Ninguno cambia CMSimple. Usar la configuración ~/.config/simusol/subir y revisar el alcance de --prueba en cada herramienta: no es una opción universal ni promete cero actividad de red.

sp subir --bootstrap summapack publica doc/0-README-como-instalar en la raíz de descargas, con el sp autónomo y los catálogos. El nombre con 0 lo sitúa antes que los demás nombres en el índice ordenado ascendentemente. subir-paquetes --reorganizar conserva esta guía y los catálogos del bootstrap.

Los programas retirados viven en viejo/ y no son la interfaz recomendada. Los archivos .summa, catálogos de recetas y plantillas pueden contener órdenes ejecutables: utilizar solamente fuentes de confianza.
