diff --git a/docs/empresalibre/docs/img/01/install_001.png b/docs/empresalibre/docs/img/01/install_001.png new file mode 100644 index 0000000..8b76df1 Binary files /dev/null and b/docs/empresalibre/docs/img/01/install_001.png differ diff --git a/docs/empresalibre/docs/instalacion.md b/docs/empresalibre/docs/instalacion.md index cdae02e..d825091 100644 --- a/docs/empresalibre/docs/instalacion.md +++ b/docs/empresalibre/docs/instalacion.md @@ -1,2 +1,244 @@ ## Instalación de Empresa Libre + +
+### Actualización + +
+
TIP: + Es muy importante y es tu responsabilidad mantener siempre actualizado y al día el sistema. +
+ +

+Mantener al día el sistema te permite tener siempre los ultimos cambios realizados +en el, recibir las correcciones de errores y las mejoras que vamos incorporando. + +Siempre consulta el [historial de cambios](/notas) para saber si hay algún proceso +extra que seguir al actualizar. Es muy importante que revises cada nota desde +tu versión actual y hasta la más reciente. + +
+Al iniciar el sistema, debes de ver la versión actual del mismo. Si no la ves, +es que tienes una versión demasiado desactualizada, es importante actualices a +la brevedad. + +![Versión del sistema](img/01/install_001.png) + + +
+Ya dentro del sistema, el proceso para actualizar es: + +1. Entra a la carpeta del proyecto. + + ┌─[empresalibre-][empresa]->{~} + └──> cd proyectos/empresa-libre + ┌─[empresalibre-][empresa]->{~/proyectos/empresa-libre} + └──> + +1. Actualiza la rama `master` del repositorio. El resultado variará, dependiendo desde la versión que estes actualizando, entre más vieja sea, veras más archivos modificados. + + └──> git pull origin master + remote: Enumerating objects: 197, done. + remote: Counting objects: 100% (197/197), done. + remote: Compressing objects: 100% (93/93), done. + remote: Total 197 (delta 135), reused 146 (delta 99) + Recibiendo objetos: 100% (197/197), 131.71 KiB | 956.00 KiB/s, listo. + Resolviendo deltas: 100% (135/135), listo. + Desde https://gitlab.com/mauriciobaeza/empresa-libre + * branch master -> FETCH_HEAD + f0ab924..18b1880 master -> origin/master + Actualizando f0ab924..18b1880 + Fast-forward + CHANGELOG.md | 44 ++++++++ + VERSION | 2 +- + source/app/controllers/main.py | 3 +- + source/app/controllers/util.py | 35 +++++- + source/app/models/db.py | 23 +++- + source/app/models/main.py | 278 ++++++++++++++++++++++++++++++++++++++-------- + source/app/settings.py | 3 +- + source/static/css/app.css | 7 ++ + source/static/js/controller/admin.js | 44 +++++++- + source/static/js/controller/bancos.js | 89 +++++++++++++-- + source/static/js/controller/partners.js | 163 ++++++++++++++++++--------- + source/static/js/controller/util.js | 1 + + source/static/js/ui/admin.js | 18 ++- + source/static/js/ui/bancos.js | 9 +- + source/static/js/ui/main.js | 5 +- + source/static/js/ui/partners.js | 28 ++++- + source/templates/base.html | 2 +- + 17 files changed, 626 insertions(+), 128 deletions(-) + +1. Si las [notas de lanzamiento](/notas) te indican que debes de hacer algún otro proceso, generalmente será que migres la base de datos. + 1. ¿Cuando debo migrar la base de datos? + 1. Si te lo indica la **ultima** nota de lanzamiento + 1. Si te lo indica alguna nota intermedia desde tu versión actual y hasta la ultima. + 1. Si **no ves** la versión de **Empresa Libre** al inicio del sistema + 1. Si **no** estas seguro desde que versión estas actualizando. + * Para migrar entra a la siguiente carpeta + + └──> cd source/app/models/ + ┌─[empresalibre-][empresa]->{~/proyectos/empresa-libre/source/app/models} + └──> + + * **IMPORTANTE:** siempre saca un respaldo de tu base de datos **antes de migrar** + + └──> python main.py -bk + [21-Sep-2018 23:34:08] INFO: API: Generando backup de: LAN7008173R5 + [21-Sep-2018 23:34:09] INFO: API: Backup generado de LAN7008173R5 + [21-Sep-2018 23:34:09] INFO: API: Sin datos para sincronización particular de lan7008173r5.bk + + * Si en vez del mensaje anterior, ves un mensaje de error como el siguiente. Mira en [errores más comúnes][1] para arreglarlo primero. Una vez resuelto, vuelve a ejecutar el comando anterior. **Verifica siempre estar en la carpeta correcta**. + + File "/usr/lib/python3.7/site-packages/requests/adapters.py", line 513, in send + raise ConnectionError(e, request=request) + requests.exceptions.ConnectionError: HTTPSConnectionPool(host='seafile.empresalibre.net', port=443): Max retries exceeded with url: /api2/auth-token/ (Caused by NewConnectionError(': Failed to establish a new connection: [Errno -2] Name or service not known')) + + * **IMPORTANTE:** Si **no sabes** desde que versión estas actualizando, o no has actualizado desde la **versión 1.2.0 del 18 de diciembre del 2017**. Entonces, primero usa el siguente comando. + + └──> python main.py -bd + Introduce el RFC: TU_RFC + + * Ahora si, si ya **no obtienes ningún error** y estas al día, puedes migrar tu base de datos con el comando. + + └──> python main.py -m -r TU_RFC + + * Por supuesto, reemplaza **TU_RFC** por el RFC del emisor a actualizar. + + └──> python main.py -m -r LAN7008173R5 + [21-Sep-2018 23:41:55] INFO: API: Conectado a la BD... + [21-Sep-2018 23:41:55] INFO: API: Creando tablas nuevas... + [21-Sep-2018 23:41:55] INFO: API: Tablas creadas correctamente... + [21-Sep-2018 23:41:55] INFO: API: Iniciando migración de tablas... + [21-Sep-2018 23:41:55] INFO: API: Tablas migradas correctamente... + [21-Sep-2018 23:41:55] INFO: API: Importando datos... + [21-Sep-2018 23:41:55] INFO: API: Importando tabla: Categorias + [21-Sep-2018 23:41:55] INFO: API: Importando tabla: SATImpuestos + [21-Sep-2018 23:41:55] INFO: API: Importando tabla: SATUnidades + [21-Sep-2018 23:41:55] INFO: API: Importando tabla: SATNivelesEducativos + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoRelacion + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATMonedas + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATFormaPago + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATRegimenes + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATBancos + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATUsoCfdi + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATEstados + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATOrigenRecurso + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATPeriodicidadPago + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATRiesgoPuesto + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoContrato + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoDeduccion + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoHoras + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoIncapacidad + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoJornada + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoNomina + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoOtroPago + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoPercepcion + [21-Sep-2018 23:41:56] INFO: API: Importando tabla: SATTipoRegimen + [21-Sep-2018 23:41:56] INFO: API: Importación terminada... + + * **IMPORTANTE:** Si tienes varios emisores en el sistema, **debes de migrarlos todos**. + +1. Por ultimo reinicia el sistema. + + └──> sudo systemctl restart empresalibre + [sudo] password for empresa: + + * El proceso anterior debe ser instantaneo, si se tarda más de un minuto, mira en [errores más comúnes][2]. + * También debe funcionar que reinicies la maquina virtual o servidor donde tengas el sistema. + +1. Cualquier otro problema, usa el [sistema de tickets del proyecto][3] + + +
+### Errores más comúnes + +
+
PRECAUCIÓN: + La modificación incorrecta de cualquier archivo del sistema, puede provocar + que deje de funcionar. Asegurate de seguir todos los pasos correctamente. + Si no estas seguro, es mejor contrates el soporte para que un técnico + especializado realice el procedimiento. +
+
+ +#### Al respaldar la base de datos, muestra el error + + File "/usr/lib/python3.7/site-packages/requests/adapters.py", line 513, in send + raise ConnectionError(e, request=request) + requests.exceptions.ConnectionError: HTTPSConnectionPool(host='seafile.empresalibre.net', port=443): Max retries exceeded with url: /api2/auth-token/ (Caused by NewConnectionError(': Failed to establish a new connection: [Errno -2] Name or service not known')) + +* Entra a la carpeta + + └──> cd proyectos/empresa-libre/source/app/ + ┌─[empresalibre-][empresa]->{~/proyectos/empresa-libre/source/app} + └──> + +* Siempre saca una copia de seguridad. + + cp conf.py ~/conf.py + +* Edita el archivo + + nano conf.py + +* Debe de verse exactamente como el siguiente ejemplo, agrega lo que haga falta. + + #!/usr/bin/env python + + DEBUG = False + MV = True + + #~ Establece una ruta accesible para el servidor web + LOG_PATH = '/home/empresa/log/empresa-libre.log' + + SEAFILE_SERVER = { + 'URL': 'https://seafile.empresalibre.net/api2/', + 'USER': '', + 'PASS': '', + 'REPO': '', + } + SEAFILE_SERVER = {} + +* Para guardar los cambios presionas: `CTRL+O` +* Para salir presionas: `CTRL+X` + +
+#### Al reinciar el sistema, tarda más de un minuto en terminar. + +
+
CUIDADO: + Se muestra el contenido del archivo de la maquina virtual, puede ser diferente + si lo usas en tu propio servidor o VPS. +
+
+ +* Edita el archivo + + sudo nano /etc/systemd/system/empresalibre.service + +* Asegurate de que este **exactamente** como en: + + [Unit] + Description=uWSGI instance to serve Empresa Libre + + [Service] + ExecStart=/usr/bin/uwsgi /home/empresa/empresa-libre/app/main.ini + KillSignal=SIGQUIT + + [Install] + WantedBy=multi-user.target + +* Para guardar los cambios presionas: `CTRL+O` +* Para salir presionas: `CTRL+X` +* Recarga los cambios. + + sudo systemctl daemon-reload + +* Asegurate de que ahora reinicia al instante. + + sudo systemctl restart empresalibre + + +[1]: #al-respaldar-la-base-de-datos-muestra-el-error +[2]: #al-reinciar-el-sistema-tarda-mas-de-un-minuto-en-terminar +[3]: https://gitlab.com/mauriciobaeza/empresa-libre/issues diff --git a/docs/empresalibre/docs/notas.md b/docs/empresalibre/docs/notas.md new file mode 100644 index 0000000..4281eaf --- /dev/null +++ b/docs/empresalibre/docs/notas.md @@ -0,0 +1,177 @@ +## Notas de lanzamiento + +Siempre debe verificar en esta sección, el proceso que debes seguir con cada +actualización del sistema. Recuerda; **es muy importante mantener tu sistema +siempre actualizado.** Solo se da soporte sobre la ultima versión de **Empresa +Libre**. + + +### 1.16.1 [18-sep-2018] +- Error [#268](https://gitlab.com/mauriciobaeza/empresa-libre/issues/268) +- IMPORTANTE: Actualizar si usas cuatro decimales en impuestos + + +### 1.16.0 [16-sep-2018] +- Se puede editar el saldo de un cliente +- Se muestra la cantidad de facturas de pago en los movimientos + + +### 1.15.0 [12-sep-2018] +- Se pueden mover las facturas con doble clic en los movimientos de banco. +- Fix - Al sumar las facturas en los depósitos +- Fix - Al importar los pedimentos en facturas por lotes +- Fix - Al guardar los datos del emisor + + +### 1.14.0 [10-sep-2018] +- Personalizar plantilla para factura de pago +- Fix - Mostrar serie y folio capturado para factura de pago +- Fix - Agregar nueva cuenta de banco + + +### 1.13.0 [10-sep-2018] +- Cancelar factura de pago +- IMPORTANTE: Es necesario realizar una migración, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -bk + +python main.py -m +``` + + +### 1.12.0 [31-ago-2018] +- Soporte para facturas (complemento) de pago. +- IMPORTANTE: Es necesario realizar una migración, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -bk + +python main.py -m +``` + + +### 1.11.1 [21-ago-2018] +- Fix - Quitar columna en tabla facturaspagos. +- IMPORTANTE: Es necesario realizar una migración, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -m +``` + + +### 1.11.0 [25-jul-2018] +- Se cambia la forma de consultar los folios restantes. Es indispensable actualizar a esta versión para ver tus timbres restantes. + + +### 1.10.0 [10-jul-2018] +- Ahora se pueden manejar precios con cuatro decimales. + + +### 1.9.3 [08-jul-2018] +- Fix: Al refacturar conceptos con descuento + + +### 1.9.2 [05-jul-2018] +- Fix: Al generar el reporte de facturas en PDF + + +### 1.9.1 [25-jun-2018] +- Fix: Al mostrar el título de la aplicación - Se agrega el registro de acción al borrar una factura + + +### 1.9.0 [18-jun-2018] +- Se agrega la vista del detalle de facturas +- Fix: Al timbrar nómina + + +### 1.8.1 [14-jun-2018] +- Fix: Se agrega una barra de desplazamiento al buscar productos o clientes +- Se cambia el servidor de consulta de timbres + + +### 1.8.0 [03-jun-2018] +- Se permiten 4 decimales en Tipo de cambio +- Se agrega el campo {total_cantidades} al generar el PDF +- Se agrega opción para generar respaldos de la BD en MV +- Fix: Al generar con complemento EDU + + +### 1.7.0 [23-may-2018] +- Se agrega soporte para truncar impuestos locales, para las estulticias de los "ingenieros" de las dependencias de gobierno + + +### 1.6.1 [09-abr-2018] +- Fix: Nómina con separación + + +### 1.6.0 [18-feb-2018] +- Facturacion a extranjeros +- IMPORTANTE: Es necesario realizar una migración, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -m +``` + + +### 1.5.0 [30-ene-2018] +- Timbrado de Nómina +- IMPORTANTE: Es necesario realizar una migración, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -m +``` + + +### 1.4.0 [01-ene-2018] +- Impresión de tickets + + +### 1.3.0 [27-Dic-2017] +- Punto de venta +- IMPORTANTE: Es necesario realizar una migración, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -m +``` + + +### 1.2.0 [18-Dic-2017] +- IMPORTANTE: Es necesario actualizar la base de datos, despues de actualizar la rama principal. + +``` +git pull origin master + +cd source/app/models + +python main.py -bd +``` + + +### 0.1.0 [26-Oct-2017] +- Generar y timbrar con CFDI 3.3 +