1 | Documentación |
---|
2 | === |
---|
3 | |
---|
4 | |
---|
5 | ## Simulador Integral de Cadenas Productivas |
---|
6 | |
---|
7 | _____ ______________ |
---|
8 | / ___// _/ ____/ __ \ |
---|
9 | \__ \ / // / / /_/ / |
---|
10 | ___/ // // /___/ ____/ |
---|
11 | /____/___/\____/_/ |
---|
12 | |
---|
13 | |
---|
14 | |
---|
15 | |
---|
16 | El __Simulador Integral de Cadenas Productivas (SICP)__ le permite modelar y simular las cadenas productivas desde |
---|
17 | distintas fuentes de datos como son: El [Sistema de Gestión para la Industria y Comercio (SIGESIC)] |
---|
18 | (https://sigesic.mppi.gob.ve/), La [Encuesta Industrial] |
---|
19 | (http://www.ine.gob.ve/index.php?option=com_content&id=347&Itemid=36&view=article) y la [Matriz Insumo / Producto] |
---|
20 | (http://www.bcv.org.ve/cuadros/series/mip97/mip97.asp?id=425), con el objetivo de suministrar |
---|
21 | información sistematizada acerca de la estructura industrial del pais y las características (flujo de entrada y salida |
---|
22 | de bienes) de un sector productivo y/o empresa en particular. |
---|
23 | |
---|
24 | ## Licencia |
---|
25 | |
---|
26 | __SICP__, sus carpetas y archivos, se disribuye bajo la Licencia de Software Libre GNU/GPL versión 2, esto implica que |
---|
27 | el usuario final de la aplicación esta en la libertad de ejecutarla, modificar su código fuente, copiarla y/o |
---|
28 | distribuírla, siempre y cuando al hacerlo se citen las fuentes originales de ésta aplicación. |
---|
29 | |
---|
30 | Para obtener mayor información en torno a los términos de la licencia bajo los cuales se distribuye la |
---|
31 | aplicación, lea con atención la [GPLv2](http://www.gnu.org/licenses/gpl-2.0.html). |
---|
32 | |
---|
33 | Así mismo, las librerías y apis de terceros implementadas en esta aplicación, se distribuyen con sus respectivas |
---|
34 | licencias y acuerdos particulares de cada una especificadas en los archivos de esas librerías. |
---|
35 | |
---|
36 | ## Pre-requisitos |
---|
37 | |
---|
38 | Para el correcto funcionamiento del __SICP__ se requiere tener instalado previamente los siguientes paquetes: |
---|
39 | |
---|
40 | // Paquetes del Sistema Operativo |
---|
41 | PostgreSQL 9.x |
---|
42 | Python >= 2.7 < 3.0 |
---|
43 | PIP >= 1.5.4 |
---|
44 | librsvg2-bin >= 2.40.2 |
---|
45 | libxml++ |
---|
46 | |
---|
47 | // Paquetes de Python |
---|
48 | Django >= 1.8 < 1.9 |
---|
49 | django-suit == 0.2.13 |
---|
50 | Pillow >= 2.8.1 |
---|
51 | django-simple-captcha >= 0.4.5 |
---|
52 | psycopg2 >= 2.6 |
---|
53 | reportlab >= 3.2.0 |
---|
54 | |
---|
55 | ## Proceso de instalación |
---|
56 | |
---|
57 | En el proceso de instalación sobre los requerimientos y herramientas necesarias para el correcto funcionamiento del |
---|
58 | sistema, se deben ejecutar algunas instrucciones desde la consola de comando para lo cual se requiere abrir una terminal |
---|
59 | y ejecutar los siguientes comandos: |
---|
60 | |
---|
61 | // Para distribuciones ubuntu |
---|
62 | ~$ sudo su - |
---|
63 | |
---|
64 | // Para distribuciones debian |
---|
65 | ~$ su - |
---|
66 | |
---|
67 | Lo anterior solicitara la contraseña de administrador del sistema operativo para acceder al usuario root, esto es |
---|
68 | necesario para los procesos de instalación posteriores de la aplicación. |
---|
69 | |
---|
70 | Una vez autenticados como usuario root del sistema operativo, mostrará en la consola el símbolo "#" que identifica que |
---|
71 | el usuario actual es root, esto permitirá instalar en el sistema operativo los requerimientos de funcionamiento del |
---|
72 | sistema para lo cual se ejecutarán los comandos detallados a continuación: |
---|
73 | |
---|
74 | // Instalación de paquetes del sistema operativo |
---|
75 | ~# apt-get install postgresql python2.7 python-pip |
---|
76 | |
---|
77 | // Instalación de paquetes del sistema operativo necesarios para la compilación de los requerimientos |
---|
78 | ~# apt-get install build-essential autoconf libtool pkg-config python-opengl python-imaging python-pyrex python-pyside.qtopengl idle-python2.7 qt4-dev-tools qt4-designer libqtgui4 libqtcore4 libqt4-xml libqt4-test libqt4-script libqt4-network libqt4-dbus python-qt4 python-qt4-gl libgle3 python-dev libpq-dev |
---|
79 | |
---|
80 | // Instalación de paquetes de python (se debe acceder a la ruta principal del proyecto sicp) |
---|
81 | ~# pip install -r requerimientos/comun.txt |
---|
82 | |
---|
83 | Esto ejecutara los distintos procesos de instalación sobre los requerimientos del sistema. |
---|
84 | |
---|
85 | Posteriormente se debe crear la base de datos del __SICP__ y el correspondiente usuario que tendrá los privilegios |
---|
86 | necesarios para interactuar con la misa, esto se hace de la siguiente forma: |
---|
87 | |
---|
88 | // Acceso al usuario postgres |
---|
89 | ~# su postgres |
---|
90 | |
---|
91 | // Acceso a la interfaz de comandos de postgresql |
---|
92 | postgres@xxx:$ psql template1 |
---|
93 | |
---|
94 | // Creación del usuario de a base de datos |
---|
95 | temlate1=# CREATE USER nombre_usuario_bd WITH ENCRYPTED PASSWORD 'contraseña' createdb; |
---|
96 | temlate1=# \q |
---|
97 | |
---|
98 | // Desautenticar el usuario postgres y regresar al usuario root |
---|
99 | postgres@xxx:$ exit |
---|
100 | |
---|
101 | // Creación de la base de datos |
---|
102 | ~# createdb nombre_bd -E 'UTF-8' -O nombre_usuario_bd -h localhost -p 5432 -U nombre_usuario_bd |
---|
103 | |
---|
104 | // Salir del usuario root |
---|
105 | ~# exit |
---|
106 | |
---|
107 | |
---|
108 | ## Configuración y ejecución de la aplicación |
---|
109 | |
---|
110 | Una vez instalados todos los requerimientos previos del sistema, se procede a la configuración del mismo, para esto se |
---|
111 | debe editar el archivo settings.py dentro de la carpeta sicp y modificar los datos por defecto de la variable DATABASES, |
---|
112 | en donde se especificarán los datos de acceso a las bases de datos de la aplicación y del sigesic. |
---|
113 | |
---|
114 | Al tener ya configurado los parámetros de acceso a la base de datos, se ejecutan los siguiente comandos: |
---|
115 | |
---|
116 | // Para construir las migraciones de la base de datos en caso de que no existan |
---|
117 | |
---|
118 | ~$ python manage.py makemigrations |
---|
119 | |
---|
120 | // Para crear la estructura de la base de datos |
---|
121 | |
---|
122 | ~$ python manage.py migrate |
---|
123 | |
---|
124 | Lo anterior crea la estructura de la base de datos e incorpora los registros básicos de la aplicación. |
---|
125 | |
---|
126 | Para ejecutar la aplicación en modo de desarrollo, se debe ejecutar el siguiente comando: |
---|
127 | |
---|
128 | ~$ python manage.py runserver |
---|
129 | |
---|
130 | Lo anterior ejecutará el servidor de desarrollo de django bajo la URL [http://localhost:8000](http://localhost:8000), |
---|
131 | para lo cual deberemos acceder a un navegador web y escribir dicha dirección URL. |
---|
132 | |
---|
133 | |
---|
134 | ## Documentación |
---|
135 | |
---|
136 | Para acceder a la documentación del sistema, en donde se especifican las clases, funciones, atributos y métodos |
---|
137 | utilizados en la aplicación, debe abrir el archivo index.html ubicado en static/docs/sistema |
---|
138 | |
---|