Adiciona explicações sobre o funcionamento da migração 0007_adiciona_partidos.py

Signed-off-by: Eliseu Egewarth <eliseuegewarth@gmail.com>

sapl/parlamentares/migrations/0007_20170831_1604.py → sapl/parlamentares/migrations/0007_adiciona_partidos.py

@@ -10,16 +10,17 @@ from django.core.management import call_command
 
 
 def gera_partidos_tse(apps, schema_editor):
-    # We get the model from the versioned app registry;
-    # if we directly import it, it'll be the wrong version
     Partido = apps.get_model("parlamentares", "Partido")
     db_alias = schema_editor.connection.alias
     partidos = Partido.objects.all().exists()
 
     if partidos:
+        # Caso haja algum partido cadastrado na base de dados,
+        # a migração não deve ser carregada para evitar duplicações de dados.
         print("Carga de Partido não efetuada. Já Existem partidos cadastrados...")
     else:
         fixture_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '../fixtures'))
+        # pega partidos listados em fixtures/pre_popula_partidos.json
         fixture_filename = 'pre_popula_partidos.json'
         fixture_file = os.path.join(fixture_dir, fixture_filename)
         call_command('loaddata', fixture_file)
@@ -27,6 +28,10 @@ def gera_partidos_tse(apps, schema_editor):
 class Migration(migrations.Migration):
 
     dependencies = [
+        # A dependencia real desse script é o arquivo 0001_initial.py, mas
+        # isso gera um erro (Conflicting migrations detected; multiple leaf
+         # nodes in the migration graph). para não  ocasionar problemas de migração,
+         # vamos manter a ordem padrão do django.
         ('parlamentares', '0006_auto_20170831_1400'),
     ]