Code Keeper Bot

למפתחים ולסוכני AI:

  • התחלה מהירה - סוכני AI
    • מטרה
    • מה אסור
    • מה מותר ומומלץ
    • פורמטי ציטוט קוד
    • מחיקה בטוחה (רק ב-/tmp)
    • קומיטים ו-PR
    • קישורים מהירים
    • Cheatsheet – GitHub CLI (gh)
  • התחלה מהירה - מפתחים
    • מטרה
    • שלב 1: התקנה
    • שלב 2: הגדרת .env
    • שלב 3: הרצה
    • מה הלאה?
  • Quickstart לתרומה
    • מטרה
    • צעדי הכנה
    • סביבת פיתוח
    • הרצת טסטים
    • על ה‑Stubs
    • קישורים
  • הנחיות מלאות לסוכני AI
    • מגבלות קריטיות
      • הרצת פקודות
    • כלי קבצים מאושרים
    • עקרונות עריכת קוד
    • קומיטים ו-Pull Requests
    • עבודה עם טסטים
    • קישורים מהירים
  • 🚦 מערכת Rate Limiting לסוכני AI ולווב
    • אסטרטגיה – Shadow Mode תחילה
    • משתני סביבה וקונפיג
    • אינטגרציה – בוט טלגרם
    • אינטגרציה – Flask/WebApp
    • החרגות חשובות
    • ניטור ומדדים (Prometheus)
    • אבטחה והגנות
    • קונפיגורציה (Pydantic Settings)
    • תקלות נפוצות
    • קישורים
  • Doc Authoring Guide (Sphinx/RTD)
    • מטרות
    • מדיניות
    • טיפים מהירים
    • קישורים
  • Style & Naming Glossary
    • מטרות
    • מיפוי מונחים
    • כללים
    • עוגני תיעוד
  • Versioning & Stable Anchors
    • מדיניות עוגנים יציבים
    • What’s New
    • דוגמת Anchors
    • קישורים
  • What’s New
    • 2026-01-29
    • 2025-12-11
    • 2025-11-11
    • 2025-11-06
    • 2025-11-05
    • 2025-10-30
    • 2025-10-29
    • 2025-10-15
  • ארכיטקטורה
    • סקירה כללית
    • תרשים רכיבים (תמציתי)
    • תרשים ארכיטקטורה מפורט
    • מבנה תיקיות
    • מקורות נוספים
      • Clean Architecture ב-src
        • למה Clean Architecture
        • תרשים שכבות
        • מבנה תיקיות
        • שכבת הדומיין (Domain)
        • שכבת היישום (Application)
        • שכבת התשתית (Infrastructure)
        • דוגמת זרימה: יצירת סניפט
        • הנחיות עבודה
    • זרימות מרכזיות
    • קישורים
    • תשתית HTTP – סשן aiohttp משותף
    • הפרדת אחריות – DocumentHandler
  • מדריך תרומה
    • מטרה
    • כללים כלליים
    • Workflow בסיסי
    • Pre-commit
    • Conventional Commits
    • דוגמאות שימושיות
    • קישורים
  • Branch Protection & PR Rules
    • מטרה
    • כללי ענפים
    • חוקי PR
    • CI – Required Checks
    • קישורים

מדריכים בסיסיים:

  • התקנה והגדרה
    • דרישות מערכת
    • התקנה מהירה
      • 1. שכפל את הריפוזיטורי
      • 2. התקן תלויות
      • 3. הגדר משתני סביבה
      • 4. הפעל את הבוט
    • התקנה עם Docker
      • 1. בנה את ה-Image
      • 2. הפעל עם Docker Compose
    • הגדרת MongoDB
    • הגדרת Telegram Bot
    • הגדרות מתקדמות
    • בדיקת התקנה
    • פתרון בעיות
    • תמיכה
  • Rate Limiting
    • Environment variables
    • Databases and Cache (Pooling/Timeouts)
    • HTTP Clients
    • שימוש ב‑http_async (Async HTTP)
    • שימוש ב‑http_sync (Sync HTTP)
    • Flask
    • Telegram Bot
    • Metrics
    • Security
    • Databases and Cache (Pooling/Timeouts)
    • HTTP Clients
    • שימוש ב-http_sync (Sync HTTP)
  • Config via Pydantic Settings
    • היררכיית טעינה
    • ולידציות
    • .env.example
    • שימוש לסוכנים
    • פרמטרי קונפיגורציה מרכזיים (חדשים)
    • איחוד תיעוד קונפיגורציה
  • קבצי קונפיגורציה ייעודיים
    • config/alert_graph_sources.json
    • config/observability_runbooks.yml
    • config/alert_quick_fixes.json
    • config/alerts.yml
    • config/error_signatures.yml
    • config/image_settings.yaml
  • משתני סביבה - רפרנס
    • טבלה מרכזית
    • התראות וניטור (הרחבה)
    • מדדים, OTEL וחיזוי
    • תפעול, אינטגרציות ופיצ’רים
    • דגלי בדיקות ופיתוח
    • דוגמאות קונפיגורציה
    • קישורים
    • טבלת Scopes לפיצ’רים של GitHub
  • 🚀 The Performance Bible: CodeKeeper Optimization Guide
    • 0. חוק הברזל: Cache First (מנע את הגישה ל-DB)
    • 1. חוק ה-Projection (אל תמשוך מה שאתה לא מציג)
    • 2. חישובים ב-DB (Smart Metadata)
    • 3. אינדוקס מורכב (Compound Indexes)
    • 4. אופטימיזציית API וחיפוש (The Snippet Pattern)
    • 5. הזרקת נתונים אסינכרונית (Lazy Loading)
    • 6. הגדרות סביבה (The Production Sweet Spot)
  • ביצועים והרחבה (Performance & Scaling)
    • עימוד (Pagination)
    • Projection
    • דגשים
    • כוונון Connection Pooling ו-Timeouts
    • לוגי איטיות (מהיר לאיתור צווארי בקבוק)
    • בדיקות מהירות אחרי שינוי ENV
    • הנחיות לפי סביבה
  • Sticky Notes Warmup – פתרון ביצועים משולב
    • רקע קצר
    • התרופה המיידית (מוכחת)
    • Warmup מבני (עדיין בתהליך אימות)
    • איפוס הדגל בעת שינוי אינדקסים
    • מה לאמת לפני rollout מלא
    • מה לעשות אם latency קופץ שוב
    • המלצה רשמית
  • טיפול בקבצים גדולים (Large Files)
    • מגבלות ופולבקים
    • הנחיות הפעלה
    • ניטור

API Reference:

  • API Reference
    • main module
    • config module
    • bot_handlers module
    • conversation_handlers module
    • database package
      • Submodules
        • database.bookmark module
        • database.bookmarks_manager module
        • database.collections_manager module
        • database.manager module
        • database.models module
        • database.repository module
    • services package
      • Submodules
        • services.backoff_state module
        • services.backup_service module
        • services.code_service module
        • services.github_service module
        • services.google_drive_service module
        • services.investigation_service module
        • services.webserver module
    • handlers package
      • Subpackages
        • handlers.github package
      • Submodules
        • handlers.documents module
        • handlers.file_view module
        • handlers.pagination module
        • handlers.save_flow module
        • handlers.states module
    • utils module
      • CodeErrorLogger
        • CodeErrorLogger.__init__()
        • CodeErrorLogger.log_code_processing_error()
        • CodeErrorLogger.log_code_activity()
        • CodeErrorLogger.log_validation_failure()
        • CodeErrorLogger.log_sanitization_success()
      • TimeUtils
        • TimeUtils.format_relative_time()
        • TimeUtils.parse_date_string()
        • TimeUtils.get_time_ranges()
      • TextUtils
        • TextUtils.truncate_text()
        • TextUtils.escape_markdown()
        • TextUtils.clean_filename()
        • TextUtils.extract_hashtags()
        • TextUtils.highlight_text()
        • TextUtils.format_file_size()
        • TextUtils.pluralize_hebrew()
      • SecurityUtils
        • SecurityUtils.generate_secure_token()
        • SecurityUtils.hash_content()
        • SecurityUtils.validate_user_input()
        • SecurityUtils.sanitize_code()
      • TelegramUtils
        • TelegramUtils.send_typing_action()
        • TelegramUtils.send_document_action()
        • TelegramUtils.safe_answer()
        • TelegramUtils.get_user_mention()
        • TelegramUtils.split_long_message()
        • TelegramUtils.safe_edit_message_text()
        • TelegramUtils.safe_edit_message_reply_markup()
        • TelegramUtils.extract_message_text_preserve_markdown()
      • CallbackQueryGuard
        • CallbackQueryGuard.DEFAULT_WINDOW_SECONDS
        • CallbackQueryGuard.should_block()
        • CallbackQueryGuard.should_block_async()
      • AsyncUtils
        • AsyncUtils.run_with_timeout()
        • AsyncUtils.batch_process()
      • PerformanceUtils
        • PerformanceUtils.timing_decorator()
        • PerformanceUtils.measure_time()
      • ValidationUtils
        • ValidationUtils.is_valid_filename()
        • ValidationUtils.is_safe_code()
      • FileUtils
        • FileUtils.download_file()
        • FileUtils.get_file_extension()
        • FileUtils.get_mime_type()
        • FileUtils.create_temp_file()
      • ConfigUtils
        • ConfigUtils.load_json_config()
        • ConfigUtils.save_json_config()
      • CacheUtils
        • CacheUtils.set()
        • CacheUtils.get()
        • CacheUtils.delete()
        • CacheUtils.clear()
      • get_memory_usage()
      • setup_logging()
      • generate_summary_stats()
      • detect_language_from_filename()
      • get_language_emoji()
      • SensitiveDataFilter
        • SensitiveDataFilter.filter()
      • install_sensitive_filter()
      • normalize_code()
    • workspace
      • activity_reporter module
        • get_mongo_client()
        • close_mongo_client()
        • SimpleActivityReporter
        • create_reporter()
      • alert_forwarder module
        • emit_event()
        • forward_alerts()
      • alert_manager module
        • emit_event()
        • reset_state_for_tests()
        • note_request()
        • get_current_error_rate_percent()
        • get_current_avg_latency_seconds()
        • get_request_stats_between()
        • bump_threshold()
        • get_thresholds_snapshot()
        • check_and_emit_alerts()
        • forward_critical_alert()
        • get_dispatch_log()
      • autocomplete_manager module
      • backup_menu_handler module
        • emit_event()
        • BackupMenuHandler
      • batch_commands module
      • batch_processor module
      • bot_handlers module
      • bot_rate_limiter module
      • cache_commands module
        • cache_stats_command()
        • clear_cache_command()
        • setup_cache_handlers()
        • cache_warm_command()
        • debug_cache_command()
      • cache_manager module
        • DynamicTTL
        • ActivityBasedTTL
        • build_cache_key()
        • CacheManager
        • dynamic_cache()
        • cached()
        • async_cached()
      • chatops package
        • Submodules
      • code_preview module
        • CodePreviewManager
      • code_processor module
      • config module
      • conftest module
      • conversation_handlers module
      • database package
        • Submodules
      • duplicate_detector module
        • scan_duplicates()
      • file_manager module
        • BackupInfo
        • BackupManager
      • fix_telegram_parse_error module
        • clean_for_telegram()
        • apply_fix()
        • wrap_edit_message_calls()
      • github_menu_handler module
      • github_upload_fix module
        • github_upload_new_file()
        • handle_document_fixed()
        • upload_to_github_fixed()
        • setup_minimal_commands()
        • stats_command_secured()
        • check_commands()
      • handlers package
        • Subpackages
        • Submodules
      • http_async module
        • CircuitOpenError
        • get_session()
        • request()
        • close_session()
      • http_sync module
        • CircuitOpenError
        • get_session()
        • request()
      • i18n package
        • Submodules
      • integrations module
      • integrations_github_monitor module
        • fetch_rate_limit()
        • summarize_rate_limit()
      • integrations_sentry module
        • is_configured()
        • get_recent_issues()
        • search_events()
        • get_issue_events()
      • internal_alerts module
        • emit_event()
        • emit_internal_alert()
        • get_recent_alerts()
      • large_files_handler module
        • LargeFilesHandler
      • lazy_loader module
      • main module
      • metrics module
        • emit_event()
        • generate_latest()
        • track_performance()
        • metrics_endpoint_bytes()
        • metrics_content_type()
        • note_active_user()
        • note_request_started()
        • note_request_finished()
        • get_active_requests_count()
        • get_current_memory_usage()
        • get_recent_errors_count()
        • get_top_slow_endpoints()
        • get_slowest_endpoint()
        • note_deployment_started()
        • note_deployment_shutdown()
        • get_avg_response_time_seconds()
        • record_request_outcome()
        • update_health_gauges()
        • record_startup_stage_metric()
        • record_startup_total_metric()
        • record_http_request()
        • record_request_queue_delay()
        • record_outbound_request_duration()
        • increment_outbound_retry()
        • set_circuit_state()
        • set_circuit_success_rate()
        • get_boot_monotonic()
        • mark_startup_complete()
        • note_first_request_latency()
        • get_process_uptime_seconds()
        • record_dependency_init()
        • record_db_operation()
        • get_uptime_percentage()
        • set_adaptive_observability_gauges()
        • set_external_error_rate_percent()
        • track_file_saved()
        • track_search_performed()
        • track_github_sync()
      • monitoring package
        • Submodules
      • observability module
      • observability_instrumentation module
        • traced()
        • start_span()
        • set_current_span_attributes()
      • observability_otel module
        • setup_telemetry()
      • predictive_engine module
        • emit_event()
        • Trend
        • note_observation()
        • evaluate_predictions()
        • reset_state_for_tests()
        • maybe_recompute_and_preempt()
        • get_recent_predictions()
        • get_trend_snapshot()
      • rate_limiter module
        • RateLimiter
      • refactor_handlers module
      • refactoring_engine module
        • מדיניות וקונפיגורציה
        • מקרה מיוחד: Safe Decomposition ל‑models.py
      • remediation_manager module
        • handle_critical_incident()
        • get_incidents()
      • reminders package
        • Submodules
      • repo_analyzer module
        • emit_event()
        • RepoAnalyzer
      • search_engine module
      • secret_manager module
        • encrypt_secret()
        • decrypt_secret()
      • services package
        • Submodules
      • setup_bookmarks module
        • emit_event()
        • check_mongodb_connection()
        • setup_bookmarks_collection()
        • verify_installation()
        • main()
      • terminal_commands module
        • emit_event()
        • run_in_sandbox()
        • terminal_enter()
        • terminal_exit()
        • terminal_run_command()
        • terminal_command()
        • setup_terminal_handlers()
      • test_basic module
        • test_python_version()
        • test_import_main()
        • test_environment()
        • test_basic_calculation()
        • TestRequirements
      • test_bookmarks module
      • user_stats module
        • UserStats
      • utils module
        • CodeErrorLogger
        • TimeUtils
        • TextUtils
        • SecurityUtils
        • TelegramUtils
        • CallbackQueryGuard
        • AsyncUtils
        • PerformanceUtils
        • ValidationUtils
        • FileUtils
        • ConfigUtils
        • CacheUtils
        • get_memory_usage()
        • setup_logging()
        • generate_summary_stats()
        • detect_language_from_filename()
        • get_language_emoji()
        • SensitiveDataFilter
        • install_sensitive_filter()
        • normalize_code()
      • webapp package
        • Submodules
  • מודולים ראשיים
    • File Management
    • GitHub Integration
    • Backup System
    • Code Processing
    • Search Engine
    • Repository Analysis
    • Batch Processing
    • Large Files Handling
    • Cache Management
    • User Statistics
    • Activity Reporting
    • Utilities
    • Lazy Loading
    • Integrations
    • Terminal Commands
    • Autocomplete Manager
  • Handlers
    • זרימת פקודה בסיסית
    • ארכיטקטורת Handlers
    • Show Command
      • Show Command
        • מפרט פקודת /show
        • דוגמת תגובת HTML
        • הערות יישום
        • קישורים
    • Drive Menu
      • Drive Menu V2
        • סקירה
        • דגל פיצ’ר
        • זרימות עיקריות
        • התחברות (Device Flow)
        • טיפול שגיאות
        • ניטור
        • API (autodoc)
    • File View Handler
    • Pagination Handler
    • Save Flow Handler
    • States Handler
    • GitHub Handlers
    • GitHub Menu Bridge
    • Document Flow
      • זרימת הטיפול במסמכים (Document Flow)
        • מפה ותפקידים
        • זרימת טיפול בקובץ
        • מצבי upload_mode
        • תלויות והזרקות
        • Best Practices
        • שכבת אחסון (FilesFacade מול DB הישן)
        • ראו גם
    • Drive Utilities
  • Services
    • Code Service
      • Code Service Module
    • GitHub Service
    • Backup Service
    • AI Explain Service
    • Community Library Service
    • Image Generator Service
    • Snippet Library Service
    • Observability HTTP Service
    • Google Drive Service
      • Google Drive Service
        • סקירה
        • הערות OAuth
        • מבני קבצים
        • API (autodoc)
  • Database
    • Database Manager
    • Models
      • CodeSnippet Model
      • DatabaseManager Class
    • Database Operations
      • Save Operations
      • Search Operations
      • Delete Operations
      • Statistics Operations
    • אינדקסים בקולקציית users
    • מדריכי מודולים ייעודיים
      • מנהל סימניות – BookmarksManager
        • מתי משתמשים בו?
        • מבנה ואינדקסים
        • מגבלות שימוש
        • תהליך Toggle
        • סנכרון עם שינויים בקובץ
        • אירועים (Analytics)
        • Autodoc
      • מנהל אוספים – CollectionsManager
        • רכיבי בסיס
        • אינדקסים
        • סוגי אוספים
        • תרחישי שימוש נפוצים
        • חוקים ושמירה על איכות
        • שיתוף ציבורי
        • Autodoc
  • MongoDB Indexing Cookbook
    • למה?
    • אינדקסים מומלצים
    • מתכונים (Python / PyMongo)
    • בדיקות explain (Mongo Shell)
    • מה לחפש ב-explain?
    • בדיקת קיום אינדקסים
    • שיטות עבודה מומלצות
    • דוגמאות נוספות
    • Gotchas נפוצים
  • Cursor-based Pagination (created_at / _id)
    • למה?
    • עקרונות מיון יציב
    • קידוד/פענוח קורסור (Python)
    • תבנית שאילתה (חדש → ישן)
    • PyMongo – דוגמה מלאה
    • דפדוף לאחור (ישן → חדש)
    • בדיקות ידניות (Copy‑Paste)
    • שיטות עבודה מומלצות
    • Gotchas נפוצים
    • קישורים
  • Database Schema
    • Collections
      • code_snippets
      • users
      • bookmarks
      • sessions (WebApp)
    • Indexes
    • Relationships
    • קישורים
  • מבנה נתונים מפורט (Detailed Database Schema)
    • סקירה כללית
    • אוסף: code_snippets
    • אוסף: large_files
    • אוסף: users
    • אוסף: bookmarks
    • אוסף: collections
    • אוסף: backups
    • יחסים בין אוספים
    • סכמת מערכת Observability - התראות ומטריקות
    • Best Practices
    • קישורים

עזרה ודוגמאות:

  • דוגמאות שימוש
    • שימוש בסיסי
      • יצירת אפליקציית בוט
      • שמירת קוד חדש
      • חיפוש קוד
    • שימוש ב-Handlers
      • יצירת Command Handler
      • יצירת Conversation Handler
    • שימוש ב-Services
      • זיהוי שפת תכנות
      • ניתוח קוד
    • אינטגרציה עם GitHub
      • העלאת קוד ל-Gist
      • שליפת Gists של משתמש
    • עבודה עם מסד הנתונים
      • ביצוע שאילתות מורכבות
      • עדכון קבצים
      • סטטיסטיקות
    • טיפול בשגיאות
      • טיפול בשגיאות בסיסי
      • Retry Logic
    • בדיקות
      • בדיקת יחידה
      • בדיקת אינטגרציה
    • דוגמאות מתקדמות
      • עיבוד באצווה
      • קאשינג
    • שיתוף ציבורי דרך ה‑API (curl)
    • דוגמת Markdown מתקדמת לתצוגה
  • Testing Guide
    • 🚀 Quickstart לטסטים
    • הנחיות קריטיות
    • טעינת Stubs לטלגרם
    • דוגמת שימוש ב‑tmp_path
    • מחיקה בטוחה
    • Mocking HTTP ב‑github_menu_handler
    • רישום Blueprint בסביבת טסטים
    • כיסוי בדיקות (pytest-cov)
    • CI נתמך
    • בדיקות ביצועים (Performance)
    • קישורים
  • דוגמאות טסטים – Rate Limiting ואסינכרוניות
    • Rate Limiting (Redis Mock)
    • טסטים אסינכרוניים
  • בדיקות ביצועים (Performance Tests)
    • מטרה
    • סימון טסטים
    • הרצה מקומית
    • CI / GitHub Actions
    • דוחות וזמני ריצה
    • טיפים
  • CI/CD Guide
    • חוקים קשיחים
    • סטטוסים נדרשים
    • ריכוז CI (Overview)
    • בדיקות מומלצות
    • בנייה של התיעוד
    • קישורים
  • Conversation Handlers & States
    • סקירה
    • רשימת States (מבחר בפועל)
    • Save Flow (תרשים מצבים)
    • GitHub Flow (תרשים מצבים)
    • ספריית סניפטים – זרימת הגשה (Bot)
      • ביטול הוגן
      • התראות אדמין והודעת משתמש
    • דוגמת Handler תמציתית
    • טבלת זרימות מלאה
    • קישורים
    • דוגמאות קוד תמציתיות (ממשיות)
      • Save – שלבים עיקריים
      • GitHub – תפריט ושיחת העלאה
      • Backup – תפריט
      • Drive – תפריט
    • מוקשים נפוצים ופתרונות
      • query.answer()
      • עריכת הודעות בבטחה – ”Message is not modified“
      • Filters
      • Persistent data (context.user_data)
    • דוגמאות טסטים קצרות
      • Save – התחלה וזרימה בסיסית
      • GitHub – upload_conv_handler
  • Troubleshooting Guide
    • שגיאות נפוצות
    • ImportError בזמן טסטים (telegram / ConversationHandler / filters)
    • שגיאות parse_mode
    • שגיאות asyncio: ”attached to a different loop“ / ”Event loop is closed“
    • דיבוג מהיר
    • בדיקת חיבור MongoDB
    • קישורים
  • Development Workflow
    • הוספת Handler חדש
    • הוספת Endpoint ל‑WebApp
    • עדכון Schema במסד הנתונים
    • קישורים
  • Pre-commit Hooks
    • מטרה
    • התקנה והרצה
    • Hooks פעילים (עיקריים)
    • טיפים לפתרון בעיות
  • כלי עזר למפתחים
    • tools/analyze_queries.py
      • מטרה
      • דרישות
      • דוגמת הרצה
      • פלט אופייני
      • טיפים
    • tools/dup_scan.py
      • מטרה
      • דוגמת הרצה
      • פרמטרים חשובים
      • Best Practices
  • סקריפטים שימושיים
    • scripts/cleanup_repo_tags.py
    • scripts/dev_seed.py
    • scripts/import_snippets_from_markdown.py
    • scripts/migrate_workspace_collections.py
    • scripts/run_log_aggregator.py
    • scripts/start_webapp.sh
    • scripts/start_with_worker.sh
    • scripts/run_all.sh
  • בינאום ותמיכה בשפות
    • מבנה הקבצים
    • בחירת שפה בזמן ריצה
    • הוספת שפה חדשה
    • עקרונות כתיבה
    • בדיקות מהירות
  • Integrations
    • GitHub API
      • יצירת Gist (דוגמה)
    • Google Drive (OAuth Flow)
    • Telegram Webhooks vs Polling
    • קישורים
    • GitHub – Scopes נדרשים
    • Troubleshooting GitHub – Rate limits
    • GitHub CLI (gh) – תקציר קצר
    • Repository Providers
    • Best Practices – מאגרים גדולים/Monorepos
  • Repository Integrations
    • סקירה
    • מצב תמיכה
    • הערות
  • Security Guide
    • סודות ופרטיות
    • הרצת קוד (Code Execution Playground)
    • הצפנת טוקנים (דוגמה)
    • CSRF ב‑WebApp
    • Rate Limiting (דוגמה)
    • קישורים
    • אבטחת הודעות בטלגרם
  • Smart Observability v7 – Predictive Health & Adaptive Feedback
    • חיבור Grafana → Telegram (Webhook)
    • Grafana Annotations
    • Adaptive Thresholds (ספים דינמיים)
    • הפרדה בין שגיאות פנימיות לחיצוניות
    • Predictive Health (v7)
      • SAFE_MODE ודילוג על פעולות מנע
      • ChatOps
      • הרשאות ChatOps ו-Rate Limit
      • Grafana – ייבוא דשבורד לדוגמה
    • Grafana – Accuracy & Prevention Panels
      • תרשים זרימת Feedback Loop
    • Auto‑Remediation (v5)
      • Incident Memory
      • Feedback Loop לאירועים חוזרים
    • ChatOps – /observe
      • הרחבות מצב מפורט
    • Endpoints
    • קישורים לתיעוד ChatOps
    • טיפים
  • Git LFS Integration
    • מטרה
    • מתי להשתמש ב‑LFS
    • התקנה בסיסית
    • Best Practices
    • מגבלות וגבולות
    • קישורים
  • סימניות (Bookmarks)
    • מהן סימניות?
    • איך להוסיף סימנייה
    • פאנל הסימניות
    • Anchor יציב
    • מגבלות, אבטחה ופרטיות
    • API קצר (למפתחים)
    • הערות שימושיות
  • פתקים דביקים (Sticky Notes)
    • מהם פתקים דביקים?
    • איך מוסיפים ומנהלים פתקים
    • עיגון יציב לעומת מיקום קבוע
    • שילוב עם סימניות
    • מגבלות, פרטיות ואבטחה
    • טיפים שימושיים
    • API קצר (למפתחים)
    • התראות ותזכורות (Reminders)
      • איורים
    • Troubleshooting קצר
      • בעיות נפוצות בתזכורות
  • תזכורות בבוט
    • סקירה קצרה
    • פקודות עיקריות
    • איך הוויזרד עובד
    • טיפים לשימוש בפקודה מהירה
    • ניהול התזכורות
    • מגבלות ומדיניות
    • מתזמן והתאוששות
    • חיבור לקוד
    • קישורים
  • האוספים שלי (My Collections)
    • מהם אוספים?
    • יכולות מרכזיות
    • איך משתמשים
    • תיוג פריטים באוספים
    • שילוב עם סימניות ופתקים דביקים
    • מגבלות ופרטיות
    • API קצר (למפתחים)
    • טיפים
    • מובייל/טאבלט – גרירה לסידור
    • לוח Kanban עבור שולחן העבודה
  • שיתוף קוד (חשוב)
    • מה זה עושה?
    • איפה הכפתור מופיע?
    • איך זה עובד (זרימה)
    • דרישות סביבתיות (ENV)
    • מגבלות והתנהגות
    • הודעות הצלחה/שגיאה
    • Troubleshooting קצר
    • דוגמאות (טקסטואליות)
  • עיון בקוד GitHub (כולל חיפוש בשם קובץ)
    • שורת כלים
    • תוצאות חיפוש
    • ניווט ריפו
  • הורדת ריפו
    • מה בדיוק מוריד
    • מגבלות
    • הודעות נפוצות
  • תכנית בדיקות לבוט – Composition Root (Container) לשירות Snippet
    • איך לבדוק
    • סט דוגמאות לשמירה (Copy/Paste)
    • בדיקות נוספות
    • תקלות שכדאי לעקוב אחריהן
    • בדיקות זרימה מורחבות (לאחר מעבר ל-Facade/Container)
      • 1) שמירה/תצוגה/עריכה (קבצים רגילים)
      • 2) קבצים גדולים
      • 3) מסמכים/העלאות
      • 4) Google Drive
      • 5) ChatOps – זיהוי שפה (שקיפות ודיבוג)
      • 6) רגרסיה כללית

זרימות עבודה:

  • זרימות עבודה (Workflows)
    • סקירה כללית
    • רשימת זרימות
      • זרימת שמירת קוד (Save Flow)
        • סקירה כללית
        • מצבי שמירה
        • זרימת עבודה בסיסית
        • מצב איסוף ארוך (LONG_COLLECT)
        • זיהוי סודות (Secrets Detection)
        • טיפול בכפילויות
        • נרמול קוד
        • Edge Cases
        • קישורים
      • זרימת חיפוש (Search Flow)
        • סקירה כללית
        • סוגי חיפוש
        • זרימת עבודה
        • מבנה SearchIndex
        • פילטרים
        • טיפול בשגיאות Regex
        • מיון תוצאות
        • חישוב Relevance Score
        • Edge Cases
        • קישורים
      • זרימת רפקטורינג (Refactor Flow)
        • סקירה כללית
        • סוגי רפקטורינג
        • זרימת עבודה
        • שימוש בבוט (Telegram)
        • CodeAnalyzer
        • יצירת הצעת רפקטורינג
        • אימות לפני ואחרי
        • ייצוא לגיסט (אופציונלי)
        • שמירת גרסה
        • Edge Cases
        • מדיניות קיבוץ ופיצול (Cohesion Policy)
        • Smart Clustering ו‑Cycle Guard
        • Safe Decomposition ל‑models.py
        • שמות קבצים דומייניים (Canonical)
        • מצב שכבות (Layered)
        • פרמטרים ניתנים לכוונון
        • מגבלות ידועות
        • קישורים
      • זרימת גיבוי ושחזור (Backup Flow)
        • סקירה כללית
        • סוגי גיבויים
        • יצירת גיבוי מלא
        • שחזור מגיבוי
        • גיבוי ל-Google Drive
        • ניהול גיבויים
        • ייבוא ZIP חיצוני
        • Edge Cases
        • קישורים
    • קישורים

מנועי המערכת:

  • מנועי המערכת (System Engines)
    • סקירה כללית
    • מנוע חיפוש (Search Engine)
    • מנוע רפקטורינג (Refactoring Engine)
    • יכולות מתקדמות (Smart Clustering, Cycle Guard)
    • מצב שכבות (Layered Mode)
    • Safe Decomposition ל‑models.py (פיצול בטוח לחבילת models/)
    • מעבד קוד (Code Processor)
    • מנוע ניתוח (Code Analyzer)
    • מנוע גיבויים (Backup Service)
    • מנוע אינטגרציות (Integration Services)
    • מנוע Observability
    • קישורים

Edge Cases וטיפול בשגיאות:

  • Edge Cases וטיפול בשגיאות
    • סקירה כללית
    • קבצים גדולים
    • קידודים לא סטנדרטיים
    • GitHub Rate Limits
    • MongoDB Connection Errors
    • Redis Unavailability
    • שגיאות Parsing
    • שגיאות File I/O
    • שגיאות Network
    • שגיאות Validation
    • שגיאות Concurrent Access
    • Best Practices
    • קישורים

איכות וקונבנציות:

  • 📝 Type Hints – Best Practices
    • אסטרטגיה: הקשחה הדרגתית
    • פרוטוקולים וסטאבים
    • דוגמאות מהקוד
    • הגדרות MyPy
    • מסלול מיגרציה
    • הנחיות לסוכנים
    • דוגמאות קצרות
  • נרמול קוד (Code Normalization)
    • למה בכלל מנרמלים?
    • מתי ואיפה המנגנון רץ?
    • מה בדיוק קורה במהלך הנרמול?
    • איך לבחור API?
    • דגשים לסוכנים בעת כתיבת קוד
    • טסטים, דיבוג ושחזור תקלות
    • שאלות נפוצות
    • מה לעשות כשמוסיפים זרימה חדשה?
    • קישורים רלוונטיים
  • כללי שכבות – CodeBot
    • שכבות
    • Composition Root
    • זיהוי שפה – מקור אמת
    • בדיקות אכיפה

WebApp:

  • המיני Web App (סקירה)
    • מה נותן?
    • דשבורד חדש
      • אייקוני שפה אחידים
        • טבלת אייקונים נפוצים
      • הנחיות לסוכני AI
    • כתובת והרשאות
    • הגדרות ENV
    • קישורים ותמונות מסך
    • ראו גם
    • באנר הכרזות בראש המסך
      • איך מפעילים?
      • הערות וקישורים
      • מה קורה מאחורי הקלעים?
      • כיבוי זמני
      • המלצות לתוכן
  • דפדפן קוד (Code Browser)
    • ייבוא ריפו חדש
    • הגדרת סנכרון אוטומטי
      • הגדרת Webhook ב-GitHub
      • בדיקת הגדרת ה-Webhook
    • משתני סביבה נדרשים
    • ראו גם
  • Web Push – Sticky Notes Reminders
    • דרישות
    • הגדרת מפתחות VAPID
    • הפעלה/כיבוי
    • מצב Remote Worker (מומלץ לפרודקשן)
      • חלופה: Sidecar (ללא שירות Render נוסף)
    • נקודות קצה (Server)
    • Service Worker
    • צד‑לקוח
    • שליחה בזמן אמת
    • בדיקות
  • ממשקי משתמשים (Web)
    • מה זה?
    • היכן זה נמצא?
    • מסכים בולטים
    • זרימת עבודה דרך הבוט
    • שדות חובה ולוגיקת ולידציה
    • חיווי מצב תהליך
    • ממשק אדמין
    • דוגמאות שימוש לסוכני AI
    • אבטחה ופרטיות
    • הערות תאימות
  • ספריית סניפטים (Web)
    • מה זה?
    • מאפייני UI
    • API – JSON
      • OpenAPI (תקציר)
      • JSON Schema (Response)
      • כללי דפדוף/ספירה
      • שגיאות
      • דוגמאות cURL
    • הגשות, אישור וניהול (אדמין)
    • ייבוא מסמך (אדמין)
    • הגשה דרך הבוט
    • UI בבוט – הסרות ושיפורים
    • גרסה משודרגת – מה חדש
    • מדריך קצר לסוכני AI
  • 🧭 WebApp Onboarding – Welcome Modal, Interactive Tour & Theme Wizard
    • רכיבים ומה הם עושים
    • תרשים אינטראקציה
    • Welcome Modal – רענון קצר
      • מטרות
      • זרימת משתמש
      • סנכרון למדריך העדכני
        • איך לעדכן
      • קישורי מדריכים (Anchors)
      • Best Practices – סימון משתמשים חדשים
      • דוגמת JS – מודאל עם Ajax
      • API קשור
    • Interactive Tour (Driver.js)
      • מתי הסיור נפתח?
      • שלבי הסיור
      • הפעלה ידנית ואיפוס
      • תחזוקה למפתחים
      • Troubleshooting – ”למה הסיור לא מופיע?“
      • צילומי מסך / GIF
    • Theme Picker Wizard (Personalization)
      • סקירה כללית
      • טריגרים והגנות
      • ממשק וחוויית משתמש
      • התמדה וסנכרון שרת
      • 🛠️ Debugging & Reset
      • מדריך בדיקות (QA)
      • צילומי מסך
      • קישורים רלוונטיים
    • Troubleshooting מרוכז – ”למה שום דבר לא קופץ לי?“
    • מדיה והרחבות
  • Caching & HTTP Validators (ETag / Last-Modified / 304)
    • למה זה חשוב?
    • עקרונות בסיס
    • מתכון: Flask + werkzeug
    • בדיקות ידניות (Copy‑Paste)
    • Checklist למימוש נכון
    • Gotchas נפוצים
    • שילוב עם Cache-Control
    • קישורים נוספים
  • מערכת Caching מתקדמת עם TTL דינמי
    • עקרונות
    • קוד לדוגמה
    • דגשים תפעוליים
    • Warmup לנכסי Frontend
    • קישורים
  • Cache Inspector (לוח בקרה של Redis)
    • מה זה Cache Inspector?
      • למה צריך את זה?
    • איך נכנסים?
    • יכולות עיקריות
      • סטטיסטיקות כלליות
      • חיפוש מפתחות
      • הצגת TTL וסטטוס
      • פעולות מחיקה
    • אבטחה ובטיחות
      • הגנת הרשאות
      • הסתרת מידע רגיש (Masking)
      • שימוש ב-SCAN במקום KEYS
      • תקציב זמן למחיקות
    • API Endpoints
      • דוגמאות API
    • תקלות נפוצות
      • Redis מושבת
      • אין הרשאות
      • חיפוש איטי
    • משתני סביבה רלוונטיים
    • ראו גם
  • Static Performance & Security Checklist (gzip/br, Cache, SRI)
    • מטרה
    • דחיסה (br/gzip)
    • כותרות Cache-Control
    • Subresource Integrity (SRI)
    • בדיקות ידניות (Copy‑Paste)
    • Best Practices
    • Gotchas
  • תחזוקת קטלוג הפקודות (commands.json)
    • מבוא
    • מבנה הנתונים (Schema)
    • דוגמת JSON
    • הנחיות סיווג (Taxonomy)
      • טיפים לזיהוי אוטומטי
    • צ’ק-ליסט להוספת פקודה
    • בדיקות
    • כרטיסיות חדשות (דצמ« 2025)
  • הרצת קוד (Code Execution Playground)
    • איפה זה ב‑UI?
    • הרשאות (Premium/Admin)
    • Feature Flag (זמינות הפיצ׳ר)
    • API
      • GET /api/code/run/limits
      • POST /api/code/run
    • אבטחה: מה יש ומה חשוב להבין
      • Docker sandbox (מומלץ)
      • חסימת קוד ”מסוכן“
      • לוגים ופרטיות
    • Fail‑Closed מול Fallback
    • תפעול מומלץ בפרודקשן (Runner נפרד)
    • Troubleshooting
      • ”אין כפתור Run“
      • enabled=false ב‑/api/code/run/limits
      • docker_available=false ב‑limits
    • Known Limitations
  • WebApp API Reference
    • Endpoints
    • Authentication Flow
    • Response Schema Example
    • Errors
    • שגיאות נפוצות – POST /api/shared/save
    • קישורים
    • מסנן ושדות קלט ל-/files
      • טבלת פרמטרים
      • דוגמאות בקשה
      • דוגמאות תגובה
  • Bulk actions (בחירה מרובה)
    • סקירה
    • Endpoints
      • POST /api/files/bulk-favorite
      • POST /api/files/bulk-unfavorite
      • POST /api/files/bulk-tag
      • POST /api/files/create-zip
      • POST /api/files/bulk-delete (Soft Delete)
      • POST /api/files/create-share-link
    • שגיאות נפוצות
    • הערות למפתחים
  • ⌨️ עורך קוד (WebApp Editor)
    • טעינת CodeMirror ומצב isLoading
    • שמירת העדפות משתמש – שני נתיבי API
    • המלצות
  • Markdown – מצב מצומצם (קיפול כותרות ###) – אדמין בלבד
    • מאפיינים עיקריים
    • הזרקת דגל הרשאה לתבנית
    • עקרונות המימוש בצד הלקוח
    • צ’ק‑ליסט לפיצ’רים מקומיים דומים
  • מדריך סגנונות וארכיטקטורת Markdown
    • 1. סקירה טכנית (Architecture)
    • 2. מערכת הצבעים (Reader Mode)
    • 3. קטלוג רכיבים (Component Gallery)
      • Admonitions
      • Tables
      • Task Lists
      • Mermaid
      • Details / Summary
      • Code Blocks
    • 4. הנחיות למפתחים (Best Practices)
  • Smooth Scrolling (WebApp) — מדריך תמציתי לסוכני AI
    • מה פעיל כבר
    • API לשימוש קליינט
    • שמירת העדפות
    • ממשק הגדרות מובנה
    • הנחיות לסוכני AI
    • אנדרואיד — מה יש ומה לא
    • נגישות וביצועים
    • פתרון תקלות
    • תוכנית המשך (Roadmap מקוצר)
    • קישורים פנימיים
  • מודולים פנימיים ב-WebApp
    • activity_tracker.py – דגימת פעילות משתמשים
    • community_library_api.py – REST עבור אוסף הקהילה
    • community_library_ui.py – תצוגת Web
    • snippet_library_api.py ו-snippet_library_ui.py
    • push_api.py – Web Push Subscriptions
    • workspace_api.py – ניהול Kanban (Workspaces)
    • config_radar.py – רנטגן קונפיגורציה
    • איך להשתמש בעמוד זה

Frontend > Theming

  • מערכת ערכות הנושא והטוקנים החדשה
    • רקע ומוטיבציה
    • שכבות משתנים וטעינת data-theme
      • תרשים זרימת היררכיית טוקנים
    • טבלת טוקנים עיקריים
    • מפת ערכות הנושא (Theme Reference)
    • Markdown Viewer ו‑Split View
    • הנחיות למפתחים (Best Practices)
      • דוגמת קוד – לא תקין לעומת תקין
    • Component Tokens ו‑Theme Builder
    • בדיקות חובה לפני Merge
    • שימושים נוספים וחריגים
    • קישורים ונספחים
  • ערכות נושא מותאמות אישית – מדריך מקיף
    • מבוא וסקירה כללית
      • מהי ערכת נושא מותאמת אישית?
      • ההבדל בין Presets לבין Custom Themes
      • יכולות המערכת
    • ייבוא ערכות VS Code
      • פורמטים נתמכים
      • מבנה ערכת VS Code
      • מיפוי צבעי UI
    • יצירה ידנית (Native Format)
      • מבנה הפורמט המקומי
      • משתנים חובה
      • רשימת משתנים מלאה (Whitelist)
    • הדגשת תחביר (Syntax Highlighting)
      • ארכיטקטורה
      • מיפוי VS Code Scopes ל-CodeMirror Tags
      • מנגנון Fallback
      • CodeMirror CSS Classes
    • אבטחה וולידציה
      • ולידציית צבעים
      • סניטציה
    • API Reference
      • Endpoints
      • מבנה תגובה
    • פרסום ערכה לציבורית (Shared Themes)
      • מבנה נתונים ב-DB
      • שמירת משתנים בפרסום
    • פתרון בעיות (Troubleshooting)
      • בעיות נפוצות
      • דוגמה לייבוא ערכת Nord
    • קישורים קשורים

Observability

  • אובזרווביליות (Observability)
    • מטרות
    • קהלי יעד
    • תצורה
    • בחירת Backend ל־Traces
    • הגדרת OTLP לסביבות
    • קישורים
    • אינסטרומנטציה ידנית (Manual Instrumentation)
    • דוקר קומפוז – הפעלה מהירה עם Jaeger
      • Quick start – אימות ספאנים ב־Jaeger
    • כיסוי דקורטור @traced
    • אימות ב-Staging
  • Background Jobs Monitor
    • סקירה כללית
    • רכיבים וקוד רלוונטי
    • מסד נתונים
      • קולקציה: job_runs
    • UI / WebApp
      • גישה לדשבורד
      • מה רואים בדשבורד
      • Jobs סטטיים vs. דינמיים
    • API Reference
      • GET /api/jobs
      • GET /api/jobs/active
      • GET /api/jobs/{job_id}
      • GET /api/jobs/runs/{run_id}
      • POST /api/jobs/{job_id}/trigger
    • אבטחה
      • הגנה על ה-API
    • ENV וקונפיגורציה
      • משתני סביבה
    • ChatOps – פקודת /jobs
      • פקודות זמינות
      • דוגמאות
    • Alerts
      • הגדרות ב-alerts.yml
      • Flow של Alerts
    • Troubleshooting
      • ”הטריגר לא עובד“
      • ”אין jobs דינמיים בדשבורד“
      • ”לא מגיעים Alerts“
      • ”Job תקוע אבל אין התראה“
      • ”השרת מחזיר 401/403“
      • ”לוגים ריקים בדשבורד“
    • Best Practices
    • ראו גם
  • 📡 Observability Dashboard & API
    • 🖥️ סקירת הממשק /admin/observability
      • חלוקת הדף
      • יכולות סינון
      • מקרא ו־UI
      • 🤖 הסבר AI להתראות
    • 📚 API Reference
      • פרמטרי זמן משותפים
      • GET /api/observability/alerts
        • Meta מועשר להתראות High Error Rate
      • GET /api/observability/aggregations
      • GET /api/observability/timeseries
      • GET /api/observability/replay
      • Runbooks דינמיים + Quick Fix
      • GET /api/observability/export
      • POST /api/observability/quickfix/track
      • POST /api/observability/alerts/ai_explain
    • 🔐 אבטחה, Rate Limiting וקאש
    • 🔌 אינטגרציות ודוגמאות שימוש
      • Grafana / BI
      • Slack / On-call Bot
      • שילוב עם Config Radar
      • רפרנס ל־README
    • ✔️ מה הלאה?
  • Query Performance Profiler
    • Overview
      • קהל יעד
      • מה הכלי לא עושה
    • ממשק משתמש (WebApp)
      • הנתיב
      • איך להגיע
      • מה רואים בדשבורד
    • API Reference
      • Authentication
      • Endpoints
        • GET /api/profiler/summary
        • GET /api/profiler/slow-queries
        • POST /api/profiler/explain
        • POST /api/profiler/recommendations
        • GET /api/profiler/collection/<name>/stats
    • Security
      • Authentication
      • הגדרת Token
    • אזהרת Observer Effect
    • Privacy / PII
    • Persistence
      • Collection
      • TTL Index
      • אינדקסים נוספים
    • Metrics (Prometheus)
    • Environment Variables
    • המלצות אופטימיזציה נפוצות
    • קישורים נוספים
  • 🧠 Quick Fix חכם (Queue Delay + עומס/DB) – הנחיות למפתחים ולסוכני AI
    • איפה זה מופיע
    • מקור אמת: איפה החוקים חיים
    • טבלת החלטה (Latency / Slow Response)
    • אילו שדות אנחנו משתמשים בהם (סכמת נתונים)
      • אותות עיקריים
      • עומס ומשאבים
      • “DB Pool utilization”
    • עקרונות Safety (חשוב)
    • איך להוסיף/לשנות חוק (צ’קליסט למפתחים ול‑AI)
    • הערות לסוכני AI (איך לעבוד נכון)
  • Asyncio תחת WSGI: הרצת קורוטינות בבטחה
    • רקע קצר
    • תסמינים נפוצים
    • מתי זה קורה בפועל
    • דפוס בטוח מומלץ
    • דוגמה קצרה
    • Checklist לפני דיפלוי
  • Visual Rule Engine - מנוע כללים ויזואלי
    • סקירה כללית
    • זרימת ההחלטה
    • UI Walkthrough
      • גישה למסך הכללים
      • יצירת כלל חדש
      • הפעלה/כיבוי כלל
      • מחיקת כלל
    • מבנה הכלל (JSON Schema)
      • שדות הכלל
      • דוגמה 1: כלל פשוט (Suppress)
      • דוגמה 2: כלל עם Group (AND)
      • דוגמה 3: OR עם NOT פנימי
      • דוגמה 4: GitHub Issue לשגיאות Sentry חדשות
    • פעולות (Actions)
      • suppress
      • send_alert
      • create_github_issue
      • webhook
    • Evaluation Context - שדות זמינים
      • שדות בסיסיים מההתראה
      • שדות מ-details
      • שדות מדדים
      • שדות זמן (מחושבים)
    • אופרטורים
    • אבטחה
      • הרשאות אדמין
      • Webhook SSRF Protection
    • הסימולטור
    • משתני סביבה
    • פתרון בעיות
      • ”הכלל לא רץ“
      • ”webhook נחסם“
      • ”is_new_error תמיד False“
      • ”GitHub Issue לא נוצר“
    • Test Plan
    • API Reference
    • קישורים
  • Coverage Report (Runbooks / Quick Fixes)
    • מטרה
    • מקור האמת (Catalog / Registry)
    • הגדרות כיסוי (Matching)
      • Runbooks
      • Quick Fixes
    • מה מוצג בדוח
    • API
  • 🧠 Observability AI Explain API
    • 🔐 אימות ובקרות
    • 📥 בקשה (POST /api/ai/explain)
    • 📤 תגובה מוצלחת (200 OK)
    • ❗ קודי שגיאה
    • ⚙️ קונפיגורציה נדרשת
    • 🧪 בדיקות
    • 📝 טיפים לפריסה
  • Rate Limiting
    • מבוא
    • Shadow Mode
    • Soft‑Warning (80%)
    • Admin Bypass
    • Monitoring
    • Troubleshooting
    • קישורים
  • 📊 הנחיות Observability ואירועים
    • תבנית אירוע/לוג – שדות חובה
    • עקרון Fail-Open
    • הנחיות טיפול בשגיאות
    • קורלציה עם request_id
    • סטנדרטים נוספים
  • סכמת לוגים ואירועים (Observability)
    • שדות חובה בכל אירוע
    • שדות מומלצים
    • אירועים מרכזיים
    • דגימה (Sampling)
    • פרטיות
  • מדדים (Metrics)
    • נקודת קצה
    • מטריקות קיימות
    • מדדי CodeBot ייעודיים (Handlers/Commands/DB)
    • מטריקות OpenTelemetry (אם זמינות)
    • דוגמאות PromQL
    • Tracing ב-Grafana
    • SLO/SLI לדוגמה
    • התראות (Prometheus alerting rules)
  • Resilience לשירותים חיצוניים
    • למה שכבה מרוכזת?
    • איך זה עובד?
    • דיאגרמת טיפול בשגיאות
    • קונפיגורציה חשובה (ENV)
    • טיפ
    • שימוש בקוד
    • ראו גם
  • התראות (Alerts)
    • סקירה מהירה
    • חוקי ברירת המחדל
    • התאמה לצרכים שלך
    • מדדי Health ו-Startup ל-Prometheus
    • קונפיגורציית alert_manager באפליקציה
    • טעינת שינויים
    • בדיקת הזרימה בקצה השני
    • טיפים אחרונים
    • ראו גם
    • התראות מערכת – דיסק כמעט מלא
  • התראות מבוססות לוגים (Log‑based Alerts)
    • מה זה ולמה
    • הרכיבים בקוד
    • קבצי קונפיג
      • דוגמה מינימלית: config/error_signatures.yml
      • דוגמה מינימלית: config/alerts.yml
    • Option B – חיבור בתוך הקוד (מומש)
      • משתני סביבה
    • Option A – Sidecar מזרם לוגים
    • ספים וקיבוץ – ברירות מחדל
    • אסטרטגיית fingerprint וקנוניקליזציה
    • צ’קליסט למפתחים
    • בדיקה מקומית (סימולציה)
    • הנחיות לסוכני AI
    • אבטחה ופרטיות
    • Rollout מומלץ
    • Troubleshooting
    • ראו גם
    • קישורים לקוד
    • טקסונומיית שגיאות וחתימות
      • תרשים זרימה מקוצר
    • תצוגה ב‑ChatOps
      • פלט לדוגמה (Placeholder)
    • קריאת המשך – classify_error()
  • מנוע ניתוח לוגים (Log Event Aggregator)
    • ארכיטקטורה
    • קונפיגורציה וקבצים
    • הרצת CLI מקומית
    • שילוב במערכת
    • עבודה בטוחה
    • ניפוי תקלות נפוץ
  • Sentry
    • הפעלה (משתני סביבה)
    • התראות ל־Telegram וללוח Observability
      • איפה להגדיר משתנים
      • מה צריך כדי שזה יופיע בלוח Observability
      • מה צריך כדי שזה יישלח לטלגרם
      • Polling – משתנים רלוונטיים
      • Webhook – אבטחה ודה-דופליקציה
    • עקרונות
  • Incident Checklist (On‑Call)
    • בעת פתיחת Incident
    • סטטוסי מעקב אחידים
    • קישורים
  • שינוי רמות לוגים
    • מתי להעלות ל-DEBUG
    • טיפ
  • GitHub Backup & Restore Runbook
    • מטרה
    • דרישות מקדימות
    • יצירת נקודת גיבוי (Checkpoint Tag)
    • יצירת ארכיון ZIP
    • שחזור – בדיקה מקומית
    • שחזור מלא לפרודקשן (זהירות!)
    • שחזור קבצים/תיקיות נקודתיים
    • טיפים ובטיחות
    • קישורים
  • Runbooks – SLO Incidents
    • HighErrorRate
    • SLOAvailabilityBreach (זמינות < 99.9%)
    • SLOLatencyP95Breach (P95 > 0.5s)
    • תקלת התחברות ל‑DB (MongoDB) – קריטי
      • סימפטומים
      • סדר פעולות (בקצרה)
    • איטיות/נפילה של שירות חיצוני – בינוני
      • סימפטומים
      • סדר פעולות
    • באג אחרי Deploy / Release – משתנה
      • סדר פעולות
    • דשבורד

פריסה ו-Workers

  • עובדי Push ו-Edge
    • Cloudflare Worker (/worker)
    • Node Push Worker (/push_worker)
    • חיבור ל-WebApp (webapp/push_api.py)
    • בדיקות ועצות

ChatOps

  • ChatOps – סקירה כללית
    • עקרונות
    • קישורים
  • פקודות ChatOps
    • כרטיסיות חיפוש (Ctrl/Cmd+K)
    • /status
    • /health
    • /uptime
    • /system_info
    • /check commands
    • /metrics
    • /observe
    • /observe -v (מפורט)
    • /observe -vv (מפורט מאוד)
    • /errors
      • סטטוסי תוצאות (Mappings)
    • /alerts
    • /jobs
    • /incidents
    • /triage
    • /predict
    • /accuracy
    • /rate_limit
    • /enable_backoff
    • /disable_backoff
    • /sen
    • /lang
    • /lang_debug
    • /dm
    • /silence
    • /unsilence
    • /silences
    • /cache_stats
    • /clear_cache
    • /cache_warm
    • /cache_clear_stale
    • /debug_cache
    • /status_worker
    • /version_history
  • ChatOps – /observe: הרחבות -v ו- -vv
    • תחביר ופרמטרים
    • דוגמאות
    • פלט לדוגמה – ‎-v
    • פלט לדוגמה – ‎-vv
    • הערות שימוש
    • קישורים רלוונטיים
  • הגבלת קצב לפקודות רגישות
    • עקרונות מרכזיים
    • שימוש בדקורטור
    • קונפיגורציה
    • שילוב בבוט
    • Autodoc
  • Playbooks – תרחישים נפוצים
    • p95 Latency עלה מעל הסף
    • Error Rate > 1%
    • Memory Usage מטפס
    • שירות חיצוני איטי
    • Repeated Incident תחת 15 דק«
  • הרשאות ו-Rate Limit
  • פתרון תקלות (FAQ)
  • שאלות נפוצות

סוכני AI:

  • 🤖 מדריך לסוכני AI
    • נקודת פתיחה מהירה
    • מבנה הפרויקט (בקצרה)
    • הוספת פיצ’רים
    • סקריפטים חשובים
    • מפת דרכים
    • GitHub Issues ו-ChatOps
  • 🚦 מערכת Rate Limiting לסוכני AI ולווב
    • אסטרטגיה – Shadow Mode תחילה
    • משתני סביבה וקונפיג
    • אינטגרציה – בוט טלגרם
    • אינטגרציה – Flask/WebApp
    • החרגות חשובות
    • ניטור ומדדים (Prometheus)
    • אבטחה והגנות
    • קונפיגורציה (Pydantic Settings)
    • תקלות נפוצות
    • קישורים

Observability – Advanced

  • קטלוג אירועים קנוניים
    • GitHub
    • DB
    • Web/Share
    • Alerts
    • Repo Analyzer
    • Business
  • מילון קודי שגיאה (Error Codes)
    • דוגמאות מיפוי
    • הנחיות
  • Tracing ממוקד בנקודות חמות
    • תרשימי זרימה
      • זרימת bot.update
        • מאפיינים מומלצים ל‑Spans (bot.update)
      • זרימת web.request
        • מאפיינים מומלצים ל‑Spans (web.request)
    • טבלת ”היכן עוטפים“
    • דוגמת Trace Viewer
    • הטמעת דקורטור ושימוש בפונקציות עזר
    • Best Practices
    • ראו גם
  • שאילתות PromQL שימושיות
    • זמן תגובה (Latency)
    • שיעור שגיאות
    • אירועי ביזנס
  • Playbook קצר להתראות
    • זרימה
    • דיאגרמת מערכת התראות חכמות
    • קישורים בקוד
    • דגשים
    • כיוונון רעש
    • טיפים מהירים
Code Keeper Bot
  • API Reference
  • workspace
  • webapp package
  • View page source
Previous Next

webapp package

Web Application for Code Keeper Bot ממשק ווב לבוט שומר קבצי קוד

Submodules

  • webapp.app module
  • webapp.bookmarks_api module
  • webapp.collections_api module
    • emit_event()
    • get_db()
    • get_manager()
    • require_auth()
    • sanitize_input()
    • tags_rate_limit()
    • create_collection()
    • list_collections()
    • get_collection()
    • update_collection()
    • delete_collection()
    • get_items()
    • add_items()
    • remove_items()
    • reorder_items()
    • update_item_tags()
    • get_tags_metadata()
    • log_tags_filtered()
    • update_share()
    • get_shared_collection()
    • get_shared_file()
    • download_shared_file()
    • export_shared_collection()
    • save_shared_collection_to_webapp()
    • save_shared_file_to_webapp()
    • not_found()
    • internal_error()
  • webapp.collections_ui module
    • collections_page()
    • collections_page_with_default()
    • shared_collection_page()
  • webapp.sticky_notes_api module
    • emit_event()
    • get_db()
    • kickoff_index_warmup()
    • require_auth()
    • notes_rate_limit()
    • list_notes()
    • get_note_reminder()
    • set_note_reminder()
    • delete_note_reminder()
    • snooze_note_reminder()
    • reminders_summary()
    • reminders_list()
    • reminders_ack()
    • create_note()
    • update_note()
    • delete_note()
    • batch_update_notes()
Previous Next

© Copyright 2026, Development Team.

Built with Sphinx using a theme provided by Read the Docs.