Notas técnicas

🎬 Qué corre dónde, y qué se puede perder

Esta página no es para el contador.

Dónde vive cada cosa

Qué	Dónde
Dolibarr 23.0.2	contenedor dolibarr, puerto 8092
Base de datos	contenedor dolibarr-db (MariaDB 10.11)
Manual	contenedor incadex-manual (nginx), puerto 8095
Herramientas a medida	/var/www/html/custom/boliviatax/

⚠️ Las herramientas a medida están en un volumen anónimo

/var/www/html/custom está montado en un volumen Docker anónimo. Si el contenedor dolibarr se recrea, ecr.php y aitb.php desaparecen con él.

La copia de verdad está en el repositorio, en dolibarr-bolivia-tax/htdocs/custom/boliviatax/. Si alguna vez faltan, se vuelven a copiar desde ahí. Conviene convertir ese volumen en uno con nombre.

Cosas de Dolibarr que hay que saber

El reporte agrupado devuelve ceros

compta/resultat/result.php no completa la variable del mes final en su rama automática, así que el bucle no procesa nada y todos los importes salen 0,00 sin ningún error. Hay que pasar el rango de meses en la dirección. No se parcheó el código de Dolibarr.

Los <select> de select2 quedan fuera de pantalla

Dolibarr esconde los <select> originales en y = −9800 y dibuja un reemplazo. Cualquier automatización que busque la posición de un campo tiene que resolver el contenedor .select2, no el <select>.

Configuración que se corrigió

SOCIETE_FISCAL_MONTH_START estaba en 0 (inválido) → se puso en 4 (abril).

Cómo se compila y publica este manual

cd incadex-docs
npm run build
cd dist && tar cz . | ssh servidor-breick 'tar xz -C /root/incadex-manual'

Se sirve desde la raíz de :8095, con base: '/' en astro.config.mjs.

El manual anterior

Hasta el 8 de septiembre de 2026 el manual eran cinco páginas HTML sueltas en esa misma carpeta. Están respaldadas en el servidor, en /root/incadex-manual-backup-20260908-1438/. Las direcciones viejas (operaciones.html, prorrateo.html, estados-financieros.html, dolibarr_caja_chica.html) redirigen a su página equivalente del manual nuevo.

Si alguna vez hay que servirlo desde un subdirectorio

No alcanza con mover la carpeta: las rutas quedan escritas dentro del HTML. Y no alcanza con cambiar base, porque los enlaces entre páginas están escritos a mano. Son las tres cosas juntas:

sed -i "s|base: '/'|base: '/sub'|" astro.config.mjs
find src/content/docs -name '*.md' -o -name '*.mdx' | xargs sed -i 's|](/|](/sub/|g'
npm run build

Si se hace a medias, el sitio queda con los estilos bien y la navegación rota, que es peor que romperlo del todo porque no se nota.

Revertir la agrupación de cuentas

DELETE FROM llx_c_accounting_category WHERE code LIKE 'BO_%';
UPDATE llx_accounting_account SET fk_accounting_category = 0;