Doc Actualizar
This commit is contained in:
parent
760d33a389
commit
6d3625caf7
Binary file not shown.
After Width: | Height: | Size: 12 KiB |
|
@ -1,2 +1,244 @@
|
||||||
## Instalación de Empresa Libre
|
## Instalación de Empresa Libre
|
||||||
|
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
### Actualización
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
<div class="alert-box notice"><span>TIP: </span>
|
||||||
|
Es <b>muy importante</b> y es <b>tu responsabilidad</b> mantener siempre actualizado y al día el sistema.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<BR><BR>
|
||||||
|
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.
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
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)
|
||||||
|
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
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('<urllib3.connection.VerifiedHTTPSConnection object at 0x7f2f031a4550>: 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]
|
||||||
|
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
### Errores más comúnes
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
<div class="alert-box error"><span>PRECAUCIÓN: </span>
|
||||||
|
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.
|
||||||
|
</div>
|
||||||
|
<BR>
|
||||||
|
|
||||||
|
#### 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('<urllib3.connection.VerifiedHTTPSConnection object at 0x7f2f031a4550>: 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`
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
#### Al reinciar el sistema, tarda más de un minuto en terminar.
|
||||||
|
|
||||||
|
<BR>
|
||||||
|
<div class="alert-box warning"><span>CUIDADO: </span>
|
||||||
|
Se muestra el contenido del archivo de la maquina virtual, puede ser diferente
|
||||||
|
si lo usas en tu propio servidor o VPS.
|
||||||
|
</div>
|
||||||
|
<BR>
|
||||||
|
|
||||||
|
* 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
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue