| """ |
| tools/tckn_tool.py — TCKN Doğrulama Aracı |
| |
| AGENTIC PATTERN: Tool Use |
| ━━━━━━━━━━━━━━━━━━━━━━━━ |
| @tool decorator ile LangChain/LangGraph'a kayıt edilir. |
| Agent, "bu TCKN geçerli mi?" sorusunu cevaplamak için |
| bu tool'u çağırır. LLM kendi başına checksum hesaplamaz; |
| sadece hangi tool'u çağıracağına karar verir. |
| |
| Algoritma: Türk TC Kimlik No mod-11 doğrulama standardı |
| - 11 haneli, ilk hane 0 olamaz |
| - 10. hane: (d1+d3+d5+d7+d9)*7 - (d2+d4+d6+d8) mod 10 |
| - 11. hane: (d1+d2+...+d10) mod 10 |
| |
| API çağrısı YOK — tamamen deterministik, senkron. |
| """ |
| from langchain_core.tools import tool |
|
|
|
|
| @tool |
| def validate_tckn(tckn: str) -> dict: |
| """ |
| Türk TC Kimlik Numarasını mod-11 algoritmasıyla doğrular. |
| |
| Args: |
| tckn: Doğrulanacak TCKN (11 hane, string) |
| |
| Returns: |
| {"valid": bool, "error": str | None, "masked": str} |
| """ |
| |
| tckn = tckn.strip().replace(" ", "").replace("-", "") |
|
|
| |
| if not tckn.isdigit(): |
| return {"valid": False, "error": "TCKN yalnızca rakamlardan oluşmalı.", "masked": ""} |
| if len(tckn) != 11: |
| return {"valid": False, "error": f"TCKN 11 hane olmalı, {len(tckn)} hane girildi.", "masked": ""} |
| if tckn[0] == "0": |
| return {"valid": False, "error": "TCKN 0 ile başlayamaz.", "masked": ""} |
|
|
| digits = [int(c) for c in tckn] |
|
|
| |
| check10 = ((sum(digits[i] for i in range(0, 9, 2)) * 7) - sum(digits[i] for i in range(1, 8, 2))) % 10 |
| if digits[9] != check10: |
| return {"valid": False, "error": "TCKN doğrulama hatası (10. hane).", "masked": _mask(tckn)} |
|
|
| |
| check11 = sum(digits[:10]) % 10 |
| if digits[10] != check11: |
| return {"valid": False, "error": "TCKN doğrulama hatası (11. hane).", "masked": _mask(tckn)} |
|
|
| return {"valid": True, "error": None, "masked": _mask(tckn)} |
|
|
|
|
| def _mask(tckn: str) -> str: |
| """TCKN'nin ortasını gizler: 123****8901 formatında döner.""" |
| if len(tckn) != 11: |
| return "***" |
| return tckn[:3] + "****" + tckn[7:] |
|
|
