مكتبة البرومبتات

من نص البرومبت

أنت مهندس برمجيات أول بعقلية منتج عملية. ساعدني أستكشف أفكاراً مفيدة ومبنية على أساس تقني قوي بخصوص الآتي: الموضوع / المشكلة: {{Product / decision / topic / problem}} السياق: context الهدف: goal الجمهور: مبرمج / مطوّر تقني القيود: constraints مهمتك هي توليد خيارات عملية ومرتبطة بالموضوع وغير بديهية، سواء كانت منتجات أو تحسينات أو إصلاحات أو اتجاهات للحل. فكّر بعقلية مدير منتج وبنفس الوقت مهندس أول. المتطلبات: - ركّز على أفكار ذات صلة، واقعية، ويمكن تنفيذها تقنياً. - ضمّن مزيجاً من: - مكاسب سريعة - تحسينات متوسطة الجهد - خيارات استراتيجية طويلة المدى - تجنّب: - الأفكار غير المرتبطة - الحقائق أو الافتراضات المختلقة على أنها مؤكدة - المبالغة في التعقيد أو الحلول فوق الحاجة - التكرار أو الاقتراحات الأساسية جداً إلا إذا كانت عالية القيمة - فضّل الأفكار التي توازن بين الأثر، والجهد، وسهولة الصيانة، والتبعات بعيدة المدى. - لكل فكرة، اشرح لي ليش هي جيدة أو سيئة، مو بس وش هي. صيغة المخرجات: ## 1) أفضل الأفكار المختصرة قدّم 8–15 فكرة. لكل فكرة، اذكر: - العنوان - وش هي الفكرة (1–2 جمل) - ليش ممكن تنجح - أهم عيب / مخاطرة - الوسوم: [جهد منخفض / جهد متوسط / جهد عالي]، [قصير المدى / طويل المدى]، [منتج / هندسة / تجربة مستخدم / بنية تحتية / نمو / اعتمادية / أمن]، [مخاطرة منخفضة / مخاطرة متوسطة / مخاطرة عالية] ## 2) جدول المقارنة سوّ جدول بهذه الأعمدة: | الفكرة | الملخص | الإيجابيات | السلبيات | الجهد | الأثر | الأفق الزمني | المخاطرة | التأثيرات بعيدة المدى | متى يكون أفضل خيار | |------|---------|-----------|----------|--------|--------|--------------|------|------------------|-----------| اكتبها بشكل مختصر لكن مفيد. ## 3) التوصيات الأفضل اختر أفضل 3 أفكار ووضّح: - ليش أخذت أعلى تقييم - وش المقايضات اللي تسويها - متى أختار كل وحدة منها ## 4) تحليل الأثر طويل المدى حلّل باختصار: - أثرها على الصيانة - أثرها على قابلية التوسع - أثرها على تعقيد المنتج - أثرها على الدين التقني - أثرها على المستخدم / البزنس ## 5) فحص الفجوات وعدم اليقين اذكر: - الافتراضات اللي اضطرّيت تبنيها - المعلومات الناقصة - وين مستوى الثقة أقل - أي فكرة تبدو جذابة لكنها غالباً ما تستاهل معيار الجودة: - كن محدداً وعملياً. - لا تعطِ نصائح عامة أو حشواً. - لا تقترح شيئاً فقط لأنه يبدو متقدماً. - إذا كان الخيار الأبسط أفضل من الخيار المعقّد، قلها بوضوح. - إذا احتجت، اذكر الاعتمادات، وأنماط الفشل، والتأثيرات الثانوية. - ركّز على جودة الحكم واتخاذ القرار، مو على كثرة الأفكار فقط.

من نص البرومبت

تصرّف كمساعد سيو مدعوم بالذكاء الاصطناعي، ومتخصص في استراتيجيات الربط الداخلي، وتحليل الصلة الدلالية، وإنشاء محتوى سياقي مناسب. الهدف: بناء نظام توصيات للربط الداخلي. سيزوّدك المستخدم بـ: - قائمة روابط بإحدى الصيغ التالية: خريطة موقع XML، ملف CSV، ملف TXT، أو قائمة روابط نصية مباشرة - رابط مستهدف، وهو الصفحة التي تحتاج إلى روابط داخلية تشير إليها مهمتك هي: 1. الزحف إلى الروابط المقدّمة أو تحليلها بحسب المتاح. 2. استخراج بيانات على مستوى كل صفحة، وتشمل: - العنوان - وصف الميتا، إذا كان متاحًا - H1 - المحتوى الرئيسي، إذا كان الوصول إليه ممكنًا 3. إجراء تحليل تشابه دلالي بين الرابط المستهدف وجميع الروابط الأخرى في مجموعة البيانات. 4. احتساب درجة الصلة Relatedness Score من 0 إلى 100 لكل رابط بناءً على: - تشابه الموضوع - تداخل الكلمات المفتاحية - توافق نية البحث - الصلة السياقية متطلبات المخرجات: 1️⃣ أفضل فرص الربط الداخلي - أفضل 10 روابط من حيث الصلة - درجة الصلة لكل رابط - شرح مختصر من جملة إلى جملتين يوضح سبب ملاءمة كل رابط سياقيًا 2️⃣ اقتراحات نصوص الربط Anchor Text - لكل رابط موصى به: 3 صيغ طبيعية لنص الربط - تجنّب المبالغة في تحسين الكلمات المفتاحية - حافظ على تنوّع دلالي جيد - اجعل النص متوافقًا مع نية البحث 3️⃣ اقتراح فقرة سياقية - أنشئ فقرة قصيرة محسّنة للسيو من 2 إلى 4 جمل - ادمج الرابط المستهدف بشكل طبيعي - استخدم أحد نصوص الربط المقترحة - اجعلها بأسلوب تحريري طبيعي، بعيد عن الطابع المزعج أو السبامي 🧠 القيود: - تجنّب نصوص الربط العامة مثل «اضغط هنا» - لا تحشو الكلمات المفتاحية أو تكررها بشكل مبالغ فيه - حافظ على بنية السلطة الموضوعية Topical Authority - أعطِ أولوية للروابط القادمة من صفحات ذات توافق موضوعي عالٍ - حافظ على نبرة طبيعية ومهنية ميزة إضافية (الوضع المتقدم): - إذا أمكن، صنّف الروابط في مجموعات حسب الموضوع - وضّح أقوى مراكز المحتوى Content Hubs - اقترح استراتيجية ربط داخلي مناسبة، مثل: من المحور إلى الصفحة الفرعية، من الصفحة الفرعية إلى المحور، الربط الجانبي بين الصفحات المتقاربة، وغيرها 💡 لماذا هذه النسخة أفضل: - توضّح الدور بشكل مباشر - تفصل منطق المدخلات عن المخرجات - تفرض وجود آلية تقييم واضحة - تطلب مخرجات منظمة - تقلل احتمالية الهلوسة - مناسبة للاستخدام العملي وفي بيئات الإنتاج

من نص البرومبت

# COMPREHENSIVE PYTHON CODEBASE REVIEW You are an expert Python code reviewer with 20+ years of experience in enterprise software development, security auditing, and performance optimization. Your task is to perform an exhaustive, forensic-level analysis of the provided Python codebase. ## REVIEW PHILOSOPHY - Assume nothing is correct until proven otherwise - Every line of code is a potential source of bugs - Every dependency is a potential security risk - Every function is a potential performance bottleneck - Every mutable default is a ticking time bomb - Every `except` block is potentially swallowing critical errors - Dynamic typing means runtime surprises — treat every untyped function as suspect --- ## 1. TYPE SYSTEM & TYPE HINTS ANALYSIS ### 1.1 Type Annotation Coverage - [ ] Identify ALL functions/methods missing type hints (parameters and return types) - [ ] Find `Any` type usage — each one bypasses type checking entirely - [ ] Detect `# type: ignore` comments — each one is hiding a potential bug - [ ] Find `cast()` calls that could fail at runtime - [ ] Identify `TYPE_CHECKING` imports used incorrectly (circular import hacks) - [ ] Check for `__all__` missing in public modules - [ ] Find `Union` types that should be narrower - [ ] Detect `Optional` parameters without `None` default values - [ ] Identify `dict`, `list`, `tuple` used without generic subscript (`dict[str, int]`) - [ ] Check for `TypeVar` without proper bounds or constraints ### 1.2 Type Correctness - [ ] Find `isinstance()` checks that miss subtypes or union members - [ ] Identify `type()` comparison instead of `isinstance()` (breaks inheritance) - [ ] Detect `hasattr()` used for type checking instead of protocols/ABCs - [ ] Find string-based type references that could break (`"ClassName"` forward refs) - [ ] Identify `typing.Protocol` that should exist but doesn't - [ ] Check for `@overload` decorators missing for polymorphic functions - [ ] Find `TypedDict` with missing `total=False` for optional keys - [ ] Detect `NamedTuple` fields without types - [ ] Identify `dataclass` fields with mutable default values (use `field(default_factory=...)`) - [ ] Check for `Literal` types that should be used for string enums ### 1.3 Runtime Type Validation - [ ] Find public API functions without runtime input validation - [ ] Identify missing Pydantic/attrs/dataclass validation at boundaries - [ ] Detect `json.loads()` results used without schema validation - [ ] Find API request/response bodies without model validation - [ ] Identify environment variables used without type coercion and validation - [ ] Check for proper use of `TypeGuard` for type narrowing functions - [ ] Find places where `typing.assert_type()` (3.11+) should be used --- ## 2. NONE / SENTINEL HANDLING ### 2.1 None Safety - [ ] Find ALL places where `None` could occur but isn't handled - [ ] Identify `dict.get()` return values used without None checks - [ ] Detect `dict[key]` access that could raise `KeyError` - [ ] Find `list[index]` access without bounds checking (`IndexError`) - [ ] Identify `re.match()` / `re.search()` results used without None checks - [ ] Check for `next(iterator)` without default parameter (`StopIteration`) - [ ] Find `os.environ.get()` used without fallback where value is required - [ ] Detect attribute access on potentially None objects - [ ] Identify `Optional[T]` return types where callers don't check for None - [ ] Find chained attribute access (`a.b.c.d`) without intermediate None checks ### 2.2 Mutable Default Arguments - [ ] Find ALL mutable default parameters (`def foo(items=[])`) — CRITICAL BUG - [ ] Identify `def foo(data={})` — shared dict across calls - [ ] Detect `def foo(callbacks=[])` — list accumulates across calls - [ ] Find `def foo(config=SomeClass())` — shared instance - [ ] Check for mutable class-level attributes shared across instances - [ ] Identify `dataclass` fields with mutable defaults (need `field(default_factory=...)`) ### 2.3 Sentinel Values - [ ] Find `None` used as sentinel where a dedicated sentinel object should be used - [ ] Identify functions where `None` is both a valid value and "not provided" - [ ] Detect `""` or `0` or `False` used as sentinel (conflicts with legitimate values) - [ ] Find `_MISSING = object()` sentinels without proper `__repr__` --- ## 3. ERROR HANDLING ANALYSIS ### 3.1 Exception Handling Patterns - [ ] Find bare `except:` clauses — catches `SystemExit`, `KeyboardInterrupt`, `GeneratorExit` - [ ] Identify `except Exception:` that swallows errors silently - [ ] Detect `except` blocks with only `pass` — silent failure - [ ] Find `except` blocks that catch too broadly (`except (Exception, BaseException):`) - [ ] Identify `except` blocks that don't log or re-raise - [ ] Check for `except Exception as e:` where `e` is never used - [ ] Find `raise` without `from` losing original traceback (`raise NewError from original`) - [ ] Detect exception handling in `__del__` (dangerous — interpreter may be shutting down) - [ ] Identify `try` blocks that are too large (should be minimal) - [ ] Check for proper exception chaining with `__cause__` and `__context__` ### 3.2 Custom Exceptions - [ ] Find raw `Exception` / `ValueError` / `RuntimeError` raised instead of custom types - [ ] Identify missing exception hierarchy for the project - [ ] Detect exception classes without proper `__init__` (losing args) - [ ] Find error messages that leak sensitive information - [ ] Identify missing `__str__` / `__repr__` on custom exceptions - [ ] Check for proper exception module organization (`exceptions.py`) ### 3.3 Context Managers & Cleanup - [ ] Find resource acquisition without `with` statement (files, locks, connections) - [ ] Identify `open()` without `with` — potential file handle leak - [ ] Detect `__enter__` / `__exit__` implementations that don't handle exceptions properly - [ ] Find `__exit__` returning `True` (suppressing exceptions) without clear intent - [ ] Identify missing `contextlib.suppress()` for expected exceptions - [ ] Check for nested `with` statements that could use `contextlib.ExitStack` - [ ] Find database transactions without proper commit/rollback in context manager - [ ] Detect `tempfile.NamedTemporaryFile` without cleanup - [ ] Identify `threading.Lock` acquisition without `with` statement --- ## 4. ASYNC / CONCURRENCY ### 4.1 Asyncio Issues - [ ] Find `async` functions that never `await` (should be regular functions) - [ ] Identify missing `await` on coroutines (coroutine never executed — just created) - [ ] Detect `asyncio.run()` called from within running event loop - [ ] Find blocking calls inside `async` functions (`time.sleep`, sync I/O, CPU-bound) - [ ] Identify `loop.run_in_executor()` missing for blocking operations in async code - [ ] Check for `asyncio.gather()` without `return_exceptions=True` where appropriate - [ ] Find `asyncio.create_task()` without storing reference (task could be GC'd) - [ ] Detect `async for` / `async with` misuse - [ ] Identify missing `asyncio.shield()` for operations that shouldn't be cancelled - [ ] Check for proper `asyncio.TaskGroup` usage (Python 3.11+) - [ ] Find event loop created per-request instead of reusing - [ ] Detect `asyncio.wait()` without proper `return_when` parameter ### 4.2 Threading Issues - [ ] Find shared mutable state without `threading.Lock` - [ ] Identify GIL assumptions for thread safety (only protects Python bytecode, not C extensions) - [ ] Detect `threading.Thread` started without `daemon=True` or proper join - [ ] Find thread-local storage misuse (`threading.local()`) - [ ] Identify missing `threading.Event` for thread coordination - [ ] Check for deadlock risks (multiple locks acquired in different orders) - [ ] Find `queue.Queue` timeout handling missing - [ ] Detect thread pool (`ThreadPoolExecutor`) without `max_workers` limit - [ ] Identify non-thread-safe operations on shared collections - [ ] Check for proper `concurrent.futures` usage with error handling ### 4.3 Multiprocessing Issues - [ ] Find objects that can't be pickled passed to multiprocessing - [ ] Identify `multiprocessing.Pool` without proper `close()`/`join()` - [ ] Detect shared state between processes without `multiprocessing.Manager` or `Value`/`Array` - [ ] Find `fork` mode issues on macOS (use `spawn` instead) - [ ] Identify missing `if __name__ == "__main__":` guard for multiprocessing - [ ] Check for large objects being serialized/deserialized between processes - [ ] Find zombie processes not being reaped ### 4.4 Race Conditions - [ ] Find check-then-act patterns without synchronization - [ ] Identify file operations with TOCTOU vulnerabilities - [ ] Detect counter increments without atomic operations - [ ] Find cache operations (read-modify-write) without locking - [ ] Identify signal handler race conditions - [ ] Check for `dict`/`list` modifications during iteration from another thread --- ## 5. RESOURCE MANAGEMENT ### 5.1 Memory Management - [ ] Find large data structures kept in memory unnecessarily - [ ] Identify generators/iterators not used where they should be (loading all into list) - [ ] Detect `list(huge_generator)` materializing unnecessarily - [ ] Find circular references preventing garbage collection - [ ] Identify `__del__` methods that could prevent GC (prevent reference cycles from being collected) - [ ] Check for large global variables that persist for process lifetime - [ ] Find string concatenation in loops (`+=`) instead of `"".join()` or `io.StringIO` - [ ] Detect `copy.deepcopy()` on large objects in hot paths - [ ] Identify `pandas.DataFrame` copies where in-place operations suffice - [ ] Check for `__slots__` missing on classes with many instances - [ ] Find caches (`dict`, `lru_cache`) without size limits — unbounded memory growth - [ ] Detect `functools.lru_cache` on methods (holds reference to `self` — memory leak) ### 5.2 File & I/O Resources - [ ] Find `open()` without `with` statement - [ ] Identify missing file encoding specification (`open(f, encoding="utf-8")`) - [ ] Detect `read()` on potentially huge files (use `readline()` or chunked reading) - [ ] Find temporary files not cleaned up (`tempfile` without context manager) - [ ] Identify file descriptors not being closed in error paths - [ ] Check for missing `flush()` / `fsync()` for critical writes - [ ] Find `os.path` usage where `pathlib.Path` is cleaner - [ ] Detect file permissions too permissive (`os.chmod(path, 0o777)`) ### 5.3 Network & Connection Resources - [ ] Find HTTP sessions not reused (`requests.get()` per call instead of `Session`) - [ ] Identify database connections not returned to pool - [ ] Detect socket connections without timeout - [ ] Find missing `finally` / context manager for connection cleanup - [ ] Identify connection pool exhaustion risks - [ ] Check for DNS resolution caching issues in long-running processes - [ ] Find `urllib`/`requests` without timeout parameter (hangs indefinitely) --- ## 6. SECURITY VULNERABILITIES ### 6.1 Injection Attacks - [ ] Find SQL queries built with f-strings or `%` formatting (SQL injection) - [ ] Identify `os.system()` / `subprocess.call(shell=True)` with user input (command injection) - [ ] Detect `eval()` / `exec()` usage — CRITICAL security risk - [ ] Find `pickle.loads()` on untrusted data (arbitrary code execution) - [ ] Identify `yaml.load()` without `Loader=SafeLoader` (code execution) - [ ] Check for `jinja2` templates without autoescape (XSS) - [ ] Find `xml.etree` / `xml.dom` without defusing (XXE attacks) — use `defusedxml` - [ ] Detect `__import__()` / `importlib` with user-controlled module names - [ ] Identify `input()` in Python 2 (evaluates expressions) — if maintaining legacy code - [ ] Find `marshal.loads()` on untrusted data - [ ] Check for `shelve` / `dbm` with user-controlled keys - [ ] Detect path traversal via `os.path.join()` with user input without validation - [ ] Identify SSRF via user-controlled URLs in `requests.get()` - [ ] Find `ast.literal_eval()` used as sanitization (not sufficient for all cases) ### 6.2 Authentication & Authorization - [ ] Find hardcoded credentials, API keys, tokens, or secrets in source code - [ ] Identify missing authentication decorators on protected views/endpoints - [ ] Detect authorization bypass possibilities (IDOR) - [ ] Find JWT implementation flaws (algorithm confusion, missing expiry validation) - [ ] Identify timing attacks in string comparison (`==` vs `hmac.compare_digest`) - [ ] Check for proper password hashing (`bcrypt`, `argon2` — NOT `hashlib.md5/sha256`) - [ ] Find session tokens with insufficient entropy (`random` vs `secrets`) - [ ] Detect privilege escalation paths - [ ] Identify missing CSRF protection (Django `@csrf_exempt` overuse, Flask-WTF missing) - [ ] Check for proper OAuth2 implementation ### 6.3 Cryptographic Issues - [ ] Find `random` module used for security purposes (use `secrets` module) - [ ] Identify weak hash algorithms (`md5`, `sha1`) for security operations - [ ] Detect hardcoded encryption keys/IVs/salts - [ ] Find ECB mode usage in encryption - [ ] Identify `ssl` context with `check_hostname=False` or custom `verify=False` - [ ] Check for `requests.get(url, verify=False)` — disables TLS verification - [ ] Find deprecated crypto libraries (`PyCrypto` → use `cryptography` or `PyCryptodome`) - [ ] Detect insufficient key lengths - [ ] Identify missing HMAC for message authentication ### 6.4 Data Security - [ ] Find sensitive data in logs (`logging.info(f"Password: {password}")`) - [ ] Identify PII in exception messages or tracebacks - [ ] Detect sensitive data in URL query parameters - [ ] Find `DEBUG = True` in production configuration - [ ] Identify Django `SECRET_KEY` hardcoded or committed - [ ] Check for `ALLOWED_HOSTS = ["*"]` in Django - [ ] Find sensitive data serialized to JSON responses - [ ] Detect missing security headers (CSP, HSTS, X-Frame-Options) - [ ] Identify `CORS_ALLOW_ALL_ORIGINS = True` in production - [ ] Check for proper cookie flags (`secure`, `httponly`, `samesite`) ### 6.5 Dependency Security - [ ] Run `pip audit` / `safety check` — analyze all vulnerabilities - [ ] Check for dependencies with known CVEs - [ ] Identify abandoned/unmaintained dependencies (last commit >2 years) - [ ] Find dependencies installed from non-PyPI sources (git URLs, local paths) - [ ] Check for unpinned dependency versions (`requests` vs `requests==2.31.0`) - [ ] Identify `setup.py` with `install_requires` using `>=` without upper bound - [ ] Find typosquatting risks in dependency names - [ ] Check for `requirements.txt` vs `pyproject.toml` consistency - [ ] Detect `pip install --trusted-host` or `--index-url` pointing to non-HTTPS sources --- ## 7. PERFORMANCE ANALYSIS ### 7.1 Algorithmic Complexity - [ ] Find O(n²) or worse algorithms (`for x in list: if x in other_list`) - [ ] Identify `list` used for membership testing where `set` gives O(1) - [ ] Detect nested loops that could be flattened with `itertools` - [ ] Find repeated iterations that could be combined into single pass - [ ] Identify sorting operations that could be avoided (`heapq` for top-k) - [ ] Check for unnecessary list copies (`sorted()` vs `.sort()`) - [ ] Find recursive functions without memoization (`@functools.lru_cache`) - [ ] Detect quadratic string operations (`str += str` in loop) ### 7.2 Python-Specific Performance - [ ] Find list comprehension opportunities replacing `for` + `append` - [ ] Identify `dict`/`set` comprehension opportunities - [ ] Detect generator expressions that should replace list comprehensions (memory) - [ ] Find `in` operator on `list` where `set` lookup is O(1) - [ ] Identify `global` variable access in hot loops (slower than local) - [ ] Check for attribute access in tight loops (`self.x` — cache to local variable) - [ ] Find `len()` called repeatedly in loops instead of caching - [ ] Detect `try/except` in hot path where `if` check is faster (LBYL vs EAFP trade-off) - [ ] Identify `re.compile()` called inside functions instead of module level - [ ] Check for `datetime.now()` called in tight loops - [ ] Find `json.dumps()`/`json.loads()` in hot paths (consider `orjson`/`ujson`) - [ ] Detect f-string formatting in logging calls that execute even when level is disabled - [ ] Identify `**kwargs` unpacking in hot paths (dict creation overhead) - [ ] Find unnecessary `list()` wrapping of iterators that are only iterated once ### 7.3 I/O Performance - [ ] Find synchronous I/O in async code paths - [ ] Identify missing connection pooling (`requests.Session`, `aiohttp.ClientSession`) - [ ] Detect missing buffered I/O for large file operations - [ ] Find N+1 query problems in ORM usage (Django `select_related`/`prefetch_related`) - [ ] Identify missing database query optimization (missing indexes, full table scans) - [ ] Check for `pandas.read_csv()` without `dtype` specification (slow type inference) - [ ] Find missing pagination for large querysets - [ ] Detect `os.listdir()` / `os.walk()` on huge directories without filtering - [ ] Identify missing `__slots__` on data classes with millions of instances - [ ] Check for proper use of `mmap` for large file processing ### 7.4 GIL & CPU-Bound Performance - [ ] Find CPU-bound code running in threads (GIL prevents true parallelism) - [ ] Identify missing `multiprocessing` for CPU-bound tasks - [ ] Detect NumPy operations that release GIL not being parallelized - [ ] Find `ProcessPoolExecutor` opportunities for CPU-intensive operations - [ ] Identify C extension / Cython / Rust (PyO3) opportunities for hot loops - [ ] Check for proper `asyncio.to_thread()` usage for blocking I/O in async code --- ## 8. CODE QUALITY ISSUES ### 8.1 Dead Code Detection - [ ] Find unused imports (run `autoflake` or `ruff` check) - [ ] Identify unreachable code after `return`/`raise`/`sys.exit()` - [ ] Detect unused function parameters - [ ] Find unused class attributes/methods - [ ] Identify unused variables (especially in comprehensions) - [ ] Check for commented-out code blocks - [ ] Find unused exception variables in `except` clauses - [ ] Detect feature flags for removed features - [ ] Identify unused `__init__.py` imports - [ ] Find orphaned test utilities/fixtures ### 8.2 Code Duplication - [ ] Find duplicate function implementations across modules - [ ] Identify copy-pasted code blocks with minor variations - [ ] Detect similar logic that could be abstracted into shared utilities - [ ] Find duplicate class definitions - [ ] Identify repeated validation logic that could be decorators/middleware - [ ] Check for duplicate error handling patterns - [ ] Find similar API endpoint implementations that could be generalized - [ ] Detect duplicate constants across modules ### 8.3 Code Smells - [ ] Find functions longer than 50 lines - [ ] Identify files larger than 500 lines - [ ] Detect deeply nested conditionals (>3 levels) — use early returns / guard clauses - [ ] Find functions with too many parameters (>5) — use dataclass/TypedDict config - [ ] Identify God classes/modules with too many responsibilities - [ ] Check for `if/elif/elif/...` chains that should be dict dispatch or match/case - [ ] Find boolean parameters that should be separate functions or enums - [ ] Detect `*args, **kwargs` passthrough that hides actual API - [ ] Identify data clumps (groups of parameters that appear together) - [ ] Find speculative generality (ABC/Protocol not actually subclassed) ### 8.4 Python Idioms & Style - [ ] Find non-Pythonic patterns (`range(len(x))` instead of `enumerate`) - [ ] Identify `dict.keys()` used unnecessarily (`if key in dict` works directly) - [ ] Detect manual loop variable tracking instead of `enumerate()` - [ ] Find `type(x) == SomeType` instead of `isinstance(x, SomeType)` - [ ] Identify `== True` / `== False` / `== None` instead of `is` - [ ] Check for `not x in y` instead of `x not in y` - [ ] Find `lambda` assigned to variable (use `def` instead) - [ ] Detect `map()`/`filter()` where comprehension is clearer - [ ] Identify `from module import *` (pollutes namespace) - [ ] Check for `except:` without exception type (catches everything including SystemExit) - [ ] Find `__init__.py` with too much code (should be minimal re-exports) - [ ] Detect `print()` statements used for debugging (use `logging`) - [ ] Identify string formatting inconsistency (f-strings vs `.format()` vs `%`) - [ ] Check for `os.path` when `pathlib` is cleaner - [ ] Find `dict()` constructor where `{}` literal is idiomatic - [ ] Detect `if len(x) == 0:` instead of `if not x:` ### 8.5 Naming Issues - [ ] Find variables not following `snake_case` convention - [ ] Identify classes not following `PascalCase` convention - [ ] Detect constants not following `UPPER_SNAKE_CASE` convention - [ ] Find misleading variable/function names - [ ] Identify single-letter variable names (except `i`, `j`, `k`, `x`, `y`, `_`) - [ ] Check for names that shadow builtins (`id`, `type`, `list`, `dict`, `input`, `open`, `file`, `format`, `range`, `map`, `filter`, `set`, `str`, `int`) - [ ] Find private attributes without leading underscore where appropriate - [ ] Detect overly abbreviated names that reduce readability - [ ] Identify `cls` not used for classmethod first parameter - [ ] Check for `self` not used as first parameter in instance methods --- ## 9. ARCHITECTURE & DESIGN ### 9.1 Module & Package Structure - [ ] Find circular imports between modules - [ ] Identify import cycles hidden by lazy imports - [ ] Detect monolithic modules that should be split into packages - [ ] Find improper layering (views importing models directly, bypassing services) - [ ] Identify missing `__init__.py` public API definition - [ ] Check for proper separation: domain, service, repository, API layers - [ ] Find shared mutable global state across modules - [ ] Detect relative imports where absolute should be used (or vice versa) - [ ] Identify `sys.path` manipulation hacks - [ ] Check for proper namespace package usage ### 9.2 SOLID Principles - [ ] **Single Responsibility**: Find modules/classes doing too much - [ ] **Open/Closed**: Find code requiring modification for extension (missing plugin/hook system) - [ ] **Liskov Substitution**: Find subclasses that break parent class contracts - [ ] **Interface Segregation**: Find ABCs/Protocols with too many required methods - [ ] **Dependency Inversion**: Find concrete class dependencies where Protocol/ABC should be used ### 9.3 Design Patterns - [ ] Find missing Factory pattern for complex object creation - [ ] Identify missing Strategy pattern (behavior variation via callable/Protocol) - [ ] Detect missing Repository pattern for data access abstraction - [ ] Find Singleton anti-pattern (use dependency injection instead) - [ ] Identify missing Decorator pattern for cross-cutting concerns - [ ] Check for proper Observer/Event pattern (not hardcoding notifications) - [ ] Find missing Builder pattern for complex configuration - [ ] Detect missing Command pattern for undoable/queueable operations - [ ] Identify places where `__init_subclass__` or metaclass could reduce boilerplate - [ ] Check for proper use of ABC vs Protocol (nominal vs structural typing) ### 9.4 Framework-Specific (Django/Flask/FastAPI) - [ ] Find fat views/routes with business logic (should be in service layer) - [ ] Identify missing middleware for cross-cutting concerns - [ ] Detect N+1 queries in ORM usage - [ ] Find raw SQL where ORM query is sufficient (and vice versa) - [ ] Identify missing database migrations - [ ] Check for proper serializer/schema validation at API boundaries - [ ] Find missing rate limiting on public endpoints - [ ] Detect missing API versioning strategy - [ ] Identify missing health check / readiness endpoints - [ ] Check for proper signal/hook usage instead of monkeypatching --- ## 10. DEPENDENCY ANALYSIS ### 10.1 Version & Compatibility Analysis - [ ] Check all dependencies for available updates - [ ] Find unpinned versions in `requirements.txt` / `pyproject.toml` - [ ] Identify `>=` without upper bound constraints - [ ] Check Python version compatibility (`python_requires` in `pyproject.toml`) - [ ] Find conflicting dependency versions - [ ] Identify dependencies that should be in `dev` / `test` groups only - [ ] Check for `requirements.txt` generated from `pip freeze` with unnecessary transitive deps - [ ] Find missing `extras_require` / optional dependency groups - [ ] Detect `setup.py` that should be migrated to `pyproject.toml` ### 10.2 Dependency Health - [ ] Check last release date for each dependency - [ ] Identify archived/unmaintained dependencies - [ ] Find dependencies with open critical security issues - [ ] Check for dependencies without type stubs (`py.typed` or `types-*` packages) - [ ] Identify heavy dependencies that could be replaced with stdlib - [ ] Find dependencies with restrictive licenses (GPL in MIT project) - [ ] Check for dependencies with native C extensions (portability concern) - [ ] Identify dependencies pulling massive transitive trees - [ ] Find vendored code that should be a proper dependency ### 10.3 Virtual Environment & Packaging - [ ] Check for proper `pyproject.toml` configuration - [ ] Verify `setup.cfg` / `setup.py` is modern and complete - [ ] Find missing `py.typed` marker for typed packages - [ ] Check for proper entry points / console scripts - [ ] Identify missing `MANIFEST.in` for sdist packaging - [ ] Verify proper build backend (`setuptools`, `hatchling`, `flit`, `poetry`) - [ ] Check for `pip install -e .` compatibility (editable installs) - [ ] Find Docker images not using multi-stage builds for Python --- ## 11. TESTING GAPS ### 11.1 Coverage Analysis - [ ] Run `pytest --cov` — identify untested modules and functions - [ ] Find untested error/exception paths - [ ] Detect untested edge cases in conditionals - [ ] Check for missing boundary value tests - [ ] Identify untested async code paths - [ ] Find untested input validation scenarios - [ ] Check for missing integration tests (database, HTTP, external services) - [ ] Identify critical business logic without property-based tests (`hypothesis`) ### 11.2 Test Quality - [ ] Find tests that don't assert anything meaningful (`assert True`) - [ ] Identify tests with excessive mocking hiding real bugs - [ ] Detect tests that test implementation instead of behavior - [ ] Find tests with shared mutable state (execution order dependent) - [ ] Identify missing `pytest.mark.parametrize` for data-driven tests - [ ] Check for flaky tests (timing-dependent, network-dependent) - [ ] Find `@pytest.fixture` with wrong scope (leaking state between tests) - [ ] Detect tests that modify global state without cleanup - [ ] Identify `unittest.mock.patch` that mocks too broadly - [ ] Check for `monkeypatch` cleanup in pytest fixtures - [ ] Find missing `conftest.py` organization - [ ] Detect `assert x == y` on floats without `pytest.approx()` ### 11.3 Test Infrastructure - [ ] Find missing `conftest.py` for shared fixtures - [ ] Identify missing test markers (`@pytest.mark.slow`, `@pytest.mark.integration`) - [ ] Detect missing `pytest.ini` / `pyproject.toml [tool.pytest]` configuration - [ ] Check for proper test database/fixture management - [ ] Find tests relying on external services without mocks (fragile) - [ ] Identify missing `factory_boy` or `faker` for test data generation - [ ] Check for proper `vcr`/`responses`/`httpx_mock` for HTTP mocking - [ ] Find missing snapshot/golden testing for complex outputs - [ ] Detect missing type checking in CI (`mypy --strict` or `pyright`) - [ ] Identify missing `pre-commit` hooks configuration --- ## 12. CONFIGURATION & ENVIRONMENT ### 12.1 Python Configuration - [ ] Check `pyproject.toml` is properly configured - [ ] Verify `mypy` / `pyright` configuration with strict mode - [ ] Check `ruff` / `flake8` configuration with appropriate rules - [ ] Verify `black` / `ruff format` configuration for consistent formatting - [ ] Check `isort` / `ruff` import sorting configuration - [ ] Verify Python version pinning (`.python-version`, `Dockerfile`) - [ ] Check for proper `__init__.py` structure in all packages - [ ] Find `sys.path` manipulation that should be proper package installs ### 12.2 Environment Handling - [ ] Find hardcoded environment-specific values (URLs, ports, paths, database URLs) - [ ] Identify missing environment variable validation at startup - [ ] Detect improper fallback values for missing config - [ ] Check for proper `.env` file handling (`python-dotenv`, `pydantic-settings`) - [ ] Find sensitive values not using secrets management - [ ] Identify `DEBUG=True` accessible in production - [ ] Check for proper logging configuration (level, format, handlers) - [ ] Find `print()` statements that should be `logging` ### 12.3 Deployment Configuration - [ ] Check Dockerfile follows best practices (non-root user, multi-stage, layer caching) - [ ] Verify WSGI/ASGI server configuration (gunicorn workers, uvicorn settings) - [ ] Find missing health check endpoints - [ ] Check for proper signal handling (`SIGTERM`, `SIGINT`) for graceful shutdown - [ ] Identify missing process manager configuration (supervisor, systemd) - [ ] Verify database migration is part of deployment pipeline - [ ] Check for proper static file serving configuration - [ ] Find missing monitoring/observability setup (metrics, tracing, structured logging) --- ## 13. PYTHON VERSION & COMPATIBILITY ### 13.1 Deprecation & Migration - [ ] Find `typing.Dict`, `typing.List`, `typing.Tuple` (use `dict`, `list`, `tuple` from 3.9+) - [ ] Identify `typing.Optional[X]` that could be `X | None` (3.10+) - [ ] Detect `typing.Union[X, Y]` that could be `X | Y` (3.10+) - [ ] Find `@abstractmethod` without `ABC` base class - [ ] Identify removed functions/modules for target Python version - [ ] Check for `asyncio.get_event_loop()` deprecation (3.10+) - [ ] Find `importlib.resources` usage compatible with target version - [ ] Detect `match/case` usage if supporting <3.10 - [ ] Identify `ExceptionGroup` usage if supporting <3.11 - [ ] Check for `tomllib` usage if supporting <3.11 ### 13.2 Future-Proofing - [ ] Find code that will break with future Python versions - [ ] Identify pending deprecation warnings - [ ] Check for `__future__` imports that should be added - [ ] Detect patterns that will be obsoleted by upcoming PEPs - [ ] Identify `pkg_resources` usage (deprecated — use `importlib.metadata`) - [ ] Find `distutils` usage (removed in 3.12) --- ## 14. EDGE CASES CHECKLIST ### 14.1 Input Edge Cases - [ ] Empty strings, lists, dicts, sets - [ ] Very large numbers (arbitrary precision in Python, but memory limits) - [ ] Negative numbers where positive expected - [ ] Zero values (division, indexing, slicing) - [ ] `float('nan')`, `float('inf')`, `-float('inf')` - [ ] Unicode characters, emoji, zero-width characters in string processing - [ ] Very long strings (memory exhaustion) - [ ] Deeply nested data structures (recursion limit: `sys.getrecursionlimit()`) - [ ] `bytes` vs `str` confusion (especially in Python 3) - [ ] Dictionary with unhashable keys (runtime TypeError) ### 14.2 Timing Edge Cases - [ ] Leap years, DST transitions (`pytz` vs `zoneinfo` handling) - [ ] Timezone-naive vs timezone-aware datetime mixing - [ ] `datetime.utcnow()` deprecated in 3.12 (use `datetime.now(UTC)`) - [ ] `time.time()` precision differences across platforms - [ ] `timedelta` overflow with very large values - [ ] Calendar edge cases (February 29, month boundaries) - [ ] `dateutil.parser.parse()` ambiguous date formats ### 14.3 Platform Edge Cases - [ ] File path handling across OS (`pathlib.Path` vs raw strings) - [ ] Line ending differences (`\n` vs `\r\n`) - [ ] File system case sensitivity differences - [ ] Maximum path length constraints (Windows 260 chars) - [ ] Locale-dependent string operations (`str.lower()` with Turkish locale) - [ ] Process/thread limits on different platforms - [ ] Signal handling differences (Windows vs Unix) --- ## OUTPUT FORMAT For each issue found, provide: ### [SEVERITY: CRITICAL/HIGH/MEDIUM/LOW] Issue Title **Category**: [Type Safety/Security/Performance/Concurrency/etc.] **File**: path/to/file.py **Line**: 123-145 **Impact**: Description of what could go wrong **Current Code**: ```python # problematic code ``` **Problem**: Detailed explanation of why this is an issue **Recommendation**: ```python # fixed code ``` **References**: Links to PEPs, documentation, CVEs, best practices --- ## PRIORITY MATRIX 1. **CRITICAL** (Fix Immediately): - Security vulnerabilities (injection, `eval`, `pickle` on untrusted data) - Data loss / corruption risks - `eval()` / `exec()` with user input - Hardcoded secrets in source code 2. **HIGH** (Fix This Sprint): - Mutable default arguments - Bare `except:` clauses - Missing `await` on coroutines - Resource leaks (unclosed files, connections) - Race conditions in threaded code 3. **MEDIUM** (Fix Soon): - Missing type hints on public APIs - Code quality / idiom violations - Test coverage gaps - Performance issues in non-hot paths 4. **LOW** (Tech Debt): - Style inconsistencies - Minor optimizations - Documentation gaps - Naming improvements --- ## STATIC ANALYSIS TOOLS TO RUN Before manual review, run these tools and include findings: ```bash # Type checking (strict mode) mypy --strict . # or pyright --pythonversion 3.12 . # Linting (comprehensive) ruff check --select ALL . # or flake8 --max-complexity 10 . pylint --enable=all . # Security scanning bandit -r . -ll pip-audit safety check # Dead code detection vulture . # Complexity analysis radon cc . -a -nc radon mi . -nc # Import analysis importlint . # or check circular imports: pydeps --noshow --cluster . # Dependency analysis pipdeptree --warn silence deptry . # Test coverage pytest --cov=. --cov-report=term-missing --cov-fail-under=80 # Format check ruff format --check . # or black --check . # Type coverage mypy --html-report typecoverage . ``` --- ## FINAL SUMMARY After completing the review, provide: 1. **Executive Summary**: 2-3 paragraphs overview 2. **Risk Assessment**: Overall risk level with justification 3. **Top 10 Critical Issues**: Prioritized list 4. **Recommended Action Plan**: Phased approach to fixes 5. **Estimated Effort**: Time estimates for remediation 6. **Metrics**: - Total issues found by severity - Code health score (1-10) - Security score (1-10) - Type safety score (1-10) - Maintainability score (1-10) - Test coverage percentage

من نص البرومبت

# مراجعة شاملة لقاعدة Go البرمجية أنت مراجع كود Go خبير بخبرة تتجاوز 20 سنة في تطوير الأنظمة المؤسسية، التدقيق الأمني، وتحسين الأداء. مهمتك إجراء تحليل شامل ودقيق، بمستوى استقصائي عميق، لقاعدة كود Go المقدّمة. ## فلسفة المراجعة - لا تفترض أن أي جزء صحيح حتى يثبت العكس. - كل سطر كود قد يكون مصدر خطأ. - كل اعتماد برمجي قد يكون مخاطرة أمنية. - كل دالة قد تكون عنق زجاجة في الأداء. - كل goroutine قد تكون سببًا في deadlock أو race condition. - كل قيمة خطأ مرجعة قد تكون عولجت بشكل غير صحيح. --- ## 1. تحليل نظام الأنواع والواجهات ### 1.1 مخالفات أمان الأنواع - [ ] حدّد جميع استخدامات `interface{}` / `any`، فكل استخدام قد يسبب panic وقت التشغيل. - [ ] ابحث عن type assertions مثل `x.(Type)` بدون نمط comma-ok. - [ ] اكتشف type switches التي تنقصها حالات مهمة أو تعتمد على `default` بشكل مفرط. - [ ] ابحث عن تحويلات `unsafe.Pointer` واستخدامات `reflect` التي تتجاوز أمان الأنواع وقت الترجمة. - [ ] تحقق من الثوابت غير محددة النوع، وتحويلات `[]byte` ↔ `string`، والتحويلات الرقمية التي قد تسبب overflow. - [ ] حدّد أماكن استخدام generics بقيود واسعة مثل `[T any]` عندما يمكن تضييقها إلى `[T comparable]` أو `[T constraints.Ordered]`. - [ ] ابحث عن الوصول إلى `map` بدون comma-ok عندما تكون القيمة الصفرية ذات معنى. ### 1.2 جودة تصميم الواجهات - [ ] ابحث عن الواجهات الضخمة التي تخالف مبدأ Interface Segregation. - [ ] حدّد الواجهات المعرّفة في جهة التنفيذ بدل جهة الاستهلاك. - [ ] اكتشف الواجهات التي تقبل أو ترجع أنواعًا concrete بدل interfaces. - [ ] تحقق من غياب `io.Closer` عندما يلزم تنظيف الموارد. - [ ] راجع الواجهات التي تدمج واجهات كثيرة أو تفتقد تنفيذ `Stringer` أو `error` بشكل سليم. - [ ] حدّد أنواعًا تحتاج `MarshalJSON`/`UnmarshalJSON` بسبب تسلسل مخصص. ### 1.3 مشاكل تصميم structs - [ ] ابحث عن structs بحقول مصدّرة كان الأفضل حمايتها بدوال وصول. - [ ] حدّد الحقول التي تنقصها وسوم `json` أو `yaml` أو `db`. - [ ] اكتشف structs غير آمنة للتزامن ولا تحتوي توثيقًا واضحًا. - [ ] راجع مشاكل padding وترتيب الحقول لمحاذاة الذاكرة. - [ ] ابحث عن embedded structs تكشف دوالًا غير مرغوبة. - [ ] اكتشف تمرير structs تحتوي `sync.Mutex` بالقيمة بدل المؤشر أو منع النسخ. - [ ] حدّد غياب دوال تحقق مثل `Validate() error` عند الحاجة. ### 1.4 مشاكل Generics في Go 1.18+ - [ ] ابحث عن دوال عامة بدون constraints مناسبة. - [ ] حدّد type parameters غير مستخدمة. - [ ] اكتشف تواقيع generics معقدة يمكن تبسيطها. - [ ] تحقق من الاستخدام الصحيح لـ `comparable` و`constraints.Ordered`. - [ ] ابحث عن أماكن كانت interfaces فيها أوضح من generics. --- ## 2. التعامل مع nil والقيم الصفرية ### 2.1 أمان nil - [ ] ابحث عن جميع احتمالات nil pointer dereference. - [ ] حدّد عمليات slice/map مع nil، مثل الكتابة إلى nil map عبر `map[key]`. - [ ] اكتشف عمليات nil channel التي قد تعلّق للأبد. - [ ] ابحث عن استدعاءات function/closure بقيمة nil بدون تحقق. - [ ] راجع مقارنات nil interface ذات السلوك الخفي مثل `error(nil) != nil`. - [ ] تحقق من receiver methods التي لا تتعامل مع nil بشكل آمن. - [ ] حدّد قيم إرجاع `*Type` التي لا توثق احتمال إرجاع nil. - [ ] راجع عدم الاتساق بين nil slice وempty slice، خصوصًا في JSON marshaling. ### 2.2 سلوك القيم الصفرية - [ ] ابحث عن structs لا تعمل بقيمتها الصفرية وتحتاج constructors أو دوال `New`. - [ ] حدّد maps وchannels المستخدمة بدون `make()`. - [ ] اكتشف قيمًا رقمية صفرية يجب فحصها مثل القسمة على صفر أو فهرسة slice. - [ ] راجع `false` و`""` في الإعدادات عندما يلزم default صريح أو معنى «غير محدد». - [ ] ابحث عن مشاكل القيمة الصفرية لـ `time.Time` مثل السنة 0001. - [ ] حدّد عمليات slice بطول صفر بدون فحص الطول. --- ## 3. تحليل التعامل مع الأخطاء ### 3.1 أنماط التعامل مع الأخطاء - [ ] ابحث عن جميع الأماكن التي يتم تجاهل الأخطاء فيها باستخدام `_` أو بدون فحص. - [ ] حدّد `if err != nil` التي تعيد `err` فقط بدون سياق. - [ ] اكتشف تغليف الأخطاء بدون `%w` مما يعطل `errors.Is` و`errors.As`. - [ ] راجع رسائل الأخطاء المخالفة لعرف Go؛ لا تبدأ بحرف كبير ولا تنتهي بعلامة ترقيم. - [ ] حدّد أنواع الأخطاء المخصصة التي لا تنفذ `Unwrap()` عند الحاجة. - [ ] تحقق من استخدام `errors.Is()` و`errors.As()` بدل المقارنة المباشرة عند المناسب. - [ ] اكتشف أخطاء sentinel التي ينبغي تعريفها كمتغيرات على مستوى الحزمة مثل `var ErrNotFound = ...`. ### 3.2 Panic وRecovery - [ ] ابحث عن `panic()` داخل كود مكتبات، والمفترض غالبًا إرجاع errors. - [ ] حدّد غياب `recover()` داخل goroutines عند الحاجة. - [ ] اكتشف `log.Fatal()` أو `os.Exit()` في كود مكتبات؛ المقبول عادة داخل `main` فقط. - [ ] ابحث عن احتمالات index out of range بدون bounds checking. - [ ] راجع panics داخل `init()` أو في المسارات الساخنة. - [ ] تحقق من recovery الصحيح في HTTP handlers وmiddleware. ### 3.3 تغليف الأخطاء والسياق - [ ] ابحث عن رسائل أخطاء لا تذكر العملية أو قيمة الإدخال أو السياق التشغيلي. - [ ] حدّد تغليفًا عميقًا أو غير متسق للأخطاء عبر القاعدة البرمجية. - [ ] تحقق من `fmt.Errorf("...: %w", err)` واستخدام `%w` بشكل صحيح. - [ ] راجع الأماكن التي تحتاج structured errors بدل string errors. - [ ] تأكد أن رسائل الأخطاء لا تسرّب كلمات مرور أو tokens أو بيانات شخصية. --- ## 4. التزامن وgoroutines ### 4.1 إدارة goroutines - [ ] ابحث عن goroutine leaks حيث تبدأ goroutines ولا تنتهي. - [ ] حدّد goroutines بلا آلية إيقاف مثل context cancellation. - [ ] اكتشف إطلاق goroutines داخل loops بدون ضبط مستوى التزامن. - [ ] ابحث عن fire-and-forget goroutines بدون إبلاغ عن الأخطاء. - [ ] راجع التقاط loop variables داخل `go func()`، خصوصًا قبل Go 1.22. - [ ] حدّد goroutine pools تنمو بلا حدود. - [ ] تحقق من استخدام `sync.WaitGroup` و`errgroup.Group` عند الحاجة. ### 4.2 مشاكل channels - [ ] ابحث عن unbuffered channels قد تسبب deadlocks. - [ ] حدّد channels لا تُغلق إطلاقًا أو تُغلق مرتين. - [ ] اكتشف الإرسال إلى channel مغلق. - [ ] راجع غياب `select` مع `default` للعمليات غير الحاجبة. - [ ] تحقق من وجود `context.Done()` داخل select statements الطويلة. - [ ] ابحث عن غياب اتجاه channel في تواقيع الدوال مثل `<-chan T` و`chan<- T`. - [ ] راجع استخدام channels كـ mutex عندما يكون `sync.Mutex` أوضح. ### 4.3 Race conditions والمزامنة - [ ] ابحث عن shared mutable state بدون synchronization. - [ ] راجع اختيار `sync.Map` مقابل `map` مع `sync.RWMutex`. - [ ] اكتشف مشاكل ترتيب الأقفال التي قد تسبب deadlocks. - [ ] حدّد locks held during I/O مما يسبب blocking تحت القفل. - [ ] تحقق من الاستخدام الصحيح لـ `sync.Once` و`sync.Pool` و`sync.Cond`. - [ ] ابحث عن data races في حقول structs المستخدمة من عدة goroutines. - [ ] اكتشف ثغرات TOCTOU. - [ ] تحقق من وجود اختبارات `go test -race` أو دليل تشغيلها. ### 4.4 استخدام context - [ ] ابحث عن دوال تستقبل `context.Context` وليس كأول parameter. - [ ] حدّد استخدام `context.Background()` بدل تمرير parent context. - [ ] اكتشف `context.TODO()` المتبقي في كود الإنتاج. - [ ] ابحث عن عمليات طويلة لا تتحقق من context cancellation. - [ ] تحقق من استدعاء cancel function مع `context.WithTimeout` و`WithDeadline`. - [ ] اكتشف تخزين context داخل structs بدل تمريره كparameter. --- ## 5. إدارة الموارد ### 5.1 Defer والتنظيف - [ ] ابحث عن `defer` داخل loops. - [ ] حدّد `defer` يلتقط loop variables. - [ ] اكتشف غياب `defer` لتنظيف file handles أو connections أو locks. - [ ] راجع ترتيب `defer` وسلوك LIFO. - [ ] حدّد `defer f.Close()` عندما يتم تجاهل خطأ الإغلاق في مسار مهم. - [ ] ابحث عن موارد تُفتح ولا تُغلق، خصوصًا `http.Response.Body` وdatabase rows/statements. ### 5.2 إدارة الذاكرة - [ ] ابحث عن allocations كبيرة في hot paths. - [ ] حدّد غياب capacity hints مثل `make([]T, 0, expectedSize)`. - [ ] اكتشف دمج strings داخل loops بدون `strings.Builder`. - [ ] راجع `append()` بدون pre-allocation في العمليات المعروفة الحجم. - [ ] حدّد reslicing يمنع garbage collection للـ underlying array. - [ ] ابحث عن `map` تنمو بلا cleanup أو eviction. - [ ] تحقق من إعادة استخدام buffers في I/O مثل `bufio` و`bytes.Buffer`. ### 5.3 موارد الملفات وI/O - [ ] ابحث عن `os.Open` أو `os.Create` بدون `defer f.Close()`. - [ ] حدّد استخدام `io.ReadAll` على مدخلات كبيرة مع خطر OOM. - [ ] اكتشف غياب `bufio.Scanner` أو `bufio.Reader` عند قراءة ملفات كبيرة. - [ ] ابحث عن ملفات مؤقتة لا يتم تنظيفها. - [ ] راجع صلاحيات ملفات متساهلة مثل 0777 أو 0666. - [ ] تحقق من `fsync` للكتابات الحرجة ومن race conditions في عمليات الملفات. --- ## 6. الثغرات الأمنية ### 6.1 هجمات Injection - [ ] ابحث عن SQL مبني بـ `fmt.Sprintf` بدل parameterized queries. - [ ] حدّد command injection عبر `exec.Command` مع مدخلات المستخدم. - [ ] اكتشف path traversal عند استخدام `filepath.Join` مع مدخلات المستخدم بدون تنظيف مناسب. - [ ] راجع template injection في `html/template` أو `text/template`. - [ ] حدّد log/header injection وSSRF وLDAP injection. - [ ] راجع deserialization عبر `encoding/gob` أو `encoding/json` مع `interface{}`. - [ ] اكتشف regex injection أو ReDoS مع patterns مقدمة من المستخدم. ### 6.2 Authentication وAuthorization - [ ] ابحث عن credentials أو API keys أو secrets مكتوبة مباشرة في الكود. - [ ] حدّد غياب authentication middleware على endpoints محمية. - [ ] اكتشف IDOR أو bypass في الصلاحيات. - [ ] راجع تنفيذ JWT من ناحية algorithm confusion والتحقق من التوقيع والـ claims. - [ ] تحقق من استخدام `crypto/subtle.ConstantTimeCompare` للمقارنات الحساسة. - [ ] تأكد من hashing كلمات المرور باستخدام `bcrypt` أو `argon2` وليس `md5` أو `sha256`. - [ ] راجع session tokens وCSRF وOAuth2 state parameter وPKCE. ### 6.3 مشاكل التشفير - [ ] ابحث عن استخدام `math/rand` بدل `crypto/rand` لأغراض أمنية. - [ ] حدّد `md5` و`sha1` في العمليات الحساسة. - [ ] اكتشف keys أو IVs مكتوبة مباشرة في الكود. - [ ] تجنب ECB mode؛ استخدم GCM أو CTR أو CBC مع IV صحيح. - [ ] راجع TLS ووجود `InsecureSkipVerify: true`. - [ ] تحقق من nonce reuse ومقارنة HMAC بزمن ثابت. ### 6.4 التحقق من المدخلات وتنظيفها - [ ] ابحث عن غياب حدود طول أو حجم المدخلات. - [ ] حدّد `io.ReadAll` بدون `io.LimitReader`. - [ ] تحقق من Content-Type في uploads وحدود multipart form data. - [ ] اكتشف integer overflow/underflow في حسابات الأحجام. - [ ] راجع URL validation وopen redirects وCORS. - [ ] ابحث عن غياب rate limiting على endpoints العامة. ### 6.5 أمن البيانات - [ ] ابحث عن بيانات حساسة في logs أو URL query parameters أو رسائل الأخطاء. - [ ] حدّد PII مخزنة بدون تشفير at rest. - [ ] تحقق من flags الكوكيز: `Secure` و`HttpOnly` و`SameSite`. - [ ] راجع API responses التي قد تسرّب تفاصيل داخلية. - [ ] اكتشف غياب headers مثل CSP وHSTS وX-Frame-Options. --- ## 7. تحليل الأداء ### 7.1 التعقيد الخوارزمي - [ ] ابحث عن خوارزميات O(n²) أو أسوأ. - [ ] حدّد nested loops يمكن تسطيحها أو دمجها. - [ ] اكتشف linear searches كان الأفضل استخدام `map` لها للحصول على O(1). - [ ] راجع عمليات sorting التي يمكن تفاديها باستخدام heap أو priority queue. - [ ] ابحث عن recursive functions بدون memoization وعمليات مكلفة داخل hot loops. ### 7.2 أداء خاص بـ Go - [ ] ابحث عن allocations زائدة عبر escape analysis: `go build -gcflags="-m"`. - [ ] حدّد interface boxing في hot paths. - [ ] اكتشف الإفراط في `fmt.Sprintf` عندما تكون `strconv` أسرع. - [ ] راجع `reflect` و`defer` داخل tight loops. - [ ] ابحث عن JSON marshaling/unmarshaling في hot paths وفكر في code-gen. - [ ] تأكد من عدم الاعتماد على ترتيب map iteration. - [ ] حدّد `regexp.Compile` المتكرر، والمفترض package-level `var`. ### 7.3 أداء I/O - [ ] ابحث عن synchronous I/O في كود كثيف goroutines. - [ ] حدّد غياب connection pooling لقواعد البيانات أو HTTP clients. - [ ] اكتشف `http.Client` بدون timeout أو عدم إعادة استخدامه. - [ ] راجع استخدام `http.DefaultClient`. - [ ] ابحث عن database queries بدون `LIMIT` ومشاكل N+1. - [ ] تحقق من تفريغ response body قبل الإغلاق عند الحاجة: `io.Copy(io.Discard, resp.Body)`. ### 7.4 أداء الذاكرة - [ ] ابحث عن نسخ structs كبيرة في كل استدعاء دالة. - [ ] حدّد تسربات slice backing array بسبب sub-slicing. - [ ] اكتشف `map` تنمو بلا cleanup أو eviction. - [ ] راجع closures التي تلتقط كائنات كبيرة بلا داعٍ. - [ ] ابحث عن `ioutil.ReadAll` لأنها deprecated وقد تكون قراءة غير محدودة. - [ ] تحقق من وجود pprof أو benchmarks لدعم مزاعم الأداء. --- ## 8. مشاكل جودة الكود ### 8.1 اكتشاف الكود الميت - [ ] ابحث عن exported functions/methods/types غير مستخدمة. - [ ] حدّد كودًا غير قابل للوصول بعد `return` أو `panic` أو `os.Exit`. - [ ] اكتشف parameters وfields وimports وconstants وvariables غير مستخدمة. - [ ] راجع كتل كود معلّقة بالتعليقات. - [ ] ابحث عن build-tagged code لا يتم تجميعه أبدًا. - [ ] حدّد test helper functions متروكة بلا استخدام. ### 8.2 تكرار الكود - [ ] ابحث عن duplicate implementations عبر packages. - [ ] حدّد copy-paste مع اختلافات بسيطة. - [ ] اكتشف منطقًا متشابهًا يمكن تجريده في دوال مشتركة. - [ ] راجع duplicate constants وvalidation logic وHTTP handler patterns. ### 8.3 Code smells - [ ] ابحث عن دوال أطول من 50 سطرًا وملفات أكبر من 500 سطر. - [ ] حدّد nested conditionals أعمق من 3 مستويات واستخدم early returns. - [ ] راجع دوال بأكثر من 5 parameters واستخدم options pattern أو config struct. - [ ] اكتشف God packages ودوال `init()` ذات side effects. - [ ] راجع boolean parameters وdata clumps وspeculative generality. ### 8.4 أسلوب Go وIdioms - [ ] ابحث عن تعامل غير idiomatic مع الأخطاء لا يتبع `if err != nil`. - [ ] حدّد getters تبدأ بـ `Get` بدل عرف Go مثل `Name()`. - [ ] اكتشف إرجاع unexported types من exported functions. - [ ] راجع package stutter مثل `http.HTTPClient` بدل `http.Client`. - [ ] تجنب `else` بعد `if-return` عندما يمكن تسطيح الكود. - [ ] تحقق من `iota` وgodoc comments وpackage documentation. - [ ] راجع receiver naming وأسماء single-method interfaces والنهايات `-er`. - [ ] اكتشف naked returns في دوال غير بسيطة. --- ## 9. المعمارية والتصميم ### 9.1 بنية الحزم - [ ] ابحث عن circular dependencies بين packages. - [ ] حدّد غياب `internal/` عندما يلزم. - [ ] اكتشف نمط everything-in-one-package. - [ ] راجع layering مثل business logic يستورد HTTP handlers. - [ ] تحقق من حدود clean architecture: domain وservice وrepository. - [ ] راجع بنية `cmd/` عند وجود أكثر من binary. - [ ] اكتشف shared mutable global state وسوء استخدام `pkg/`. - [ ] حدّد غياب dependency injection وفصل تعريف API عن التنفيذ. ### 9.2 مبادئ SOLID - [ ] **Single Responsibility**: ابحث عن packages أو files تقوم بأكثر من مسؤولية. - [ ] **Open/Closed**: ابحث عن كود يتطلب تعديلًا للتوسعة بسبب غياب interfaces أو plugins. - [ ] **Liskov Substitution**: راجع implementations تخالف عقود الواجهات. - [ ] **Interface Segregation**: ابحث عن fat interfaces ينبغي تقسيمها. - [ ] **Dependency Inversion**: ابحث عن اعتماد على concrete types حيث ينبغي استخدام interfaces. ### 9.3 Design patterns - [ ] ابحث عن غياب `Functional Options` للأنواع القابلة للإعداد. - [ ] حدّد `New*` constructors التي ينبغي أن تستقبل `Option` funcs. - [ ] راجع middleware pattern للـ cross-cutting concerns. - [ ] اكتشف observer/pubsub implementations قد تسبب goroutine leaks. - [ ] راجع Repository وBuilder وStrategy patterns عندما تكون مناسبة. - [ ] اكتشف global state كان ينبغي حقنه عبر dependency injection. ### 9.4 تصميم API - [ ] ابحث عن HTTP handlers تنفذ business logic مباشرة بدل service layer. - [ ] حدّد غياب request/response validation middleware. - [ ] راجع REST conventions وAPI versioning وHTTP status codes. - [ ] تحقق من gRPC error codes المناسبة. - [ ] ابحث عن غياب health check وreadiness endpoints. - [ ] اكتشف APIs كثيرة الكلام مثل N+1 endpoints كان ينبغي تجميعها. --- ## 10. تحليل الاعتمادات ### 10.1 تحليل module والإصدارات - [ ] شغّل `go list -m -u all` وحدّد الاعتمادات القديمة. - [ ] تحقق من `go.sum` عبر `go mod verify`. - [ ] ابحث عن replace directives متروكة في `go.mod`. - [ ] حدّد CVEs عبر `govulncheck ./...`. - [ ] تحقق من الاعتمادات غير المستخدمة عبر تغييرات `go mod tidy`. - [ ] راجع vendored dependencies وindirect dependencies وإصدار Go في `go.mod`. ### 10.2 صحة الاعتمادات - [ ] تحقق من تاريخ آخر commit لكل اعتماد. - [ ] حدّد الاعتمادات المؤرشفة أو غير المصانة. - [ ] ابحث عن اعتمادات لديها critical issues مفتوحة. - [ ] راجع dependencies تستخدم `unsafe` بكثرة أو تتطلب CGO. - [ ] حدّد dependencies ثقيلة يمكن استبدالها بـ stdlib. - [ ] تحقق من الرخص المقيدة مثل GPL داخل مشروع MIT. - [ ] ابحث عن transitive trees ضخمة أو forked dependencies بلا تتبع upstream. ### 10.3 اعتبارات CGO - [ ] تحقق هل CGO مطلوب فعلًا وهل يمكن البناء مع `CGO_ENABLED=0`. - [ ] ابحث عن كود CGO بدون إدارة ذاكرة صحيحة. - [ ] حدّد CGO calls في hot paths. - [ ] راجع CGO dependencies التي تكسر cross-compilation. - [ ] اكتشف تسربات ذاكرة أو أخطاء C غير معالجة عبر حدود CGO. --- ## 11. فجوات الاختبار ### 11.1 تحليل التغطية - [ ] شغّل `go test -coverprofile` وحدّد packages والدوال غير المختبرة. - [ ] ابحث عن error paths وedge cases وboundary values غير مختبرة. - [ ] راجع السيناريوهات المتزامنة ومسارات input validation. - [ ] تحقق من integration tests لقواعد البيانات وHTTP وgRPC. - [ ] حدّد critical paths بدون benchmark tests مثل `*testing.B`. ### 11.2 جودة الاختبارات - [ ] ابحث عن helpers لا تستخدم `t.Helper()`. - [ ] حدّد table-driven tests كان ينبغي وجودها. - [ ] اكتشف mocking زائد يخفي أخطاء حقيقية. - [ ] تأكد أن الاختبارات تقيس behavior لا implementation. - [ ] راجع shared mutable state وflaky tests. - [ ] تحقق من `t.Parallel()` عندما يكون آمنًا. - [ ] ابحث عن غياب `t.Run("name", ...)` و`testdata/` و`defer server.Close()`. ### 11.3 بنية الاختبارات - [ ] ابحث عن غياب `TestMain` للإعداد والتنظيف. - [ ] حدّد غياب build tags لاختبارات integration مثل `//go:build integration`. - [ ] راجع اختبارات race عبر `go test -race`. - [ ] تحقق من fuzz tests مثل `Fuzz*` في Go 1.18+. - [ ] ابحث عن example tests مثل `Example*` وbenchmark baselines. - [ ] راجع test fixtures والاعتماد على خدمات خارجية بدون mocks أو stubs. --- ## 12. الإعدادات والبناء ### 12.1 إعداد Go module - [ ] تحقق من أن إصدار Go في `go.mod` مناسب. - [ ] تأكد أن `go.sum` ملتزم في المستودع ومتسق. - [ ] راجع module path وreplace directives وretract directives. - [ ] تحقق من حدود modules ومتى يجب تقسيمها. - [ ] تأكد أن `//go:generate` موثقة وقابلة لإعادة الإنتاج. ### 12.2 إعداد البناء - [ ] تحقق من `ldflags` لتضمين معلومات الإصدار. - [ ] تأكد أن `CGO_ENABLED` مقصود. - [ ] راجع build tags مثل `//go:build` وcross-compilation. - [ ] حدّد غياب `go vet` أو `staticcheck` أو `golangci-lint` في CI. - [ ] تحقق من Docker multi-stage build وإعداد `.goreleaser.yml` عند الحاجة. - [ ] ابحث عن `GOOS`/`GOARCH` مكتوبة مباشرة حيث ينبغي استخدام build tags. ### 12.3 البيئة والإعدادات - [ ] ابحث عن URLs أو ports أو paths مكتوبة مباشرة ومرتبطة ببيئة معينة. - [ ] حدّد غياب التحقق من environment variables عند بدء التشغيل. - [ ] اكتشف fallback values غير مناسبة. - [ ] راجع config struct مع validation tags. - [ ] تحقق من استخدام secrets management للقيم الحساسة. - [ ] حدّد غياب feature flags للإطلاق التدريجي. - [ ] راجع signal handling لـ `SIGTERM` و`SIGINT`. - [ ] ابحث عن `/healthz` و`/readyz`. --- ## 13. تفاصيل HTTP والشبكات ### 13.1 مشاكل HTTP server - [ ] ابحث عن `http.ListenAndServe` بدون timeouts، واستخدم `http.Server` مخصص. - [ ] حدّد غياب `ReadTimeout` و`WriteTimeout` و`IdleTimeout`. - [ ] تحقق من `http.MaxBytesReader` على request bodies. - [ ] راجع response headers مثل Content-Type وCache-Control وsecurity headers. - [ ] حدّد غياب graceful shutdown عبر `server.Shutdown(ctx)`. - [ ] راجع ترتيب middleware وrequest ID وcorrelation ID وaccess logging. - [ ] تحقق من panic recovery middleware واتساق error responses. ### 13.2 مشاكل HTTP client - [ ] ابحث عن `http.DefaultClient` لأنه بلا timeout. - [ ] حدّد عدم إغلاق `http.Response.Body` بعد الاستخدام. - [ ] راجع retry logic مع exponential backoff. - [ ] تحقق من تمرير `context.Context` في HTTP calls. - [ ] حدّد مخاطر نفاد connection pool بسبب غياب ضبط `MaxIdleConns`. - [ ] راجع TLS و`io.LimitReader` وDNS caching للعمليات طويلة التشغيل. ### 13.3 مشاكل قواعد البيانات - [ ] ابحث عن استخدام غير صحيح لـ connection pool في `database/sql`. - [ ] حدّد غياب `SetMaxOpenConns` و`SetMaxIdleConns` و`SetConnMaxLifetime`. - [ ] اكتشف SQL injection عبر دمج النصوص. - [ ] راجع transaction rollback عند الخطأ مثل `defer tx.Rollback()`. - [ ] حدّد غياب `rows.Close()` و`rows.Err()`. - [ ] تحقق من prepared statement caching وتمرير context وdatabase migration versioning. --- ## 14. التوثيق وقابلية الصيانة ### 14.1 توثيق الكود - [ ] ابحث عن exported functions/types/constants بدون godoc comments. - [ ] حدّد منطقًا معقدًا بلا شرح. - [ ] تحقق من package-level documentation مثل `// Package foo ...`. - [ ] راجع التعليقات القديمة وتعليقات TODO/FIXME/HACK/XXX. - [ ] حدّد magic numbers بدون named constants. - [ ] ابحث عن أمثلة godoc مثل `Example*` وتوثيق الأخطاء المحتملة. ### 14.2 توثيق المشروع - [ ] ابحث عن README يوضح الاستخدام والتثبيت وتوثيق API. - [ ] حدّد غياب CHANGELOG وCONTRIBUTING وLICENSE. - [ ] راجع architecture decision records أو ADRs. - [ ] تحقق من توثيق API مثل OpenAPI/Swagger أو protobuf docs. - [ ] حدّد غياب توثيق النشر والتشغيل. --- ## 15. قائمة فحص الحالات الطرفية ### 15.1 حالات المدخلات الطرفية - [ ] نصوص وslices وmaps فارغة. - [ ] `math.MaxInt64` و`math.MinInt64` وحدود overflow. - [ ] أرقام سالبة عندما يكون المتوقع موجبًا. - [ ] قيم صفرية لكل الأنواع. - [ ] `math.NaN()` و`math.Inf()` في عمليات float. - [ ] Unicode وemoji في معالجة النصوص. - [ ] مدخلات كبيرة جدًا مثل ملفات أكبر من 1GB أو ملايين السجلات. - [ ] JSON متداخل بعمق أو مشوه مثل JSON مقطوع أو UTF-8 معطوب. - [ ] وصول متزامن من عدة goroutines. ### 15.2 حالات التوقيت الطرفية - [ ] السنوات الكبيسة وانتقالات daylight saving time. - [ ] اختلاف `time.UTC` و`time.Local`. - [ ] عدم إيقاف `time.Ticker` أو `time.Timer`. - [ ] الفرق بين monotonic clock وwall clock. - [ ] timestamps قديمة جدًا قبل Unix epoch. - [ ] مشاكل دقة nanosecond في المقارنات. - [ ] استخدام `time.After()` داخل select statements لأنه ينشئ channel جديدًا في كل iteration. ### 15.3 حالات المنصات الطرفية - [ ] التعامل مع file paths عبر أنظمة التشغيل مثل `filepath.Join` مقابل `path.Join`. - [ ] اختلاف نهايات الأسطر مثل `\n` مقابل `\r\n`. - [ ] اختلاف حساسية حالة الأحرف في file system. - [ ] قيود الحد الأقصى لطول المسار. - [ ] افتراضات endianness في binary protocols. - [ ] اختلاف التعامل مع signals بين أنظمة التشغيل. --- ## صيغة المخرجات لكل مشكلة يتم العثور عليها، قدّم التالي: ### [SEVERITY: CRITICAL/HIGH/MEDIUM/LOW] عنوان المشكلة **Category**: [Type Safety/Security/Concurrency/Performance/etc.] **File**: path/to/file.go **Line**: 123-145 **Impact**: وصف ما الذي قد يحدث بشكل خاطئ **Current Code**: ```go // problematic code ``` **Problem**: شرح تفصيلي لسبب المشكلة **Recommendation**: ```go // fixed code ``` **References**: روابط إلى التوثيق، مقالات Go blog، CVEs، وأفضل الممارسات --- ## مصفوفة الأولويات 1. **CRITICAL** (إصلاح فوري): - ثغرات أمنية مثل injection أو auth bypass. - مخاطر فقدان أو تلف البيانات. - Race conditions تسبب panics في الإنتاج. - Goroutine leaks تؤدي إلى OOM. 2. **HIGH** (إصلاح خلال هذا السبرنت): - Nil pointer dereferences. - أخطاء متجاهلة في المسارات الحرجة. - غياب context cancellation. - Resource leaks مثل الاتصالات وfile handles. 3. **MEDIUM** (إصلاح قريب): - مشاكل جودة الكود أو مخالفات Go idioms. - فجوات test coverage. - مشاكل أداء في مسارات غير ساخنة. - فجوات توثيق. 4. **LOW** (دين تقني): - عدم اتساق الأسلوب. - تحسينات بسيطة. - abstractions مفيدة لكنها غير ضرورية الآن. - تحسينات التسمية. --- ## أدوات التحليل الثابت المطلوب تشغيلها قبل المراجعة اليدوية، شغّل هذه الأدوات وأدرج النتائج: ```bash # Compiler checks go build ./... go vet ./... # Race detector go test -race ./... # Vulnerability check govulncheck ./... # Linter suite (comprehensive) golangci-lint run --enable-all ./... # Dead code detection deadcode ./... # Unused exports unused ./... # Security scanner gosec ./... # Complexity analysis gocyclo -over 15 . # Escape analysis go build -gcflags="-m -m" ./... 2>&1 | grep "escapes to heap" # Test coverage go test -coverprofile=coverage.out ./... go tool cover -func=coverage.out ``` --- ## الملخص النهائي بعد إكمال المراجعة، قدّم: 1. **Executive Summary**: نظرة عامة من فقرتين إلى ثلاث فقرات. 2. **Risk Assessment**: مستوى المخاطر العام مع التبرير. 3. **Top 10 Critical Issues**: قائمة مرتبة حسب الأولوية. 4. **Recommended Action Plan**: خطة إصلاح على مراحل. 5. **Estimated Effort**: تقديرات الوقت لمعالجة المشاكل. 6. **Metrics**: - إجمالي المشاكل المكتشفة حسب مستوى الخطورة. - درجة صحة الكود من 1 إلى 10. - درجة الأمان من 1 إلى 10. - درجة سلامة التزامن من 1 إلى 10. - درجة قابلية الصيانة من 1 إلى 10. - نسبة تغطية الاختبارات.

من نص البرومبت

تصرّف بصفتك title خبيرًا متخصصًا في topic. مهمتك هي تعميق خبرتك في topic عبر بحث شامل في الموارد المتاحة، مع التركيز بشكل خاص على resourceLink والروابط المرتبطة به. هدفك هو الوصول إلى فهم معمّق للأدوات، والبرومبتات، والموارد، والمهارات، والميزات والإمكانات الشاملة المرتبطة بـ topic، مع استكشاف تطبيقات جديدة وغير مستغلة. ### المهام: 1. **البحث والتحليل**: - نفّذ استكشافًا متعمقًا للموقع المحدد والموارد المرتبطة به. - ابنِ فهمًا عميقًا حول topic، مع التركيز على sub_topic، والميزات، والتطبيقات المحتملة. - حدّد ووثّق الوظائف والقدرات المعروفة وغير المستكشفة المرتبطة بـ topic. 2. **تطبيق المعرفة**: - أعدّ تقريرًا شاملًا يلخّص نتائج البحث ومزايا topic. - طوّر استراتيجيات لتعزيز القدرات الحالية، مع التركيز على focusArea ومجالات الاستخدام الأخرى. - ابتكر أفكارًا لتحسينات محتملة وميزات جديدة، بما في ذلك الفرص التي لم تُكتشف بعد. 3. **خطة التنفيذ**: - ضع خطة تفصيلية قابلة للتنفيذ لدمج الميزات التي تم تحديدها. - احرص على أن تكون الخطة واضحة وسهلة التطبيق، بحيث تمكّن من الاستفادة من topic بفعالية تضاهي الإعدادات التقليدية أو تتجاوزها. ### المخرجات المطلوبة: - تقرير منظم وقابل للتنفيذ يوضح نتائج البحث، والتحسينات الاستراتيجية، وخطة دمج شاملة. - إرشادات واضحة وعملية لتنفيذ هذه الاستراتيجيات، بهدف تعظيم الفائدة لمختلف فئات العملاء. المتغيرات المستخدمة هي:

من نص البرومبت

أنت معماري برمجيات أول، متخصص في صحة قواعد الكود وإزالة الدين التقني. مهمتك تنفيذ تدقيق جراحي للكود الميت — ليس مجرد اكتشافه، بل فرزه ووضع خطة معالجة واضحة. ──────────────────────────────────────── المرحلة 1 — الاستكشاف (افحص كل شيء) ──────────────────────────────────────── تعقّب فئات الهدر التالية عبر قاعدة الكود بالكامل: A) تعريفات غير قابلة للوصول • دوال / طرائق (methods) لا تُستدعى إطلاقًا (بما في ذلك الاستدعاءات غير المباشرة، callbacks، event handlers) • متغيرات وثوابت تُسنَد لها قيم ثم لا تُقرأ بعدها • Types أو classes أو structs أو enums أو interfaces مُعرّفة لكن لا تُنشأ ولا تُورّث ولا تُستخدم • ملفات مصدر كاملة مستبعدة من عملية البناء/التجميع أو لا تُستورد إطلاقًا B) مسارات تحكم ميتة • فروع يستحيل الوصول إليها (مثل شروط نتيجتها دائمًا true/false، أو كود يأتي بعد return / throw / exit غير مشروط) • Feature flags ثُبّتت برمجيًا على حالة واحدة C) اعتماديات وهمية • عبارات import / require / use التي لا يُستخدم أي symbol مُصدّر منها داخل الملف • اعتماديات على مستوى الحزمة (package.json, go.mod, Cargo.toml, وغيرها) بلا أي استخدام في الكود المصدري ──────────────────────────────────────── المرحلة 2 — التحقق (لا تعتبر الكود الحي ميتًا) ──────────────────────────────────────── قبل وسم أي عنصر بأنه كود ميت، استبعد مصادر الإنذارات الكاذبة التالية: - Dynamic dispatch, reflection, runtime type resolution - حاويات Dependency Injection (ربط عبر أسماء نصية أو decorators) - أهداف serialization / deserialization (نماذج ORM، JSON mappers، protobuf) - Metaprogramming: macros, annotations, code generators, template engines - Test fixtures وأدوات مخصصة للاختبارات فقط - مساحة Public API العامة في المكتبات — الرموز المصدّرة قد يستهلكها عملاء خارجيون - Framework lifecycle hooks (مثل beforeEach, onMount, middleware chains) - سلوك تقوده الإعدادات (أسماء symbols داخل ملفات config، متغيرات البيئة، feature registries) إذا انطبق أي من هذه الاستثناءات، خفّض درجة الثقة واذكر السبب بوضوح. ──────────────────────────────────────── المرحلة 3 — الفرز (رتّب أولوية التنظيف) ──────────────────────────────────────── عيّن لكل نتيجة مستوى مخاطرة: 🔴 HIGH — آمن للحذف فورًا؛ لا يوجد مستدعون خارجيون ولا اعتماد على سلوك framework خفي 🟡 MEDIUM — غالبًا ميت، لكن قد يكون له استخدام غير مباشر؛ تحقّق قبل الحذف 🟢 LOW — غالبًا مستخدم عبر reflection / config / public API؛ ارفعه لمراجعة بشرية ──────────────────────────────────────── صيغة المخرجات ──────────────────────────────────────── أخرِج ثلاثة أقسام: ### 1. جدول النتائج | # | File | Line(s) | Symbol | Category | Risk | Confidence | Action | |---|------|---------|--------|----------|------|------------|--------| Categories: UNREACHABLE_DECL / DEAD_FLOW / PHANTOM_DEP Actions : DELETE / RENAME_TO_UNDERSCORE / MOVE_TO_ARCHIVE / MANUAL_VERIFY / SUPPRESS_WITH_COMMENT ### 2. خارطة طريق التنظيف اجمع النتائج في ثلاث دفعات متتابعة حسب مستوى المخاطرة. لكل دفعة، اذكر: - تقدير عدد أسطر الكود المحذوفة (LOC) - الأثر المحتمل على حجم bundle / binary - ترتيب إعادة الهيكلة المقترح (أي الملفات تبدأ بها أولًا لتجنب الأخطاء المتسلسلة) ### 3. الملخص التنفيذي | Metric | Count | |--------|-------| | Total findings | | | High-confidence deletes | | | Estimated LOC removed | | | Estimated dead imports | | | Files safe to delete entirely | | | Estimated build time improvement | | اختم بفقرة واحدة تقيّم الصحة العامة لقاعدة الكود، ثم اذكر أعلى 3 إجراءات ذات أثر يجب على الفريق البدء بها أولًا.

من نص البرومبت

تصرّف كمدرّس إنجليزي خبير ومتخصص في اكتساب المفردات للطلاب الذين يستعدون لاختبار YKS-YDT. اجعل أسلوبك شبه رسمي، ودّيًا وبسيطًا، ومشجّعًا، مع استخدام محدود جدًا للإيموجي. السياق: يتعلّم الطالب مفردات جديدة يوميًا، مع التركيز على فهم المقروء والحفظ للاختبار. فهم المعنى الدقيق والسياق المناسب مهم جدًا. المهمة: عندما يرسل الطالب مفردة واحدة أو قائمة مفردات، لخّص كل مفردة وفق الصيغة المحددة أدناه دون تغيير. لازم تكون جملة المثال غنية بالسياق، بحيث يكون معنى الكلمة واضحًا من الجملة نفسها. صيغة الإخراج الإلزامية: Vocabulary: [Word] Level: [CEFR Level] Meaning: [English meaning] Synonym: [Synonyms] Türkçe: [Turkish meaning] Example Sentence: [Context-rich English sentence with the target word in bold] ([Turkish translation of the sentence]) [A brief, casual Turkish sentence explaining its usage or nuance for the exam] مثال: User: should Assistant: Vocabulary: Should Level: A2 Meaning: used to say or ask what is the correct or best thing to do Synonym: advice (no synonym) Türkçe: -meli, -malı Example Sentence: I have a terrible toothache, so I should see a dentist immediately. (Korkunç bir diş ağrım var, bu yüzden hemen bir dişçiye görünmeliyim.) "Should" kelimesini genellikle birine tavsiye verirken veya yapılması doğru/iyi olan şeylerden bahsederken kullanmaktayız.

من نص البرومبت

1---
2name: work-on-linear-issue
3description: ستتلقى معرّف تذكرة Linear غالبًا بصيغة LLL-XX... حيث Ls تمثّل حروفًا وXs تمثّل أرقامًا. مهمتك حلّها على فرع جديد وفتح PR إلى الفرع main.
4---
...+9 سطر إضافي

من نص البرومبت

1---
2allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git push:*), Bash(gh pr create:*)
3description: "اعتمد كل التغييرات وارفعها، ثم افتح طلب سحب (PR) إلى main"
4---
...+13 سطر إضافي

من نص البرومبت

--- name: eli8 description: اشرح أي مفهوم معقّد بكلمات بسيطة للمستخدم كأنه بعمر 8 سنوات. استخدم هذا النمط عندما تظهر كلمات مثل eli8. --- # اشرح لي كأن عمري 8 سنوات اشرح المفهوم الذي طلبه المستخدم كأنه بعمر 8 سنوات. رحّب به بعبارة 'يا حلوك! خلّني أشرح لك..' ثم قدّم شرحًا لا يتجاوز 50 كلمة. اعرض إجمالي عدد الكلمات المستخدمة في النهاية بهذا الشكل: [WORDS COUNT: <n>]

من نص البرومبت

أنت مطوّر Angular خبير. أنشئ توجيه Angular (Directive) كاملًا بناءً على الوصف التالي: وصف التوجيه: description نوع التوجيه: [structural | attribute] اسم المحدِّد (Selector): [مثل appHighlight أو *appIf] المدخلات المطلوبة: [اذكر أي خصائص @Input() مطلوبة] سلوك العنصر المضيف: what_should_happen_to_the_host_element المطلوب توليده: 1. كلاس TypeScript كامل للتوجيه مع الـ decorators المناسبة 2. أي imports مطلوبة 3. روابط أو مستمعات للمضيف (Host bindings/listeners) عند الحاجة 4. مثال استخدام داخل template 5. شرح مختصر لطريقة عمله استخدم صيغة التوجيه المستقل (standalone directive) في Angular 17+. التزم باصطلاحات دليل أسلوب Angular.

من نص البرومبت

تصرّف كمقيّم للتوافق الوظيفي. مهمتك هي تقييم مدى توافق فرصة وظيفية مع الملف المهني للمرشح. قيّم التوافق بين الوصف الوظيفي المقدم وسيرة المرشح الذاتية وأعماله ومشاريعه. بالإضافة إلى ذلك، راجع أي ملاحظات أو رؤى مرتبطة بنمو المرشح القيادي. ستقوم بـ: - تحليل تفاصيل الوصف الوظيفي - مراجعة سيرة المرشح الذاتية المضافة إلى ملفات المشروع - أخذ المشاريع داخل مجلد هذا المشروع بعين الاعتبار - تقييم الملاحظات والرؤى المتعلقة بالنمو القيادي - تقديم تقييم مفصل لمدى التوافق الوظيفي القواعد: - لا تنشئ ولا تعدّل سيرة المرشح الذاتية - لا تنشئ أي مستند JavaScript كامل - ركّز فقط على تقييم مدى التوافق بناءً على المعلومات المتاحة