docs: архитектурный анализ + History + gitignore (2026-06-27)

testgen/templates.py

@@ -11,7 +11,7 @@ build_addendum(ctx)   — Дополнительное соглашение
 """
 
 from docx import Document
-from docx.shared import Pt, Cm, RGBColor
+from docx.shared import Pt, Cm
 from docx.enum.text import WD_ALIGN_PARAGRAPH
 from docx.enum.table import WD_TABLE_ALIGNMENT
 import pools
@@ -20,14 +20,6 @@ import pools
 # Хелперы
 # ═══════════════════════════════════════════════════════════════
 
-def _comment_para(doc, text):
-    """Добавить параграф-комментарий в начало документа (серый, мелкий)."""
-    p = doc.add_paragraph()
-    p.alignment = WD_ALIGN_PARAGRAPH.LEFT
-    run = p.add_run(text)
-    run.font.size = Pt(8)
-    run.font.color.rgb = RGBColor(0x80, 0x80, 0x80)
-    run.font.italic = True
 
 def _add_title(doc, text):
     p = doc.add_paragraph()
@@ -111,13 +103,7 @@ def build_contract(ctx):
     num = ctx["number"]
     date = ctx["date"]
 
-    # ── Комментарий для тестов ──
-    _comment_para(doc, (
-        f"Данный файл: ДОГОВОР, компания {c['prefix']}, № {num} от {date}.\n"
-        f"Стороны: {c['legal']} (Заказчик) + {pools.PROVIDER} (Исполнитель).\n"
-        f"Сгенерирован автоматически для тестирования сервиса contracts.\n"
-        f"{ctx.get('comment','')}"
-    ))
+    # ── Комментарий в manifest.json, не в документе ──
 
     _add_title(doc, "Договор на оказание технологических услуг")
     _add_para(doc, f"№ {num}")
@@ -183,13 +169,6 @@ def build_spec(ctx):
     contract_date = ctx.get("contract_date", date)
     ver = ctx.get("version", 1)
 
-    _comment_para(doc, (
-        f"Данный файл: СПЕЦИФИКАЦИЯ v{ver}, компания {c['prefix']}, к договору № {num} от {contract_date}.\n"
-        f"Версия {ver}: {'базовая' if ver == 1 else 'ревизия с изменениями'}.\n"
-        f"Содержит: {len(ctx['services'])} строк(и) услуг, итого {ctx['total_str']} руб.\n"
-        f"{ctx.get('comment','')}"
-    ))
-
     _add_title(doc, f"Приложение № 1")
     _add_para(doc, f"к Договору на оказание технологических услуг № {num} от {contract_date} г.")
     _add_para(doc, "")
@@ -225,13 +204,6 @@ def build_addendum(ctx):
     contract_date = ctx.get("contract_date", date)
     anum = ctx.get("addendum_num", 1)
 
-    _comment_para(doc, (
-        f"Данный файл: ДОПОЛНИТЕЛЬНОЕ СОГЛАШЕНИЕ №{anum}, компания {c['prefix']}, к договору № {num} от {contract_date}.\n"
-        f"Содержит: инсталляционные услуги ({len(ctx.get('services_install',[]))} стр.), "
-        f"абонентские услуги ({len(ctx.get('services_monthly',[]))} стр.).\n"
-        f"{ctx.get('comment','')}"
-    ))
-
     _add_title(doc, f"Дополнительное Соглашение №{anum}")
     _add_para(doc, f"к Договору № {num} от {contract_date}")
     _add_para(doc, f"{pools.CITY}    «{date.split('.')[0]}» {_month_name(int(date.split('.')[1]))} {date.split('.')[2]}")