docs: пояснения почему выбрана такая логика (reasoning)

api/dtc.py

@@ -37,7 +37,12 @@ def register(app):
 
     @app.route("/api/v1/dtc/decode", methods=["POST"])
     def dtc_decode():
-        """Расшифровка кодов DTC из справочника."""
+        """Расшифровка кодов DTC из справочника doc/dtc_codes.txt.
+
+        Принимает: {"codes": ["P0301", "P0302"]}
+        Возвращает: {"codes": [{"code": "P0301", "desc": "..."}]}
+        Неизвестные коды возвращаются как есть — справочник неполный.
+        """
         data = request.get_json(silent=True) or {}
         codes = data.get("codes", [])
         if not codes:
@@ -48,7 +53,13 @@ def register(app):
 
     @app.route("/api/v1/dtc/upload", methods=["POST"])
     def dtc_upload():
-        """Приём кодов ошибок (без полной диагностики)."""
+        """Приём кодов ошибок (без полной диагностики, только Ошибки).
+
+        Идемпотентность: если client шлёт request_id, сервер:
+          1. Проверяет кэш — если есть, возвращает его (LLM не вызывается)
+          2. Если нет — сохраняет, кэширует ответ
+        Это предотвращает дубликаты при повторных отправках (например, 499).
+        """
         data = request.get_json(silent=True)
         if not data:
             return jsonify({"error": "empty"}), 400