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
|
||||
|
||||
|
||||
<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