!#59 Add: settings docs

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = python -msphinx
+SPHINXPROJ    = Python-Facebook-Chatbot
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_templates/links.rst

@@ -0,0 +1,82 @@
+.. _Rest: http://es.wikipedia.org/wiki/Representational_State_Transfer
+.. AWS
+.. _ssh: https://en.wikipedia.org/wiki/Secure_Shell
+.. _aws route53: https://aws.amazon.com/route53/
+.. _aws elasticache: https://aws.amazon.com/elasticache/
+.. _aws rds: https://aws.amazon.com/rds/
+.. _aws sqs: https://aws.amazon.com/sqs/
+.. _aws dynamodb: https://aws.amazon.com/dynamodb/
+.. _aws elb: https://aws.amazon.com/elasticloadbalancing
+.. _aws cloudfront: https://aws.amazon.com/cloudfront/
+.. _aws s3: https://aws.amazon.com/s3/
+.. _aws ec2: https://aws.amazon.com/ec2/
+
+.. code developer
+.. _cloud computing: https://en.wikipedia.org/wiki/Cloud_computing
+.. _git: https://git-scm.com/
+.. _repositorio: https://bitbucket.org/lapositivatd/python-facebook-chatbot
+.. _company: https://bitbucket.org/lapositivatd
+.. _Python 3.6.0: https://www.python.org/downloads/release/python-360
+.. _Docker: https://www.docker.com/
+.. _Docker Compose: https://docs.docker.com/compose
+.. _Django: https://www.djangoproject.com/
+
+.. Referencias
+
+.. _La positiva: https://www.lapositiva.com.pe/
+.. _medium.com: https://medium.com
+.. _airbnb: https://www.airbnb.com/
+.. _spotify: https://www.spotify.com/
+.. _dropbox: https://www.dropbox.com
+
+.. Tecnologies
+.. _webhook: https://en.wikipedia.org/wiki/Webhook
+.. _IoT: https://en.wikipedia.org/wiki/Internet_of_things
+.. _DynamoDB: https://aws.amazon.com/dynamodb/
+.. _PostgreSQL: https://www.postgresql.org
+.. _RabbitMQ: http://www.rabbitmq.com
+.. _Supervisor: http://supervisord.org/index.html
+.. _Redis: http://redis.io
+.. _ApacheSolr: http://lucene.apache.org/solr
+.. _Vagrant: http://www.vagrantup.comhttp://bundler.io/
+.. _GitHub: https://github.com
+.. _Bitbucket: https://bitbucket.org
+.. _Terraform: https://www.terraform.io/
+.. _Wercker: https://www.wercker.com/
+
+
+.. Security
+
+.. _oauth2: https://oauth.net/2/
+
+.. Extensiones
+
+.. Autores
+
+.. Web Framework
+
+.. Librerias
+
+.. Gestor de Dependencias
+
+.. Packages Python
+
+.. Standard code
+
+.. _PEP 8: https://www.python.org/dev/peps/pep-0008/
+.. _PEP 257: https://www.python.org/dev/peps/pep-0257/
+
+.. Tools Development
+
+.. _Pre Commit: https://github.com/observing/pre-commit
+.. _shellcheck: https://github.com/koalaman/shellcheck
+.. _pyenv: https://github.com/pyenv/pyenv
+.. _tmuxinator: https://github.com/tmuxinator/tmuxinator
+.. _Gherkin: https://github.com/cucumber/cucumber/wiki/Gherkin
+.. _Behave: http://pythonhosted.org/behave/
+
+..
+   Servicios Cloud
+.. _Azure: https://azure.microsoft.com/en-us/
+.. _Google Cloud Platform: https://cloud.google.com
+.. _AWS: https://aws.amazon.com

docs/architecture/componentes/Api.rst

@@ -0,0 +1,29 @@
+Api
+***
+
+
+`AWS Route53`_
+==============
+
+AWS CloudFront
+==============
+
+AWS S3
+======
+
+AWS ELB Elastic Load Balancer (ELB)
+===================================
+
+
+AWS SQS
+=======
+
+
+AWS DynamoDB
+============
+
+
+.. include:: ../../_templates/links.rst
+
+
+.. rubric:: Footnotes

docs/architecture/componentes/WebHooks.rst

@@ -0,0 +1,15 @@
+WebHooks
+********
+
+Aws ApiGateWay
+==============
+
+
+Aws Lambda
+==========
+
+
+.. include:: ../../_templates/links.rst
+
+
+.. rubric:: Footnotes

docs/architecture/componentes/index.rst

@@ -0,0 +1,9 @@
+Componentes
+***********
+
+.. toctree::
+
+   Api
+   WebHooks
+
+.. include:: ../../_templates/links.rst

docs/architecture/consideraciones.rst

@@ -0,0 +1,5 @@
+Consideraciones
+===============
+
+
+.. include:: ../_templates/links.rst

docs/architecture/despliegue.rst

@@ -0,0 +1,90 @@
+Despliegue
+**********
+
+El despliegue de los componentes se encuentra claramente definido en la
+siguiente imagen:
+
+
+.. uml::
+
+  left to right direction
+
+  actor Admin
+  node "Laptop"
+  component "Terraform"
+  component "ansible"
+  artifact "Inventory"
+  artifact "playbook"
+  cloud AWS
+  node Application
+  node ActiveMQ
+  node Other1
+  [Admin] --> [Laptop]
+  [Laptop] --> [Terraform]
+  [Terraform] --> [ansible]
+  [ansible] <- [Inventory]
+  [ansible] <- [playbook]
+  [ansible] -- [AWS]
+  [AWS] -- [Application]
+  [AWS] -- [ActiveMQ]
+  [AWS] -- [Other1]
+
+Pasos
+=====
+
+Orquestar servicios:
+--------------------
+
+.. code-block:: bash
+
+  λ terraform init
+  λ make decrypt_vars env=stage
+  λ terraform apply
+  λ make encrypt_vars env=stage
+
+Orquestar Servidores:
+---------------------
+
+.. code-block:: bash
+
+  λ make ansible_provision env=stage
+  λ make ansible_deploy env=stage
+
+Orquestar Servidores:
+---------------------
+
+.. code-block:: bash
+
+  λ make ansible_provision env=stage
+  λ make ansible_deploy env=stage
+
+Desplegar Aplicacion
+--------------------
+
+.. code-block:: bash
+
+  λ make ansible_deploy_tags env=stage tags=deployment
+
+Admin
+=====
+
+
+Laptop
+======
+
+Terraform
+=========
+
+Ansible
+=======
+
+Inventory
+---------
+
+Playbook
+--------
+
+
+.. rubric:: Notas
+
+.. include:: ../_templates/links.rst

docs/architecture/index.rst

@@ -0,0 +1,28 @@
+Arquitectura
+************
+
+Para diseñar la arquitectura se tomó como referencia modelos ya existentes como:
+- `medium.com`_
+- `airbnb`_
+- `spotify`_
+- `dropbox`_
+
+la intención de utilizar un modelo existente,
+es que podremos tomarlos como referencia no sólo en términos de arquitectura,
+sino también en el desarrollo ya que muchos de los componentes utilizados
+han sido liberados por sus desarrolladores.
+
+En primer lugar se establece el uso `PostgreSQL`_
+como el principal origen de datos y de acuerdo a lo presentado en los
+:doc:`requerimientos <../requirements/index>`
+
+.. toctree::
+
+   objetivos
+   consideraciones
+   componentes/index
+   despliegue
+   integracion
+   pendientes
+
+.. include:: ../_templates/links.rst

docs/architecture/integracion.rst

@@ -0,0 +1,4 @@
+Integración
+===========
+
+.. include:: ../_templates/links.rst

docs/architecture/objetivos.rst

@@ -0,0 +1,5 @@
+Objetivos
+=========
+
+
+.. include:: ../_templates/links.rst

docs/architecture/pendientes.rst

@@ -0,0 +1,2 @@
+Pendientes
+**********