README.md

@@ -9,8 +9,11 @@ Install it
 ----------
 Be sure to use python3.
 
-    sudo apt-get install python virtualenvwrapper
-    mkvirtualenv transparency
+    sudo apt-get install python virtualenv
+    virtualenv transparency_venv
+    git clone https://code.ffdn.org/jocelyn/transparency
+    cd transparency
+    source ../transparency_venv/bin/activate
     pip install -r requirements.txt
 
 Generate a secret key:
@@ -19,18 +22,23 @@ Generate a secret key:
 
 Set your organization name :
 
-    echo 'ORGANISATION_NAME="ACME Charity"' >> transparency/local_settings.py
+    echo 'ORGANIZATION_NAME="ACME Charity"' >> transparency/local_settings.py
 
 Create database:
 
     ./manage.py migrate
 
+Create administrator account:
+
+    ./manage.py createsuperuser
+
 Run it
 ------
 
 Run development server
 
-    workon transparency
+    source ../transparency_venv/bin/activate # if it is not already done
+    echo 'DEBUG=True' >> transparency/local_settings.py
     ./manage.py runserver
 
 Use it

costs/admin.py

@@ -54,7 +54,7 @@ class DocumentAdmin(admin.ModelAdmin):
             edit_url = reverse('admin:costs_document_change', args=(new.pk,))
             self.message_user(
                 request, mark_safe(
-                    "{} copié, pensez à <a href=\"{}\">L'éditer</a>".format(
+                    "{} a été créé, en tant que brouillon, pensez à <a href=\"{}\">l'éditer</a>.".format(
                         new, edit_url)))
     copy.short_description = 'Copier'
 
@@ -87,7 +87,7 @@ class ServiceUseInline(AbstractUseInline):
 
 
 class DirectDocumentFilter(admin.SimpleListFilter):
-    title = 'Document'
+    title = 'Rapport'
 
     parameter_name = 'document'
 
@@ -167,8 +167,10 @@ class ServiceAdmin(admin.ModelAdmin):
 @admin.register(Good)
 class GoodAdmin(admin.ModelAdmin):
     list_filter = [DirectDocumentFilter]
+    exclude = ['description_html']
 
 
 @admin.register(Cost)
 class CostAdmin(admin.ModelAdmin):
     list_filter = [DirectDocumentFilter]
+    exclude = ['description_html']

costs/models.py

@@ -13,8 +13,8 @@ import markdown
 class Document(models.Model):
     """ A document is a scenario or a record from facts, on 1 month.
     """
-    TYPE_FACT = 'fact'
-    TYPE_PLAN = 'plan'
+    TYPE_PUBLIC = 'fact'
+    TYPE_DRAFT = 'plan'
 
     name = models.CharField('Nom', max_length=130)
     comment = models.TextField(
@@ -25,12 +25,13 @@ class Document(models.Model):
         default=datetime.datetime.now,
         help_text="Date de création du document")
     type = models.CharField(max_length=10, choices=(
-        (TYPE_FACT, 'rapport de transparence'),
-        (TYPE_PLAN, 'estimation ou étude'),
-    ))
+        (TYPE_PUBLIC, 'Rapport public'),
+        (TYPE_DRAFT, 'Rapport brouillon'),
+    ), help_text="Un rapport brouillon n'est pas visible publiquement")
 
     class Meta:
         ordering = ['-date']
+        verbose_name = 'Rapport'
 
     def __str__(self):
         return self.name
@@ -51,6 +52,7 @@ class Document(models.Model):
             new_doc = Document.objects.get(pk=self.pk)
             new_doc.pk = None
             new_doc.name = 'COPIE DE {}'.format(new_doc.name)
+            new_doc.type = Document.TYPE_DRAFT
             new_doc.save()
 
             new_services, new_costs, new_goods = {}, {}, {}

costs/templates/costs/document_detail.html

@@ -19,7 +19,7 @@
 {% if request.user.is_staff %}
 <a href="{% url 'admin:costs_document_change' document.id %}" class="item">
   <i class="edit icon"></i>
-    Éditer
+    Éditer dans l'admin
 </a>
 {% endif %}
 
@@ -41,13 +41,12 @@
 
 
 {% block content %}
-{% if document.type == document.TYPE_PLAN %}
+{% if document.type == document.TYPE_DRAFT %}
 <div class="ui yellow icon message">
       <i class="warning icon"></i>
       <div class="content">
         <p>
-          Ce document est un document de travail, exposant un scénario, et non
-un relevé.
+          Ce rapport est un brouillon, il n'est pas visible publiquement.
         </p>
       </div>
 </div>

costs/templates/costs/documents_list.html

@@ -25,7 +25,7 @@ Afin que tout un chacun puisse <strong>choisir son prix d'abonnement de manière
 <section class="ui row">
   <h2>Rapports de transparence</h2>
   <p class="ui text container">
-    Ces documents correspondent à des relevés effectués en début de chaque
+    Ces rapports correspondent à des relevés effectués en début de chaque
   mois, ils peuvent être utilisés comme base au calcul du <strong>prix
   libre</strong>.
   </p>
@@ -36,15 +36,11 @@ Afin que tout un chacun puisse <strong>choisir son prix d'abonnement de manière
     ({{ doc.service_set.count }} service{{ doc.service_set.count|pluralize }})
     </li>
     {% empty %}
-    <li>Pas de documents pour l'heure.</li>
+    <li>Pas de rapport pour l'heure.</li>
     {% endfor %}
   </ul>
 
-  <h2>Estimations et études</h2>
-  <p class="ui text container">
-    Ces documents ne sont pas issus de relevés mais servent d'outils pour
-  établir des budgets prévisionnels pour des services à venir.
-  </p>
+  <h2>Rapports brouillons</h2>
   <ul class="ui text container">
 {% for doc in planning_documents %}
     <li>
@@ -52,7 +48,7 @@ Afin que tout un chacun puisse <strong>choisir son prix d'abonnement de manière
     ({{ doc.date|date:"M Y" }}, {{ doc.service_set.count }} service{{ doc.service_set.count|pluralize }})
     </li>
     {% empty %}
-    <li>Pas de documents pour l'heure.</li>
+    <li>Pas de rapport pour l'heure.</li>
     {% endfor %}
   </ul>
 

costs/templates/costs/service_detail.html

@@ -11,7 +11,7 @@
 
     </div>
     <br>
-  {% if document.type == document.TYPE_PLAN %}
+  {% if document.type == document.TYPE_DRAFT %}
   <a class="ui label orange" title="Ce document se base sur des estimations">
     {{ document.get_type_display }}
   </a>

costs/views.py

@@ -20,7 +20,7 @@ def format_to_content_type(_format):
 @login_required
 def list_documents(request):
     breadcrumbs = (
-        ('Documents', reverse('list-documents')),
+        ('Rapports', reverse('list-documents')),
     )
     docs = Document.objects.all()\
                            .prefetch_related('service_set')\
@@ -29,8 +29,8 @@ def list_documents(request):
     return render(
         request, 'costs/documents_list.html', {
             'documents': docs,
-            'planning_documents': docs.filter(type=Document.TYPE_PLAN),
-            'factual_documents': docs.filter(type=Document.TYPE_FACT),
+            'planning_documents': docs.filter(type=Document.TYPE_DRAFT),
+            'factual_documents': docs.filter(type=Document.TYPE_PUBLIC),
             'breadcrumbs': breadcrumbs,
         })
 
@@ -40,7 +40,7 @@ def detail_document(request, pk):
     doc = get_object_or_404(Document, pk=pk)
 
     breadcrumbs = (
-        ('Documents', reverse('list-documents')),
+        ('Rapports', reverse('list-documents')),
         (str(doc), doc.get_absolute_url())
     )
     return render(
@@ -63,7 +63,7 @@ def compare_document(request, pk, other_pk):
     other_doc = Document.objects.get(pk=other_pk)
 
     breadcrumbs = (
-        ('Documents', reverse('list-documents')),
+        ('Rapports', reverse('list-documents')),
         (str(doc), doc.get_absolute_url()),
         ('Variations depuis {}'.format(other_doc), request.path),
     )
@@ -89,7 +89,7 @@ def detail_service(request, pk):
 
     doc = service.document
     breadcrumbs = (
-        ('Documents', reverse('list-documents')),
+        ('Rapports', reverse('list-documents')),
         (str(doc), doc.get_absolute_url()),
         (service.name, service.get_absolute_url())
     )

publicsite/templates/publicsite/public_document_detail.html

@@ -21,8 +21,10 @@
     {% endfor %}
       </tbody>
     </table>
-    <a href="{% url "detail-document" pk=document.pk %}">Coûts détaillés</a>
-(adhérents seulement).
+    {% if document %}
+      <a href="{% url "detail-document" pk=document.pk %}">Coûts détaillés</a>
+      (adhérents seulement).
+    {% endif %}
   </section>
 
   <section class="column">

publicsite/views.py

@@ -4,7 +4,7 @@ from costs.models import Document
 
 def public_document_detail(request, pk=None):
     docs = Document.objects\
-                   .filter(type=Document.TYPE_FACT)\
+                   .filter(type=Document.TYPE_PUBLIC)\
                    .order_by('-date')
 
     if pk is None: