============ Sistema ANSP ============

Sistema de gerenciamento de projetos Fapesp desenvolvido pelo NARA/ANSP. É um conjunto de aplicações Django para gerenciar concessões e gastos de um projeto Fapesp.

Instalação

1. Instale os pacotes de desenvolvimento do python, xml, ffi, xslt, zlib e yaml, o pacote de fontes liberation e o pip para instalar pacotes python. No caso do Ubuntu, seria:

apt-get install libffi-dev libpython-dev libxml2-dev libxslt1-dev zlib1g-dev libyaml-dev fonts-liberation python-pip

2. Instale o virtualenv:

   pip install virtualenv
   

3. Crie o ambiente virtual:

   virtualenv <nome do ambiente>
   

4. Entre no diretório do ambiente virtual e ative-o:

   cd <nome do ambiente>
   source bin/activate
   

5. Instale o django-arquea:

   pip install django-arquea
   

Configuração

1. Crie um novo projeto Django:

   django-admin startproject <nome do projeto>
   

2. Adicione a seguinte linha no final seu settings.py:

   cd <nome do projeto>
   vi <nome do projeto>/settings.py
   INSTALLED_APPS += ('configuracao',)
   

3. Crie as configurações padrão:

   python manage.py criarsistema <nome do projeto>
   

4. Execute

   python manage.py migrate
   

   para criar a base de dados inicial e

   python manage.py loaddata initial_data.yaml
   

   para carregar os dados iniciais.

5. Execute

   python manage.py createsuperuser
   

   para criar o super usuário inicial.

6. Execute

   python manage.py runserver
   

   e acesse http://localhost:8000 para verificar se a aplicação está rodando.

Colocando em produção

1. Estando tudo ok nas etapas anteriores, é hora de colocar em produção. Por padrão, é criada uma base de dados SQLite, que é ótima para testes, mas não é muito indicada para um ambiente de produção. Recomendamos utilizar o PostgreSQL ou o MySQL. Mostraremos como instalar e configurar o PostgreSQL no Ubuntu.

1. Instale a biblioteca de desenvolvimento do PostgreSQL:

   apt-get install libpq-dev
   

2. Instale o servidor do PostgreSQL:

   apt-get install postgresql
   

3. Crie a base de dados:

   sudo su - postgres
   createdb <base>
   createuser <user>
   psql <base>
   grant all on database <base> to <user>;
   alter user <user> password '<pass>';
   quit
   CTRL+D
   

4. Repita o passo 4 de "Instalação" e instale o psycopg:

   pip install psycopg2
   

5. Edite o arquivo settings.py e altere as informações do banco de dados:

   cd <nome do projeto>
   vi <nome do projeto>/settings.py
   
   DATABASES = {
       'default': {
       'ENGINE': 'django.db.backends.postgresql_psycopg2',
       'HOST': 'localhost', # se instalar o servidor em outra máquina, ip ou hostname dele
       'NAME': '<base>',
       'USER': '<user>',
       'PASSWORD': '<pass>'
       }
   }
   

6. Execute os passos 4 e 5 de "Configuração".

7. Execute o passo 6 de "Configuração" para verificar se com o PostgreSQL tudo continua funcionando.

2. Para colocarmos em produção, precisamos de um webserver. Abaixo, é utilizado o Apache + WSGI, mas pode ser feito de outras maneiras, como descrito em https://docs.djangoproject.com/en/1.7/howto/deployment/ .

1. Instale o apache2, o mod_wsgi;

2. Habilite esses módulos;

3. Configure o apache. Considerando que o sistema rodará sozinho na máquina, a configuração seria apenas modificar o arquivo /etc/apache2/sites-available/000-default:

   WSGIScriptAlias / /path/to/your/project/project/wsgi.py
   WSGIPythonPath /path/to/your/project/project:/virtualenv/dir/lib/python2.7/site-packages
   <VirtualHost *:80>
   
           WSGIProcessGroup %{GLOBAL}
           WSGIApplicationGroup %{GLOBAL}
   
           Alias /files/   /var/www/files/
           Alias /static/  /var/www/static/
   
           <Directory /var/www/static>
              Require all granted
           </Directory>
   
           <Directory /var/www/files>
              Require all granted
           </Directory>
   
           <Directory /path/to/your/project/project>
              <Files wsgi.py>
                 Require all granted
              </Files>
           </Directory>
   
           <Location "/files">
              AuthType Basic
              AuthName "Sistema"
              Require valid-user
              AuthBasicProvider wsgi
              WSGIAuthUserScript /path/to/your/project/project/wsgi.py
           </Location>
   
           ErrorLog ${APACHE_LOG_DIR}/error.log
           CustomLog ${APACHE_LOG_DIR}/access.log combined
   </VirtualHost>
   

   trocando os diretórios e arquivos informados pelos da sua instalação

4. Execute, no diretório do projeto:

   python manage.py collectstatic