Sitio de documentación de APS-Conecta: la fuente única, en español, de las guías para el personal de salud, los administradores de instalación y los desarrolladores de la organización.
Este repositorio contiene el sitio de documentación pública de APS-Conecta, generado con Sphinx y diseñado para publicarse mediante GitHub Pages. No contiene código de producto: las aplicaciones, la distribución, las bibliotecas y los datos viven en sus propios repositorios, y este sitio solo los documenta y enlaza. La frontera que conviene no confundir: la instalación y la operación de la plataforma se describen aquí, pero se ejecutan desde el repositorio de cada componente.
El sitio se organiza por audiencia:
- usuario: guías para el personal que usa la plataforma a diario — interfaz web, archivos, oficina, conversación, calendario, contactos, perfil y seguridad, y las aplicaciones Farmacia, Estadística, Epidemiología y Territorio, además del inicio IntraVox.
- administración: instalación, arquitectura, aprovisionamiento, usuarios y grupos, oficina, mapas base, seguridad y operaciones para quien mantiene una instalación.
- desarrollo: entorno, desarrollo de aplicaciones, tema, calidad y licencias, con una página de referencia por repositorio de la organización.
- proyecto: catálogo de repositorios y seguimiento público del trabajo.
Las páginas de aviso legal, distribución derivada, marcas y licencias se publican como parte del sitio.
Estado al 2026-10-18: el sitio está construido y se publica en GitHub Pages desde main; el flujo build lo regenera cada día y en cada fusión. Los cuatro árboles de contenido (usuario, administración, desarrollo y proyecto) tienen páginas, con una página de referencia por repositorio de la organización. Quedan páginas de borrador en el catálogo, entre ellas las de buscador-documental, cuyos textos completos viven todavía en ese repositorio.
Requisitos: Python 3.11 o superior.
-
Clonar el repositorio y entrar en él:
git clone https://github.com/APS-Conecta/documentation.git cd documentation
-
Instalar las dependencias de compilación:
pip install -r requirements.txt -
Compilar el sitio:
make htmlEl resultado queda en
_build/html/index.html.
El texto del sitio está cubierto por Creative Commons Atribución 3.0 Unported y el código de soporte (generadores y configuración de compilación) por AGPL-3.0-or-later; los textos legales íntegros viven en COPYING y LICENSE en la raíz de este repositorio. Las marcas y el logotipo de la organización quedan fuera de esas licencias; el detalle está en la página de aviso y marcas.