Compare commits

..
18 Commits
Author SHA1 Message Date
javad 2e5d0bcdd3 some improve 2026-10-27 11:49:09 +03:30
javad fa73a734a0 improve bazdid 6 2026-10-22 14:01:08 +03:30
javad 99c25a8216 improve bazdid 5 2026-10-21 16:34:38 +03:30
javad 825f2a5973 improve bazdid 4 2026-10-21 16:34:13 +03:30
javad 8fd881e0ea improve bazdid 4 2026-10-21 15:13:35 +03:30
javad f86d060e4d improve bazdid 3 2026-10-21 12:24:52 +03:30
javad f8d768a724 improve bazdid 2 2026-10-21 11:28:01 +03:30
javad 534a84f977 improve bazdid 2026-10-21 10:50:42 +03:30
javad 2aee85593f improve entezar bazdid 2026-10-20 19:02:34 +03:30
javad 1fd27d0445 fix mandehesab, bazdid, sms 2026-10-16 17:54:07 +03:30
javad 7e5c83bea2 fix mobile and names 2026-10-15 11:21:55 +03:30
javad e3a6d1f9d4 fix sms 2026-10-11 19:04:20 +03:30
javad 1dea3509a7 fix phone columns 2026-10-10 17:51:30 +03:30
javad 69de29a8fa docker compose edit 5 2026-10-10 16:21:52 +03:30
javad e9ffc11e44 docker compose edit 4 2026-10-10 15:39:54 +03:30
javad b82a2f61a8 docker compose edit 3 2026-10-10 15:29:40 +03:30
javad 0fcb7632cb docker compose edit 2 2026-10-10 15:23:12 +03:30
javad f273c83a5e docker compose edit 2026-10-10 15:01:13 +03:30
86 changed files with 160903 additions and 17012 deletions

No files matched your search

+66
View File
@@ -0,0 +1,66 @@
# ==========================================
# 1. Operational Style & Communication (Claude Code Style)
# ==========================================
You are an expert engineer. Deliver high-signal, structured technical execution with zero conversational fluff.
## Communication Rules
- Match the user's language (Persian or English).
- Be direct, terse, and technical. Never use pleasantries, greetings, apologies, or robotic affirmations.
- Do NOT output preamble text or explanations before invoking tools; execute immediately.
- Never run interactive or long-running commands (e.g., ensure test commands include non-blocking flags).
## Task Wrap-Up Format
- Minor fixes (single file/few lines): Output a single sentence or "Done."
- Complex or multi-step tasks: Output ONLY this structured summary:
- 1-sentence summary of the fix/feature.
- Bullet points of key modified files and core changes.
- Test/build verification status.
- Required manual actions (e.g., .env keys or migrations), only if strictly necessary.
# ==========================================
# 2. Project Operating Guidelines
# ==========================================
## Codebase Navigation & Analysis (Ripwire vs. Graphify)
- Default to Ripwire for all hands-on coding, AST, edits, call graphs, and tests.
- Reserve Graphify strictly for high-level architectural understanding, cross-artifact relations, and non-code assets.
- CLI-only (never use MCP). Route strictly by question and artifact type.
- Never query both tools for the same sub-task; never execute in parallel. Always prefer `--expand` over reading entire files.
- Trivial edits (<= 1 file, no exported symbols): Modify directly without querying either tool.
- Routing gate:
- Code, symbols, AST, usages, impact, tests -> Ripwire.
- Architecture discovery, cross-artifact concepts (PDF, media, docs, ADR/RFC), SQL schemas -> Graphify (.sql symbols use Ripwire; schema semantics use Graphify).
- Ambiguous/Mixed -> run `ripwire . --help-task="task"` to classify.
- Graphify rules: Requires `graphify-out/graph.json` (if absent, fallback to Ripwire). Match terms directly against graph vocabulary. Cross-verify graph findings against source code before editing.
- Pre-edit gate: Inspect target symbol with both `ripwire . --impact=SYM` and `ripwire . --uses=SYM`.
- Post-edit pipeline: Run `ripwire . --test-gate` followed by `ripwire . --quality-delta`.
## Dynamic Help, Self-Correction & Staleness
- Help precedence: Inspect `ripwire --help` or `ripwire --help=--FLAG` when uncertain; CLI help is authoritative.
- Retries: Cap at 1 retry on failures.
- Stale data: Run `graphify update .` or `ripwire . --no-cache` and retry once.
- Missing binary: Report missing dependency clearly; do not guess syntax.
## Git Operations & Safety
- Read-only for agent: Allowed commands are strictly `git status`, `git diff`, and `git log`.
- Human-gated: NEVER run `git add`, `commit`, `push`, `checkout`, `merge`, `rebase`, or branch commands. Ask the user to execute these and pause.
- Exception: `graphify hook install` is permitted (read-side only).
## Development Server Lifecycle
- Binding: Always bind Django to `0.0.0.0:8000` (LAN accessible). Never use `127.0.0.1` unless explicitly requested.
- Process management: Inspect port 8000 and terminate previous project server instances before launching.
- Health check: Confirm exactly one process listens on `0.0.0.0:8000`, then verify health via local fetch to `127.0.0.1:8000`.
- Asset verification: Verify served frontend content on live server before diagnosing browser cache issues.
## Environment, Frontend & PWA Safety
- Python venv: Strictly use `.venv` for all Python/Django operations (`.venv/Scripts/python.exe` on WSL, `.venv\Scripts\python.exe` on Windows). Run pip with `<venv-python> -m pip` and Django with `<venv-python> manage.py ...`.
- PyPI Mirror: Use Liara mirror: `https://package-mirror.liara.ir/repository/pypi/simple`.
- Asset versioning: Local frontend assets must include `static_asset_version` in URLs.
- PWA: Keep service worker registration URL versioned with `updateViaCache: 'none'`.
- Cache regression gate: Frontend/PWA cache changes must pass assertions in `tests/test_views.py` and `tests/e2e/test_pwa_versioning.py`.
## End-to-End Browser Tests (Playwright)
- Tests live in `tests/e2e/`, marked with `e2e`, run against Django's transactional `live_server`.
- Use Chromium and BrowserContext from `tests/e2e/conftest.py`. Function-scoped to avoid deadlocks.
- Page Objects: Encapsulate in `tests/e2e/pages/`. Assert user-visible outcomes only.
- Synchronization: Never use hardcoded sleeps; use Playwright locators and assertions.
+6
View File
@@ -56,6 +56,12 @@ RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
# کپی کردن و واگذاری مالکیت محیط مجازی به کاربر django
COPY --from=builder --chown=django:django /opt/venv /opt/venv
# کپی صریح فایل دادهٔ نام‌های ایرانی (پیش‌نیاز دستور fix_customer_names).
# صریح نوشته شده تا حتی اگر context ساخت یا .dockerignore در آینده عوض شود،
# فایل بی‌سروصدا از ایمیج بیرون نیفتد. اگر فایل در context نباشد، build با خطای
# روشن شکست می‌خورد (fail-fast) — بهتر از اجرای دستور روی سرور و خطای «فایل پیدا نشد».
COPY --chown=django:django iranianNamesDataset.json /app/iranianNamesDataset.json
# کپی کردن تمام کدهای پروژه با مالکیت کاربر محدود شده
COPY --chown=django:django . .
+302 -25
View File
@@ -1,11 +1,11 @@
Project Root: khatibi
Generated At: 2026-10-10T06:32:47+00:00
Python Files: 153
Generated At: 2026-10-27T07:48:20+00:00
Python Files: 194
Django Files: 12
JavaScript/TypeScript Files: 14
HTML Files: 54
Total Files: 523
Total Directories: 74
HTML Files: 59
Total Files: 794
Total Directories: 81
khatibi
├── .cursor
@@ -20,6 +20,10 @@ khatibi
│ │ └── graphify.js
│ └── opencode.json
├── .run
│ ├── delivery.pid
│ ├── scanner.pid
│ ├── web.pid
│ └── worker.pid
├── admin
│ ├── migrations
│ │ └── __init__.py
@@ -34,8 +38,14 @@ khatibi
│ ├── management
│ │ ├── commands
│ │ │ ├── __init__.py
│ │ │ ├── cleanup_visit_dedup.py
│ │ │ ├── fix_customer_names.py
│ │ │ ├── fix_customer_phones.py
│ │ │ ├── gt_esh.py
│ │ │ ├── normalize_customer_sms_phones.py
│ │ │ ├── recalc_last_bazdid.py
│ │ │ ├── send_daily_report.py
│ │ │ ├── sms_delivery.py
│ │ │ ├── sms_scan.py
│ │ │ ├── sms_worker.py
│ │ │ └── sqlite_db_backup.py
@@ -103,6 +113,25 @@ khatibi
│ │ ├── 0060_sms_permission_label.py
│ │ ├── 0061_sms_timing_and_primary.py
│ │ ├── 0062_sms_link_provider.py
│ │ ├── 0063_alter_smsqueue_status.py
│ │ ├── 0064_sms_webservice_delivery.py
│ │ ├── 0065_smsproviderconfig_test_message.py
│ │ ├── 0066_smsdedup.py
│ │ ├── 0067_customer_notes.py
│ │ ├── 0068_auto_20261010_1305.py
│ │ ├── 0069_smstemplate_auto_send.py
│ │ ├── 0070_sms_types_seven.py
│ │ ├── 0071_sms_settings_permission.py
│ │ ├── 0072_customernamefixjob.py
│ │ ├── 0073_alter_action_actiontype_choices.py
│ │ ├── 0074_alter_action_status_choices.py
│ │ ├── 0075_cheque_funding_before_due.py
│ │ ├── 0076_alter_smstemplate_text_help.py
│ │ ├── 0077_alter_smstemplate_text_balance_help.py
│ │ ├── 0078_action_visit_covering_index.py
│ │ ├── 0079_customer_visit_hold.py
│ │ ├── 0080_action_soft_delete.py
│ │ ├── 0081_sms_type_install_created.py
│ │ └── __init__.py
│ ├── models
│ │ ├── __init__.py
@@ -117,13 +146,18 @@ khatibi
│ │ └── users.py
│ ├── sms
│ │ ├── __init__.py
│ │ ├── balance.py
│ │ ├── enqueue.py
│ │ ├── notices.py
│ │ ├── parts.py
│ │ ├── phone_cleanup.py
│ │ ├── phones.py
│ │ ├── recipients.py
│ │ ├── render.py
│ │ ├── rules.py
│ │ ├── scanner.py
│ │ └── timing.py
│ │ ├── timing.py
│ │ └── triggers.py
│ ├── static
│ │ └── admin_panel
│ │ ├── DataTables
@@ -208,7 +242,8 @@ khatibi
│ │ ├── customer
│ │ │ ├── customerNazarInc.html
│ │ │ └── nazar.html
│ │ ├── _customer_sms.html
│ │ ├── _customer_info.html
│ │ ├── _customer_phones.html
│ │ ├── ActionList.html
│ │ ├── base.html
│ │ ├── baseHesabdari.html
@@ -234,6 +269,7 @@ khatibi
│ │ ├── customers.html
│ │ ├── customerSarresid.html
│ │ ├── customersBK.html
│ │ ├── customerSmsHistory.html
│ │ ├── entezar.html
│ │ ├── entezarBK.html
│ │ ├── financial_dashboard.html
@@ -253,6 +289,7 @@ khatibi
│ │ ├── reportCheckNesiye.html
│ │ ├── rezayat.html
│ │ ├── sms_queue.html
│ │ ├── sms_report.html
│ │ ├── sms_settings.html
│ │ ├── sms_templates.html
│ │ ├── store.html
@@ -278,19 +315,33 @@ khatibi
│ ├── admin.py
│ ├── apps.py
│ ├── context_processor.py
│ ├── name_fix.py
│ ├── services.py
│ ├── signals.py
│ ├── tests.py
│ ├── urls.py
│ ├── views - Copy.py
│ └── viewsBK.py
│ ├── viewsBK.py
│ └── visit_policy.py
├── data9
│ ├── backup-20261020-180934.sqlite3
│ ├── backup-20261020-213406.sqlite3
│ ├── backup-20261020-213406.sqlite3-shm
│ ├── backup-20261020-213406.sqlite3-wal
│ ├── db2 (2).sqlite32
│ ├── db2.sqlite32
│ ├── db222.sqlite3
│ ├── kt.sqlite3
│ ├── kt.sqlite3-shm
│ └── kt.sqlite3-wal
│ ├── khatibi92669266_backups_db_backup_20261020_223011.sqlite3
│ ├── khatibi92669266_backups_db_backup_20261020_223011.sqlite3-shm
│ ├── khatibi92669266_backups_db_backup_20261020_223011.sqlite3-wal
│ ├── khatibi92669266_backups_db_backup_20261021_223009.sqlite3
│ ├── khatibi92669266_backups_db_backup_20261021_223009.sqlite3-shm
│ ├── khatibi92669266_backups_db_backup_20261021_223009.sqlite3-wal
│ └── kt.sqlite3
├── docs
│ ├── entezar_action_fields_report.html
│ ├── entezar_action_fields_report.md
│ └── visit_hold_entezar.md
├── graphify-out
│ ├── 2026-10-09
│ │ ├── .graphify_analysis.json
@@ -299,67 +350,184 @@ khatibi
│ │ ├── graph.json
│ │ ├── GRAPH_REPORT.md
│ │ └── manifest.json
│ ├── 2026-10-10
│ │ ├── .graphify_analysis.json
│ │ ├── .graphify_labels.json
│ │ ├── .graphify_semantic_marker
│ │ ├── graph.json
│ │ ├── GRAPH_REPORT.md
│ │ └── manifest.json
│ ├── 2026-10-11
│ │ ├── .graphify_analysis.json
│ │ ├── .graphify_labels.json
│ │ ├── .graphify_semantic_marker
│ │ ├── graph.json
│ │ ├── GRAPH_REPORT.md
│ │ └── manifest.json
│ ├── 2026-10-16
│ │ ├── .graphify_analysis.json
│ │ ├── .graphify_labels.json
│ │ ├── .graphify_semantic_marker
│ │ ├── graph.json
│ │ ├── GRAPH_REPORT.md
│ │ └── manifest.json
│ ├── 2026-10-20
│ │ ├── .graphify_analysis.json
│ │ ├── .graphify_labels.json
│ │ ├── .graphify_semantic_marker
│ │ ├── graph.json
│ │ ├── GRAPH_REPORT.md
│ │ └── manifest.json
│ ├── 2026-10-22
│ │ ├── .graphify_analysis.json
│ │ ├── .graphify_labels.json
│ │ ├── .graphify_semantic_marker
│ │ ├── graph.json
│ │ ├── GRAPH_REPORT.md
│ │ └── manifest.json
│ ├── cache
│ │ ├── ast
│ │ │ └── v0.9.82-s7
│ │ │ ├── 0075bdcd95747f7c750eba8757614aab71d4d8c77bd6764e4c5a98fe18dc8997.json
│ │ │ ├── 0175e34128b5ac5119a5da4cc53d889dce334d8f20357631d54627c53cae9b8e.json
│ │ │ ├── 01850b7fad89dcb9e521fceed2c41e64e9909a0f4c4a54d818d346ccf63bbc5d.json
│ │ │ ├── 01b87542be8c5f2850a08a631287f94a89184e186d5cfca4d585800f41ee0f5d.json
│ │ │ ├── 0317da4b3f4f0b0b5f6cf487567ec7e1b6f3bed2c6ad5cb19bd526a020521c10.json
│ │ │ ├── 0348dd4662ebd96572421864ce77a266334a327f8bcbdc237d54c313d116bafb.json
│ │ │ ├── 03c6fb41770a9293658a5db5af36f7e4afe64ae04b3ce8cc6c5874320706fd22.json
│ │ │ ├── 0400cc0eadd706ff70ef627ffe39f401fc72a591dcbcd5463fca07fc271f080d.json
│ │ │ ├── 0442dd7e8445ba796e02aaefde16760c8ed37f63359d4319498be512f60266bd.json
│ │ │ ├── 056f0cb55bfd5a1ddf744c7c824c342048c1db47f3bb350030a1533ab56bf8d7.json
│ │ │ ├── 05b753e15288fbd02b721b00cfd03c3a523e9e234420330b980a462a1de2dad6.json
│ │ │ ├── 07eb6ef411f8e9b78d19cfd5f262bfc9fc482701f0834c8936cbb5ba2b14efab.json
│ │ │ ├── 0b48631fc75356bef276f694d7db5b457bd2315410fd4538680612fe10b95eb2.json
│ │ │ ├── 0b8f8e3b6e4d84256e784dabb96f5646fa6e7295adbd20648c235e7821b4ca1d.json
│ │ │ ├── 0e6bfa570caca1f79f549f5cdc37f8bdf9c9b43a023ca28a8fcb83351389b399.json
│ │ │ ├── 100f37182d082767395fcd09f1ec937fd74e57ed039885843bf81d349c3fc1f5.json
│ │ │ ├── 10615f5a999e04257afc03cdc52e1b9e4e11ae7818d7c64ae13b976e3974feb4.json
│ │ │ ├── 11042a6b38137d4e725c18d536cde9c98652782cb58390aa6216dacad2d18cf5.json
│ │ │ ├── 1219157d5f2c0a61d4069d2e7067d2eaf1c6403fcd5965743d9a196fe4564184.json
│ │ │ ├── 1285cdf9b89689e3ac99cea19470a3c14fdbf3a9d1bb2cd8da2cfdbd42ca940f.json
│ │ │ ├── 128b2b616c097fbfbcbc3fddafc224df0919ba261bb5ded7bcafa8b445fe118b.json
│ │ │ ├── 12d922593c75865b8068057f9244ad61a5ee573b7f3f38a16c31fa83abb9d668.json
│ │ │ ├── 13a39530fbb076496d510363b40bf16093d8d117751e7240bcc09a447bdace35.json
│ │ │ ├── 13ca1f37c3eea3c07228d2d98d47f7db6a9c1d8468b259651f3fea5419651569.json
│ │ │ ├── 143902d3d7280d781e9f6a8e366068809dec67bd385462175012f9b5c072e470.json
│ │ │ ├── 14f64f9b156b6b520e7af189b303a2844728f3ab8bbe1e65fed49160b1431cb2.json
│ │ │ ├── 15be5091a5bfbf8f48c3f3ae344a980be5452eab00f054c001958aae96557514.json
│ │ │ ├── 174e406c2649f2384921581cbf912945a95d54aab73707b9aa45752aaa7c54d7.json
│ │ │ ├── 17850e40dfa0d02ec3b0d4b2e1f9b931fe6a3a90c6cd874dabeb9466bed5f1d1.json
│ │ │ ├── 183467d5c1ee7daac78dfb428bd335c17e17272bd4510358f38fc5924140c816.json
│ │ │ ├── 1893253c5245ae073f9de9168d537384ab764b79d7b1631c785cd7335aab791b.json
│ │ │ ├── 1b244c373e08c304261f7f760687c7ebe0ba9c79e7ab7ea16c3fa4768da959f5.json
│ │ │ ├── 1ceebfc94adbc38aa951c83044b67943bc4032309ba3a61d9335dd833d49bbef.json
│ │ │ ├── 1d5a29a9dabb365c079039c788988636b66c3a4bd2dbe66b249df001c2b5396f.json
│ │ │ ├── 1d7a28f73bb52bbc018674a0c01405b7f395bcc5f340ecabe332e2fe440bcae8.json
│ │ │ ├── 1d9f15f04104af07c60349f21bcd9f6f2c0e65c915e3e9c69040a10197b0fa6f.json
│ │ │ ├── 1dd0c6958a307a1e4e59c24f20225292277585dd8652b35537ede94fc04807ee.json
│ │ │ ├── 1f7001563689c4ba77d24f98418fd10725419d45385094fd18d89f20573d6453.json
│ │ │ ├── 20652a8d348bf514ac266f30a6400f923674dae819d18046d008066943377804.json
│ │ │ ├── 21af53aa7322868a25b47458e59f339a8f6e58b7914fbe8e3389ab86e0b0b643.json
│ │ │ ├── 22310d4d49f2beee611c83915933ea06e80ec562fd92c170345c556cd3772561.json
│ │ │ ├── 2356cb9f067d43739312459bad2cb6d9ecbacac703e7e40a282d5b89d64332b3.json
│ │ │ ├── 23c92d4714bc2e410ae9267e6ea7c139d5b16215da917f9a89c44a29724c69d7.json
│ │ │ ├── 23da13b308596ede7678e92e57041bcecdd8e9baff04b759ddf9a69803dd790a.json
│ │ │ ├── 23f4e3a62e03a38743659d94dd1350d17775da8be9175846e4ff3f38fa87c515.json
│ │ │ ├── 24508e7a9b6fa93cdd28b9436bdb55fa24ad8f324baa95adb3afd37e301af9ac.json
│ │ │ ├── 2501a9885d6fa5292276ee8cc7db63a9a3c08605f38d199d425d33f650dac35e.json
│ │ │ ├── 25dbf169bbd8ae50f7cc568b4dbb7d259eb993ccddc9dbb20db96018ed093f5a.json
│ │ │ ├── 28b192ecdcd9b33d8e4980d5043b6b2bc59095df392e22bf44d2166f7fa6d5ba.json
│ │ │ ├── 28df8bbd275806fd77c086629211231bd1329fe8156f521b19b5c5979f0d3b51.json
│ │ │ ├── 294e2d390f56acc0445564d428d90c641d76496cbc457bcfb09876382e9d87ab.json
│ │ │ ├── 2976c530804df2075019fedaf2b908eeeff37b2703310c7e031b653d1fec71e5.json
│ │ │ ├── 2c587e304ae13b0717d72f5099508220c82234a8a293219c2ed2c97df9152404.json
│ │ │ ├── 2f36d1565911fdcb414da716162085b0fdc4b92d9d2d3fbb9fecc403b1916766.json
│ │ │ ├── 3089c169c5eb18e61b13a19751166813d18c7bbe35b938b2b149406ff349feda.json
│ │ │ ├── 3258762ed4d4077750967504aecb42df00c35a69571f5d4839d4cfebd9b1c838.json
│ │ │ ├── 3330ae8555dab8f7ff4e014183f014681feb3f40a0d8969f30a4b2e9658e27f8.json
│ │ │ ├── 338e7d5d2e7d3a7260ab74d9b7b19bbab6b9ce84e7036623060190d9e0cc4bcd.json
│ │ │ ├── 33b32e27be802f61375110f7f4ac9419fd4eb633523e01e31774b874448849c1.json
│ │ │ ├── 3614ae46baf3e1b6efa17011c37407a5d2931aba1886d8f8bdf8e4e154ab6c3f.json
│ │ │ ├── 370c10e9d6f01aa67799b1f2191d5749a69ce4541aa55cbf4a28d45732bd641b.json
│ │ │ ├── 373e16b6c6996757d88a6ac751cd44028efa64701d746f8536819889417125ff.json
│ │ │ ├── 38980449465279974120694e1c667f229049f75d656fe518196d9cadc2429155.json
│ │ │ ├── 3a341a98aef632503bf2dc67ad87833e604c9aabe7ff69f5bcff7b54d6fe6407.json
│ │ │ ├── 3ba0d4c75ab8bfa5bc2a60dccb74197cb94bd161e526e54770a9b0a2aa757806.json
│ │ │ ├── 3c9f8987dc7426b442fe2a90c7de5d909fc85988e172e7722c11f24a2c331481.json
│ │ │ ├── 3d94db4e528b0e06bb975a12c71733767fe57307bb6e3de7c6ce65721e097541.json
│ │ │ ├── 3ff644065147b53af40ea703202c0fd832114936fe67e6c9a30d15e3da915455.json
│ │ │ ├── 40e7fbe5e765171201ab8016acce76a28304e1339d9aeb5a9cc18da87c5604d2.json
│ │ │ ├── 4162977f2c2251e7a8b331d7229bd43dff56df31356191b19886b5bf5d56377d.json
│ │ │ ├── 41952e7c846da15fe658603ff001dafdb0e12d3372a7f0306adfa3a71de8bee7.json
│ │ │ ├── 4204828f3cbb3465c469e28345e0fc4d7ff9a84e30e3dd9f00ab4dbe27014e0d.json
│ │ │ ├── 435b8e433cd2f09f7b81717214592f9bfadd8edd8177adcabd4338ce803855d2.json
│ │ │ ├── 44fd8135217bc689f0886e5bd75458999e67ea57252445884c2822fff306312e.json
│ │ │ ├── 458c1b9a3ce257e789f75305939ab2e79029c557657102eebf2082e50a47a0e5.json
│ │ │ ├── 45f7e59ef3f291171180b6763e8da408d8b7579bb7cb96dd4ca859e48aa5ce14.json
│ │ │ ├── 46616763804b2b938d73c75f7651158e94803e0b86b3a759ecdd59375759eea3.json
│ │ │ ├── 46bde576f6f1e69457e4ad33238fdbd602d2a7f027644a84cb81068215fbd5e1.json
│ │ │ ├── 4723c76012231305253c473fb5f2b81fa35a49f9f4aa38f54e9af3285aa51a02.json
│ │ │ ├── 477b0c06bcadb94314490ac76899f499d45a942aadef1e65623d303342157463.json
│ │ │ ├── 492a9871203480b590199773e90727872f60f06013713a4a2936d87986cdbbe5.json
│ │ │ ├── 4da7df08a0ef803551d404438fe24d6c8cc11d9a2c3cc8d85e37d5228ba3a166.json
│ │ │ ├── 4e24d52f79dfa76aa2406de05583fa49ce966a28fb653fa284fb8e8204797385.json
│ │ │ ├── 4e604dd03a70463ae25f6615ea3ce4fe8e98fab15d6b11ddafd51d601062e84d.json
│ │ │ ├── 506e815cbeaaf3aa6e448dcbf70c10b4d118dff41e05a292fb8ec6d76dd391c4.json
│ │ │ ├── 507e42a0bbe7a582ce1fcb77651e1cfde643907ca0429fedfe11afe7ae3b11c4.json
│ │ │ ├── 50b38b9cbcb9d5aad3a94b28cb983b3694926bc20e0381419b82008efd042d65.json
│ │ │ ├── 52608b276c6f0a2f190186e5bac578715ad888ff5ba3c10ff30879c3baf9d9ce.json
│ │ │ ├── 527de91bd8bbc5a7ab79951457a9f192909faa9bbf02aaec72bb3d26e2298b57.json
│ │ │ ├── 5316515ee7fc3e1038e676b361d9028edc735993c3d34791a77a14503deb064d.json
│ │ │ ├── 53bcc38a002a291b8a370a1c24dde42e704cbda5d409d77b8405599e45844cae.json
│ │ │ ├── 559fbbe72061ed129b192884f1f2b9c58d23f2af199cd408aa95d7c5af2753ef.json
│ │ │ ├── 5730d72cc177474584197921cce656696e3177780028c4629950f5514b530c6d.json
│ │ │ ├── 57a18b5350b4a567305ca01b2951efee6eeb3b289b5ffbbf390c3962ff29d61c.json
│ │ │ ├── 58ad02e0930221b4f44603dbcf01d3b5d07d9da2772edafe48a94a9894ea148a.json
│ │ │ ├── 58bfae9cf8467d2bb9363884d517e98cae38a934f4c474e9e02aed520fdaab95.json
│ │ │ ├── 58f2e3419fb2de4a3bdc4a9c0bf48e50f2cc225506096109dbf2b9bfe4778bb5.json
│ │ │ ├── 5901400fc36893a9ad85acd97eb73b691cb4b8d1440047c5f85c1534a2c7e492.json
│ │ │ ├── 59dd2e5089bebfb0397e9c492c890c619fcaa4d73b9d035e533320f276e1ebf9.json
│ │ │ ├── 5a15a341e370fb512c0b3f5ae1c30ec0d8a6729a690f286369015d107210124e.json
│ │ │ ├── 5b59421d9713dc21f9f77603d9708edd8c3eb8ba198636f80f1cedcc79ffcaca.json
│ │ │ ├── 5b63b5d7fc7a09b2dbf5e2f7db6fe00ccab773762b3291bd666c8e29d32100d3.json
│ │ │ ├── 5c8593cf08ce32f0c569aacfaf83b8baeb352934f6f8749aa4f652d5ce2acff1.json
│ │ │ ├── 5c922734de6f6345b5230507bee5c43dc284c308901e84846666b939493e6258.json
│ │ │ ├── 5ce9ee869c507986bf00ae6929f3aae3ab7aa58b5c2bded4965374fcf7f5654b.json
│ │ │ ├── 5d5b6249e3cfa0aeee94ba2053fc73b4b7b5b8fa1d21df09d40bda7c90ef273d.json
│ │ │ ├── 5d994876cad71133f4bf804932fb2604ffdc8bb8cc434ca1434667ef789144e7.json
│ │ │ ├── 5e19aa3aba5509cd48a9a93b39db071cfc2c2728ccae46b34caa0e214cc6be01.json
│ │ │ ├── 5f050da3769e151e52138ee1ea5dcbcb6160cb57952c75665e607628d0e08d67.json
│ │ │ ├── 5f858ab6d9f90e0f41617273b6f132af3f76f520deafb8d612adce373875e768.json
│ │ │ ├── 5fe315e6417b8eb8b26079139d8bbe46ddaaf7cd67b078d927ea79d3815be453.json
│ │ │ ├── 60002a01d6fc22147e2994d1a1a447d5e577c02aed2443789af20571ec2d2a19.json
│ │ │ ├── 60e00560038df059b1696e54dcf055cd658677d6e1201570a8500531addc0ac6.json
│ │ │ ├── 611c158815bdf3dbec9f5a5c01bce751fcd07db536e9bbaba2b2d232f82f5ae6.json
│ │ │ ├── 62d88411a61ee9d3b60dda6c4febf33539b8b9e8226b5d2b9205f8e2b0c4478a.json
│ │ │ ├── 63c38f2a8abe98c0d1e9cb5b7d9fd0451e1e46c2bcbf1d2c3b241b263ac0a9cd.json
│ │ │ ├── 6448d65fdcfe330b5d4278c8d1540e7b075238672b8101f9d2e1c4052f7c9c49.json
│ │ │ ├── 64fc04d8c553b2121a71955d48257160a40f6dd34258e3287945873f02d897dc.json
│ │ │ ├── 65d5139792e0ee840c5b1710d7659ecfb5dbdcadbd02d205f7517a6a3a374211.json
│ │ │ ├── 6603c5eb7403f7426c429341d43018fdffcb3430f22972c426ac43956d229b33.json
│ │ │ ├── 6648bc2b25d0bd25846d48f406d3e9a6f89677542600e9f3f57533747ed9b08c.json
│ │ │ ├── 6691dea01045e5561ac1c72f902f96ba84564c221498829443f793fee8784021.json
│ │ │ ├── 67b4e119f02b3ed94553e526bbd33cddff90053edb27438e472409b2ca5ad9a0.json
│ │ │ ├── 6805914035b171d32a1b80948179da15f78c5741e5a80b216d51a6586185c0c3.json
│ │ │ ├── 6876f75a9cb4a5f5857c47e3b0d6b38e51941aff76bc6d92cb1b4eef1c51071e.json
│ │ │ ├── 6a88f82e5b9f9da12b50f8531eac30c10e1c2a0cf39601d275fd90ee3e28da55.json
│ │ │ ├── 6aca679f90689aa4c275389c8b4e2462a9456775e8b124071070af2c988ca0fc.json
│ │ │ ├── 6afa6136d9df8317bdd8d49f4109412776deb21ba123fdd2a97331b400a0230d.json
│ │ │ ├── 6bfbb9eed6842bf331dec78724d7e740919c76345b54be844964f44640482a87.json
│ │ │ ├── 6d026e901d3b2ff0cb9550c750966905afbbc681ba68db88e1de608fb2964495.json
│ │ │ ├── 6d4d7d7f829f13e46e4898aceb760d66d2255dc838eab0933f9a92d720f420a7.json
│ │ │ ├── 6d556671b5632e29972dc09e345d68d522a5b3bcd2852b803d56668890fa46d7.json
│ │ │ ├── 6dcafcac3a0b169a08580cc4cb9196423dacfa51329841311665c363a97bc29e.json
│ │ │ ├── 6df9c1e88224e95c55dee4238fa91358360231ee47362294e884bc6e24d73612.json
│ │ │ ├── 6e262456570c174e207055c7c964fe85431addb0f59298b1e4d912500dfb23a3.json
│ │ │ ├── 6e2ed39911a83c75e432ffd0dab22fd095ce8c5bb186d6ab22d594375f3b32bc.json
│ │ │ ├── 6ed362dbf43e46eeb440246d52fdc4e0783c895114249ea33f3de7ddf6898a3a.json
│ │ │ ├── 6ee8ac22fd8b7d0152fe85c630c98fd9c7f1f74312b5f923dbebb3ff5367a71e.json
│ │ │ ├── 71a07328d56403d55714d76cefc05db3e68c6498719e629e4e76889a1940efc2.json
│ │ │ ├── 72577fde1eae8cf079aff518cecce910ac310cefcc038fbbcb0a5d11f20fa20d.json
│ │ │ ├── 73a129efd08cc38274f3c56503c234eef17f58faf74dadbdbbe475efcbfc2777.json
│ │ │ ├── 7483cdf00a2d7de8809278d9dcdf2f2330354b02117952da4b9452d4bbd6b81e.json
│ │ │ ├── 74efb913c62b374d818cfc5af6d7ee9bb46966eb2bce0e26e0bba461683b98a7.json
@@ -369,107 +537,198 @@ khatibi
│ │ │ ├── 767dd58146a5d4a713611561a9e5c1b706e5f509a5621891c9b2e195f3b8ee0a.json
│ │ │ ├── 77a1520156879de714ee872c29b1387967bcc5ce470b47d37087ea2a110f3875.json
│ │ │ ├── 780977bca042ffdde1cca2811a3a46c36bd3fcff2723c94ac527428113131c64.json
│ │ │ ├── 784dd791c21e8837a3e925331cf234b2138ded3d2012968739604d5535a18e09.json
│ │ │ ├── 78d30d0a40b28969d64653d2508fd53e53709b95a45f3e380ebd6c7aff04ace9.json
│ │ │ ├── 79ffc45a7139464dd6c7b1fc6f1f0f9c44347fbd7dcee92c6d4b63525424c442.json
│ │ │ ├── 7be7f428e6acfe4c99370707cc7de9253f801feff1564088f2584d5dc8c42a89.json
│ │ │ ├── 7bf404104bb32fc04568c2d287891fa69955ac3f46718c99dcca64a4bfff6fe3.json
│ │ │ ├── 7c4fc90402a7836b364425c33cc2ffc98e7634391ebe78143df03c88945d8988.json
│ │ │ ├── 7d106c54b917d9e26357fa71aa871e94cb99c940b6c48808e93cd57415da91e3.json
│ │ │ ├── 7d59da18a8b644e48a164eb8a764efc9f4c3538b99d41c8e93ce38cc5556ba05.json
│ │ │ ├── 7e9bad82d0eb642b739dcf11e86c2fcf2005dfb12c94478af143deb9a8129bfa.json
│ │ │ ├── 8055bf9fe36a9fa183d0c5dc152684e65410d58c5634e544e8f38f6c9216f6ad.json
│ │ │ ├── 81d6d00c4c975b3289ac212d355856c3d6e60bccde0780fe2e3fc8cac31f3c19.json
│ │ │ ├── 82833f6235cb6559bad38e93372d42284eb4e9097e90519337266113da2495bf.json
│ │ │ ├── 828dacee98d6f71fcf53c8a051b3bf1bfc9d94c272a79ed8539801e3fb90b3df.json
│ │ │ ├── 82916053b0e3cfa286347ea0a7101f2d06678bd28b8b8d8fe955d11bcb7a43aa.json
│ │ │ ├── 837801d7d0e218e49de562a7e03711e75941d42ce5cc2f77552bc6293a45a4e8.json
│ │ │ ├── 84281ba94e70a71d52b5179cf2e933f8412da3a9eaf5e7177b815f8fadd0afc5.json
│ │ │ ├── 846ba1087a1ee6b5cda2ebdf22d0bc61ad9175b21aba29783429277288dbfaaf.json
│ │ │ ├── 84cef5656079ececae35930e1b26620186b50f25fd977c569537daad2d59db86.json
│ │ │ ├── 86e57806cd08cf765ce1f56f0638dd321e93c653bb6613aa35d7ad375808433c.json
│ │ │ ├── 881adf7185e68d203906537117de576a11fba814941cf9eeedd0dfac2d65e536.json
│ │ │ ├── 88e349e879d601e1f5c75f3b019ffb4958e90639317ba893c54f82b0cc9066c2.json
│ │ │ ├── 8a70e1324d7f834d2c41a7c3b4cbb3b8ccad92d413970316bc95e13f5132ff76.json
│ │ │ ├── 8d658a3a8b1ae03cbc881e3c47cf2cfe111f9be2b564fb3739cf3d9367845a8b.json
│ │ │ ├── 8ffb83ce6f13d2f97d0197c7381748e9b66956c13f0158bc519350b7dd1b9ad0.json
│ │ │ ├── 908e0129cefe129d0b562243460fe20793c84876244cef2e99ca1becf8cf6a1f.json
│ │ │ ├── 909129924b48dede801eb946cf98bb93003ab8116be2b6acbd2f7fe8dc166358.json
│ │ │ ├── 92ecdeb228d91f4adb6c1e9bfd1b3f0eea65faec8dbcb27fca3211d1d264cb46.json
│ │ │ ├── 940d0349821b0fb7f2c3effcb81fd13bb1c046daa6f6c5f2cd1b157058c55877.json
│ │ │ ├── 957f37be1d5d6a5207f90ad07704f8423c915c5bcdfcd130acc85a388fc89d19.json
│ │ │ ├── 95e88ece49092778e7709f6b87db4c05dd055b838cfdf20d7d4705b6373739ba.json
│ │ │ ├── 96c3ba545db191ae5811d5dfdde74e7c6396a932b759513c94160cb7b7c81fc8.json
│ │ │ ├── 96f5469edd566b92d9d38423a27779142fbe2b77cfc9d85005d43ffc99ce3de1.json
│ │ │ ├── 9766508e5a013c3d3cbb2602719391199e90af5720c9782a77ca71565aa346b1.json
│ │ │ ├── 9880af8b991c19abe5ed019ad7b7291b8b281ed9dcb894a00c3fd8259a59b4a4.json
│ │ │ ├── 996411678d23c3cf8a0e6c1c5076701e8bf5f3dad21ca907ec4116d15366a668.json
│ │ │ ├── 9b2fd03f2769231e4c207b2f0ee915e3b5eb050232f2fe6c59ddb01904976650.json
│ │ │ ├── 9c2c2f6f8d4d4c3a9a60da3ed38a26dc789e8cfaff5d46d140d2f208e5fef3c3.json
│ │ │ ├── 9cfb6e4f7b08a863675af032e7823c0523170f5201e686c5ef72b39c04b07a12.json
│ │ │ ├── 9eabdb0cacba38c8fb6b3e777932e06bd82172cdc0bcccf2fc0bfc23b5bd4974.json
│ │ │ ├── 9ef7cb42412a83490d3e54c81d4e7fa58db25253eb50a41d97d5d4064df0dfe2.json
│ │ │ ├── a186e74ebd87e23212ffe7fd72c40e9383c0624a3efdb2fe1e3271d9ea96d9b9.json
│ │ │ ├── a31ab0e36b30049a602cc060d77c0715187f7c3838db91b8c20bfaa802f49899.json
│ │ │ ├── a43d68ff03b49e9153a73777c0bde346a6b1969f640d67eae500d60d410a02c0.json
│ │ │ ├── a7c605f57dd37c8725a92f08d4fe18701628701fa986cbb98d3a4aeb3a74abbe.json
│ │ │ ├── a823c9c28027c8d525714e6571bc3f3ca38f3bd0420aaf4f4921067cf0672475.json
│ │ │ ├── a8311f6e51027ea4606e35bf14d50edc1795e71b2d63cddeae8c7bb7ece215b8.json
│ │ │ ├── aabf6dbb2202699bb1b06fd582c88465b9cf2b8cc060bda2e2bc0c67fc493bed.json
│ │ │ ├── ab5d0682afc0714c24b9ac5fda36b243c638d272ea973f46a5c18e783132c861.json
│ │ │ ├── add004e78a62164d7565c102eb825debea20811f7fe76afa0567a1b6b289f264.json
│ │ │ ├── adda28366431a09f735c806811acad036f33199438c7679d275e3c80714b9a80.json
│ │ │ ├── aeaae7b60339b1283cab517b4ab42806c64933c272d007a68431988ba8e0edb5.json
│ │ │ ├── af128ca7fc8d02ae40fff36925a5b96034862ce0d581e22a8a0c88f41040e526.json
│ │ │ ├── b24556e20d540fd63de3dc04501ffd021836b930c4ebc3ff309f7950ef17a335.json
│ │ │ ├── b26c22033963df1727407c1fa6c79d8241bfc16056e7a8d3c4383fb2d050d3cd.json
│ │ │ ├── b26e251bde84a040dbb2d1a4f700ebcd761f51a124a98a104704e82537e320eb.json
│ │ │ ├── b34cb0a1a28e753a900b3d23f01d3810f9c06635b0650d34be4ec9d98daa8fbb.json
│ │ │ ├── b543952627caaf0a5c52bec09b33fae93443fca7234365680bbe75acc260dd1c.json
│ │ │ ├── b59999c2fd322c241c7bd37e6ed0a95c9124cbb79f8424f1fa7cb2e92fe63817.json
│ │ │ ├── b82d5f6840b4930eb62fdb1c7b3a58124fff805e529ede7684516a65322fcae0.json
│ │ │ ├── b87a932e418a18531d61dc15776db652401e7cf1682dead02abdf50e2cd00530.json
│ │ │ ├── b9b878bef7c0ae7d407a42c797a4697990237971be65a5d01a6c7b9b444a2a9a.json
│ │ │ ├── b9f8ea31056fe0c0fc40a84640c58f29895312c65bf694567487204d8f1170e9.json
│ │ │ ├── bb140cfe12cfb3e32dc9815393035fc33c7649c2faeeccb82cdee56a930ea635.json
│ │ │ ├── bb74cda4073a6da7a4b60fecfb3bb40796a51ceafcbdd128d60e5ce23fa4f319.json
│ │ │ ├── bc24ddb05a8aa685edc1376cbd110423adf05bcc488fb97a30fe286e7e74c2da.json
│ │ │ ├── bc6f93c7938b3565d50cdfc4abe4fd62f0739fd6299f35d7c50075cd860cab58.json
│ │ │ ├── bcea7c584e5031a9c5734144f8169d016ef1ed316e6f4827609509ba2a79d3eb.json
│ │ │ ├── bd00f0b0db2eb10f7e889df5a0f08994e8c1eaa0eb69be8398e45e0e634724fd.json
│ │ │ ├── bd6e156d8e427b14676b4707710f2b340026e679cb7bd29b22b247a4b637e7bd.json
│ │ │ ├── be1200d7c9b2881ba54c7fa95daf5f3e2ce993619b974c7760a9d44a416e00c0.json
│ │ │ ├── be72e639c12e860a2120c3ecf96b94c86e5c69b2f1f0715cd2804d0475409cd6.json
│ │ │ ├── c12baf851ec40542280cb62d2f878d5e7383357365281938cfb55a64c08a9a10.json
│ │ │ ├── c36b696b57c1deb51e47a057b32d1dd75e3f1560e83931aab1f8ba86abcc1543.json
│ │ │ ├── c3c6651e6b7dd802c31efb56ac20c1f1ba3c4c0108599f1480c6a143b2e688ef.json
│ │ │ ├── c46ad3fc8fd3db1315ab2e40add760b44e8f98c24c79e334c342c6a411fc671c.json
│ │ │ ├── c52300dce4cf464158f8db56df5030359a501a81bbe4a5f36e50c8c38a5ac48c.json
│ │ │ ├── c535c8a7523b768d28903b84f4cfbce7d62181a2a05f3db08ec3a7c8cbf86ce8.json
│ │ │ ├── c56beb43cf063fd1cc92950ca14695b543b3971bf7e7dbd4a676242057258533.json
│ │ │ ├── c5c93ccc7715c31fc7538bcd9327c8fb7c1e495bd17d6444b384ec426b7a231f.json
│ │ │ ├── c718a8f0cdfb66217ab4484dca103c7029d43976f7f0889bfb11f6cab3bb2510.json
│ │ │ ├── c72226544540cc75217ba02f1d09d989eb810d879409ac086c76245f27220cfa.json
│ │ │ ├── c795f43bd1f10cf666ff987d18af538b2164c1683629ac689f0a54cb875118be.json
│ │ │ ├── c7eb97fa16701c6d9ee531fa032479a7c771292f3e9d8921d3ea12a4897fd43a.json
│ │ │ ├── c846b5de286163b5eed16ff6d6e00f2038f30bf7edd2ab3f8d831369e190ae18.json
│ │ │ ├── c850d65440fa6ea38db7300c89c5052b3db430ea2c7d20d35cf38c6b41807d0d.json
│ │ │ ├── c8719ca6bbbd7a4815ce5f982745c94d54d2f753312c08b96964ab7ead661291.json
│ │ │ ├── ca0c19553fc1b40bdec0973b3e0c5363d6bbbf69d9961567483ba1c1cb9023eb.json
│ │ │ ├── cb3b2a1c1afd8d0837cc29b5040ec984dc0c0070af2135d0b0e5cb5ff726f2a7.json
│ │ │ ├── cdc5059cf09416d24d03fe57a48af5219727866c84b8109d986456fbaa789dc4.json
│ │ │ ├── cf17cbc72af5f2b56eff6cc03157817d7552c6c5e4565e97278e02ae69a362f3.json
│ │ │ ├── cf6668c54cd4f65d268a17df44f100e1cb77f91eae90dd2dc052564731b2f195.json
│ │ │ ├── d1289d5406d360e3ff617e213db4e262cd43a32711a61aba97bdcd0a906cbcb5.json
│ │ │ ├── d12cd2b31145213be1b4d89e7be64f3aecc122841cdeac7660eceae3dd871f01.json
│ │ │ ├── d12dccf07d58d7c0a2b5ea5b6aa821aa419fdc8b34a48939ebf9c565bc439551.json
│ │ │ ├── d1392fc7270aa978a815d8dbe99ea56de021ee699664635d53b8df5b2988c835.json
│ │ │ ├── d1f2090208e1aab3b0e377278b02e9fc1007e5e1724c9000fb69d050365c8660.json
│ │ │ ├── d3456cd690135f9630e6b0bb79fef5d205804c7acabffc61cbd5ac4032b17bc7.json
│ │ │ ├── d51b2eb414ee4ea432987cd45d6b623013e994a6080c89cde57b69004b576e9d.json
│ │ │ ├── d5676c133bc21ec531e7c17c5e9416781e3459852a4e6e1fac9c77ecdb5c05a2.json
│ │ │ ├── d606b856d99eb59fe3e5378e597bbeff679c812e9f1b173ecced4639ede8ad11.json
│ │ │ ├── d88e1e365cafd5d26ce47c2a0fe1f067dc3bfe5ceed1f75a21393fae950be939.json
│ │ │ ├── d899e8cc575f125b908d78f0c8d34408a4af1972ee0544d0517f8d1933239214.json
│ │ │ ├── d94bebfe941bb0acc30b633423eaee11690652709e5f8f28d157473d31a07ee3.json
│ │ │ ├── d9590fb13a20db20da78d33674f56397a18e3356d08dab6f7c0739130caee096.json
│ │ │ ├── db68b8db5217e2295eb1195760d7352960627da044a4c4f8f6b89c67ad2f8f57.json
│ │ │ ├── db794bbcafe219af962673ef26efb1ee1eacf3923e13113352f3eedfd3192d23.json
│ │ │ ├── db81ec42bfd68175829c568dac66c2844afba128b94afa2accdf24ed67aeccaf.json
│ │ │ ├── dbbdad9d992922aff62ad3262a531716cfc32e2f15f600773b9a0cf10545058d.json
│ │ │ ├── dc0344515d1b3ffe8643560516b88418be0b306fba56101b8a630ed73d48db46.json
│ │ │ ├── dcad55d51bb4494a642af555d5bfe78c5b8ee3d11de1b3d8f4286d608980854b.json
│ │ │ ├── ddd79719e349936349e9ec7684d3eec146d3b73f95a419ad142ae603ab199acd.json
│ │ │ ├── e08c4784f0f82403ff24a1676e3d75e11a208aadf8fe94a723461c9658afd1e0.json
│ │ │ ├── e0eb3c543474df255f97ae0679df48999b86b75dc42943b9d67f4cfcf1acae34.json
│ │ │ ├── e16f78807ff202fa2c81867b321acfacede2d24cc785856eef0633d8d352796b.json
│ │ │ ├── e1a7be59904a3dc503c5b12bddc7604c6783b02462c8ec76834c65c5610c3bda.json
│ │ │ ├── e2967fb2aed9420b2cdf823d95f971b7038323c97a6ed139ce63b7a1912381d1.json
│ │ │ ├── e2c62f6012dcae176d19340f6db8db3e94547ebbc4a21577b63caf35cc72ecfb.json
│ │ │ ├── e3ee8d9942c74a74be83ca00d5438e4a1e1cb5b23f55d95d308a42954e4757f0.json
│ │ │ ├── e86dc6bb7703d4329623bd33ccbc5e5e6c6daebf8d36d84fd415d6f868c779b0.json
│ │ │ ├── e8738fdd0a67e92abd0ce636990ee001a2fc7586e9eda224915f33cb80d3b2c6.json
│ │ │ ├── e8e380264b41f789dddd25b7af5d0e3c517b957a14fe8ba2ce7bb8a529e005cf.json
│ │ │ ├── e9589ded446a5befb285a0a2e93a182ca9431c76661e68c9210ed252580dd7f0.json
│ │ │ ├── e9e14d581ed59799b2d83c67402e8555b5b59e7d49425950ec490422bd0307d9.json
│ │ │ ├── eaceb29a907e3e67bed5255cc1f8b8b3eab9d9946f4d4df2cc99070151285029.json
│ │ │ ├── ec07e022005d3513838eee7e6618ff060e25d914cab7745aa6172f22d4089497.json
│ │ │ ├── ec3570ad9673cc5dfc9a0d12f208b7f4d897d28d1ae2974d6a3fa63ad27598d3.json
│ │ │ ├── eccad1f007b52643ce8d81576efb7d1969ecbff2e9db288989fd9a9c21fd7288.json
│ │ │ ├── ecd9c1dbfa0a72e253adb680ae7088eff24c26360e53a65862b274ea1281ceae.json
│ │ │ ├── ee450e6251e62d8972efb53bc35145c4a65050a7b6db2954b84bda42fca7b704.json
│ │ │ ├── ee557c6ed214858651cd3ebceb5e0fd00999354a4c54bb379f26c64b48b509ab.json
│ │ │ ├── efd113025c3fb3c0becaecd8090e8494b13d92ff3c49220d54665b3a8af586af.json
│ │ │ ├── f081ba494afddbf02c2599aedee9fc9d38ccdb159ade7f07ce3bdad3323a001e.json
│ │ │ ├── f1af209a02f2ec5c5a344e3fa7dd8ad7d443e0479e55f5465449c0a2eed314a1.json
│ │ │ ├── f2eacc54ffb4b9802045711c0fb0ac7210c95f21ed6ae78011fe0496951aa086.json
│ │ │ ├── f3a6285dcf9eb39df500bc0b76b03b5941103e8b90c06ffaeab1b3129f18fedc.json
│ │ │ ├── f3fe81220df98d0410b1505fa995df65427035dd552c85f1d80e35bb75a9aba1.json
│ │ │ ├── f48decaf1220666fbda1a5328b963dbd999caab9ebbb1d84459d4c556a6e6ba7.json
│ │ │ ├── f537b36e2ee33d1303c10e950a6910cc7fd954c7fce3220be2c95d75d70dfd40.json
│ │ │ ├── f72f6f3fe9d226e4717e158dedd318fff0a1d52ece54f965311c2b4f862dcfee.json
│ │ │ ├── f76726d2898f2a3ba7168d3fb77c21087432eb9c200631b664ecb3b1837aaf17.json
│ │ │ ├── f92b94479afedf47039d8821a77facb55d9a862338e85876b80cac3b41c844f6.json
│ │ │ ├── fa4a8a35e96c919372da27c7af11abea0c89fff941c0b20dbc4e48c15f32597c.json
│ │ │ ├── fb6825c4e9ffba13d17a2da18a1e07aef792089a7cd24b31e7f4f32ee39287e8.json
│ │ │ ├── fbfc351c35c5272de5612b4740e380b06a24c37f8074b977e35f62ad85a6dcc0.json
│ │ │ ├── fc6ae63ae2639372c4ae4fbe9718feca814261dda099ba58bb780d14c69086cd.json
│ │ │ ├── fd714e03c631694d30457ac529d05d8d131c183665e086246da607f752dea5eb.json
│ │ │ ├── fe7f3f3c4b234398f7c0fb728456ac41c92c6e939634e147d2fdda12067df842.json
│ │ │ ├── fe8b7b639a9f98fd1b883b7dccf8490ee905a2a21df5671ca1838a173fa0f921.json
│ │ │ └── ff862e0ffad7bba911716072ae82f268240d82105ffefe78c7714a160c4c31ba.json
│ │ ├── semantic
│ │ │ └── p5e80268fecd6
│ │ │ ├── 0be9cb2f924f20c8cd09e0361a90c8f0b4c8859120101bbe21eee930294ebdfd.json
│ │ │ ├── 0c4f87b180cd5b0576b197ff5cb0e9cc5dfd8d82d97d618036df00c7955fdbac.json
│ │ │ ├── 14328edb08c286b631c2ef0ead8ac33b522157be84855de346e8c0688e30c965.json
│ │ │ ├── 14e03f8f9b4ebd7cf018188e2351ca859aa4e27d02d5dbfc7b1f8b932d282d16.json
│ │ │ ├── 212a2dc6dcc30c1b45f6cf5bfa9bf16386fa138bf382bbde438f8d6883769b29.json
│ │ │ ├── 2679b1fb1647af24f007334e6560733c957ca3cf3831eb02a9c8fb7a7ae44d62.json
│ │ │ ├── 296d532aced4658e74a296977efe4fd8a2ec3cf02a997ce3837f59ce36e61343.json
│ │ │ ├── 2a13d2bb6f18a81d9511481df0edcdb1a8779e1ec03e919991693cae7e84c8e0.json
│ │ │ ├── 2ac09852870126bb1792a5e9242b34d3f55365bfa6e3b09aa432461a6c72045e.json
│ │ │ ├── 2d3b8c0bb7eea6a50a24093abfc3457c0938079b0771b2568498060f6f3a4a74.json
│ │ │ ├── 40373bd2bcd76ed8ed27031299e541005d4c8c0c7df312a9312f390b173d7248.json
│ │ │ ├── 42a95a4a8f651dbebe297ce92beca376cb19eab99d6ef6b5d10a16d79d1842e4.json
│ │ │ ├── 4f53e6b5fc48381f8afe6052371989c4df69347c84c2ec65a46b73cd1c464b5f.json
│ │ │ ├── 538cdc2fb71798c581f20d37d52a1484c2ef21691d2e01ee79edcf253ba06394.json
│ │ │ ├── 569db52f8b9229dc3cd5cbde156a4ac012ab711d32bdeb4175b60ba863ac8cd0.json
│ │ │ ├── 57dba5c2a37beb12ccc107807b7544f687d6d8ba6394c8977c3c59b433d2dab4.json
│ │ │ ├── 5ad5f87fc2eb132405e3aab9ef8a84e41f76c958fbcb188873c86abd4fbc12fd.json
│ │ │ ├── 5c0f2ea11f5bdcc5272d6344c9015c20bf79f315d74a910d56bf7a2922c92315.json
│ │ │ ├── 5dbe87f1a5fa172581ed5abebee35b5d08ff488e798a334992a2756bff277cdc.json
│ │ │ ├── 6aaa93a769a41eb1d37a91608cd6f98b9252c2a5598bd859a130986429d1d53f.json
│ │ │ ├── 7b504b4173cb8d683a7021270372c5c65f078ac3e3e1351601bedfec9c585632.json
│ │ │ ├── 7edbffbd4455d071df034927a69faaf76f8e8bbf6495921ce2b70eea1abe8e4f.json
│ │ │ ├── 82db37687728a8df60ccf231c06838b4a0074d22ad93e89d3f5e93d4de48132f.json
│ │ │ ├── 8a79c80fca0ed04957e7b4df749ab80b5d0f4ce3d0ae032a47d51d4a2fbfcd82.json
│ │ │ ├── 8f60bda631cbe7457886d1d574b2e3d2850034f469592a3e8c333f0623a2d3c6.json
│ │ │ ├── 8b6c538ab1a901fb71decc7f7f511c8c67a76d72f05f02b1bddc10f5026f9e4e.json
│ │ │ ├── 96f5469edd566b92d9d38423a27779142fbe2b77cfc9d85005d43ffc99ce3de1.json
│ │ │ ├── 9897fa1997a41e155ed8de922722238e1f684f5c77a7f56405c8ac7cd1aa376f.json
│ │ │ ├── 9b674bec71dfe6e133af9fb4e35a421fa56cecd230544008ed83a44e6eaae3bf.json
│ │ │ ├── a3f3d3cf99dd02b4d8c41297d4634e120953f1650257c0c6a1888481aa4c5745.json
│ │ │ ├── aa41b77ce8563f4b4bee015be5ffa598f1c98d4f2854ec9a465f271e8c3f974b.json
│ │ │ ├── b5f6ef338a857f51d581abe7c50f57f41757aa6900bf94f6ed8fc2ad442f6019.json
│ │ │ ├── be1200d7c9b2881ba54c7fa95daf5f3e2ce993619b974c7760a9d44a416e00c0.json
│ │ │ ├── c109dbf29a8233cec6f0e4e3c1256a94ecee99887756af2060e620aaa5979e4b.json
│ │ │ ├── c1d9e0aa5d7450242681eebd003d4f502744a3624112b10ab091011a50820ce3.json
│ │ │ ├── c89f13bada10536a104ce57788562563a61c2682430e4273ca3195890d45c68c.json
│ │ │ ├── c97d49fed39b9aca8dea35a49c3e031a641420e4452e61d1ea2a912e899f6dd9.json
│ │ │ ├── cacf6773249daafca21d21004106209d86aa215140de071c64363aff4d9e5431.json
│ │ │ ├── cfb57017bc764ee7e9011b52f1e44ad2f41b2670778af73232ecfc309b406a0d.json
│ │ │ ├── dc89fcddf8c6f20bc9f52ae15e5cc8b226320d2776dc8f27be16894e53165013.json
│ │ │ ├── dd78862d0f7862653c702e86f7acfabfe33ec5d85d40ba764138c0d1784f7b06.json
│ │ │ ├── de67f63e3f49d4ee32811dd67676da33a1e584f671d396fca130f3681d54bd76.json
│ │ │ ├── e0a52ba8204140f195e8d30847dda00d3de5439cf903c576b77fac1ec852b5fb.json
│ │ │ ├── e86dc6bb7703d4329623bd33ccbc5e5e6c6daebf8d36d84fd415d6f868c779b0.json
│ │ │ ├── e9ca16b55daa5d6bdf6b0257a4e08c35caeae32eaaeb5c0be11532b77ab658ea.json
│ │ │ ├── ea11661eb53bce4c7a43acb2d636de01d960acdad246c1f1372df351e25bac25.json
│ │ │ ├── eaceb29a907e3e67bed5255cc1f8b8b3eab9d9946f4d4df2cc99070151285029.json
│ │ │ ├── f71a50c524a31da468cf7c0c08d929d4d31bf17e77473db59b5830f4c583ce25.json
│ │ │ ├── f7fdf480e35ed096b57529bfcafd8695aff9a98851050be1f00e4a736ad79719.json
│ │ │ └── fb1977d392a5009580c7a608fd403ac2ae96c72f6f2835ba6e49cf662dd0bf6d.json
@@ -484,12 +743,10 @@ khatibi
│ │ │ ├── 2a13d2bb6f18a81d9511481df0edcdb1a8779e1ec03e919991693cae7e84c8e0.json
│ │ │ ├── 2d3b8c0bb7eea6a50a24093abfc3457c0938079b0771b2568498060f6f3a4a74.json
│ │ │ ├── 32267f72ce9ef01cd2e804d43c6828549af8eb6f868c76e7d1619502a953f14d.json
│ │ │ ├── 40373bd2bcd76ed8ed27031299e541005d4c8c0c7df312a9312f390b173d7248.json
│ │ │ ├── 40a84c5465882009ab69d2874adbb9aaed373cd706d70c92e9e1f4c35640472e.json
│ │ │ ├── 4280dd1094314da773fe73ba1ffb91f58f22eea26281bd5cb51f5e9a201c95f6.json
│ │ │ ├── 42a95a4a8f651dbebe297ce92beca376cb19eab99d6ef6b5d10a16d79d1842e4.json
│ │ │ ├── 4b8f3b6c0ccb3b5494fb2af8c0f9892b6b198a8d503f53498bd1fe2548ef112a.json
│ │ │ ├── 4f53e6b5fc48381f8afe6052371989c4df69347c84c2ec65a46b73cd1c464b5f.json
│ │ │ ├── 538cdc2fb71798c581f20d37d52a1484c2ef21691d2e01ee79edcf253ba06394.json
│ │ │ ├── 569db52f8b9229dc3cd5cbde156a4ac012ab711d32bdeb4175b60ba863ac8cd0.json
│ │ │ ├── 57dba5c2a37beb12ccc107807b7544f687d6d8ba6394c8977c3c59b433d2dab4.json
@@ -497,15 +754,12 @@ khatibi
│ │ │ ├── 60002a01d6fc22147e2994d1a1a447d5e577c02aed2443789af20571ec2d2a19.json
│ │ │ ├── 6aaa93a769a41eb1d37a91608cd6f98b9252c2a5598bd859a130986429d1d53f.json
│ │ │ ├── 7101777f271bbc6bce9a2a4fd3bcf487bb62a846a2436bc8c70008bfb23ce33b.json
│ │ │ ├── 7b504b4173cb8d683a7021270372c5c65f078ac3e3e1351601bedfec9c585632.json
│ │ │ ├── 7db83b9e384d80a1584b152f9fbc781e0ae5a7524dac0a57ce98bb4d3432bfae.json
│ │ │ ├── 7edbffbd4455d071df034927a69faaf76f8e8bbf6495921ce2b70eea1abe8e4f.json
│ │ │ ├── 8a79c80fca0ed04957e7b4df749ab80b5d0f4ce3d0ae032a47d51d4a2fbfcd82.json
│ │ │ ├── 8f60bda631cbe7457886d1d574b2e3d2850034f469592a3e8c333f0623a2d3c6.json
│ │ │ ├── 908e0129cefe129d0b562243460fe20793c84876244cef2e99ca1becf8cf6a1f.json
│ │ │ ├── 92e1d82ed4571249c09163413ceae360dd4d7d03c162c554f3b5a47e94474cf1.json
│ │ │ ├── 9897fa1997a41e155ed8de922722238e1f684f5c77a7f56405c8ac7cd1aa376f.json
│ │ │ ├── 9b674bec71dfe6e133af9fb4e35a421fa56cecd230544008ed83a44e6eaae3bf.json
│ │ │ ├── a3f1dac3e797de04ab83d263a12eda947904d8e5015b77363db2d29aba8b4928.json
│ │ │ ├── aa41b77ce8563f4b4bee015be5ffa598f1c98d4f2854ec9a465f271e8c3f974b.json
│ │ │ ├── b205a6dda565ed51a38a6b75c509f41589425f0c2006aad838978f5dc6810b91.json
@@ -522,7 +776,6 @@ khatibi
│ │ │ ├── dc89fcddf8c6f20bc9f52ae15e5cc8b226320d2776dc8f27be16894e53165013.json
│ │ │ ├── dd78862d0f7862653c702e86f7acfabfe33ec5d85d40ba764138c0d1784f7b06.json
│ │ │ ├── de67f63e3f49d4ee32811dd67676da33a1e584f671d396fca130f3681d54bd76.json
│ │ │ ├── e0a52ba8204140f195e8d30847dda00d3de5439cf903c576b77fac1ec852b5fb.json
│ │ │ ├── e13320e9716b0be66b7cc677a64b44cf3127f7317f35cfa3b849dfbaa9c1f367.json
│ │ │ ├── e1c07127e4cef79fe0bfc63a0ab904e5d1b0d9c4be5278b553b6e48d39753b4d.json
│ │ │ ├── f0478454ef37ecdc5128db97c18d0ffd92005c1d1db586b6750d985e30a25d76.json
@@ -558,7 +811,9 @@ khatibi
│ │ ├── http.py
│ │ ├── normalize.py
│ │ ├── providers.py
│ │ └── sms0098.py
│ │ ├── sms0098.py
│ │ ├── sms0098_codes.py
│ │ └── sms0098ws.py
│ ├── __init__.py
│ ├── announcements.py
│ └── voip.py
@@ -569,35 +824,57 @@ khatibi
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
├── scripts
│ ├── coordination_hold_order_probe.py
│ ├── entezar_action_audit.py
│ └── hold_write_verification.py
├── static
│ └── .gitkeep
├── tests
│ ├── __init__.py
│ ├── factories.py
│ ├── test_customer_name_fix.py
│ ├── test_customers.py
│ ├── test_entezar_action_simulation.py
│ ├── test_factors.py
│ ├── test_inventory.py
│ ├── test_models_contract.py
│ ├── test_sms.py
│ ├── test_sms_phone_normalize.py
│ ├── test_urls_contract.py
│ └── test_view_smoke.py
│ ├── test_view_smoke.py
│ └── test_visit_policy.py
├── .clinerules
├── .dockerignore
├── .gitignore
├── .graphifyignore
├── 0098sms.md
├── AGENTS.md
├── backup-20261020-155504.sqlite3
├── backup-20261020-155539.sqlite3
├── backup-20261020-155613.sqlite3
├── backup-20261020-155723.sqlite3
├── backup-20261020-155757.sqlite3
├── backup-20261020-155827.sqlite3
├── check_finance.py
├── CLAUDE.md
├── db.json
├── docker-compose.yml
├── Dockerfile
├── entrypoint.sh
├── financial_audit_20260816_151225.csv
├── fix_customer_names.md
├── fix_customer_phones.md
├── GEMINI.md
├── ghost_hunter.py
├── iranianNamesDataset.json
├── khatibi.zip
├── local.env
├── manage.py
├── normalize_customer_sms_phones.md
├── production.env
├── project_tree.py
├── recalc_last_bazdid.md
├── reconciliation_tool.py
├── requirements.txt
├── requirements2.txt
@@ -0,0 +1,81 @@
"""پاک‌سازی کلیدهای «آلوده» دفتر یکتاسازی یادآوری بازدید.
چرا لازم است؟ کلید یکتاسازیِ یادآوری بازدید، در نسخهٔ قدیمی ``visit:<id>:<شمارهٔ چرخه>``
بود که شمارهٔ چرخه با تقسیم روز بر یک عدد ثابت محاسبه می‌شد. وقتی آن عدد صفر می‌شد،
عددهای بی‌معنا (مثل ``visit:1601:24663``) ساخته و برای همیشه در ``SMSDedup`` ثبت
می‌شدند؛ نتیجه‌اش قفل دائمی یادآوری برای همان مشتری بود.
قاعدهٔ جدید کلید را با «موعد تقویمی» می‌سازد: ``visit:<id>:<YYYY-MM>``. کلیدهای قدیمی
هرگز با کلید جدید برخورد نمی‌کنند، بنابراین بی‌ضرر ولی بازدارنده‌اند.
این دستور **فقط** کلیدهای بی‌معنا/قدیمیِ دفتر را حذف می‌کند و هیچ مشتری، اقدام یا
پیامکی را تغییر نمی‌دهد.
python manage.py cleanup_visit_dedup --dry-run # فقط گزارش
python manage.py cleanup_visit_dedup # حذف کلیدهای بی‌معنا (cycle > حد)
python manage.py cleanup_visit_dedup --all-legacy # حذف همهٔ کلیدهای قالب قدیمی
"""
import re
from django.core.management.base import BaseCommand
from django.db import transaction
from ...models import SMSDedup
# سقف منطقی شمارهٔ چرخه؛ هر عدد بزرگ‌تر از این، نتیجهٔ باگ تقسیم قدیمی است.
MAX_SANE_CYCLE = 50
LEGACY_PATTERN = re.compile(r"^visit:(\d+):(\d+)$")
NEW_PATTERN = re.compile(r"^visit:(\d+):(\d{4}-\d{2})$")
class Command(BaseCommand):
help = "حذف کلیدهای آلوده/قدیمی دفتر یکتاسازی یادآوری بازدید (بدون تغییر دادهٔ مشتری)."
def add_arguments(self, parser):
parser.add_argument("--dry-run", action="store_true",
help="فقط گزارش؛ چیزی حذف نمی‌شود.")
parser.add_argument("--all-legacy", action="store_true",
help="همهٔ کلیدهای قالب قدیمی (visit:<id>:<عدد>) حذف شوند، "
"نه فقط عددهای بی‌معنا.")
def handle(self, *args, **options):
dry_run = options["dry_run"]
all_legacy = options["all_legacy"]
absurd, sane_legacy, current = [], [], []
for key in SMSDedup.objects.filter(key__startswith="visit:").values_list(
"key", flat=True
).iterator():
if NEW_PATTERN.match(key):
current.append(key)
continue
match = LEGACY_PATTERN.match(key)
if match:
cycle = int(match.group(2))
(absurd if cycle > MAX_SANE_CYCLE else sane_legacy).append(key)
else:
absurd.append(key)
doomed = absurd + (sane_legacy if all_legacy else [])
self.stdout.write(self.style.MIGRATE_LABEL("گزارش کلیدهای یادآوری بازدید:"))
self.stdout.write(f" کلیدهای قالب جدید (موعد تقویمی): {len(current):,}")
self.stdout.write(f" کلیدهای بی‌معنا (چرخه > {MAX_SANE_CYCLE} یا ناشناخته): {len(absurd):,}")
self.stdout.write(f" کلیدهای قدیمیِ سالم (چرخه ≤ {MAX_SANE_CYCLE}): {len(sane_legacy):,}")
if absurd:
self.stdout.write(" نمونهٔ کلیدهای بی‌معنا: " + ", ".join(absurd[:5]))
self.stdout.write(f" قابل حذف در این اجرا: {len(doomed):,}")
if dry_run:
self.stdout.write(self.style.WARNING(
"\n[شبیه‌سازی] هیچ کلیدی حذف نشد."
))
return
if not doomed:
self.stdout.write(self.style.SUCCESS("\nانجام شد: چیزی برای حذف نبود."))
return
with transaction.atomic():
deleted, _ = SMSDedup.objects.filter(key__in=doomed).delete()
self.stdout.write(self.style.SUCCESS(
f"\nانجام شد: {deleted:,} کلید حذف شد (فقط از دفتر یکتاسازی)."
))
@@ -0,0 +1,484 @@
"""افزودن قطعیِ پیشوند «آقای/خانم» به ابتدای نام مشتریان، بر پایهٔ فایل نام‌های ایرانی.
سیاست‌ها (کاملاً محافظه‌کارانه):
* **پیش‌فرض بدون نوشتن است** (dry-run). نوشتن فقط با ``--apply`` ممکن است.
* برای اجرای واقعی، علاوه بر ``--apply``، تأیید صریح ``--confirm-production`` لازم است.
* فقط فیلد ``Customer.name_family`` و آن هم تنها در موارد قطعی تغییر می‌کند.
* هیچ جنسیتی ذخیره نمی‌شود؛ هیچ فیلدی به مدل مشتری اضافه نشده است.
اجرا:
python manage.py fix_customer_names --dry-run
python manage.py fix_customer_names --apply --confirm-production
ادامهٔ job متوقف‌شده (پیش‌فرض: خودکار آخرین job ناتمام با همان hash ادامه می‌یابد):
python manage.py fix_customer_names --apply --confirm-production --resume <JOB_ID>
شروع عمدی job جدید (مثلاً پس از تکمیل job قبلی یا تغییر فایل):
python manage.py fix_customer_names --apply --confirm-production --new-job
جزئیات ایمنی:
* فایل JSON در هر اجرا فقط یک بار خوانده و parse می‌شود و هرگز نوشته نمی‌شود.
* تغییرات نام و checkpoint هر batch در یک تراکنش اتمیک روی همان دیتابیس ثبت می‌شوند.
* دامنهٔ job با بیشترین pk مشتریان در لحظهٔ آغاز قفل می‌شود؛ مشتریان جدیدتر وارد نمی‌شوند.
* قفل بر پایهٔ heartbeat است و پس از crash (پس از ``LOCK_TTL``) قابل بازیابی است.
* خطای «database is locked» با backoff نمایی + jitter و تعداد محدود retry می‌شود.
* فرمان هیچ migration خودکاری اجرا نمی‌کند.
"""
import random
import time
from datetime import timedelta
from pathlib import Path
from django.conf import settings
from django.core.management.base import BaseCommand, CommandError
from django.db import DEFAULT_DB_ALIAS, connections, transaction
from django.db.models import Max
from django.db.utils import OperationalError
from django.utils import timezone
from admin_panel.models import Customer, CustomerNameFixJob
from admin_panel.name_fix import (ALGORITHM_VERSION, DatasetError,
decide_prefix, load_name_index)
DEFAULT_JSON_FILENAME = "iranianNamesDataset.json"
# مدت اعتبار قفل/heartbeat. batchها کوچک‌اند، پس این مقدار سخاوتمندانه است.
LOCK_TTL = timedelta(minutes=15)
MAX_DB_RETRIES = 4
BACKOFF_BASE_SECONDS = 0.5
# کلیدهای آماری که در ``stats`` مدل job ذخیره و بین اجراها منتقل می‌شوند.
STATS_KEYS = (
"scanned", "changed", "unchanged", "single_word", "has_prefix",
"empty_invalid", "unknown_name", "ambiguous_gender", "batches",
)
# نگاشت «دلیل تصمیم» به «کلید آماری».
REASON_TO_STAT = {
"male": "changed",
"female": "changed",
"single_word": "single_word",
"has_prefix": "has_prefix",
"empty": "empty_invalid",
"unknown_name": "unknown_name",
"ambiguous_gender": "ambiguous_gender",
}
class Command(BaseCommand):
help = (
"افزودن پیشوند «آقای/خانم» به نام مشتریان بر پایهٔ فایل نام‌های ایرانی؛ "
"پیش‌فرض dry-run است و نوشتن نیازمند --apply --confirm-production."
)
def add_arguments(self, parser):
parser.add_argument(
"--json-path", default=str(Path(settings.BASE_DIR) / DEFAULT_JSON_FILENAME),
help=f"مسیر فایل دادهٔ نام‌ها (پیش‌فرض: {DEFAULT_JSON_FILENAME} در ریشهٔ پروژه).",
)
parser.add_argument(
"--batch-size", type=int, default=200,
help="تعداد مشتریان در هر batch (پیش‌فرض ۲۰۰).",
)
parser.add_argument(
"--dry-run", action="store_true",
help="صریحاً حالت شبیه‌سازی (پیش‌فرض همین است؛ همراه --apply مجاز نیست).",
)
parser.add_argument(
"--apply", action="store_true",
help="نوشتن واقعی در دیتابیس. بدون این گزینه فقط گزارش (dry-run) تولید می‌شود.",
)
parser.add_argument(
"--confirm-production", action="store_true",
help="تأیید صریح اپراتور برای نوشتن واقعی؛ همراه --apply الزامی است.",
)
parser.add_argument(
"--resume", type=int, default=None,
help="ادامهٔ یک job مشخص با شناسه (pk) آن.",
)
parser.add_argument(
"--new-job", action="store_true",
help="شروع عمدی یک job جدید (حتی اگر job ناتمام یا تکمیل‌شده‌ای وجود داشته باشد).",
)
parser.add_argument(
"--samples", type=int, default=5,
help="تعداد نمونهٔ «قبل/بعد» برای نمایش در گزارش (پیش‌فرض ۵).",
)
# ------------------------------------------------------------------ main
def handle(self, *args, **options):
alias = DEFAULT_DB_ALIAS
batch_size = max(1, options["batch_size"])
samples_wanted = max(0, options["samples"])
apply_changes = options["apply"]
json_path = self._resolve_json_path(options["json_path"])
self._announce_target(alias)
try:
name_index = load_name_index(json_path)
except DatasetError as exc:
raise CommandError(f"فایل داده رد شد و هیچ تغییری اعمال نشد: {exc}")
self._print_dataset_report(name_index)
if options["dry_run"] and apply_changes:
raise CommandError("--dry-run و --apply با هم ناسازگارند.")
if not apply_changes:
counters, samples = self._run_readonly(
name_index, alias, batch_size, samples_wanted)
self._print_summary(counters, samples, dry_run=True, job=None)
return
if not options["confirm_production"]:
raise CommandError(
"برای نوشتن واقعی، هم --apply و هم --confirm-production لازم است. "
"بدون --apply اجرا حالت dry-run است."
)
self._ensure_job_table(alias)
job, resumed = self._claim_job(
alias, name_index, batch_size, options["resume"], options["new_job"])
counters = self._counters_from(job.stats)
note = "ادامهٔ job" if resumed else "job جدید"
self.stdout.write(self.style.MIGRATE_HEADING(
f"job#{job.pk} {note}؛ از pk>{job.last_processed_pk} تا pk<={job.initial_max_pk} "
f"(batch={batch_size})"
))
try:
counters, samples = self._apply(
name_index, alias, batch_size, job, counters, samples_wanted)
except KeyboardInterrupt:
self._finalize(alias, job, counters, CustomerNameFixJob.Status.PAUSED,
note="توقف با Ctrl+C؛ قابل ادامه با --resume")
self.stdout.write(self.style.WARNING(
f"job#{job.pk} متوقف شد؛ برای ادامه: --apply --confirm-production --resume {job.pk}"
))
return
except Exception as exc: # noqa: BLE001 - هر خطای غیرمنتظره: توقف امن
self._finalize(alias, job, counters, CustomerNameFixJob.Status.FAILED,
note=f"خطا: {type(exc).__name__}")
raise CommandError(
f"اجرای job#{job.pk} با خطا متوقف شد و batch جاری rollback شد: {exc}"
)
self._finalize(alias, job, counters, CustomerNameFixJob.Status.COMPLETED,
note="تکمیل شد")
self._print_summary(counters, samples, dry_run=False, job=job)
# -------------------------------------------------------------- helpers
def _resolve_json_path(self, raw_path):
if not raw_path:
raise CommandError("مسیر فایل داده مشخص نشده است.")
path = Path(raw_path).expanduser()
if not path.is_file():
raise CommandError(f"فایل داده پیدا نشد: {path}")
return path
def _announce_target(self, alias):
"""مقصد دیتابیس را بدون افشای credential نمایش می‌دهد."""
conf = settings.DATABASES.get(alias, {})
engine = conf.get("ENGINE", "?")
name = str(conf.get("NAME", ""))
settings_module = getattr(settings, "SETTINGS_MODULE", "")
self.stdout.write(f"مقصد دیتابیس: alias={alias} engine={engine}")
self.stdout.write(f" NAME: {name}")
if "production_settings" in settings_module:
self.stdout.write(self.style.WARNING(
" توجه: ماژول تنظیمات production فعال است."))
self.stdout.write(" (فقط نام/مسیر دیتابیس چاپ می‌شود؛ credential چاپ نمی‌شود.)")
def _print_dataset_report(self, name_index):
rep = name_index.report
self.stdout.write(self.style.MIGRATE_HEADING("اعتبارسنجی فایل داده"))
self.stdout.write(f" مسیر: {name_index.path}")
self.stdout.write(f" SHA-256: {name_index.sha256}")
self.stdout.write(
f" رکورد کل: {rep['records_total']} | کلید قابل‌استفاده: {rep['usable_keys']} | "
f"کلید غیرقابل‌استفاده: {rep['unusable_keys']}"
)
self.stdout.write(
f" ردشده → malformed: {rep['rejected_malformed']} | "
f"نام خالی: {rep['rejected_empty_name']} | "
f"جنسیت نامعتبر: {rep['rejected_unknown_gender']}"
)
self.stdout.write(
f" نام تکراری: {rep['duplicate_keys']} "
f"(هم‌جنسیت: {rep['duplicate_same_gender']} | متناقض: {rep['duplicate_conflict']})"
)
def _ensure_job_table(self, alias):
table = CustomerNameFixJob._meta.db_table
tables = connections[alias].introspection.table_names()
if table not in tables:
raise CommandError(
f"جدول «{table}» وجود ندارد. ابتدا migration را اعمال کن: "
f"python manage.py migrate"
)
def _empty_counters(self):
return {key: 0 for key in STATS_KEYS}
def _counters_from(self, stats):
counters = self._empty_counters()
if isinstance(stats, dict):
for key in STATS_KEYS:
value = stats.get(key)
if isinstance(value, int):
counters[key] = value
return counters
def _tally(self, counters, decision):
counters["scanned"] += 1
counters[REASON_TO_STAT[decision.reason]] += 1
def _finish_counters(self, counters):
counters["unchanged"] = counters["scanned"] - counters["changed"]
return counters
def _collect_sample(self, samples, raw_name, new_name, wanted):
if wanted and len(samples) < wanted:
samples.append((raw_name, new_name))
# ------------------------------------------------------------ execution
def _run_readonly(self, name_index, alias, batch_size, samples_wanted):
"""اسکن فقط-خواندنی همهٔ مشتریان؛ هیچ نوشتنی (نه نام، نه job) رخ نمی‌دهد."""
counters = self._empty_counters()
samples = []
qs = (Customer.objects.using(alias)
.only("id", "name_family").order_by("pk"))
in_batch = 0
for customer in qs.iterator(chunk_size=batch_size):
decision = decide_prefix(customer.name_family, name_index)
self._tally(counters, decision)
if decision.new_name is not None:
self._collect_sample(samples, customer.name_family,
decision.new_name, samples_wanted)
in_batch += 1
if in_batch >= batch_size:
counters["batches"] += 1
in_batch = 0
if in_batch:
counters["batches"] += 1
return self._finish_counters(counters), samples
def _apply(self, name_index, alias, batch_size, job, totals, samples_wanted):
"""پردازش batchبه‌batch با checkpoint پایدار بر پایهٔ primary key."""
samples = []
max_pk = job.initial_max_pk or 0
last_pk = job.last_processed_pk or 0
while last_pk < max_pk:
rows = list(
Customer.objects.using(alias)
.filter(pk__gt=last_pk, pk__lte=max_pk)
.order_by("pk").only("id", "name_family")[:batch_size]
)
if not rows:
break
batch_counters = self._empty_counters()
changes = []
for customer in rows:
decision = decide_prefix(customer.name_family, name_index)
self._tally(batch_counters, decision)
if decision.new_name is not None:
# فقط فیلد نام تغییر می‌کند؛ سایر فیلدها دست‌نخورده می‌مانند.
changes.append(Customer(pk=customer.pk, name_family=decision.new_name))
self._collect_sample(samples, customer.name_family,
decision.new_name, samples_wanted)
new_last_pk = rows[-1].pk
batch_counters["batches"] = 1
self._commit_batch_with_retry(
alias, changes, new_last_pk, batch_counters, job, totals)
last_pk = new_last_pk
return self._finish_counters(totals), samples
def _commit_batch(self, alias, changes, new_last_pk, batch_counters, job, totals):
"""تغییرات نام + checkpoint + heartbeat را در یک تراکنش اتمیک ثبت می‌کند."""
merged = dict(totals)
for key in STATS_KEYS:
merged[key] = merged[key] + batch_counters[key]
merged = self._finish_counters(merged)
now = timezone.now()
with transaction.atomic(using=alias):
if changes:
Customer.objects.using(alias).bulk_update(changes, ["name_family"])
CustomerNameFixJob.objects.using(alias).filter(pk=job.pk).update(
last_processed_pk=new_last_pk,
stats=merged,
heartbeat_at=now,
updated_at=now,
status=CustomerNameFixJob.Status.RUNNING,
)
# فقط پس از commit موفق، آمار در حافظه به‌روز می‌شود (retry آمار را دوباره اضافه نمی‌کند).
totals.update(merged)
def _commit_batch_with_retry(self, alias, changes, new_last_pk,
batch_counters, job, totals):
for attempt in range(MAX_DB_RETRIES):
try:
self._commit_batch(alias, changes, new_last_pk,
batch_counters, job, totals)
return
except OperationalError as exc:
locked = "locked" in str(exc).lower()
if not locked or attempt == MAX_DB_RETRIES - 1:
raise
delay = BACKOFF_BASE_SECONDS * (2 ** attempt)
delay += random.uniform(0, delay / 2) # jitter
self.stderr.write(
f"دیتابیس قفل شد؛ تلاش {attempt + 2}/{MAX_DB_RETRIES} پس از {delay:.2f}s…"
)
time.sleep(delay)
# ------------------------------------------------------------ job / lock
def _claim_job(self, alias, name_index, batch_size, resume_id, force_new):
"""قفل را می‌گیرد و job مناسب (جدید یا قابل‌ادامه) را RETURN می‌کند.
خروجی: ``(job, resumed)``. در صورت اجرای هم‌زمان یا تناقض hash،
``CommandError`` پرتاب می‌شود و هیچ تغییری اعمال نمی‌گردد.
"""
Job = CustomerNameFixJob
now = timezone.now()
digest = name_index.sha256
active = (Job.objects.using(alias)
.filter(status=Job.Status.RUNNING).order_by("-pk").first())
if active is not None:
fresh = (active.heartbeat_at is not None
and (now - active.heartbeat_at) < LOCK_TTL)
if fresh and active.pk != resume_id:
raise CommandError(
f"job#{active.pk} همین حالا در حال اجراست (heartbeat تازه). "
"اجرای هم‌زمان مجاز نیست."
)
if not fresh:
# قفل کهنه (crash/قطع برق): آزادسازی کنترل‌شده
Job.objects.using(alias).filter(pk=active.pk).update(
status=Job.Status.FAILED, finished_at=now, updated_at=now,
note="قفل کهنه؛ آزادسازی خودکار پس از crash")
self.stderr.write(
f"job#{active.pk} ناتمام رها شده بود و اکنون به‌عنوان failed آزاد شد.")
if resume_id is not None:
job = Job.objects.using(alias).filter(pk=resume_id).first()
if job is None:
raise CommandError(f"job#{resume_id} پیدا نشد.")
self._check_hash(job, digest)
if job.status == Job.Status.COMPLETED:
raise CommandError(
f"job#{job.pk} قبلاً تکمیل شده است؛ برای اجرای دوباره --new-job بده.")
resumed = True
elif force_new:
job = self._create_job(alias, digest, batch_size, now)
resumed = False
else:
job = (Job.objects.using(alias)
.filter(source_hash=digest, algorithm_version=ALGORITHM_VERSION)
.exclude(status=Job.Status.COMPLETED).order_by("-pk").first())
if job is not None:
resumed = True
else:
done = Job.objects.using(alias).filter(
source_hash=digest, algorithm_version=ALGORITHM_VERSION,
status=Job.Status.COMPLETED).exists()
if done:
raise CommandError(
"روی همین فایل یک job تکمیل‌شده وجود دارد؛ برای اجرای دوبارهٔ "
"کنترل‌شده --new-job بده."
)
job = self._create_job(alias, digest, batch_size, now)
resumed = False
Job.objects.using(alias).filter(pk=job.pk).update(
status=Job.Status.RUNNING, heartbeat_at=now, updated_at=now)
job.refresh_from_db(using=alias)
return job, resumed
def _check_hash(self, job, digest):
if job.source_hash != digest:
raise CommandError(
f"hash فایل ورودی با job#{job.pk} نمی‌خواند؛ ادامه رد شد و هیچ تغییری "
"اعمال نمی‌شود. برای فایل جدید یک job مستقل اجرا کن."
)
if job.algorithm_version != ALGORITHM_VERSION:
raise CommandError(
f"نسخهٔ الگوریتم job#{job.pk} ({job.algorithm_version}) با نسخهٔ فعلی "
f"({ALGORITHM_VERSION}) نمی‌خواند؛ ادامه رد شد."
)
def _create_job(self, alias, digest, batch_size, now):
Job = CustomerNameFixJob
initial_max_pk = (Customer.objects.using(alias)
.aggregate(m=Max("id"))["m"]) or 0
return Job.objects.using(alias).create(
source_hash=digest,
algorithm_version=ALGORITHM_VERSION,
status=Job.Status.RUNNING,
batch_size=batch_size,
initial_max_pk=initial_max_pk,
last_processed_pk=0,
stats=self._finish_counters(self._empty_counters()),
heartbeat_at=now,
note="",
)
def _finalize(self, alias, job, counters, status, note):
"""وضعیت نهایی/میانی job را با روش اتمیک ثبت می‌کند."""
job.refresh_from_db(using=alias)
now = timezone.now()
persisted = self._finish_counters(dict(counters))
finished = status in (CustomerNameFixJob.Status.COMPLETED,
CustomerNameFixJob.Status.FAILED)
finished_at = now if finished else job.finished_at
with transaction.atomic(using=alias):
CustomerNameFixJob.objects.using(alias).filter(pk=job.pk).update(
status=status, stats=persisted, updated_at=now, heartbeat_at=now,
finished_at=finished_at, note=note[:255])
job.status = status
job.stats = persisted
job.finished_at = finished_at
# -------------------------------------------------------------- summary
def _print_summary(self, counters, samples, dry_run, job):
if dry_run:
head = "گزارش dry-run — هیچ تغییری نوشته نشد"
else:
head = f"گزارش اجرای واقعی job#{job.pk} ({job.status})"
self.stdout.write(self.style.MIGRATE_HEADING(head))
self.stdout.write(f" مشتریان بررسی‌شده: {counters['scanned']}")
self.stdout.write(f" قابل اصلاح / اصلاح‌شده: {counters['changed']}")
self.stdout.write(f" بدون تغییر: {counters['unchanged']}")
self.stdout.write(
f" تک‌کلمه‌ای: {counters['single_word']} | "
f"دارای پیشوند: {counters['has_prefix']} | "
f"خالی/نامعتبر: {counters['empty_invalid']}"
)
self.stdout.write(
f" ناشناخته در JSON: {counters['unknown_name']} | "
f"جنسیت مبهم/نامعتبر: {counters['ambiguous_gender']}"
)
self.stdout.write(f" batchهای تکمیل‌شده: {counters['batches']}")
if job is not None:
self.stdout.write(
f" شناسهٔ job: {job.pk} | شروع: {job.started_at} | پایان: {job.finished_at}"
)
if samples:
self.stdout.write(" نمونهٔ تغییرات (قبل → بعد):")
for before, after in samples:
self.stdout.write(f" «{before}» → «{after}»")
if dry_run:
self.stdout.write(self.style.WARNING(
"برای اجرای واقعی: --apply --confirm-production"))
@@ -0,0 +1,367 @@
"""استخراج و تجمیع شماره‌های موبایل هر مشتری در ``Customer.sms_primary_phones``.
منابع بررسی (به همین ترتیب اولویت برای حذف تکراری‌ها):
``phone1`` → ``phone2`` → ``phone3`` → رکوردهای ``PhoneNumber`` بر اساس ``id``.
**امنیت داده:** فیلدهای مبدأ، سایر مشخصات مشتری و رکوردهای ``PhoneNumber`` هرگز
ویرایش/حذف نمی‌شوند. تنها ستونی که نوشته می‌شود ``sms_primary_phones`` است.
**قالب ذخیره‌شده:** ``+989xxxxxxxxx`` — همان قالب متعارف پروژه که
``admin_panel.sms.phones.stored_primary_normalized`` انتظار دارد و تمام تست‌های
موجود (``tests/test_sms.py``، ``tests/test_customers.py``) روی آن قفل شده‌اند.
اعتبارسنجی ورودی با استاندارد ۱۱ رقمی ``09xxxxxxxxx`` انجام می‌شود، ولی مقدارِ
ذخیره‌شده همان ``+98…`` است؛ در غیر این‌صورت تطبیق «شمارهٔ اصلی» در پنل و
``resolved_recipients`` هیچ‌وقت نمی‌گیرد و داده بی‌اثر می‌شود.
**تضمین‌ها:**
* پیش‌فرض dry-run است؛ نوشتن فقط با ``--apply``.
* هر batch در ``transaction.atomic`` اختصاصی؛ خطا ⇒ فقط همان batch برمی‌گردد.
* Keyset pagination (``id__gt``) + checkpoint فایل پس از commit موفق هر batch.
* رکوردِ بدون تغییر نوشته نمی‌شود؛ مقدار موجودِ غیرخالی هرگز با «خالی» پاک نمی‌شود.
* سرریز طول (> ``max_length``) ⇒ رکورد دست‌نخورده + ثبت در گزارش.
اجرا:
python manage.py normalize_customer_sms_phones --dry-run
python manage.py normalize_customer_sms_phones --apply
python manage.py normalize_customer_sms_phones --apply --resume
python manage.py normalize_customer_sms_phones --apply --start-id 5000
python manage.py normalize_customer_sms_phones --apply --reset-checkpoint
"""
import json
import os
from pathlib import Path
from django.conf import settings
from django.core.management.base import BaseCommand, CommandError
from django.db import transaction
from persiantools import digits
from admin_panel.models import Customer
from admin_panel.sms.phones import normalize_primary_values
from integrations.sms.normalize import normalize_mobile
DEFAULT_BATCH_SIZE = 100
DEFAULT_CHECKPOINT_NAME = ".sms_normalization_checkpoint.json"
# مرز طول از خود مدل خوانده می‌شود تا با تغییر مدل هم‌راستا بماند.
FIELD_MAX_LENGTH = Customer._meta.get_field("sms_primary_phones").max_length
LEGACY_FIELDS = ("phone1", "phone2", "phone3")
# حداکثر تعداد شناسهٔ سرریز که در گزارش چاپ می‌شود (بقیه فقط شمرده می‌شوند).
OVERFLOW_SAMPLE = 10
# ارقام «پیش‌شمارهٔ ثابت»: 021، 031، 051، 071، … (برای گزارش، نه تصمیم داده).
LANDLINE_SECOND_DIGITS = set("12345678")
def digit_string(raw):
"""فقط ارقامِ یک مقدار ورودی، با تبدیل ارقام فارسی/عربی به انگلیسی."""
if raw is None:
return ""
text = digits.fa_to_en(digits.ar_to_fa(str(raw).strip()))
return "".join(ch for ch in text if ch.isdigit())
def is_landline(raw):
"""آیا مقدار ورودی شکل شمارهٔ ثابت دارد؟ (فقط برای تفکیک در گزارش)
شامل شمارهٔ ثابت محلی ۸رقمی (مثل ``57387608``) و شمارهٔ ثابت با پیش‌شماره
(مثل ``02112345678`` / ``03133445566``) می‌شود — همان قاعدهٔ مستندشدهٔ پروژه
در ``fix_customer_phones.md``.
"""
text = digit_string(raw)
if len(text) == 8:
return True
if len(text) not in (10, 11) or not text.startswith("0"):
return False
return text[1] in LANDLINE_SECOND_DIGITS
class Command(BaseCommand):
help = (
"استخراج و تجمیع شماره‌های موبایل معتبر هر مشتری در sms_primary_phones "
"(پیش‌فرض dry-run؛ اتمیکِ batch به batch با checkpoint قابل ادامه)."
)
def add_arguments(self, parser):
parser.add_argument(
"--batch-size", type=int, default=DEFAULT_BATCH_SIZE,
help=f"تعداد مشتریان در هر batch (پیش‌فرض {DEFAULT_BATCH_SIZE}).",
)
parser.add_argument(
"--dry-run", action="store_true",
help="صریحاً حالت شبیه‌سازی (پیش‌فرض همین است؛ همراه --apply مجاز نیست).",
)
parser.add_argument(
"--apply", action="store_true",
help="نوشتن واقعی در دیتابیس. بدون این گزینه فقط شبیه‌سازی می‌شود.",
)
parser.add_argument(
"--resume", action="store_true",
help="ادامه از آخرین شناسهٔ ثبت‌شده در فایل وضعیت.",
)
parser.add_argument(
"--start-id", type=int, default=None,
help="شروع دستی از یک شناسه (مشتریان با id بزرگ‌تر پردازش می‌شوند). "
"بر --resume اولویت دارد.",
)
parser.add_argument(
"--reset-checkpoint", action="store_true",
help="پاک‌کردن فایل وضعیت و شروع از ابتدا (در dry-run نادیده گرفته می‌شود).",
)
parser.add_argument(
"--checkpoint", default=None,
help=f"مسیر فایل وضعیت (پیش‌فرض: {DEFAULT_CHECKPOINT_NAME} در ریشهٔ پروژه).",
)
# ------------------------------------------------------------------ main
def handle(self, *args, **options):
batch_size = max(1, options["batch_size"])
apply_changes = options["apply"]
checkpoint_path = Path(
options["checkpoint"] or (Path(settings.BASE_DIR) / DEFAULT_CHECKPOINT_NAME)
)
self.stdout.write(
f"حالت: {'اجرای واقعی (--apply)' if apply_changes else 'شبیه‌سازی (dry-run)'} | "
f"batch={batch_size} | فایل وضعیت: {checkpoint_path}"
)
if options["dry_run"] and apply_changes:
raise CommandError("--dry-run و --apply با هم ناسازگارند.")
self._handle_reset(checkpoint_path, apply_changes, options["reset_checkpoint"])
last_id, source = self._start_point(checkpoint_path, options)
self.stdout.write(f"شروع از مشتریان با id > {last_id} ({source})")
counters = {
"scanned": 0, "updated": 0, "unchanged": 0, "kept_nonempty": 0,
"filtered_landline": 0, "filtered_invalid": 0, "duplicates": 0,
"overflow": 0, "batches": 0,
}
overflow_ids = []
try:
last_id = self._run(
last_id, batch_size, apply_changes, checkpoint_path,
counters, overflow_ids)
except KeyboardInterrupt:
self.stdout.write(self.style.WARNING(
f"متوقف شد (Ctrl+C). آخرین شناسهٔ ثبت‌شده: {last_id}. "
"برای ادامه: --apply --resume"
))
return
except Exception as exc: # noqa: BLE001 - توقف امن با گزارش روشن
raise CommandError(
f"اجرا متوقف شد؛ batch جاری rollback شد و آخرین شناسهٔ معتبر "
f"{last_id} است: {exc}"
)
self._print_report(counters, overflow_ids, apply_changes, last_id)
# ------------------------------------------------------------ start/lock
def _handle_reset(self, checkpoint_path, apply_changes, reset_requested):
if not reset_requested:
return
if not checkpoint_path.exists():
self.stdout.write("فایل وضعیت وجود نداشت؛ چیزی برای پاک‌کردن نبود.")
return
if not apply_changes:
self.stdout.write("--reset-checkpoint در شبیه‌سازی نادیده گرفته شد (فایل وضعیت دست‌نخورده).")
return
try:
checkpoint_path.unlink()
except OSError as exc:
raise CommandError(f"فایل وضعیت پاک نشد ({checkpoint_path}): {exc}")
self.stdout.write(f"فایل وضعیت پاک شد: {checkpoint_path}")
def _start_point(self, checkpoint_path, options):
"""(last_id, توضیح منبع) — اولویت: --start-id سپس --resume سپس ابتدا."""
if options["start_id"] is not None:
return max(0, options["start_id"]), "--start-id"
if options["resume"]:
if not checkpoint_path.exists():
raise CommandError(
f"--resume داده شد ولی فایل وضعیت وجود ندارد: {checkpoint_path}"
)
data = self._read_checkpoint(checkpoint_path)
value = data.get("last_id")
if not isinstance(value, int) or value < 0:
raise CommandError(
f"فایل وضعیت معتبر نیست (last_id={value!r}): {checkpoint_path}"
)
return value, "--resume"
return 0, "ابتدا"
def _read_checkpoint(self, path):
try:
data = json.loads(path.read_text(encoding="utf-8"))
except (OSError, ValueError) as exc:
raise CommandError(f"فایل وضعیت خوانده نشد ({path}): {exc}")
if not isinstance(data, dict):
raise CommandError(f"فایل وضعیت ساختار معتبر ندارد ({path}).")
return data
def _write_checkpoint(self, path, last_id, batch_size, counters):
"""نوشتن اتمیک فایل وضعیت (tmp + os.replace) با آخرین شناسهٔ موفق."""
payload = {
"last_id": last_id,
"batch_size": batch_size,
"applied": True,
"scanned": counters["scanned"],
"updated": counters["updated"],
"overflow": counters["overflow"],
"batches": counters["batches"],
}
tmp = path.with_name(path.name + ".tmp")
try:
tmp.write_text(
json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
os.replace(tmp, path)
except OSError as exc:
raise CommandError(f"فایل وضعیت نوشته نشد ({path}): {exc}")
# ---------------------------------------------------------------- batch
def _run(self, last_id, batch_size, apply_changes, checkpoint_path,
counters, overflow_ids):
"""حلقهٔ اصلی: هر batch یک تراکنش اتمیک + checkpoint پس از commit موفق."""
max_id = (Customer.objects.order_by("-id")
.values_list("id", flat=True).first()) or 0
if last_id >= max_id:
self.stdout.write("مشتری‌ای در دامنهٔ پردازش باقی نمانده است.")
return last_id
while last_id < max_id:
rows = list(
Customer.objects
.filter(id__gt=last_id)
.order_by("id")
.prefetch_related("phones") # جلوگیری از N+1
.only("id", "phone1", "phone2", "phone3", "sms_primary_phones")
[:batch_size]
)
if not rows:
break
pending = []
for customer in rows:
counters["scanned"] += 1
value = self._target_value(customer, counters)
current = (customer.sms_primary_phones or "").strip()
if value is None:
overflow_ids.append(customer.id) # سرریز: دست‌نخورده
continue
if not value:
# مقدار محاسبه‌شده خالی است: مقدار موجودِ مدیر پاک نمی‌شود.
if current:
counters["kept_nonempty"] += 1
continue
if value == current:
counters["unchanged"] += 1
continue
pending.append((customer, value))
if apply_changes and pending:
# یک تراکنش کوتاه برای همین batch: خطا ⇒ فقط همین batch برمی‌گردد.
with transaction.atomic():
Customer.objects.bulk_update(
[self._stage(customer, value) for customer, value in pending],
["sms_primary_phones"])
counters["updated"] += len(pending)
new_last_id = rows[-1].id
counters["batches"] += 1
if apply_changes:
self._write_checkpoint(
checkpoint_path, new_last_id, batch_size, counters)
last_id = new_last_id
self.stdout.write(
f" batch {counters['batches']}: last_id={last_id} | "
f"بررسی‌شده={counters['scanned']} | "
f"{'به‌روزشده' if apply_changes else 'قابل‌به‌روزرسانی'}={counters['updated']} | "
f"سرریز={counters['overflow']}"
)
return last_id
# -------------------------------------------------------------- helpers
def _stage(self, customer, value):
"""مقدار نهایی را روی نمونه می‌گذارد و همان را برمی‌گرداند (برای bulk_update)."""
customer.sms_primary_phones = value
return customer
def _target_value(self, customer, counters):
"""مقدار نهایی ``sms_primary_phones`` برای یک مشتری.
خروجی: رشتهٔ نهایی، ``""`` (شمارهٔ معتبری نیست) یا ``None`` (سرریز > max_length).
"""
raw_values = [getattr(customer, field, "") for field in LEGACY_FIELDS]
numbers = sorted(customer.phones.all(), key=lambda row: row.id)
raw_values.extend(row.phone_number for row in numbers)
self._count_filters(raw_values, counters)
value = normalize_primary_values(raw_values)
if not value:
return ""
if len(value) > FIELD_MAX_LENGTH:
counters["overflow"] += 1
return None
return value
def _count_filters(self, raw_values, counters):
"""شمارش شماره‌های فیلترشده (ثابت/نامعتبر) و تکراری‌های حذف‌شده."""
seen = set()
duplicates = 0
for raw in raw_values:
if raw is None or not str(raw).strip():
continue
number = normalize_mobile(raw)
if not number:
if is_landline(raw):
counters["filtered_landline"] += 1
else:
counters["filtered_invalid"] += 1
continue
if number in seen:
duplicates += 1
else:
seen.add(number)
counters["duplicates"] += duplicates
# -------------------------------------------------------------- report
def _print_report(self, counters, overflow_ids, apply_changes, last_id):
head = ("گزارش شبیه‌سازی (dry-run) — هیچ تغییری ذخیره نشد"
if not apply_changes else "گزارش اجرای واقعی")
self.stdout.write(self.style.MIGRATE_HEADING(head))
self.stdout.write(f" مشتریان بررسی‌شده: {counters['scanned']}")
self.stdout.write(
f" مشتریان {'به‌روزشده' if apply_changes else 'قابل‌به‌روزرسانی'}: "
f"{counters['updated']}"
)
self.stdout.write(f" بدون تغییر: {counters['unchanged']}")
self.stdout.write(
f" شماره‌های فیلترشده: ثابت={counters['filtered_landline']} | "
f"نامعتبر={counters['filtered_invalid']} | "
f"جمع={counters['filtered_landline'] + counters['filtered_invalid']}"
)
self.stdout.write(f" شماره‌های تکراری حذف‌شده: {counters['duplicates']}")
self.stdout.write(
f" سرریز طول (>{FIELD_MAX_LENGTH} کاراکتر، دست‌نخورده): {counters['overflow']}"
)
if overflow_ids:
sample = ", ".join(str(pk) for pk in overflow_ids[:OVERFLOW_SAMPLE])
more = len(overflow_ids) - OVERFLOW_SAMPLE
tail = f" و {more} مورد دیگر" if more > 0 else ""
self.stdout.write(f" شناسه‌های سرریز: {sample}{tail}")
if counters["kept_nonempty"]:
self.stdout.write(
f" مقدار موجودِ غیرخالی که محافظت شد (شمارهٔ معتبری پیدا نشد): "
f"{counters['kept_nonempty']}"
)
self.stdout.write(f" batchهای تکمیل‌شده: {counters['batches']}")
self.stdout.write(f" آخرین شناسهٔ پردازش‌شده: {last_id}")
if not apply_changes:
self.stdout.write(self.style.WARNING(
"برای اجرای واقعی: --apply (و در صورت توقف قبلی: --apply --resume)"
))
@@ -0,0 +1,270 @@
"""بازمحاسبهٔ ``Customer.last_bazdid_dt`` از روی منبع حقیقت «آخرین بازدید».
منبع حقیقت، ``admin_panel.visit_policy.last_visit_map`` است: بزرگ‌ترین تاریخ مؤثر
در میان اقدام‌های ``bazdid + finish`` هر مشتری (تاریخ مؤثر = ``actionDateTime`` اگر
از حالا جلوتر نباشد، وگرنه ``finishDateTime``).
این دستور **فقط** ستون ``last_bazdid_dt`` مشتری را عوض می‌کند و هیچ رکورد اقدامی
(از جمله رکوردهای «هماهنگی») را نمی‌خواند/نمی‌نویسد.
python manage.py recalc_last_bazdid --dry-run # فقط گزارش
python manage.py recalc_last_bazdid # فقط اصلاح رو به جلو
python manage.py recalc_last_bazdid --exact --confirm=YES # ترمیم کامل + بکاپ خودکار
* ``--dry-run``: هیچ نوشتنی انجام نمی‌شود.
* ``--exact``: هر اختلافی (رو به جلو، رو به عقب، پرکردن مقدار خالی) اصلاح می‌شود.
بدون ``--confirm=YES`` اجرا نمی‌شود و پیش از هر نوشتن، خودکار ``VACUUM INTO``
می‌گیرد؛ اگر بکاپ شکست بخورد، هیچ چیز نوشته نمی‌شود.
* ``--clear-orphans``: مقادیری که هیچ بازدید معتبری پشتشان نیست را ``NULL`` می‌کند.
* ``--batch-size``: اندازهٔ دستهٔ خواندن مشتریان.
idempotent است: اجرای دوباره در همان حالت هیچ تغییری ایجاد نمی‌کند.
"""
import os
from datetime import datetime
from django.core.management.base import BaseCommand, CommandError
from django.db import connection, transaction
from ...models import Action, Customer
from ...visit_policy import as_aware, last_visit_map
CONFIRM_TOKEN = "YES"
SAMPLE_LIMIT = 20
def _bucket(current, new, clear_orphans):
"""دستهٔ تغییر پیشنهادی برای یک مشتری."""
if new is None:
if current is not None and clear_orphans:
return "orphan_cleared"
return "no_change"
if current is None:
return "fill_null"
if new > current:
return "forward"
if new < current:
return "backward"
return "no_change"
class Command(BaseCommand):
help = (
"بازمحاسبهٔ Customer.last_bazdid_dt از منبع حقیقت بازدید "
"(فقط bazdid + finish؛ هرگز هماهنگی)."
)
def add_arguments(self, parser):
parser.add_argument(
"--dry-run", action="store_true",
help="فقط گزارش؛ هیچ رکوردی ذخیره نمی‌شود.",
)
parser.add_argument(
"--exact", action="store_true",
help="هر اختلافی را اصلاح کن (شامل عقب‌بردن مقدار). نیازمند --confirm=YES.",
)
parser.add_argument(
"--confirm", default="",
help="برای اجرای --exact باید مقدار YES باشد.",
)
parser.add_argument(
"--clear-orphans", action="store_true",
help="مقدارهایی که هیچ اقدام بازدید معتبری پشتشان نیست را NULL کن.",
)
parser.add_argument(
"--batch-size", type=int, default=500,
help="اندازهٔ دستهٔ خواندن مشتریان (پیش‌فرض ۵۰۰).",
)
# ------------------------------------------------------------------
def handle(self, *args, **options):
dry_run = options["dry_run"]
exact = options["exact"]
clear_orphans = options["clear_orphans"]
batch_size = max(1, options["batch_size"])
if exact and not dry_run:
if options["confirm"].strip().upper() != CONFIRM_TOKEN:
raise CommandError(
"اجرای --exact بدون تاییدیه مجاز نیست. ابتدا --dry-run --exact "
"را ببینید، از دیتابیس بکاپ بگیرید و سپس با --confirm=YES اجرا کنید."
)
prefix = "[شبیه‌سازی] " if dry_run else ""
self.stdout.write(self.style.MIGRATE_HEADING(
f"{prefix}بازمحاسبهٔ آخرین بازدید مشتریان آغاز شد."
))
stats, samples, pending, suspects = self._plan(exact, clear_orphans, batch_size)
backup_path = None
if exact and not dry_run and pending:
backup_path = self._backup()
self.stdout.write(self.style.SUCCESS(f"بکاپ ساخته شد: {backup_path}"))
if not dry_run and pending:
self._apply(pending)
self._report(stats, samples, suspects, dry_run, exact, clear_orphans,
len(pending), backup_path)
# ------------------------------------------------------------------
def _plan(self, exact, clear_orphans, batch_size):
"""محاسبهٔ تغییرات پیشنهادی بدون هیچ نوشتنی."""
visits = last_visit_map()
stats = {
"scanned": 0, "with_visit": 0, "no_change": 0,
"fill_null": 0, "forward": 0, "backward": 0, "orphan_cleared": 0,
"kept_orphan": 0,
}
pending = []
samples = []
qs = Customer.objects.only("id", "name_family", "last_bazdid_dt").order_by("id")
for customer in qs.iterator(chunk_size=batch_size):
stats["scanned"] += 1
new = visits.get(customer.id)
current = as_aware(customer.last_bazdid_dt)
if new is not None:
stats["with_visit"] += 1
bucket = _bucket(current, new, clear_orphans)
if bucket == "no_change":
stats["no_change"] += 1
if new is None and current is not None:
stats["kept_orphan"] += 1
continue
if not exact and bucket in ("backward", "orphan_cleared"):
stats["no_change"] += 1 # حالت پیش‌فرض فقط رو به جلو حرکت می‌کند
continue
stats[bucket] += 1
pending.append((customer.id, new))
if len(samples) < SAMPLE_LIMIT:
samples.append((customer.id, customer.name_family, current, new, bucket))
return stats, samples, pending, self._hamahangi_suspect_count()
def _apply(self, pending):
"""اعمال تغییرات؛ فقط ستون ``last_bazdid_dt`` مشتری نوشته می‌شود."""
with transaction.atomic():
for customer_id, target in pending:
Customer.objects.filter(pk=customer_id).update(last_bazdid_dt=target)
# ------------------------------------------------------------------
def _backup(self):
"""یک نسخهٔ سالم از دیتابیس با timestamp می‌سازد؛ خطا یعنی توقف کامل اجرا.
اول ``VACUUM INTO`` (سریع و اتمی) و اگر SQLite اجازه نداد (مثلاً داخل یک
تراکنش باز)، نسخهٔ سازگار با روش رسمی ``sqlite3.Connection.backup``
گرفته می‌شود تا در هر دو حالت یک فایل سالم حاصل شود.
"""
db_path = str(connection.settings_dict.get("NAME") or "")
if not db_path:
raise CommandError("مسیر دیتابیس مشخص نیست؛ بکاپ ممکن نشد.")
target_dir = os.path.dirname(os.path.abspath(db_path))
stamp = datetime.now().strftime("%Y%m%d-%H%M%S")
backup_path = os.path.join(target_dir, f"backup-{stamp}.sqlite3")
try:
with connection.cursor() as cursor:
cursor.execute("VACUUM INTO %s", [backup_path])
except Exception as vacuum_error: # noqa: BLE001
try:
self._copy_database(db_path, backup_path)
except Exception as copy_error: # noqa: BLE001
raise CommandError(
"بکاپ گرفتن شکست خورد؛ هیچ تغییری اعمال نشد: "
f"{vacuum_error} / {copy_error}"
)
if not os.path.exists(backup_path) or os.path.getsize(backup_path) == 0:
raise CommandError("فایل بکاپ ساخته نشد یا خالی است؛ اجرا متوقف شد.")
return backup_path
def _copy_database(self, source_path, target_path):
"""نسخهٔ پشتیبان سازگار از فایل SQLite (روش رسمی ``backup``)."""
import sqlite3
source = sqlite3.connect(self._source_uri(source_path), uri=True)
try:
target = sqlite3.connect(target_path)
try:
source.backup(target)
finally:
target.close()
finally:
source.close()
@staticmethod
def _source_uri(source_path):
"""URI فقط‌خواندنی؛ اگر مسیر خودش URI باشد (دیتابیس تست) دست‌نخورده می‌ماند."""
if source_path.startswith("file:"):
return source_path
return f"file:{source_path}?mode=ro"
def _hamahangi_suspect_count(self):
"""تعداد مشتریانی که مقدارشان دقیقاً برابر تاریخ یک رکورد هماهنگی است.
تشخیص **تقریبی** است: ``last_bazdid_dt`` هیچ ارجاعی به رکورد منبع ندارد،
پس برابری مقدار فقط «نشانه» است، نه اثبات.
"""
stamps = {}
rows = Action.objects.filter(
actionType=Action.ActionType.HAMAHANGI,
).values_list("customer_id", "actionDateTime", "finishDateTime")
for customer_id, action_dt, finish_dt in rows.iterator():
stamps.setdefault(customer_id, set()).update(
v for v in (as_aware(action_dt), as_aware(finish_dt)) if v is not None
)
if not stamps:
return 0
count = 0
qs = Customer.objects.filter(id__in=list(stamps)).only("id", "last_bazdid_dt")
for customer in qs.iterator():
if as_aware(customer.last_bazdid_dt) in stamps[customer.id]:
count += 1
return count
def _report(self, stats, samples, suspects, dry_run, exact, clear_orphans,
changed, backup_path=None):
style = self.style
label = "[شبیه‌سازی] " if dry_run else ""
mode = "exact" if exact else "default(forward-only)"
self.stdout.write(style.MIGRATE_LABEL(
f"\n{label}گزارش بازمحاسبهٔ آخرین بازدید (حالت: {mode}):"
))
self.stdout.write(f" بررسی‌شده (کل مشتریان): {stats['scanned']:,}")
self.stdout.write(f" دارای بازدید معتبر: {stats['with_visit']:,}")
self.stdout.write(f" بدون تغییر: {stats['no_change']:,}")
self.stdout.write(f" پر کردن مقدار خالی: {stats['fill_null']:,}")
self.stdout.write(f" اصلاح رو به جلو: {stats['forward']:,}")
self.stdout.write(f" اصلاح رو به عقب: {stats['backward']:,}")
if clear_orphans:
self.stdout.write(f" پاک‌سازی یتیم: {stats['orphan_cleared']:,}")
else:
self.stdout.write(
f" بدون بازدید ولی دارای مقدار (دست‌نخورده): {stats['kept_orphan']:,}"
)
self.stdout.write(style.WARNING(
f" نشانهٔ آلودگی هماهنگی (تقریبی): {suspects:,}"
))
if samples:
self.stdout.write("\n نمونهٔ تغییرات (id | مشتری | فعلی → جدید | دسته):")
for customer_id, name, current, new, bucket in samples:
self.stdout.write(f" {customer_id} | {name} | {current} → {new} | {bucket}")
if dry_run:
self.stdout.write(style.WARNING(
f"\n[شبیه‌سازی] {changed:,} تغییر پیشنهادی. هیچ رکوردی ذخیره نشد."
))
elif changed:
self.stdout.write(style.SUCCESS(
f"\nانجام شد: {changed:,} مشتری به‌روزرسانی شد (فقط ستون last_bazdid_dt)."
))
else:
self.stdout.write(style.SUCCESS(
"\nانجام شد: هیچ اصلاحی لازم نبود (داده از قبل هم‌راستا است)."
))
if backup_path:
self.stdout.write(f" بکاپ: {backup_path}")
@@ -97,7 +97,8 @@ class Command(BaseCommand):
# آمار نظرسنجی‌ها
nazar_stats = Action.objects.filter(
nazarDT__range=(today_start, today_end),
grade__gt=0
grade__gt=0,
deleted_at__isnull=True,
).aggregate(
avg_grade=Avg('grade'),
total_count=Count('id')
@@ -0,0 +1,174 @@
"""کاهش انواع پیامک به همان ۷ نوع مصوب + هم‌راستاسازی قالب‌ها.
* سه نوع قدیمی (``cheque_due``، ``debt_due``، ``custom``) حذف می‌شوند:
قالب‌ها و تنظیمات opt-out مربوط به آن‌ها پاک می‌شود.
* دو نوع جدید اضافه می‌شود: ``visit_created`` (ثبت اقدام بازدید) و
``payment_thanks`` (تشکر از پرداخت).
* متن/زمان‌بندی نوع‌های باقی‌مانده به معنای جدید هم‌راستا می‌شود
(مثلاً «تأمین موجودی چک» = چند روز پس از سررسید، و نظرسنجی = بی‌درنگ پس از فاکتور).
"""
from django.db import migrations, models
SMS_TYPE_CHOICES = [
("welcome", "خوش‌آمدگویی (ایجاد مشتری)"),
("survey", "نظرسنجی پس از ثبت فاکتور"),
("cheque_registration", "یادآوری تأمین موجودی چک"),
("visit", "یادآوری بازدید خدمات دستگاه"),
("visit_created", "ثبت بازدید (اقدام از نوع بازدید)"),
("payment_thanks", "تشکر از پرداخت"),
("nesiye_due", "یادآوری سررسید نسیه"),
]
REMOVED_TYPES = ["cheque_due", "debt_due", "custom"]
# نوع → مقادیر پیش‌فرض (خالی‌نماندن قالب‌های جدید و هم‌راستایی نوع‌های تغییریافته).
DEFAULT_TEMPLATES = {
"welcome": {
"title": "خوش‌آمدگویی",
"text": "{name} عزیز، از خرید شما سپاسگزاریم. به‌امید دیدار دوباره.",
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": None,
},
"survey": {
"title": "نظرسنجی پس از فاکتور",
"text": "{name} عزیز، از خرید شما سپاسگزاریم. لطفاً با ثبت نظر خود در "
"نظرسنجی ما را همراهی کنید.",
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": None,
},
"cheque_registration": {
"title": "یادآوری تأمین موجودی چک",
"text": "{name} عزیز، چک شما به مبلغ {amount_sep} ریال سررسید شده است. "
"لطفاً نسبت به تأمین موجودی حساب اقدام فرمایید.",
"offset_days": 1,
"repeat_interval_days": None,
"repeat_interval_months": None,
},
"visit": {
"title": "یادآوری بازدید خدمات دستگاه",
"text": "{name} عزیز، بیش از ۹ ماه از تعویض فیلتر دستگاه شما گذشته است. "
"لطفاً جهت هماهنگی برای ثبت بازدید رایگان با تلفن 09139741111 "
"تماس بگیرید.",
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": 9,
},
"visit_created": {
"title": "ثبت بازدید",
"text": "{name} عزیز، بازدید شما برای تاریخ {date} ثبت شد. "
"از همکاری شما سپاسگزاریم.",
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": None,
},
"payment_thanks": {
"title": "تشکر از پرداخت",
"text": "{name} عزیز، از پرداخت شما به مبلغ {amount_sep} ریال سپاسگزاریم.",
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": None,
},
"nesiye_due": {
"title": "یادآوری سررسید نسیه",
"text": "{name} عزیز، سررسید بدهی شما به مبلغ {amount_sep} ریال نزدیک است "
"({date}). لطفاً نسبت به تسویه اقدام فرمایید.",
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": None,
},
}
def align_templates(apps, schema_editor):
SMSTemplate = apps.get_model("admin_panel", "SMSTemplate")
CustomerSMSSetting = apps.get_model("admin_panel", "CustomerSMSSetting")
# ۱. پاک‌سازی انواع حذف‌شده.
SMSTemplate.objects.filter(sms_type__in=REMOVED_TYPES).delete()
CustomerSMSSetting.objects.filter(sms_type__in=REMOVED_TYPES).delete()
# ۲. ایجاد/به‌روزرسانی قالب‌های ۷ نوع مجاز (متن پیش‌فرض جدید + زمان‌بندی).
for sms_type, data in DEFAULT_TEMPLATES.items():
_template, created = SMSTemplate.objects.get_or_create(
sms_type=sms_type,
defaults={
"title": data["title"],
"text": data["text"],
"is_enabled": True,
"offset_days": data["offset_days"],
"repeat_interval_days": data["repeat_interval_days"],
"repeat_interval_months": data["repeat_interval_months"],
},
)
if not created:
SMSTemplate.objects.filter(sms_type=sms_type).update(
offset_days=data["offset_days"],
repeat_interval_days=data["repeat_interval_days"],
repeat_interval_months=data["repeat_interval_months"],
)
# ۳. متن/عنوانِ نوع‌های تغییریافته به معنای جدید هم‌راستا می‌شود.
SMSTemplate.objects.filter(sms_type="visit").update(
title=DEFAULT_TEMPLATES["visit"]["title"],
text=DEFAULT_TEMPLATES["visit"]["text"],
)
SMSTemplate.objects.filter(sms_type="cheque_registration").update(
title=DEFAULT_TEMPLATES["cheque_registration"]["title"],
text=DEFAULT_TEMPLATES["cheque_registration"]["text"],
)
SMSTemplate.objects.filter(sms_type="survey").update(
title=DEFAULT_TEMPLATES["survey"]["title"],
text=DEFAULT_TEMPLATES["survey"]["text"],
)
def clear_removed_queue_types(apps, schema_editor):
"""نوعِ ردیف‌های صفِ باقی‌مانده از انواع حذف‌شده را خالی می‌کند.
ردیف صف حذف نمی‌شود (متن و تاریخچه‌اش می‌ماند) چون ممکن است هنوز ارسال‌نشده
باشد؛ فقط ``sms_type`` آن خالی می‌شود تا کدِ نوعِ نامعتبر در دیتابیس نماند.
"""
SMSQueue = apps.get_model("admin_panel", "SMSQueue")
SMSQueue.objects.filter(sms_type__in=REMOVED_TYPES).update(sms_type="")
def noop(apps, schema_editor):
pass
class Migration(migrations.Migration):
dependencies = [
("admin_panel", "0069_smstemplate_auto_send"),
]
operations = [
migrations.AlterField(
model_name="smstemplate",
name="sms_type",
field=models.CharField(
choices=SMS_TYPE_CHOICES, max_length=40, unique=True,
verbose_name="نوع پیامک",
),
),
migrations.AlterField(
model_name="customersmssetting",
name="sms_type",
field=models.CharField(
choices=SMS_TYPE_CHOICES, max_length=40, verbose_name="نوع پیامک",
),
),
migrations.AlterField(
model_name="smsqueue",
name="sms_type",
field=models.CharField(
blank=True, choices=SMS_TYPE_CHOICES, default="", max_length=40,
verbose_name="نوع",
),
),
migrations.RunPython(align_templates, noop),
migrations.RunPython(clear_removed_queue_types, noop),
]
@@ -0,0 +1,47 @@
"""افزودن پرمیشن جداگانهٔ ``ManageSMSSettings`` برای صفحات تنظیمات/قالب‌های پیامک.
پیش از این، همهٔ مسیرهای پیامک با ``ManageSMS`` کنترل می‌شد. از این پس صفحات
«تنظیمات سامانه» و «قالب‌ها» با ``ManageSMSSettings`` جدا می‌شوند تا مدیر بتواند
دسترسی به آن‌ها را فقط به کاربران مشخصی بدهد، بدون دادن کل اختیارات پیامک.
"""
from django.db import migrations
from django.db.models import F
def ensure_permission(apps, schema_editor):
"""رکورد Permission جدید را (اگر نبود) می‌سازد و نام نمایشی‌اش را اصلاح می‌کند."""
Permission = apps.get_model('auth', 'Permission')
ContentType = apps.get_model('contenttypes', 'ContentType')
content_type, _created = ContentType.objects.get_or_create(
app_label='admin_panel', model='smsproviderconfig',
)
Permission.objects.get_or_create(
content_type=content_type,
codename='ManageSMSSettings',
defaults={'name': 'ManageSMSSettings'},
)
# نام نمایشی هر دو پرمیشن پیامک را با قرارداد پروژه هم‌راستا می‌کند.
Permission.objects.filter(
content_type=content_type, codename__in=['ManageSMS', 'ManageSMSSettings'],
).update(name=F('codename'))
class Migration(migrations.Migration):
dependencies = [
('admin_panel', '0070_sms_types_seven'),
]
operations = [
migrations.AlterModelOptions(
name='smsproviderconfig',
options={
'permissions': [('ManageSMS', 'ManageSMS'),
('ManageSMSSettings', 'ManageSMSSettings')],
'verbose_name': 'تنظیمات سامانه پیامک',
'verbose_name_plural': 'تنظیمات سامانه پیامک',
},
),
migrations.RunPython(ensure_permission, migrations.RunPython.noop),
]
@@ -0,0 +1,35 @@
# Generated by Django 3.2.25 on 2026-10-15 06:07
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('admin_panel', '0071_sms_settings_permission'),
]
operations = [
migrations.CreateModel(
name='CustomerNameFixJob',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('source_hash', models.CharField(max_length=64)),
('algorithm_version', models.CharField(default='1', max_length=16)),
('status', models.CharField(choices=[('running', 'در حال اجرا'), ('paused', 'متوقف\u200cشده (قابل ادامه)'), ('completed', 'تکمیل\u200cشده'), ('failed', 'ناموفق')], default='paused', max_length=16)),
('batch_size', models.PositiveIntegerField(default=200)),
('initial_max_pk', models.BigIntegerField(blank=True, null=True)),
('last_processed_pk', models.BigIntegerField(default=0)),
('stats', models.JSONField(blank=True, default=dict)),
('note', models.CharField(blank=True, default='', max_length=255)),
('started_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
('finished_at', models.DateTimeField(blank=True, null=True)),
('heartbeat_at', models.DateTimeField(blank=True, null=True)),
],
options={
'verbose_name': 'job اصلاح نام مشتری',
'verbose_name_plural': 'jobهای اصلاح نام مشتری',
},
),
]
@@ -0,0 +1,37 @@
# Generated by Django 3.2.25 on 2026-10-16 10:49
from django.db import migrations, models
class Migration(migrations.Migration):
"""افزودن ``choices`` به ``Action.actionType``.
این migration فقط وضعیت مدل را به‌روز می‌کند: Django ``choices`` را در
``deconstruct()`` فیلد نگه می‌دارد، پس بدون این migration دستور
``makemigrations --check`` شکست می‌خورد. تعریف ستون در SQLite هیچ تغییری
نمی‌کند (``choices`` در DDL بازتاب نمی‌یابد) و هیچ داده‌ای بازنویسی نمی‌شود.
"""
dependencies = [
('admin_panel', '0072_customernamefixjob'),
]
operations = [
migrations.AlterField(
model_name='action',
name='actionType',
field=models.CharField(
blank=True,
choices=[
('bazdid', 'بازدید'),
('nasb', 'نصب'),
('vosol', 'وصول مطالبات'),
('hamahangi', 'هماهنگی'),
('inCall', 'تماس ورودی'),
('outCall', 'تماس خروجی'),
],
max_length=50,
null=True,
),
),
]
@@ -0,0 +1,37 @@
# Generated by Django 3.2.25 on 2026-10-16 10:49
from django.db import migrations, models
class Migration(migrations.Migration):
"""افزودن ``choices`` به ``Action.status``.
این migration فقط وضعیت مدل را به‌روز می‌کند: Django ``choices`` را در
``deconstruct()`` فیلد نگه می‌دارد، پس بدون این migration دستور
``makemigrations --check`` شکست می‌خورد. تعریف ستون در SQLite هیچ تغییری
نمی‌کند (``choices`` در DDL بازتاب نمی‌یابد) و هیچ داده‌ای بازنویسی نمی‌شود.
املای مقادیر عیناً همان چیزی است که در دیتابیس و کد موجود به‌کار رفته:
``'waite'`` (نه ``'wait'``)، ``'finish'`` و ``'cancell'``.
"""
dependencies = [
('admin_panel', '0073_alter_action_actiontype_choices'),
]
operations = [
migrations.AlterField(
model_name='action',
name='status',
field=models.CharField(
blank=True,
choices=[
('waite', 'در انتظار (باز)'),
('finish', 'انجام شده'),
('cancell', 'لغو شده'),
],
max_length=50,
null=True,
),
),
]
@@ -0,0 +1,49 @@
"""یادآوری تأمین موجودی چک: تغییر جهت از «پس از سررسید» به «پیش از سررسید».
هدف این migration **فقط** هم‌راستا‌کردن مقدار عددی ``offset_days`` قالب
``cheque_registration`` با معنای جدید است (تعداد روز **قبل** از سررسید).
آنچه این migration عمداً **نمی‌کند**:
* ``text`` (متن پیامک) را تغییر نمی‌دهد — متنی که مدیر در پنل تنظیم کرده دست‌نخورده
می‌ماند. اگر متن فعلی از زمان گذشته حرف می‌زند («سررسید شده است»)، مدیر می‌تواند
خودش از صفحهٔ «قالب‌های پیامک» ویرایشش کند.
* ``title``، ``is_enabled`` و ``auto_send`` را تغییر نمی‌دهد.
* هیچ نوع/قالب دیگری را لمس نمی‌کند.
مقدار ``offset_days`` روی پیش‌فرض معنای جدید (۱ روز قبل از سررسید) تنظیم می‌شود تا
نصب‌های تازه و نصب‌های موجود یکسان رفتار کنند؛ اما اگر مدیر قبلاً عددی غیر از مقدار
قدیمی (``1``) گذاشته باشد، به آن دست نمی‌زنیم تا انتخابش از بین نرود.
idempotent است؛ اجرای دوباره بی‌خطر است.
"""
from django.db import migrations
SMS_TYPE = "cheque_registration"
# مقدار پیش‌فرضِ منطق قدیم («۱ روز پس از سررسید») که با معنای جدید هم‌عددی است؛
# فقط رکوردهایی که هنوز روی همین مقدار هستند هم‌راستا می‌شوند.
OLD_DEFAULT = 1
NEW_DEFAULT = 1
def align_cheque_offset(apps, schema_editor):
"""``offset_days`` قالب چک را روی پیش‌فرض جدید بگذارد (بدون لمس متن)."""
SMSTemplate = apps.get_model("admin_panel", "SMSTemplate")
SMSTemplate.objects.filter(
sms_type=SMS_TYPE, offset_days=OLD_DEFAULT,
).update(offset_days=NEW_DEFAULT)
def noop(apps, schema_editor):
pass
class Migration(migrations.Migration):
dependencies = [
("admin_panel", "0074_alter_action_status_choices"),
]
operations = [
migrations.RunPython(align_cheque_offset, noop),
]
@@ -0,0 +1,36 @@
"""افزودن متغیر ``{sayyad_id}`` به راهنمای ``help_text`` متن قالب پیامک.
هدف: راهنمای متغیرها در پنل، «شناسهٔ صیاد چک» را هم نشان دهد.
آنچه این migration عمداً **نمی‌کند**:
* ``text`` (متن واقعی قالب‌ها) را تغییر نمی‌دهد — فقط ``help_text`` فیلد عوض شده
است که در ``deconstruct()`` می‌آید و state مدل را جلو می‌برد.
* هیچ رکورد ``SMSTemplate`` را لمس نمی‌کند.
idempotent است؛ اجرای دوباره بی‌خطر است.
"""
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
("admin_panel", "0075_cheque_funding_before_due"),
]
operations = [
migrations.AlterField(
model_name="smstemplate",
name="text",
field=models.TextField(
help_text=(
"متغیرهای قابل استفاده: {name} نام مشتری، {amount} مبلغ، "
"{amount_sep} مبلغ با جداکننده، {date} تاریخ جلالی، "
"{days} تعداد روز، {check_row} شماره ردیف چک، "
"{sayyad_id} شناسه صیاد چک، {owner_name} نام مالک چک."
),
verbose_name="متن پیامک",
),
),
]
@@ -0,0 +1,39 @@
"""افزودن متغیرهای ``{balance}`` / ``{balance_sep}`` به راهنمای متن قالب پیامک.
هدف: راهنمای متغیرها در پنل، «مانده حساب مشتری» را هم نشان دهد و تفاوتش را با
مبلغ سررسیدشده روشن کند.
آنچه این migration عمداً **نمی‌کند**:
* ``text`` (متن واقعی قالب‌ها) را تغییر نمی‌دهد — فقط ``help_text`` فیلد عوض شده
است که در ``deconstruct()`` می‌آید و state مدل را جلو می‌برد.
* هیچ رکورد ``SMSTemplate`` را لمس نمی‌کند.
idempotent است؛ اجرای دوباره بی‌خطر است.
"""
from django.db import migrations, models
HELP_TEXT = (
"متغیرهای قابل استفاده: {name} نام مشتری، {amount} مبلغ، "
"{amount_sep} مبلغ با جداکننده، {date} تاریخ جلالی، {days} تعداد روز، "
"{check_row} شماره ردیف چک، {sayyad_id} شناسه صیاد چک، "
"{owner_name} نام مالک چک، {balance} مانده حساب مشتری، "
"{balance_sep} مانده حساب با جداکننده. "
"(توجه: {balance} مانده کل حساب است و با مبلغ سررسیدشدهٔ چک/نسیه "
"که در {amount} می‌آید تفاوت دارد.)"
)
class Migration(migrations.Migration):
dependencies = [
("admin_panel", "0076_alter_smstemplate_text_help"),
]
operations = [
migrations.AlterField(
model_name="smstemplate",
name="text",
field=models.TextField(help_text=HELP_TEXT, verbose_name="متن پیامک"),
),
]
@@ -0,0 +1,36 @@
# Generated by Django 3.2.25 on 2026-10-20 14:50
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('admin_panel', '0077_alter_smstemplate_text_balance_help'),
]
operations = [
# ایندکس سه‌ستونیِ قبلی باید ابتدا برداشته شود؛ وگرنه نام ``act_visit_idx``
# تکراری می‌شود. ساخت ایندکس پوشا هم همین‌جا انجام می‌شود تا وضعیت مدل
# (``Meta.indexes``) و دیتابیس دقیقاً یکی باشند.
migrations.RunSQL(
sql=[
'DROP INDEX IF EXISTS "act_visit_idx";',
(
'CREATE INDEX "act_visit_idx" ON "admin_panel_action" '
'("actionType", "status", "customer_id", "actionDateTime", "finishDateTime");'
),
],
reverse_sql=['DROP INDEX IF EXISTS "act_visit_idx";'],
state_operations=[
migrations.AddIndex(
model_name='action',
index=models.Index(
fields=['actionType', 'status', 'customer_id',
'actionDateTime', 'finishDateTime'],
name='act_visit_idx',
),
),
],
),
]
@@ -0,0 +1,23 @@
# Generated by Django 3.2.25 on 2026-10-20 18:07
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('admin_panel', '0078_action_visit_covering_index'),
]
operations = [
migrations.AddField(
model_name='customer',
name='visit_hold_set_at',
field=models.DateTimeField(blank=True, help_text='برای حسابرسی: آخرین باری که مقدار «قرار بعدی» نوشته شد.', null=True, verbose_name='زمان ثبت قرار'),
),
migrations.AddField(
model_name='customer',
name='visit_hold_until',
field=models.DateTimeField(blank=True, help_text='تا پایان این روز پیگیری لازم نیست؛ از فرم «هماهنگی» تنظیم می\u200cشود.', null=True, verbose_name='قرار بعدی (تعویق بازدید)'),
),
]
@@ -0,0 +1,26 @@
# Generated by Django 3.2.25 on 2026-10-21 12:31
from django.conf import settings
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
dependencies = [
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
('admin_panel', '0079_customer_visit_hold'),
]
operations = [
migrations.AddField(
model_name='action',
name='deleted_at',
field=models.DateTimeField(blank=True, default=None, help_text='اگر پر باشد، این اقدام توسط کاربر حذف شده است (status=cancell).', null=True, verbose_name='زمان حذف'),
),
migrations.AddField(
model_name='action',
name='deleted_by',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='deleted_actions', to=settings.AUTH_USER_MODEL, verbose_name='حذف\u200cکننده'),
),
]
@@ -0,0 +1,113 @@
"""افزودن نوع پیامک ``install_created`` («ثبت نصب — اقدام از نوع نصب»).
**این مهاجرت هیچ دادهٔ موجودی را تغییر نمی‌دهد.** سه کار انجام می‌شود:
۱. ``choices`` سه فیلد ``sms_type`` (قالب، تنظیم مشتری، صف) به ۸ نوع گسترش
می‌یابد تا مقدار جدید در پنل/اعتبارسنجی معتبر باشد. ``AlterField`` فقط
متادیتای ستون را عوض می‌کند و به ارزش ردیف‌ها دست نمی‌زند.
۲. **فقط** یک قالب تازه برای نوع جدید ساخته می‌شود (``get_or_create``): اگر از
قبل وجود داشته باشد، هیچ فیلدی از آن بازنویسی نمی‌شود.
* ``is_enabled=True`` ⇒ از پنل قالب‌ها دیده/ویرایش شود.
* ``auto_send=False`` (صریح) ⇒ در صف «در انتظار تأیید» می‌ماند تا مدیر خودش
تأیید/ارسال کند؛ هیچ پیامکی ناخواسته ارسال نمی‌شود.
۳. قالب‌های هفت نوع قبلی حتی لمس هم نمی‌شوند: در این فایل هیچ ``update``/``save``
روی آن‌ها وجود ندارد.
متغیرهای متنی همان ``{name}`` و ``{date}`` هستند؛ نیازی به تغییر ساختار نیست.
"""
from django.db import migrations, models
SMS_TYPE_CHOICES = [
("welcome", "خوش‌آمدگویی (ایجاد مشتری)"),
("survey", "نظرسنجی پس از ثبت فاکتور"),
("cheque_registration", "یادآوری تأمین موجودی چک"),
("visit", "یادآوری بازدید خدمات دستگاه"),
("visit_created", "ثبت بازدید (اقدام از نوع بازدید)"),
("install_created", "ثبت نصب (اقدام از نوع نصب)"),
("payment_thanks", "تشکر از پرداخت"),
("nesiye_due", "یادآوری سررسید نسیه"),
]
NEW_SMS_TYPE = "install_created"
# قالب پیش‌فرض نوع جدید. متن مشابه «ثبت بازدید» است تا لحن پیام‌ها یکدست بماند.
INSTALL_TEMPLATE = {
"title": "ثبت نصب",
"text": "{name} عزیز، نصب شما برای تاریخ {date} ثبت شد. "
"از همکاری شما سپاسگزاریم.",
"is_enabled": True,
# خاموش: پیامک در «در انتظار تأیید» می‌ماند (رفتار پیش‌فرض امن پروژه).
"auto_send": False,
"offset_days": 0,
"repeat_interval_days": None,
"repeat_interval_months": None,
}
def seed_install_template(apps, schema_editor):
"""ایجاد قالب «ثبت نصب» اگر وجود ندارد (اجرای دوباره بی‌خطر است).
``get_or_create`` عمداً بدون هیچ ``update`` است: قالب‌های موجود (هر هفت نوع
قبلی) و حتی خودِ ``install_created`` اگر از قبل باشد، دست‌نخورده می‌مانند.
"""
SMSTemplate = apps.get_model("admin_panel", "SMSTemplate")
SMSTemplate.objects.get_or_create(
sms_type=NEW_SMS_TYPE,
defaults={
"title": INSTALL_TEMPLATE["title"],
"text": INSTALL_TEMPLATE["text"],
"is_enabled": INSTALL_TEMPLATE["is_enabled"],
"auto_send": INSTALL_TEMPLATE["auto_send"],
"offset_days": INSTALL_TEMPLATE["offset_days"],
"repeat_interval_days": INSTALL_TEMPLATE["repeat_interval_days"],
"repeat_interval_months": INSTALL_TEMPLATE["repeat_interval_months"],
},
)
def drop_install_template(apps, schema_editor):
"""بازگشت: فقط ردیف‌های همان نوع جدید حذف می‌شوند.
سایر قالب‌ها و تنظیم‌های مشتری دست نمی‌خورند.
"""
apps.get_model("admin_panel", "SMSTemplate").objects.filter(
sms_type=NEW_SMS_TYPE,
).delete()
apps.get_model("admin_panel", "CustomerSMSSetting").objects.filter(
sms_type=NEW_SMS_TYPE,
).delete()
class Migration(migrations.Migration):
dependencies = [
("admin_panel", "0080_action_soft_delete"),
]
operations = [
migrations.AlterField(
model_name="smstemplate",
name="sms_type",
field=models.CharField(
choices=SMS_TYPE_CHOICES, max_length=40, unique=True,
verbose_name="نوع پیامک",
),
),
migrations.AlterField(
model_name="customersmssetting",
name="sms_type",
field=models.CharField(
choices=SMS_TYPE_CHOICES, max_length=40, verbose_name="نوع پیامک",
),
),
migrations.AlterField(
model_name="smsqueue",
name="sms_type",
field=models.CharField(
blank=True, choices=SMS_TYPE_CHOICES, default="", max_length=40,
verbose_name="نوع",
),
),
migrations.RunPython(seed_install_template, drop_install_template),
]
+67 -2
View File
@@ -22,7 +22,35 @@ class VisitQueue(models.Model):
class Action(models.Model):
actionType = models.CharField(max_length=50, null=True, blank=True)
"""اقدام/وظیفهٔ CRM مرتبط با مشتری.
``actionType`` فقط این شش مقدار را می‌پذیرد؛ همین شش مقدار در فرم‌های پنل
(``customerActionInc.html``) و در تمام مقایسه‌های کد (``== 'bazdid'``،
``exclude(actionType='vosol')`` و …) استفاده می‌شوند.
``status`` نیز همان سه مقدارِ به‌کاررفته در کد و قالب‌ها را می‌پذیرد.
املای ``'waite'`` عمداً حفظ شده است: ۲٫۷۱۹ رکورد موجودِ دیتابیس و تمام
مقایسه‌های کد/قالب (``== 'waite'``، ``if filter_status == 'waite'``) با
همین املا کار می‌کنند و تغییرش داده را از موتور جست‌وجو جدا می‌کند.
"""
class ActionType(models.TextChoices):
BAZDID = 'bazdid', 'بازدید'
NASB = 'nasb', 'نصب'
VOSOL = 'vosol', 'وصول مطالبات'
HAMAHANGI = 'hamahangi', 'هماهنگی'
IN_CALL = 'inCall', 'تماس ورودی'
OUT_CALL = 'outCall', 'تماس خروجی'
class Status(models.TextChoices):
# املا عیناً مطابق داده و کد فعلی است (نه 'wait').
WAITE = 'waite', 'در انتظار (باز)'
FINISH = 'finish', 'انجام شده'
CANCELL = 'cancell', 'لغو شده'
actionType = models.CharField(
max_length=50, null=True, blank=True, choices=ActionType.choices,
)
forUser = models.ForeignKey(User, on_delete=models.SET_NULL, null=True, blank=True)
customer = models.ForeignKey('Customer', related_name='actionrlt', on_delete=models.CASCADE, null=True, blank=True)
createdDT = models.DateTimeField(auto_now_add=True)
@@ -31,8 +59,45 @@ class Action(models.Model):
finishDateTime = models.DateTimeField(null=True, blank=True)
desc = models.CharField(max_length=500, null=True, blank=True)
result = models.CharField(max_length=500, null=True, blank=True)
status = models.CharField(max_length=50, null=True, blank=True)
status = models.CharField(
max_length=50, null=True, blank=True, choices=Status.choices,
)
nazar = models.CharField(max_length=50, null=True, blank=True, default=None)
nextNazarDT = models.DateTimeField(null=True, blank=True, default=None)
nazarDT = models.DateTimeField(null=True, blank=True, default=None)
grade = models.IntegerField(null=True, blank=True, default=None)
# --- حسابرسی «حذف» (soft-delete از طریق status='cancell') ---
# چرا ستون جدا؟ چون ``cancell`` از قبل معنای «لغو برنامه» را دارد و در گزارش‌ها
# هم استفاده می‌شود. با این دو ستون می‌توانیم «حذف توسط کاربر» را از «لغو
# عادی» تفکیک کنیم، بدون آنکه منطق محاسبات (که فقط waite/finish را می‌بیند)
# دست بخورد.
deleted_at = models.DateTimeField(
null=True, blank=True, default=None, verbose_name="زمان حذف",
help_text="اگر پر باشد، این اقدام توسط کاربر حذف شده است (status=cancell).",
)
deleted_by = models.ForeignKey(
User, on_delete=models.SET_NULL, null=True, blank=True,
related_name="deleted_actions", verbose_name="حذف‌کننده",
)
@property
def is_deleted(self):
"""آیا این اقدام با «حذف» کنار گذاشته شده است؟ (نه لغو عادی)"""
return self.deleted_at is not None
class Meta:
# ایندکس **پوشا (covering)** برای محاسبهٔ «آخرین بازدید»: هر سه ستونِ لازم
# برای فیلتر و تجمیع داخل خودِ ایندکس است، پس دیتابیس به جدول اصلی مراجعه
# نمی‌کند. اندازه‌گیری روی دادهٔ واقعی: ۱۶۴ms → ۲۹ms.
# ستون‌های actionType/status/customer_id برای فیلتر و group، و دو ستون
# تاریخ برای محاسبهٔ «تاریخ مؤثر» در همان ایندکس.
indexes = [
models.Index(
fields=[
'actionType', 'status', 'customer_id',
'actionDateTime', 'finishDateTime',
],
name='act_visit_idx',
),
]
+19
View File
@@ -39,6 +39,25 @@ class Customer(models.Model):
help_text="شماره‌های نرمال‌شده (+98…) جدا‌شده با کاما؛ خالی = شمارهٔ اول مشتری.",
)
# ------------------------------------------------------------------
# «قرار بعدی» — تعویقِ دستیِ بازدید (تصمیم محصولی)
# ------------------------------------------------------------------
# این ستون **اعتبار مستقل ندارد**: فقط وقتی اثر دارد که یک اقدام «هماهنگی»
# فعال (``waite``/``finish``) با تاریخ آینده برای همان مشتری وجود داشته باشد.
# منبع حقیقت همچنان جدول ``Action`` است و این مقدار یک میان‌بر سریع برای
# نمایش/فیلتر است. اگر هماهنگی حذف/لغو شود، این مقدار خودبه‌خود بی‌اثر می‌شود
# (نگاه کنید به ``visit_policy.manual_holds_map``).
visit_hold_until = models.DateTimeField(
null=True, blank=True,
verbose_name="قرار بعدی (تعویق بازدید)",
help_text="تا پایان این روز پیگیری لازم نیست؛ از فرم «هماهنگی» تنظیم می‌شود.",
)
visit_hold_set_at = models.DateTimeField(
null=True, blank=True,
verbose_name="زمان ثبت قرار",
help_text="برای حسابرسی: آخرین باری که مقدار «قرار بعدی» نوشته شد.",
)
def __str__(self):
return self.name_family
+20 -8
View File
@@ -11,16 +11,21 @@ from django.db import models
class SMSType(models.TextChoices):
"""انواع پیامک‌های سیستم."""
"""انواع پیامک‌های سیستم (دقیقاً ۸ نوع، به ترتیب چرخهٔ کاری).
ترتیب تعریف = ترتیب نمایش در پنل. هر نوع یا از یک رویداد (view) یا از یک
اسکنر دوره‌ای در صف قرار می‌گیرد؛ نگاشت آن در ``admin_panel/sms/triggers.py``
و ``admin_panel/sms/scanner.py`` است.
"""
WELCOME = "welcome", "خوش‌آمدگویی (ایجاد مشتری)"
CHEQUE_DUE = "cheque_due", "یادآوری سررسید چک"
NESIYE_DUE = "nesiye_due", "یادآوری سررسید نسیه"
SURVEY = "survey", "نظرسنجی پس از ثبت فاکتور"
CHEQUE_REGISTRATION = "cheque_registration", "یادآوری تأمین موجودی چک"
DEBT_DUE = "debt_due", "یادآوری بدهی (سررسید وصول مطالبات)"
VISIT = "visit", "یادآوری بازدید خدمات"
SURVEY = "survey", "نظرسنجی پس از فاکتور"
CUSTOM = "custom", "پیام سفارشی"
VISIT = "visit", "یادآوری بازدید خدمات دستگاه"
VISIT_CREATED = "visit_created", "ثبت بازدید (اقدام از نوع بازدید)"
INSTALL_CREATED = "install_created", "ثبت نصب (اقدام از نوع نصب)"
PAYMENT_THANKS = "payment_thanks", "تشکر از پرداخت"
NESIYE_DUE = "nesiye_due", "یادآوری سررسید نسیه"
class SMSProviderConfig(models.Model):
@@ -33,6 +38,9 @@ class SMSProviderConfig(models.Model):
# نام نمایشی مطابق قرارداد سایر پرمیشن‌های پروژه (ViewStore/AddCustomer/...)
# تا در فهرست پرمیشن‌های Django Admin به‌سادگی پیدا شود.
("ManageSMS", "ManageSMS"),
# سطح دسترسی جداگانه برای صفحات «تنظیمات» و «قالب‌ها»: مدیر می‌تواند فقط
# به کاربران مشخصی اجازهٔ دیدن/ویرایش این‌ها را بدهد (نه هر کاربر پیامک).
("ManageSMSSettings", "ManageSMSSettings"),
]
ProviderChoices = [
@@ -147,7 +155,11 @@ class SMSTemplate(models.Model):
verbose_name="متن پیامک",
help_text="متغیرهای قابل استفاده: {name} نام مشتری، {amount} مبلغ، "
"{amount_sep} مبلغ با جداکننده، {date} تاریخ جلالی، {days} تعداد روز، "
"{check_row} شماره ردیف چک، {owner_name} نام مالک چک.",
"{check_row} شماره ردیف چک، {sayyad_id} شناسه صیاد چک، "
"{owner_name} نام مالک چک، {balance} مانده حساب مشتری، "
"{balance_sep} مانده حساب با جداکننده. "
"(توجه: {balance} مانده کل حساب است و با مبلغ سررسیدشدهٔ چک/نسیه "
"که در {amount} می‌آید تفاوت دارد.)",
)
is_enabled = models.BooleanField(default=True, verbose_name="فعال")
auto_send = models.BooleanField(
+42
View File
@@ -1,6 +1,48 @@
from django.db import models
class CustomerNameFixJob(models.Model):
"""وضعیت و checkpoint عملیات «افزودن پیشوند آقای/خانم به نام مشتریان».
این مدل **فقط** برای مدیریت/بازیابی job است و هیچ اطلاعاتی دربارهٔ جنسیت یا
هویت مشتری نگه نمی‌دارد. مدل ``Customer`` هیچ تغییر ساختاری نمی‌گیرد.
"""
class Status(models.TextChoices):
RUNNING = "running", "در حال اجرا"
PAUSED = "paused", "متوقف‌شده (قابل ادامه)"
COMPLETED = "completed", "تکمیل‌شده"
FAILED = "failed", "ناموفق"
# شناسهٔ فایل ورودی: اگر hash تغییر کند، ادامهٔ job رد می‌شود.
source_hash = models.CharField(max_length=64)
algorithm_version = models.CharField(max_length=16, default="1")
status = models.CharField(max_length=16, choices=Status.choices, default=Status.PAUSED)
batch_size = models.PositiveIntegerField(default=200)
# دامنهٔ job: بیشترین primary key مشتریان در لحظهٔ آغاز. مشتریان جدیدتر
# (pk > initial_max_pk) عمداً خارج از دامنه می‌مانند.
initial_max_pk = models.BigIntegerField(null=True, blank=True)
# checkpoint: آخرین pk پردازش‌شده (به‌صورت اتمیک با تغییرات همان batch ثبت می‌شود).
last_processed_pk = models.BigIntegerField(default=0)
stats = models.JSONField(default=dict, blank=True)
note = models.CharField(max_length=255, blank=True, default="")
started_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
finished_at = models.DateTimeField(null=True, blank=True)
# ضربان قفل: برای تشخیص job رهاشده پس از crash و جلوگیری از اجرای هم‌زمان.
heartbeat_at = models.DateTimeField(null=True, blank=True)
class Meta:
verbose_name = "job اصلاح نام مشتری"
verbose_name_plural = "jobهای اصلاح نام مشتری"
def __str__(self):
return f"job#{self.pk} {self.status} hash={self.source_hash[:8]} pk<={self.last_processed_pk}"
class CacheTable(models.Model):
key = models.CharField(max_length=50, unique=True)
value = models.CharField(max_length=400)
+205
View File
@@ -0,0 +1,205 @@
"""منطق محضِ افزودن پیشوند «آقای/خانم» به نام مشتریان بر پایهٔ ``iranianNamesDataset.json``.
این ماژول هیچ چیزی در دیتابیس تغییر نمی‌دهد و به Django وابسته نیست؛ فقط:
* فایل JSON را **یک بار** می‌خواند و SHA-256 و index جست‌وجو می‌سازد.
* برای هر نام تصمیم می‌گیرد که آیا پیشوند اضافه شود یا نه (سیاست کاملاً محافظه‌کارانه).
قواعد تصمیم (به ترتیب):
1. نام تهی/فقط فاصله → دست‌نخورده.
2. اولین کلمه یکی از ``آقا``/``آقای``/``خانم`` → دست‌نخورده (پیشوند تکرار نمی‌شود).
3. نام تک‌کلمه‌ای → دست‌نخورده (ممکن است فقط نام خانوادگی باشد).
4. اولین کلمه در index نباشد → دست‌نخورده.
5. جنسیت اولین کلمه مبهم/نامعتبر باشد → دست‌نخورده.
6. در غیر این‌صورت پیشوند قطعی افزوده می‌شود.
نرمال‌سازی صرفاً برای کلید جست‌وجو است (NFC + یکسان‌سازی ``ي/ی`` و ``ك/ک``).
از fuzzy matching، حذف حروف یا حدس جنسیت استفاده نمی‌شود.
"""
import hashlib
import json
import unicodedata
from dataclasses import dataclass, field
from pathlib import Path
from typing import Dict, Optional
# نسخهٔ الگوریتم؛ با هر تغییر در قواعد تصمیم یا نرمال‌سازی باید افزایش یابد تا
# jobهای قبلی به‌اشتباه ادامه داده نشوند.
ALGORITHM_VERSION = "1"
PREFIX_MALE = "آقای"
PREFIX_FEMALE = "خانم"
# پیشوندهایی که اگر ابتدای نام باشند، نام دست‌نخورده می‌ماند.
KNOWN_PREFIXES = frozenset({"آقا", "آقای", "خانم"})
# تنها مقادیر معتبر Gender در فایل داده. هر مقدار دیگری «نامعتبر» شمرده می‌شود.
GENDER_TO_PREFIX = {"M": PREFIX_MALE, "F": PREFIX_FEMALE}
_ARABIC_YEH = "\u064a"
_PERSIAN_YEH = "\u06cc"
_ARABIC_KAF = "\u0643"
_PERSIAN_KAF = "\u06a9"
class DatasetError(ValueError):
"""ساختار فایل داده خراب است؛ هیچ تغییری مجاز نیست."""
def normalize_name_key(value) -> str:
"""کلید جست‌وجو: NFC + حذف فاصلهٔ ابتدا/انتها + یکسان‌سازی ي/ی و ك/ک."""
if not isinstance(value, str):
return ""
text = unicodedata.normalize("NFC", value).strip()
return text.replace(_ARABIC_YEH, _PERSIAN_YEH).replace(_ARABIC_KAF, _PERSIAN_KAF)
@dataclass
class NameIndex:
"""نتیجهٔ خواندن فایل داده: index قابل‌استفاده + گزارش اعتبارسنجی."""
path: str
sha256: str
index: Dict[str, str] = field(default_factory=dict) # کلید نرمال‌شده → 'M'/'F'
ambiguous: frozenset = frozenset() # کلیدهایی که قطعی نیستند
report: Dict[str, int] = field(default_factory=dict)
def lookup(self, key: str) -> Optional[str]:
"""جنسیت قطعیِ یک کلید نرمال‌شده، یا ``None`` اگر ناشناخته/مبهم باشد."""
return self.index.get(key)
@dataclass
class Decision:
"""تصمیم برای یک نام. ``new_name`` تنها هنگام تصمیم قطعی پر می‌شود."""
new_name: Optional[str]
reason: str # male | female | single_word | has_prefix | empty | unknown_name | ambiguous_gender
def validate_dataset(doc) -> list:
"""اعتبارسنجی ساختار کلی JSON. آرایهٔ ``RECORDS`` را برمی‌گرداند.
در صورت خرابی ساختار (JSON غیر دیکشنری، نبودِ ``RECORDS`` یا لیست نبودن آن)
``DatasetError`` پرتاب می‌شود؛ در این حالت هیچ نام مشتری نباید تغییر کند.
"""
if not isinstance(doc, dict):
raise DatasetError("ریشهٔ فایل JSON یک شیء (object) نیست.")
if "RECORDS" not in doc:
raise DatasetError("کلید «RECORDS» در فایل JSON وجود ندارد.")
records = doc["RECORDS"]
if not isinstance(records, list):
raise DatasetError("مقدار «RECORDS» یک آرایه (list) نیست.")
return records
def build_name_index(records, *, path="", sha256="") -> NameIndex:
"""از آرایهٔ رکوردها، index محافظه‌کارانه و گزارش اعتبارسنجی می‌سازد.
سیاست: یک کلید نرمال‌شده تنها وقتی قابل‌استفاده است که **همهٔ** رکوردهایش
جنسیت معتبر (``M``/``F``) و یکسان داشته باشند. هر رکورد نامعتبر، جنسیت
ناشناخته، یا تناقض ``M``/``F`` ⇒ کلید کاملاً کنار گذاشته می‌شود.
"""
groups: Dict[str, Dict[str, object]] = {}
report = {
"records_total": 0,
"rejected_malformed": 0, # رکورد غیردیکشنری یا Names/Gender غیررشته‌ای
"rejected_empty_name": 0, # نام خالی پس از strip
"rejected_unknown_gender": 0, # مقدار Gender خارج از M/F
"duplicate_keys": 0,
"duplicate_same_gender": 0,
"duplicate_conflict": 0,
"usable_keys": 0,
"unusable_keys": 0,
}
for record in records:
report["records_total"] += 1
if not isinstance(record, dict):
report["rejected_malformed"] += 1
continue
names = record.get("Names")
gender = record.get("Gender")
if not isinstance(names, str) or not isinstance(gender, str):
report["rejected_malformed"] += 1
continue
key = normalize_name_key(names)
if not key:
report["rejected_empty_name"] += 1
continue
entry = groups.setdefault(key, {"gender": None, "invalid": False, "count": 0})
entry["count"] += 1
if gender in GENDER_TO_PREFIX:
if entry["gender"] is not None and entry["gender"] != gender:
entry["invalid"] = True # تناقض M/F
else:
entry["gender"] = gender
else:
entry["invalid"] = True # جنسیت ناشناخته/نامعتبر
report["rejected_unknown_gender"] += 1
index: Dict[str, str] = {}
ambiguous = set()
for key, entry in groups.items():
if entry["count"] > 1:
report["duplicate_keys"] += 1
if entry["invalid"]:
report["duplicate_conflict"] += 1
else:
report["duplicate_same_gender"] += 1
if entry["invalid"] or entry["gender"] is None:
ambiguous.add(key)
else:
index[key] = entry["gender"]
report["usable_keys"] = len(index)
report["unusable_keys"] = len(ambiguous)
return NameIndex(path=path, sha256=sha256, index=index,
ambiguous=frozenset(ambiguous), report=report)
def load_name_index(path) -> NameIndex:
"""فایل را **یک بار** می‌خواند، hash و index می‌سازد.
برای محاسبهٔ SHA-256 فایل جداگانه دوباره خوانده نمی‌شود.
"""
resolved = Path(path)
raw = resolved.read_bytes() # تنها خواندن فایل
digest = hashlib.sha256(raw).hexdigest()
try:
doc = json.loads(raw.decode("utf-8"))
except UnicodeDecodeError as exc:
raise DatasetError(f"فایل JSON با UTF-8 خوانده نشد: {exc}") from exc
except json.JSONDecodeError as exc:
raise DatasetError(f"JSON نامعتبر است: {exc}") from exc
records = validate_dataset(doc)
return build_name_index(records, path=str(resolved), sha256=digest)
def decide_prefix(raw_name, name_index: NameIndex) -> Decision:
"""تصمیم برای یک مقدار ``name_family``. هیچ‌گاه خودِ مقدار را تغییر نمی‌دهد."""
if not isinstance(raw_name, str):
return Decision(None, "empty")
stripped = raw_name.strip()
if not stripped:
return Decision(None, "empty")
tokens = stripped.split()
if tokens[0] in KNOWN_PREFIXES:
return Decision(None, "has_prefix")
if len(tokens) < 2:
return Decision(None, "single_word")
key = normalize_name_key(tokens[0])
gender = name_index.lookup(key)
if gender is None:
reason = "ambiguous_gender" if key in name_index.ambiguous else "unknown_name"
return Decision(None, reason)
prefix = GENDER_TO_PREFIX[gender]
return Decision(f"{prefix} {stripped}", "male" if gender == "M" else "female")
+44
View File
@@ -0,0 +1,44 @@
"""مانده حساب مشتری برای استفاده در قالب‌های پیامک.
تعریف (همان قاعدهٔ صفحهٔ حسابداری مشتری و گزارش مالی)::
مانده حساب = مجموع بدهکار (debit) − مجموع بستانکار (credit)
نکتهٔ مهم — تفاوت با «مانده سررسیدشده»:
* **مانده حساب** (این ماژول): تراز کل همهٔ اسناد حسابداری مشتری (``Article``).
منبع: ``admin_panel/models/finance.py::Article``.
* **مانده/مبلغ سررسیدشده**: مبلغ چک‌ها و نسیه‌های پرداخت‌نشده در جدول
``Sarresid`` (``payStatus='false'``). بسیار متفاوت از مانده حساب است و
جای دیگری (``views/finance.py``) محاسبه می‌شود.
به همین دلیل این مقدار با کلید مستقل ``{balance}`` در قالب‌ها منتشر می‌شود و
هرگز با مبلغ سررسید (``{amount}`` در پیامک چک/نسیه) قاطی نمی‌شود.
"""
import logging
logger = logging.getLogger(__name__)
def customer_balance(customer):
"""مانده حساب مشتری (``debit − credit``) به‌صورت عدد صحیح.
اگر مشتری یا اسنادش وجود نداشته باشد ``0`` برمی‌گردد. هیچ استثنایی پرتاب
نمی‌کند تا مسیر ساخت پیامک هرگز مختل نشود.
"""
if customer is None or getattr(customer, "pk", None) is None:
return 0
try:
from django.db.models import Sum
from ..models import Article
agg = Article.objects.filter(customer=customer).aggregate(
d=Sum("debit"), c=Sum("credit"),
)
debit = agg["d"] or 0
credit = agg["c"] or 0
return debit - credit
except Exception:
logger.exception("محاسبهٔ مانده حساب مشتری %s شکست خورد", customer.pk)
return 0
+10 -1
View File
@@ -5,6 +5,7 @@ from uuid import uuid4
from django.db import IntegrityError
from ..models import SMSDedup, SMSQueue, SMSTemplate, SMSType
from .balance import customer_balance
from .recipients import resolve_recipients
from .render import render_template
from .rules import is_sms_enabled
@@ -22,6 +23,11 @@ def enqueue_sms(*, customer=None, sms_type, context=None, dedup_key=None,
یا آزمایشی)، و ``SMSTemplate.auto_send`` که مدیر در صفحهٔ قالب‌ها برای هر نوع
پیامک روشن می‌کند تا پیامک‌های خودکارِ اسکنر بدون صف تأیید ارسال شوند.
متغیرهای مشترکِ همهٔ قالب‌ها (مثل ``{balance}`` = مانده حساب مشتری) همین‌جا و
یک‌بار به ``context`` افزوده می‌شوند تا هر قالبی بتواند از آن‌ها استفاده کند؛
فراخوان‌ها لازم نیست هر بار آن‌ها را بسازند. اگر فراخوان خودش مقداری داده باشد
(``context``) همان اولویت دارد.
هیچ استثنایی به فراخوان پرتاب نمی‌شود؛ خطاها فقط لاگ می‌شوند تا مسیر اصلی
(مثلاً ایجاد مشتری یا اسکنر) هرگز به‌خاطر پیامک مختل نشود.
"""
@@ -30,7 +36,10 @@ def enqueue_sms(*, customer=None, sms_type, context=None, dedup_key=None,
template = SMSTemplate.objects.filter(sms_type=sms_type, is_enabled=True).first()
if template is None:
return 0
message = render_template(template.text, context)
ctx = dict(context or {})
# متغیرهای سراسری قالب‌ها؛ هرگز مقدار فراخوان را بازنویسی نمی‌کنند.
ctx.setdefault("balance", customer_balance(customer))
message = render_template(template.text, ctx)
# «ارسال خودکار» هر نوع پیامک در صفحهٔ قالب‌ها تعیین می‌شود؛ خاموش = بازبینی مدیر.
approved = approved or template.auto_send
+4
View File
@@ -30,6 +30,10 @@ NOTICES = {
"approved": ("success", "پیامک تأیید شد و برای ارسال در صف قرار گرفت."),
"not_pending": ("warning", "این پیامک در وضعیت «در انتظار تأیید» نیست."),
"deleted": ("success", "پیامک از صف حذف شد."),
"delete_done_blocked": (
"warning",
"این پیامک ارسال شده است و از صف حذف نمی‌شود؛ سابقهٔ آن در «گزارش ارسال» می‌ماند.",
),
"bulk_approved_all": ("success", "{count} پیامک تأیید شد و برای ارسال در صف قرار گرفت."),
"bulk_approved": ("success", "{count} پیامک تأیید شد."),
"bulk_deleted": ("success", "{count} پیامک از صف حذف شد."),
+90
View File
@@ -0,0 +1,90 @@
"""محاسبهٔ «تعداد پیامکِ محاسبه‌شده» (parts) و کدگذاری متن.
هر پیامک روی شبکهٔ موبایل بر اساس **کدگذاری** و **طول** به یک یا چند «بخش» (part)
شکسته می‌شود و اپراتور بر همان تعداد بخش هزینه می‌گیرد. این ماژول همان قاعدهٔ
استاندارد (3GPP/GSM 03.38) را پیاده می‌کند تا بتوان هزینهٔ ارسال را تحلیل کرد:
* **GSM-7** — برای متن‌های انگلیسی/عددی. هر بخش ۱۶۰ کاراکتر؛ در حالت چندبخشی
(multipart) هر بخش ۱۵۳ کاراکتر (۷ کاراکتر برای هدر الحاق).
برخی کاراکترها (مثل `{}[]~\\|^€`) در جدول «الحاقی» هستند و **۲ کاراکتر** حساب
می‌شوند.
* **UCS-2** — اگر متن حتی **یک** کاراکتر خارج از جدول GSM-7 داشته باشد (فارسی،
عربی، ایموجی…)، **کل پیامک** با UCS-2 کدگذاری می‌شود: هر بخش ۷۰ کاراکتر؛ در
حالت چندبخشی هر بخش ۶۷ کاراکتر. ایموجی‌ها (خارج از BMP) دو واحد کدِ UTF-16
حساب می‌شوند.
بنابراین یک متن فارسی حتی اگر کوتاه باشد، در «۷۰ کاراکتر» جا می‌شود و ممکن است
چند پیامک حساب شود؛ و یک متن ترکیبی فارسی+انگلیسی همیشه UCS-2 است.
"""
from math import ceil
ENCODING_GSM7 = "gsm7"
ENCODING_UCS2 = "ucs2"
# جدول کامل GSM 03.38 (بخش پایه). کاراکتر 0x1B عمداً وارد نشده چون نقش «پیشوند
# الحاق» دارد و کاراکتر مستقل قانونی نیست.
GSM7_BASIC = set(
"@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ"
" !\"#¤%&'()*+,-./0123456789:;<=>?"
"¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ"
"¿abcdefghijklmnopqrstuvwxyzäöñüà"
)
# کاراکترهای «جدول الحاقی»: در GSM-7 دو واحد حساب می‌شوند.
GSM7_EXTENDED = set("^{}\\[~]|€")
# (سقف تک‌بخشی، سقف هر بخش چندبخشی) برای هر کدگذاری.
LIMITS = {
ENCODING_GSM7: (160, 153),
ENCODING_UCS2: (70, 67),
}
ENCODING_LABELS = {
ENCODING_GSM7: "GSM-7 (انگلیسی/عدد)",
ENCODING_UCS2: "UCS-2 (فارسی/یونیکد)",
}
def is_gsm7(text):
"""آیا کل متن با جدول GSM-7 قابل نمایش است؟ (شرط کافی و لازم برای GSM-7)."""
return all(ch in GSM7_BASIC or ch in GSM7_EXTENDED for ch in text or "")
def detect_encoding(text):
"""کدگذاری متن: ``gsm7`` یا ``ucs2``. متن خالی = ``gsm7``."""
return ENCODING_GSM7 if is_gsm7(text) else ENCODING_UCS2
def encoded_length(text):
"""طول متن بر حسب «واحدهایی که اپراتور می‌شمارد».
* GSM-7: کاراکترهای الحاقی ۲ واحد.
* UCS-2: واحدهای کد UTF-16 (ایموجی = ۲).
"""
text = text or ""
if is_gsm7(text):
return sum(2 if ch in GSM7_EXTENDED else 1 for ch in text)
return len(text.encode("utf-16-le")) // 2
def parts_count(text):
"""تعداد بخش‌هایی که اپراتور برای این متن حساب می‌کند (۱ برای متن خالی = ۰)."""
text = text or ""
if not text:
return 0
single, multipart = LIMITS[detect_encoding(text)]
length = encoded_length(text)
if length <= single:
return 1
return ceil(length / multipart)
def describe(text):
"""خلاصهٔ محاسبه برای نمایش در گزارش (کدگذاری، طول، تعداد بخش)."""
encoding = detect_encoding(text)
return {
"encoding": encoding,
"encoding_label": ENCODING_LABELS[encoding],
"length": encoded_length(text),
"parts": parts_count(text),
}
+15 -1
View File
@@ -3,11 +3,21 @@ from persiantools.jdatetime import JalaliDate, JalaliDateTime
class _SafeDict(dict):
"""دیکشنری که برای کلیدهای ناشناخته رشته خالی برمی‌گرداند (بدون خطا)."""
"""دیکشنری امن برای ``str.format_map``.
* کلیدِ ناشناخته ⇒ رشتهٔ خالی (بدون ``KeyError``).
* کلیدِ شناخته‌شده با مقدار ``None`` ⇒ رشتهٔ خالی. فیلدهای اختیاری مدل
(مثل ``Sarresid.check_sayyad_id`` یا ``check_row_number``) ممکن است ``NULL``
باشند؛ بدون این تبدیل، ``None`` عیناً در متن پیامک چاپ می‌شد.
"""
def __missing__(self, key):
return ""
def __getitem__(self, key):
value = super().__getitem__(key) if key in self else ""
return "" if value is None else value
def format_amount(value):
try:
@@ -35,6 +45,10 @@ def render_template(text, context=None):
ctx = dict(context or {})
if "amount" in ctx:
ctx.setdefault("amount_sep", format_amount(ctx["amount"]))
if "balance" in ctx:
# مثل «مبلغ»، نسخهٔ جداکننده‌دار هم آماده می‌شود تا در قالب‌ها
# ``{balance_sep}`` در دسترس باشد (۳٬۵۰۰٬۰۰۰ → "3,500,000").
ctx.setdefault("balance_sep", format_amount(ctx["balance"]))
if "date" in ctx:
ctx.setdefault("date_raw", ctx["date"])
ctx["date"] = format_jalali(ctx["date"])
+1 -2
View File
@@ -4,7 +4,7 @@ from ..models import CustomerSMSSetting, SMSType
def is_sms_enabled(customer, sms_type):
"""اگر رکوردی با is_enabled=False وجود داشته باشد غیرفعال است؛ در غیر این‌صورت فعال."""
if customer is None or sms_type == SMSType.CUSTOM:
if customer is None:
return True
setting = CustomerSMSSetting.objects.filter(customer=customer, sms_type=sms_type).first()
if setting is None:
@@ -21,5 +21,4 @@ def customer_toggle_map(customer):
return [
{"code": code, "label": label, "enabled": overrides.get(code, True)}
for code, label in SMSType.choices
if code != SMSType.CUSTOM
]
+114 -166
View File
@@ -9,55 +9,68 @@
در هر اجرا حداکثر ``backlog_max`` مورد قدیمی هم صف می‌شود.
* **سقف هر اجرا (``max_per_run``)**: سقف کل صف‌کردن هر اسکنر در یک اجرا.
اسکنرها فقط انواع «دوره‌ای» را پوشش می‌دهند (تأمین موجودی چک، سررسید نسیه، بازدید
دوره‌ای). انواع «رویدادی» (خوش‌آمدگویی، نظرسنجی، ثبت بازدید، تشکر از پرداخت) هنگام
وقوع رخداد توسط ویوها و از طریق ``admin_panel/sms/triggers.py`` صف می‌شوند.
هر اسکنر مستقل و مقاوم به خطاست؛ یک خطا بقیه را متوقف نمی‌کند. ``dedup_key`` از
ارسال تکراری جلوگیری می‌کند و تضمین می‌کند اجرای دوبارهٔ اسکنر رکورد جدیدی نسازد.
یادآوری‌های **دوره‌ای** (بازدید و ثبت چک) کلیدشان شامل شمارهٔ دوره است. یعنی اگر
مدیر یک مورد را از صف حذف کند، فقط همان دوره کنسل می‌شود و در دورهٔ بعد دوباره
ساخته می‌شود؛ برای همیشه خاموش نمی‌ماند.
یادآوری‌های **دوره‌ای** (بازدید) کلیدشان شامل شمارهٔ دوره است. یعنی اگر مدیر یک مورد
را از صف حذف کند، فقط همان دوره کنسل می‌شود و در دورهٔ بعد دوباره ساخته می‌شود؛ برای
همیشه خاموش نمی‌ماند.
"""
import logging
import os
from datetime import datetime, time, timedelta
from django.db.models import Q, Sum
from django.utils import timezone
from ..models import (Article, Customer, Factor, Sarresid, SMSProviderConfig,
SMSTemplate, SMSType)
from ..models import Customer, Sarresid, SMSProviderConfig, SMSTemplate, SMSType
from ..visit_policy import (as_aware, cycle_anchor_map, next_appointment_map,
visit_latest_due, visit_period)
from .enqueue import enqueue_sms
from .timing import DEFAULT_VISIT_MONTHS
logger = logging.getLogger(__name__)
# پیش‌فرض فاصلهٔ تکرار «یادآوری ثبت چک» (روز) وقتی قالبی تنظیم نشده باشد.
CHEQUE_REG_INTERVAL_DEFAULT = 3
def _template(sms_type):
return SMSTemplate.objects.filter(sms_type=sms_type, is_enabled=True).first()
def _aware(value):
"""تبدیل تاریخ/ساعت naive به aware (کد قدیمی پروژه جاهایی مقدار naive ذخیره می‌کند)."""
"""تبدیل تاریخ/ساعت naive به aware (کد قدیمی پروژه جاهایی مقدار naive ذخیره می‌کند).
در روزهای تغییر ساعت، نیمه‌شب ممکن است وجود نداشته باشد؛ آن حالت هم پوشش داده
می‌شود تا یک ``installDate`` روی مرز DST اجرای کل اسکن را نشکند.
"""
if value is None:
return None
if isinstance(value, datetime):
if timezone.is_naive(value):
try:
return timezone.make_aware(value, timezone.get_current_timezone())
except Exception:
return timezone.make_aware(
value, timezone.get_current_timezone(), is_dst=False,
)
return value
# date → آغاز همان روز
moment = datetime.combine(value, time.min)
try:
return timezone.make_aware(moment, timezone.get_current_timezone())
except Exception:
return timezone.make_aware(
datetime.combine(value, time.min), timezone.get_current_timezone(),
moment, timezone.get_current_timezone(), is_dst=False,
)
class _Budget:
"""ظرفیت صف‌کردن یک اسکنر در یک اجرا (خط شروع + سقف قدیمی + سقف کل)."""
def __init__(self, config):
def __init__(self, config, now=None):
self.since = config.scan_since
# مرجع زمانی «خط شروع»؛ برای اسکن با زمان تزریقی (تست/بازپخش) هم‌زمان می‌شود.
self.now = now
self.allow_backlog = bool(config.allow_backlog)
self.backlog_max = config.backlog_max or 0
self.max_per_run = config.max_per_run or 0
@@ -65,8 +78,21 @@ class _Budget:
self.backlog_count = 0
def is_backlog(self, trigger):
"""آیا این مورد پیش از «خط شروع» واجد شرط شده است؟
مرجع زمانی، «اکنونِ همین اجرا» است (``self.now``)؛ برای اسکن عادی همان
``timezone.now()`` و برای اسکن با زمان تزریقی همان لحظهٔ تزریق‌شده.
"""
trigger = _aware(trigger)
return self.since is not None and trigger < self.since
since = self.since
if since is not None and self.now is not None:
moment = _aware(self.now)
now_ref = timezone.now()
if moment is not None and now_ref is not None:
# پنجره با «همان لحظه‌ای» که اسکن برایش اجرا می‌شود سنجیده شود،
# وگرنه اسکنِ بازپخش/تست همیشه همه‌چیز را «قدیمی» می‌بیند.
since = since + (moment - now_ref)
return since is not None and trigger < since
def can_send(self, trigger):
if self.max_per_run and (self.new_count + self.backlog_count) >= self.max_per_run:
@@ -82,33 +108,52 @@ class _Budget:
self.new_count += 1
def scan_cheque_due(today):
template = _template(SMSType.CHEQUE_DUE)
def scan_cheque_funding(today):
"""یادآوری «تأمین موجودی چک» چند روز **پیش از** سررسید چکِ پرداخت‌نشده.
تعداد روزِ *قبل* از سررسید از قالب همین نوع (``offset_days`` در دیتابیس،
قابل ویرایش از پنل) خوانده می‌شود؛ مثلاً ``offset_days = 1`` یعنی یک روز پیش
از سررسید پیامک می‌رود تا مشتری فرصت تأمین موجودی داشته باشد.
پنجرهٔ یادآوری از «سررسید − offset روز» باز می‌شود و تا خودِ سررسید ادامه
دارد؛ پس اگر اسکنر چند روز از دست برود، یادآوری از دست نمی‌رود (چک‌هایی که
سررسیدشان رسیده هم واجد شرط می‌مانند). اگر چک پرداخت شود
(``payStatus=true``) دیگر یادآوری نمی‌گیرد؛ ``dedup_key`` نیز مانع ارسال
تکراری در اجراهای بعدی می‌شود.
"""
template = _template(SMSType.CHEQUE_REGISTRATION)
if template is None:
return 0
budget = _Budget(SMSProviderConfig.load())
offset = template.offset_days or 0
# پنجرهٔ یادآوری: از «سررسید − offset» تا «سررسید». یعنی فقط سررسیدهای
# امروز تا offset روز آینده واجد شرط‌اند و مقادیر دورتر هنوز پیامکی نمی‌گیرند.
# (سررسیدهای گذشته هم داخل شرط می‌مانند تا یک یادآوری از دست نرود.)
window_end = today + timedelta(days=max(offset, 0))
qs = Sarresid.objects.filter(
type="check", payStatus="false",
sarresidDT__date__gte=today,
sarresidDT__date__lte=today + timedelta(days=offset),
type="check", payStatus="false", sarresidDT__date__lte=window_end,
).select_related("customer").order_by("sarresidDT")
count = 0
for s in qs:
if not s.customer or not s.sarresidDT:
continue
# پنجرهٔ یادآوری از «سررسید منهای offset» باز می‌شود.
due = s.sarresidDT.date()
# لحظهٔ باز شدن پنجرهٔ یادآوری = سررسید − offset روز.
trigger = _aware(s.sarresidDT) - timedelta(days=offset)
if not budget.can_send(trigger):
continue
days = (s.sarresidDT.date() - today).days
# روزهای باقی‌مانده تا سررسید؛ اگر سررسید دورتر از پنجره باشد پیامک نمی‌رود.
days = (due - today).days
if days > offset:
continue
made = enqueue_sms(
customer=s.customer, sms_type=SMSType.CHEQUE_DUE,
customer=s.customer, sms_type=SMSType.CHEQUE_REGISTRATION,
context={
"name": s.customer.name_family, "amount": s.price,
"date": s.sarresidDT, "days": days, "check_row": s.check_row_number,
"sayyad_id": s.check_sayyad_id, "owner_name": s.check_owner_name,
},
dedup_key=f"cheque_due:{s.id}",
dedup_key=f"cheque_fund:{s.id}",
)
if made:
budget.record(trigger)
@@ -149,163 +194,66 @@ def scan_nesiye_due(today):
return count
def scan_cheque_registration(today):
"""یادآوری «ثبت اطلاعات چک» برای چک‌های پرداخت‌نشدهٔ ثبت‌نشده.
هر ``interval`` روز یک‌بار تکرار می‌شود و به‌محض اینکه شمارهٔ صیادی چک ثبت شود
(یا چک پرداخت شود) متوقف می‌گردد. دورهٔ تکرار از پنل قابل تنظیم است.
"""
template = _template(SMSType.CHEQUE_REGISTRATION)
if template is None:
return 0
budget = _Budget(SMSProviderConfig.load())
interval = template.repeat_interval_days or CHEQUE_REG_INTERVAL_DEFAULT
qs = Sarresid.objects.filter(
type="check", payStatus="false", sarresidDT__date__gte=today,
).filter(
Q(check_sayyad_id="") | Q(check_sayyad_id__isnull=True),
).select_related("customer")
count = 0
for s in qs:
if not s.customer:
continue
anchor = s.createdDT or s.sarresidDT
if not anchor:
continue
days = (today - anchor.date()).days
if days <= 0 or days % interval != 0:
continue
cycle = days // interval
# لحظهٔ باز شدن همین دورهٔ تکرار (نه خودِ چک) ملاک خط شروع است.
trigger = _aware(anchor) + timedelta(days=days)
if not budget.can_send(trigger):
continue
made = enqueue_sms(
customer=s.customer, sms_type=SMSType.CHEQUE_REGISTRATION,
context={
"name": s.customer.name_family, "amount": s.price,
"date": s.sarresidDT, "days": (s.sarresidDT.date() - today).days
if s.sarresidDT else "",
"check_row": s.check_row_number,
},
dedup_key=f"cheque_reg:{s.id}:{cycle}",
)
if made:
budget.record(trigger)
count += made
return count
def scan_debt_due(today):
"""یادآوری بدهی برای مانده‌دارها روی سررسید وصول مطالبات."""
template = _template(SMSType.DEBT_DUE)
if template is None:
return 0
budget = _Budget(SMSProviderConfig.load())
offset = template.offset_days or 0
target = today - timedelta(days=offset)
qs = Sarresid.objects.filter(
payStatus="false", sarresidDT__date=target,
).select_related("customer").order_by("sarresidDT")
count = 0
seen = set()
for s in qs:
if not s.customer or s.customer_id in seen or not s.sarresidDT:
continue
trigger = _aware(s.sarresidDT)
if not budget.can_send(trigger):
continue
totals = Article.objects.filter(customer=s.customer).aggregate(
d=Sum("debit"), c=Sum("credit"),
)
net = (totals["d"] or 0) - (totals["c"] or 0)
if net <= 0:
continue
made = enqueue_sms(
customer=s.customer, sms_type=SMSType.DEBT_DUE,
context={"name": s.customer.name_family, "amount": net},
dedup_key=f"debt_due:{s.id}",
)
if made:
seen.add(s.customer_id)
budget.record(trigger)
count += made
return count
def scan_survey(today):
"""نظرسنجی چند روز پس از ایجاد فاکتور."""
template = _template(SMSType.SURVEY)
if template is None:
return 0
budget = _Budget(SMSProviderConfig.load())
offset = template.offset_days or 3
target = today - timedelta(days=offset)
qs = Factor.objects.filter(
is_active=True, create_date__date=target,
).exclude(pay_status="cancell").select_related("customer").order_by("create_date")
count = 0
for f in qs:
if not f.customer or not f.create_date:
continue
trigger = _aware(f.create_date) + timedelta(days=offset)
if not budget.can_send(trigger):
continue
made = enqueue_sms(
customer=f.customer, sms_type=SMSType.SURVEY,
context={"name": f.customer.name_family, "amount": f.amount},
dedup_key=f"survey:{f.id}",
)
if made:
budget.record(trigger)
count += made
return count
def scan_visit(today):
def scan_visit(today, *, now=None):
"""یادآوری بازدید برای مشتریان عقب‌افتاده از بازدید (منطق صفحهٔ «انتظار»).
لحظهٔ واجد‌شرط‌شدن هر مشتری = «آخرین بازدید + دورهٔ مجاز» (یا تاریخ نصب برای
مشتریانی که هرگز بازدید نشده‌اند). اگر این لحظه پیش از خط شروع باشد، مورد قدیمی
تلقی می‌شود و فقط با اجازهٔ صریح مدیر (و در سقف تعیین‌شده) ارسال می‌گردد.
لحظهٔ واجد‌شرط‌شدن هر مشتری = «آخرین بازدید معتبر + دورهٔ مجاز» (یا تاریخ نصب
برای مشتریانی که هرگز بازدید نشده‌اند). مبنای «آخرین بازدید» و دوره، هر دو از
``admin_panel.visit_policy`` می‌آیند تا این اسکنر و صفحهٔ ``entezar`` هرگز
دو جواب متفاوت ندهند. مشتری دارای «تعویق فعال» (هماهنگی در انتظار) یادآوری
نمی‌گیرد، چون قرار بعدی از قبل با او گذاشته شده است.
``now`` برای تست/بازپخش قابل تزریق است؛ پیش‌فرض «همین حالا» است.
اگر لحظهٔ واجد‌شرط‌شدن پیش از خط شروع باشد، مورد قدیمی تلقی می‌شود و فقط با
اجازهٔ صریح مدیر (و در سقف تعیین‌شده) ارسال می‌گردد.
"""
template = _template(SMSType.VISIT)
if template is None:
return 0
budget = _Budget(SMSProviderConfig.load())
# دورهٔ بازدید: اول از قالب (قابل تنظیم از پنل)، وگرنه متغیر محیطی legacy، وگرنه پیش‌فرض.
months = template.repeat_interval_months
if not months:
try:
months = int(os.environ.get("bazdid", DEFAULT_VISIT_MONTHS))
except (TypeError, ValueError):
months = DEFAULT_VISIT_MONTHS
period = timedelta(weeks=int(months * 4.3))
period_days = max(period.days, 1)
now = timezone.now()
period = visit_period()
now = timezone.now() if now is None else as_aware(now)
budget = _Budget(SMSProviderConfig.load(), now=now)
# لنگر چرخه: آخرین «بازدید» یا «نصب» (تصمیم محصولی). تماس تلفنی چرخه را ریست نمی‌کند.
anchors = cycle_anchor_map(now=now)
# قرار بعدی (هماهنگی توافق‌شده یا بازدید برنامه‌ریزی‌شده) ⇒ یادآوری لازم نیست.
appointments = next_appointment_map(now=now)
# مرز تاریخ‌ها باید به وقت **محلی** گرفته شود؛ `.date()` روی دیتاتایم aware،
# تاریخ UTC می‌دهد که در ساعت‌های اول شب تهران یک روز عقب‌تر است و باعث می‌شد
# مشتریِ دقیقاً روی مرز، از اسکن جا بیفتد.
cutoff_date = (now - period).astimezone(timezone.get_current_timezone()).date()
qs = Customer.objects.filter(
laghv_bazdid=False,
is_active=True,
installDate__lte=(now - period).date(),
installDate__lte=cutoff_date,
).order_by("id")
count = 0
for customer in qs:
anchor = _aware(customer.last_bazdid_dt) or _aware(customer.installDate)
if customer.id in appointments:
continue # قرار بعدی ثبت شده است؛ یادآوری لازم نیست
anchor = anchors.get(customer.id) or _aware(customer.installDate)
if anchor is None:
continue
trigger = anchor + period
if trigger > now:
# «تازه‌ترین» موعدی که رسیده است (۹ ماه، ۱۸ ماه، ۲۷ ماه…).
# قاعدهٔ قبلی همیشه موعد اول را می‌سنجید و همین باعث می‌شد دوره‌های بعدی
# هرگز ساخته نشوند.
trigger = visit_latest_due(anchor, now=now)
# موعد یک «تاریخ» است نه یک لحظه؛ اگر روزِ موعد فرا رسیده باشد باید صف شود.
if trigger is None or trigger.date() > now.astimezone(
timezone.get_current_timezone()
).date():
continue # هنوز عقب‌افتاده نیست
if not budget.can_send(trigger):
continue
# چرخه = شمارهٔ دورهٔ کاملِ سپری‌شده از لنگر. کلید به چرخه گره می‌خورد تا
# حذفِ یادآوری توسط مدیر فقط همان «دوره» را کنسل کند و در دوره‌های بعدی
# دوباره ساخته شود (نه اینکه برای همیشه خاموش بماند).
cycle = max((today - anchor.date()).days // period_days, 0)
# کلید یکتاسازی = «موعد تقویمیِ» همان دوره، نه شمارش روز.
# با این قاعده هر دوره دقیقاً یک کلید دارد: ۹ ماه، ۱۸ ماه، ۲۷ ماه… .
# (قاعدهٔ قبلی — days // 274 — با موعد تقویمی هم‌تراز نبود و باعث
# گم‌شدنِ یک دوره و تکرار/پرش شمارهٔ چرخه می‌شد.)
due_month = trigger.strftime("%Y-%m")
made = enqueue_sms(
customer=customer, sms_type=SMSType.VISIT,
context={"name": customer.name_family},
dedup_key=f"visit:{customer.id}:{cycle}",
dedup_key=f"visit:{customer.id}:{due_month}",
)
if made:
budget.record(trigger)
@@ -313,12 +261,12 @@ def scan_visit(today):
return count
# فقط انواعی که «موعد» دارند و دوره‌ای اسکن می‌شوند؛ انواع رویدادی (خوش‌آمدگویی،
# نظرسنجی، ثبت بازدید، ثبت نصب، تشکر از پرداخت) در ``admin_panel/sms/triggers.py``
# توسط ویوها صف می‌شوند، نه این‌جا.
SCANNERS = [
("cheque_due", scan_cheque_due),
("cheque_registration", scan_cheque_funding),
("nesiye_due", scan_nesiye_due),
("cheque_registration", scan_cheque_registration),
("debt_due", scan_debt_due),
("survey", scan_survey),
("visit", scan_visit),
]
+29 -34
View File
@@ -9,8 +9,7 @@ from ..models import SMSType
NONE = "none"
BEFORE_DUE = "before_due"
AFTER_CREATION = "after_creation"
RECURRING = "recurring"
AFTER_DUE = "after_due"
PERIOD_MONTHS = "period_months"
# پیش‌فرض دورهٔ بازدید (ماه) وقتی مدیر مقداری در قالب نگذاشته باشد.
@@ -22,39 +21,18 @@ TIMING = {
"field": None,
"note": "به‌محض ثبت مشتری و بدون تأخیر ارسال می‌شود؛ تنظیم زمانی ندارد.",
},
SMSType.CHEQUE_DUE: {
SMSType.SURVEY: {
"kind": NONE,
"field": None,
"note": "بی‌درنگ پس از ثبت فاکتور ارسال می‌شود؛ تنظیم زمانی ندارد.",
},
SMSType.CHEQUE_REGISTRATION: {
"kind": BEFORE_DUE,
"field": "offset_days",
"label": "چند روز قبل از سررسید چک",
"default": 2,
"note": "پنجرهٔ یادآوری از «سررسید − این تعداد روز» باز می‌شود و تا سررسید ادامه دارد.",
},
SMSType.NESIYE_DUE: {
"kind": BEFORE_DUE,
"field": "offset_days",
"label": "چند روز قبل از سررسید نسیه",
"default": 2,
"note": "پنجرهٔ یادآوری از «سررسید − این تعداد روز» باز می‌شود و تا سررسید ادامه دارد.",
},
SMSType.CHEQUE_REGISTRATION: {
"kind": RECURRING,
"field": "repeat_interval_days",
"label": "هر چند روز یک‌بار",
"default": 3,
"note": "تا زمانی که اطلاعات ثبت چک (شمارهٔ صیادی) وارد نشده و چک پرداخت نشده، "
"با این فاصله تکرار می‌شود.",
},
SMSType.SURVEY: {
"kind": AFTER_CREATION,
"field": "offset_days",
"label": "چند روز بعد از صدور فاکتور",
"default": 3,
"note": "این تعداد روز پس از ثبت فاکتور ارسال می‌شود.",
},
SMSType.DEBT_DUE: {
"kind": NONE,
"field": None,
"note": "روی سررسیدِ وصول مطالبات و فقط برای مشتریانی که مانده بدهکارند ارسال می‌شود.",
"default": 1,
"note": "این تعداد روز پیش از سررسید چکِ پرداخت‌نشده، پیامک یادآوری "
"تأمین موجودی با مبلغ چک ارسال می‌شود.",
},
SMSType.VISIT: {
"kind": PERIOD_MONTHS,
@@ -63,10 +41,27 @@ TIMING = {
"default": DEFAULT_VISIT_MONTHS,
"note": "برای مشتریانی که از این مدت بازدید نشده‌اند ارسال می‌شود.",
},
SMSType.CUSTOM: {
SMSType.VISIT_CREATED: {
"kind": NONE,
"field": None,
"note": "فقط به‌صورت دستی از صفحهٔ مشتری ارسال می‌شود؛ تنظیم زمانی ندارد.",
"note": "به‌محض ثبت «اقدام از نوع بازدید» ارسال می‌شود؛ تنظیم زمانی ندارد.",
},
SMSType.INSTALL_CREATED: {
"kind": NONE,
"field": None,
"note": "به‌محض ثبت «اقدام از نوع نصب» ارسال می‌شود؛ تنظیم زمانی ندارد.",
},
SMSType.PAYMENT_THANKS: {
"kind": NONE,
"field": None,
"note": "بی‌درنگ پس از ثبت پرداخت (سند وصول/بستانکار) ارسال می‌شود؛ تنظیم زمانی ندارد.",
},
SMSType.NESIYE_DUE: {
"kind": BEFORE_DUE,
"field": "offset_days",
"label": "چند روز قبل از سررسید نسیه",
"default": 0,
"note": "پنجرهٔ یادآوری از «سررسید − این تعداد روز» باز می‌شود و تا سررسید ادامه دارد.",
},
}
+100
View File
@@ -0,0 +1,100 @@
"""تریگرهای رویدادی پیامک (لایهٔ سرویس، بدون signal).
چهار نوع پیامک «رویدادی» هستند و لحظهٔ وقوع‌شان یک اکشن پنل است، نه یک سررسید
تاریخی؛ پس به‌جای اسکنر دوره‌ای، ویوها بعد از انجام کارِ اصلی این توابع را صدا
می‌زنند:
* :func:`notify_welcome` — ایجاد مشتری.
* :func:`notify_factor_survey` — ثبت فاکتور (نظرسنجی).
* :func:`notify_visit_scheduled` — ثبت «اقدام از نوع بازدید».
* :func:`notify_install_scheduled` — ثبت «اقدام از نوع نصب».
* :func:`notify_payment_thanks` — ثبت پرداخت (سند بستانکار / وصول).
قرارداد پروژه: استفاده از signal ممنوع است؛ همه‌چیز صریح از دلِ ویو صدا زده می‌شود.
این توابع هیچ استثنایی به فراخوان پرتاب نمی‌کنند (``enqueue_sms`` خودش مقاوم است) تا
مسیر اصلی هرگز به‌خاطر پیامک مختل نشود.
"""
import logging
from ..models import SMSType
from .enqueue import enqueue_sms
logger = logging.getLogger(__name__)
# روش‌های «غیرپرداخت»: سند بستانکاری که به‌خاطر تخفیف صادر شده، پرداختِ واقعی نیست
# و نباید پیامک «تشکر از پرداخت» بگیرد.
NON_PAYMENT_METHODS = {"تخفیف"}
def notify_welcome(customer, *, created_by=None):
"""پیامک خوش‌آمدگویی در لحظهٔ ساخت مشتری."""
if customer is None or customer.pk is None:
return 0
return enqueue_sms(
customer=customer, sms_type=SMSType.WELCOME,
context={"name": customer.name_family},
dedup_key=f"welcome:{customer.pk}",
created_by=created_by,
)
def notify_factor_survey(customer, factor, *, created_by=None):
"""پیامک نظرسنجی، بی‌درنگ پس از ثبت فاکتور."""
if customer is None or factor is None or factor.pk is None:
return 0
return enqueue_sms(
customer=customer, sms_type=SMSType.SURVEY,
context={"name": customer.name_family, "amount": factor.amount},
dedup_key=f"survey:{factor.pk}",
created_by=created_by,
)
def notify_visit_scheduled(customer, action, *, created_by=None):
"""پیامک «بازدید شما برای تاریخ … ثبت شد» پس از ایجاد اقدام بازدید."""
if customer is None or action is None or action.pk is None:
return 0
return enqueue_sms(
customer=customer, sms_type=SMSType.VISIT_CREATED,
context={"name": customer.name_family, "date": action.actionDateTime},
dedup_key=f"visit_created:{action.pk}",
created_by=created_by,
)
def notify_install_scheduled(customer, action, *, created_by=None):
"""پیامک «نصب شما برای تاریخ … ثبت شد» پس از ایجاد اقدام نصب.
قرینهٔ :func:`notify_visit_scheduled` است و همان قرارداد را دارد: فقط برای
اقدام ``nasb`` صدا زده می‌شود، متن از قالب ``install_created`` می‌آید و
یکتاسازی با شناسهٔ همان رکورد اقدام انجام می‌شود (ویرایش دوباره = بدون تکرار).
"""
if customer is None or action is None or action.pk is None:
return 0
return enqueue_sms(
customer=customer, sms_type=SMSType.INSTALL_CREATED,
context={"name": customer.name_family, "date": action.actionDateTime},
dedup_key=f"install_created:{action.pk}",
created_by=created_by,
)
def notify_payment_thanks(customer, amount, *, article_id=None, method=None,
created_by=None):
"""پیامک تشکر از پرداخت؛ پس از ثبت سند پرداخت (بستانکار/وصول).
``article_id`` برای یکتاسازی استفاده می‌شود تا یک پرداخت هرگز دو پیامک نگیرد.
``method`` نحوهٔ پرداخت است؛ اگر «تخفیف» باشد (که پرداختِ واقعی نیست) هیچ پیامکی
ساخته نمی‌شود.
"""
if customer is None:
return 0
if method and str(method).strip() in NON_PAYMENT_METHODS:
return 0
dedup_key = f"payment_thanks:{article_id}" if article_id is not None else None
return enqueue_sms(
customer=customer, sms_type=SMSType.PAYMENT_THANKS,
context={"name": customer.name_family, "amount": amount},
dedup_key=dedup_key,
created_by=created_by,
)
+1
View File
@@ -130,3 +130,4 @@ input[disabled]{
text-align: center;
border-left: 1px solid #b7b7b7;
}
@@ -0,0 +1,144 @@
{% load custom_tags %}
{% comment %}
کارت پروفایل مشتری — ستون سمت راست صفحهٔ مشتری.
تک‌منبع (DRY): هم customerBase.html و هم customerBaseNew.html این را include می‌کنند
تا ساختار، استایل و اسکریپت ویرایش/شماره‌ها در همهٔ صفحات مشتری یکسان بماند.
شناسه‌های موردنیاز جاوااسکریپت:
#formcsEdit, #enEdit, #editCs, #cancelEdit, #del_customer, #showUserDT, #userDT
{% endcomment %}
<form action="{% url 'admin_panel:customerEdit' customer.id %}" id="formcsEdit" class="has-background-white brad5" method="post">
{% csrf_token %}
<div class="buttons m-0 level p-2 is-hidden-tablet">
<p class="level-item">{{ customer.name_family }}</p>
<span id="showUserDT" class="button level-item">مشاهده مشخصات</span>
</div>
<div id="userDT" class="is-hidden-mobile">
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">نام ونام خانوادگی</label>
<div class="control">
<input required disabled value="{{ customer.name_family }}" name="an_name" class="input an_name" type="text" placeholder="نام نام خانوادگی">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">آدرس</label>
<div class="control">
<input disabled name="an_address" value="{{ customer.address }}" class="input an_address" type="text" placeholder="آدرس کامل">
</div>
</div>
{% include "./_customer_phones.html" with phones_editable=1 %}
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">تاریخ نصب</label>
<div class="control">
<input disabled name="installDate" value="{{ customer.installDate | toJalali }}" id="persianDateP" class="input ss02 installDate" type="text" placeholder="مثل: 1400/06/01">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">کدشناسایی</label>
<div class="control">
<input disabled value="{{ customer.idCode }}" name="idnCode" class="input idnCode ss02" type="text" placeholder="">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">توضیحات</label>
<div class="control">
<textarea disabled name="notes" class="textarea ss02 an_notes" rows="4" placeholder="یادداشت آزاد">{{ customer.notes }}</textarea>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">لغو بازدید</label>
<div class="control">
<select name="laghv_bazdid" style="width: 100%" class="select" id="LaghvBazdid">
<option value="false" {% if not customer.laghv_bazdid %}selected{% endif %}>خیر</option>
<option value="true" {% if customer.laghv_bazdid %}selected{% endif %}>بله</option>
</select>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
{% if perms.admin_panel.DelCustomer %}
<span class="button is-danger" id="del_customer">حذف مشتری</span>
{% endif %}
<span class="button is-success" id="enEdit">ویرایش</span>
<span class="button is-light is-hidden" id="cancelEdit">انصراف</span>
<input class="button is-danger is-hidden" id="editCs" value="ثبت" type="submit">
</div>
</div>
</form>
<script>
// اسکریپت مشترک کارت پروفایل مشتری: ویرایش/انصراف، افزودن و حذف شماره،
// باز/بستن در موبایل و حذف مشتری. (یک‌بار bind می‌شود.)
(function () {
if (window.__customerInfoCardInit) { return; }
window.__customerInfoCardInit = true;
// --- ورود به حالت ویرایش ---
$(document).on('click', '#enEdit', function () {
$('#formcsEdit').find('input, textarea, select').prop('disabled', false);
$('#formcsEdit').find('.remove-phone-btn, .add-phone-btn').prop('disabled', false);
$('#enEdit').addClass('is-hidden');
$('#cancelEdit').removeClass('is-hidden');
$('#editCs').removeClass('is-hidden');
});
// --- انصراف: بارگذاری مجدد؛ تغییرات ذخیره‌نشده دور ریخته می‌شود ---
$(document).on('click', '#cancelEdit', function () {
window.location.reload();
});
// --- افزودن شماره (در حالت ویرایش) ---
$(document).on('click', '.add-phone-btn', function () {
var phoneRow = `
<div class="field has-addons mt-2 ss02">
<div class="control" style="width: 30%;">
<input name="phone_titles" class="input" type="text" placeholder="عنوان">
</div>
<div class="control is-expanded">
<input name="phones" class="input an_phone" type="text" placeholder="شمارهٔ تماس جدید">
</div>
<div class="control">
<button type="button" class="button is-danger remove-phone-btn">-</button>
</div>
</div>`;
$('#dynamic-phones-edit').append(phoneRow);
});
// --- حذف شماره (حداقل یک شماره باید بماند) ---
$(document).on('click', '.remove-phone-btn', function () {
if ($('#dynamic-phones-edit .field.has-addons').length > 1) {
$(this).closest('.field.has-addons').remove();
} else {
window.alert('حداقل یک شمارهٔ تماس باید وجود داشته باشد.');
}
});
// --- باز/بستن مشخصات در موبایل ---
$(document).on('click', '#showUserDT', function () {
var $btn = $(this);
if ($btn.text().trim() === 'مشاهده مشخصات') {
$btn.text('مخفی کردن');
$('#userDT').removeClass('is-hidden-mobile');
} else {
$btn.text('مشاهده مشخصات');
$('#userDT').addClass('is-hidden-mobile');
}
});
// --- حذف مشتری ---
$(document).on('click', '#del_customer', function () {
if (window.confirm('با حذف مشتری، تمام سوابق، فاکتورها و اطلاعات از سیستم حذف می‌شود، مطمئن هستید؟')) {
window.location.href = '/panel/customer/{{ customer.id }}/del';
}
});
})();
</script>
@@ -0,0 +1,94 @@
{% load custom_tags %}
{# ستون «شماره‌های تماس» مشتری — تک‌منبع برای همهٔ صفحاتِ ستون اطلاعات مشتری. #}
{# شماره‌ها از خودِ شیء customer استخراج می‌شوند (نه context view) تا هیچ صفحه‌ای بدون داده نماند. #}
{# با phones_editable=1 (قالب‌هایی که اسکریپت افزودن/حذف شماره دارند) دکمه‌های ویرایش هم می‌آیند. #}
{% customer_phones customer as sms_phone_entries %}
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">شماره‌های تماس</label>
<div id="dynamic-phones-edit">
{% for entry in sms_phone_entries %}
<div class="field has-addons mt-2 ss02">
<div class="control" style="width: 30%;">
<input disabled value="{{ entry.title }}" name="phone_titles" class="input" type="text" placeholder="عنوان">
</div>
<div class="control is-expanded">
<input disabled value="{{ entry.display }}" name="phones" class="input an_phone" type="text" placeholder="تلفن">
</div>
<div class="control">
<a href="tel:{{ entry.display }}" class="button is-success" title="تماس با {{ entry.display }}">
📞
</a>
</div>
{% if perms.admin_panel.ManageSMS and entry.is_mobile %}
<div class="control">
<button type="button"
class="button sms-primary-toggle {% if entry.is_primary %}is-warning{% else %}is-light{% endif %}"
data-url="{% url 'admin_panel:sms_primary_toggle' customer.id %}"
data-phone="{{ entry.raw }}"
data-primary="{% if entry.is_primary %}true{% else %}false{% endif %}"
title="{% if entry.is_primary %}برداشتن از شماره‌های اصلی پیامک{% else %}تعیین به‌عنوان شمارهٔ اصلی پیامک{% endif %}">{% if entry.is_primary %}★ اصلی{% else %}☆ اصلی{% endif %}</button>
</div>
{% endif %}
{% if phones_editable and perms.admin_panel.ViewStore %}
<div class="control">
<button type="button" disabled class="button is-danger remove-phone-btn">-</button>
</div>
{% endif %}
</div>
{% empty %}
<p class="help mt-2">شماره‌ای برای این مشتری ثبت نشده است.</p>
{% endfor %}
</div>
{% if phones_editable and perms.admin_panel.ViewStore %}
<button type="button" disabled id="add-more-phone-edit" class="button is-small is-info mt-2 w-100 add-phone-btn">
+ افزودن شماره دیگر
</button>
{% endif %}
</div>
{% if perms.admin_panel.ManageSMS %}
<script>
// تعیین شمارهٔ اصلی پیامک از همین ستون (بدون فرم تودرتو) — با درخواست async و
// بارگذاری مجدد صفحه تا وضعیت شماره‌ها و رنگ دکمه‌ها به‌درستی به‌روز شوند.
(function () {
if (window.__smsPrimaryToggleInit) { return; }
window.__smsPrimaryToggleInit = true;
function csrfToken() {
var match = document.cookie.match(/(^|;\s*)csrftoken=([^;]+)/);
return match ? decodeURIComponent(match[2]) : '';
}
document.addEventListener('click', function (event) {
var btn = event.target.closest ? event.target.closest('.sms-primary-toggle') : null;
if (!btn || btn.disabled) { return; }
event.preventDefault();
var body = new URLSearchParams();
body.append('phone', btn.getAttribute('data-phone') || '');
body.append('is_primary', btn.getAttribute('data-primary') === 'true' ? 'false' : 'true');
btn.classList.add('is-loading');
btn.disabled = true;
fetch(btn.getAttribute('data-url'), {
method: 'POST',
credentials: 'same-origin',
headers: {
'X-CSRFToken': csrfToken(),
'X-Requested-With': 'XMLHttpRequest',
'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
},
body: body.toString()
}).then(function (response) {
if (!response.ok) { throw new Error('HTTP ' + response.status); }
window.location.reload();
}).catch(function () {
btn.classList.remove('is-loading');
btn.disabled = false;
window.alert('خطا در تغییر شمارهٔ اصلی. لطفاً دوباره تلاش کنید.');
});
});
})();
</script>
{% endif %}
@@ -1,70 +0,0 @@
{% if perms.admin_panel.ManageSMS %}
<div class="box" dir="rtl">
<h2 class="title is-5">پیامک</h2>
<div class="columns is-multiline">
<div class="column is-6-desktop is-12-mobile">
<h3 class="subtitle is-6">شماره‌های اصلی (گیرنده پیامک)</h3>
{# همهٔ شماره‌ها از هر منبعی که ذخیره شده‌اند نمایش داده می‌شوند (جدول شماره‌ها یا فیلدهای قدیمی) #}
{% for entry in sms_phone_entries %}
<form method="post" action="{% url 'admin_panel:sms_primary_toggle' customer.id %}" class="field has-addons">
{% csrf_token %}
<input type="hidden" name="phone" value="{{ entry.raw }}">
<input type="hidden" name="is_primary" value="{% if entry.is_primary %}false{% else %}true{% endif %}">
<div class="control is-expanded">
<input class="input" type="text"
value="{{ entry.title }} — {{ entry.display }}{% if not entry.is_mobile %} (غیرقابل ارسال پیامک){% endif %}"
disabled>
</div>
<div class="control">
{% if entry.is_mobile %}
<button class="button {% if entry.is_primary %}is-success{% else %}is-light{% endif %}" type="submit">
{% if entry.is_primary %}اصلی ✓{% else %}تعیین به‌عنوان اصلی{% endif %}
</button>
{% else %}
<button class="button is-light" type="button" disabled>غیرموبایل</button>
{% endif %}
</div>
</form>
{% empty %}
<p class="help">شماره‌ای برای این مشتری ثبت نشده است.</p>
{% endfor %}
<p class="help">اگر شمارهٔ اصلی تعیین نشده باشد، شمارهٔ اولِ معتبر به‌صورت خودکار استفاده می‌شود.</p>
<p class="help">گیرندگان فعلی: {% for r in sms_recipients %}<span dir="ltr">{{ r }}</span>{% if not forloop.last %}، {% endif %}{% empty %}—{% endfor %}</p>
</div>
<div class="column is-6-desktop is-12-mobile">
<h3 class="subtitle is-6">فعال/غیرفعال پیامک‌ها برای این مشتری</h3>
{% for item in sms_toggles %}
<form method="post" action="{% url 'admin_panel:sms_customer_toggle' customer.id %}" class="field has-addons">
{% csrf_token %}
<input type="hidden" name="sms_type" value="{{ item.code }}">
<input type="hidden" name="is_enabled" value="{% if item.enabled %}false{% else %}true{% endif %}">
<div class="control is-expanded">
<input class="input" type="text" value="{{ item.label }}" disabled>
</div>
<div class="control">
<button class="button {% if item.enabled %}is-success{% else %}is-danger{% endif %}" type="submit">
{% if item.enabled %}فعال{% else %}غیرفعال{% endif %}
</button>
</div>
</form>
{% endfor %}
</div>
<div class="column is-12">
<h3 class="subtitle is-6">ارسال پیامک سفارشی</h3>
<form method="post" action="{% url 'admin_panel:sms_send_custom' customer.id %}">
{% csrf_token %}
<div class="field">
<div class="control">
<textarea class="textarea" name="text" rows="2" placeholder="متن پیامک... (خالی بگذارید تا متن قالب «پیام سفارشی» استفاده شود)"></textarea>
</div>
</div>
<p class="help">می‌توانید از متغیرهایی مثل {name} (نام مشتری) استفاده کنید.</p>
<button class="button is-info" type="submit">ارسال به شماره‌های اصلی</button>
</form>
</div>
</div>
</div>
{% endif %}
+10 -1
View File
@@ -120,19 +120,26 @@
{% if perms.admin_panel.ManageSMS %}
{% if perms.admin_panel.ManageSMS or perms.admin_panel.ManageSMSSettings %}
<div class="navbar-item has-dropdown is-hoverable">
<a class="navbar-link">پیامک</a>
<div class="navbar-dropdown">
{% if perms.admin_panel.ManageSMSSettings %}
<a href="{% url 'admin_panel:sms_settings' %}" style="padding-right: 10px;" class="navbar-item">
تنظیمات سامانه
</a>
<a href="{% url 'admin_panel:sms_templates' %}" style="padding-right: 10px;" class="navbar-item">
قالب‌ها
</a>
{% endif %}
{% if perms.admin_panel.ManageSMS %}
<a href="{% url 'admin_panel:sms_queue' %}" style="padding-right: 10px;" class="navbar-item">
صف ارسال
</a>
<a href="{% url 'admin_panel:sms_report' %}" style="padding-right: 10px;" class="navbar-item">
گزارش ارسال
</a>
{% endif %}
</div>
</div>
{% endif %}
@@ -232,6 +239,8 @@
{% block bodyPage %}
{% endblock %}
{# بستن <div class=""> که بالاتر باز شده بود؛ پیش‌تر بسته نمی‌شد و HTML نامعتبر می‌شد. #}
</div>
</body>
<script>
@@ -164,6 +164,8 @@
{% block bodyPage %}
{% endblock %}
{# بستن <div class=""> که بالاتر باز شده بود (همان باگ base.html). #}
</div>
</body>
<script>
@@ -4,7 +4,7 @@
{% block BodyCustomer1 %}
{% include 'admin_panel/customerActionInc.html' %}
{% include 'admin_panel/customerActionInc.html' with show_delete=True %}
<!--
<div id="action" class="column is-12-mobile is-12-desktop ">
@@ -62,9 +62,12 @@
{% endif %}
{% for action in actions %}
<div customer_id='{{ action.customer.id }}' action_id='{{ action.id }}' class="columns is-mobile is-multiline is-gapless actionBox {{ bgBox }}">
<div customer_id='{{ action.customer.id }}' action_id='{{ action.id }}'
customer_hold='{% if action.customer.visit_hold_until %}{{ action.customer.visit_hold_until|date:"c" }}{% endif %}'
class="columns is-mobile is-multiline is-gapless actionBox {{ bgBox }}">
<div class="column is-12-mobile is-12-desktop actionBoxDesc actionBoxOpenB">
<div class="pr-4 pl-4 pb-4 pt-4">
<div class="pr-4 pl-4 pb-4 pt-4 ax-cardrow">
<span class="ax-cardrow-main">
{% ifequal action.status 'finish' %}
<img class="" style="width: 20px; height: 20px;" src="{% static 'admin_panel/icons/check.png' %}">
{% endifequal %}
@@ -79,6 +82,27 @@
<span class="is-bazdid">{% ifequal action.actionType 'nasb' %}نصب{% endifequal %}{% ifequal action.actionType 'bazdid' %}بازدید{% endifequal %}{% ifequal action.actionType 'vosol' %}وصول مطالبات{% endifequal %}{% ifequal action.actionType 'hamahangi' %}هماهنگی{% endifequal %}{% ifequal action.actionType 'inCall' %}تماس ورودی{% endifequal %}{% ifequal action.actionType 'outCall' %}تماس خروجی{% endifequal %}</span>
<span class="pr-3">{{ action.desc }}</span>
</span>
{% if show_delete %}
{% if action.nazarDT %}
<span class="ax-del is-locked" title="این اقدام دارای نظرسنجی ثبت‌شده است و قابل حذف نیست">
<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 1a5 5 0 0 0-5 5v3H6a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-9a2 2 0 0 0-2-2h-1V6a5 5 0 0 0-5-5zm-3 8V6a3 3 0 0 1 6 0v3H9z"/></svg>
<span class="ax-del-text">نظرسنجی</span>
</span>
{% else %}
<form method="post" class="ax-del-form"
action="{% url 'admin_panel:customerActionDelete' action.customer.id action.id %}">
{% csrf_token %}
<button type="submit" class="ax-del is-danger"
title="حذف این اقدام"
data-type="{% ifequal action.actionType 'nasb' %}نصب{% endifequal %}{% ifequal action.actionType 'bazdid' %}بازدید{% endifequal %}{% ifequal action.actionType 'vosol' %}وصول مطالبات{% endifequal %}{% ifequal action.actionType 'hamahangi' %}هماهنگی{% endifequal %}{% ifequal action.actionType 'inCall' %}تماس ورودی{% endifequal %}{% ifequal action.actionType 'outCall' %}تماس خروجی{% endifequal %}"
onclick="return confirm('این «' + (this.dataset.type || 'اقدام') + '» حذف شود؟\n\nاقدام از فهرست انتظار/وظایف خارج می‌شود و پیامک ارسال‌نشدهٔ مرتبط لغو می‌گردد. سابقه برای حسابرسی باقی می‌ماند.');">
<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M9 3h6l1 2h4v2H4V5h4l1-2zm-3 6h12l-1 12a2 2 0 0 1-2 2H9a2 2 0 0 1-2-2L6 9zm4 3v8h2v-8h-2zm4 0v8h2v-8h-2z"/></svg>
<span class="ax-del-text">حذف</span>
</button>
</form>
{% endif %}
{% endif %}
</div>
</div>
<div class="column is-12-mobile is-12-desktop actionBoxOpenB">
@@ -113,7 +137,9 @@
<p style="text-align: center; margin-bottom: 20px; color: #d90000; font-size: 18px;"> کارهای مانده از روزهای قبل</p>
{% for action in actionPr %}
<div customer_id='{{ action.customer.id }}' action_id='{{ action.id }}' class="columns is-mobile is-multiline is-gapless actionBox {{ bgBox }}">
<div customer_id='{{ action.customer.id }}' action_id='{{ action.id }}'
customer_hold='{% if action.customer.visit_hold_until %}{{ action.customer.visit_hold_until|date:"c" }}{% endif %}'
class="columns is-mobile is-multiline is-gapless actionBox {{ bgBox }}">
<div class="column is-12-mobile is-12-desktop actionBoxDesc actionBoxOpenB">
<div class="pr-4 pl-4 pb-4 pt-4">
{% ifequal action.status 'finish' %}
@@ -161,27 +187,222 @@
</div>
<style>
/* ===== دکمهٔ «حذف» روی کارت اقدام (mobile first) ===== */
.ax-cardrow {
display: flex; align-items: flex-start; justify-content: space-between;
gap: .5rem; flex-wrap: nowrap;
}
.ax-cardrow-main { flex: 1 1 auto; min-width: 0; }
.ax-del-form { margin: 0; flex: 0 0 auto; }
.ax-del {
display: inline-flex; align-items: center; gap: .25rem;
padding: .2rem .45rem; border-radius: .375rem; border: 1px solid #e5e7eb;
background: #fff; color: #6b7280; font-size: .68rem; font-weight: 700;
cursor: pointer; line-height: 1.5; white-space: nowrap;
transition: background-color .15s ease, border-color .15s ease,
color .15s ease, box-shadow .15s ease;
}
.ax-del svg { width: 13px; height: 13px; fill: currentColor; flex: 0 0 auto; }
.ax-del:hover { background: #fef2f2; border-color: #fecaca; color: #b91c1c; }
.ax-del:focus-visible {
outline: 2px solid #fca5a5; outline-offset: 1px;
}
.ax-del.is-danger { border-color: #fee2e2; color: #dc2626; background: #fff; }
.ax-del.is-danger:hover {
background: #dc2626; border-color: #dc2626; color: #fff;
box-shadow: 0 1px 6px rgba(220, 38, 38, .25);
}
/* «نظرسنجی دارد» ⇒ دکمه غیرفعال (قاعدهٔ محصولی) */
.ax-del.is-locked {
cursor: not-allowed; color: #9ca3af; background: #f9fafb;
border-color: #e5e7eb;
}
.ax-del.is-locked:hover { background: #f9fafb; border-color: #e5e7eb; color: #9ca3af; }
@media (max-width: 480px) {
.ax-del-text { display: none; } /* در موبایل فقط آیکون، برای صرفه‌جویی فضا */
.ax-del { padding: .25rem; }
}
/* ===== مودال «ایجاد/ویرایش وظیفه» — mobile first =====
همهٔ کلاس‌ها با پیشوند ax- هستند تا با سایر بخش‌ها تداخل نکنند. */
#ActionBox .ax-card {
width: calc(100% - 1rem); max-width: 44rem;
max-height: calc(100vh - 1rem); display: flex; flex-direction: column;
border-radius: .75rem; overflow: hidden;
}
#ActionBox .ax-head {
display: flex; align-items: center; justify-content: space-between;
gap: .5rem; padding: .75rem 1rem; flex: 0 0 auto;
background: #f8fafc; border-bottom: 1px solid #e5e7eb;
}
#ActionBox .ax-title { font-size: .95rem; font-weight: 800; color: #0f172a; margin: 0; }
#ActionBox .ax-sub { font-size: .75rem; color: #64748b; margin: .1rem 0 0; }
#ActionBox .ax-body {
padding: .75rem 1rem; overflow-y: auto; -webkit-overflow-scrolling: touch;
flex: 1 1 auto;
}
#ActionBox .ax-foot {
display: flex; gap: .5rem; justify-content: flex-start;
padding: .6rem 1rem; flex: 0 0 auto;
background: #f8fafc; border-top: 1px solid #e5e7eb;
}
#ActionBox .ax-foot .button { margin: 0 !important; min-height: 2.6rem; flex: 1 1 0; }
@media (min-width: 768px) {
#ActionBox .ax-foot { justify-content: flex-start; }
#ActionBox .ax-foot .button { flex: 0 0 auto; min-width: 7rem; }
}
/* بخش‌ها */
#ActionBox .ax-section { padding: .6rem 0; border-bottom: 1px dashed #eef2f6; }
#ActionBox .ax-section:last-of-type { border-bottom: 0; }
#ActionBox .ax-legend {
display: flex; align-items: center; gap: .4rem;
font-size: .78rem; font-weight: 800; color: #0e7490; margin: 0 0 .5rem;
}
#ActionBox .ax-step {
display: inline-flex; align-items: center; justify-content: center;
width: 1.35rem; height: 1.35rem; border-radius: 999px;
background: #33b5d3; color: #fff; font-size: .7rem; font-weight: 800;
}
/* شبکهٔ فیلدها: موبایل تک‌ستونه، دسکتاپ دوستونه */
#ActionBox .ax-grid { display: grid; grid-template-columns: 1fr; gap: .6rem; }
@media (min-width: 768px) {
#ActionBox .ax-grid { grid-template-columns: 1fr 1fr; }
#ActionBox .ax-span-2 { grid-column: 1 / -1; }
}
#ActionBox .ax-label {
font-size: .74rem !important; font-weight: 700; color: #475569; margin-bottom: .25rem;
}
#ActionBox .ax-help {
font-size: .7rem; color: #94a3b8; margin-top: .2rem; line-height: 1.5;
}
/* هدف لمسی بزرگ‌تر روی موبایل */
#ActionBox .input, #ActionBox .select select, #ActionBox .textarea {
font-size: .85rem;
}
@media (max-width: 767px) {
#ActionBox .input, #ActionBox .select select { min-height: 2.6rem; }
#ActionBox .textarea { min-height: 4.5rem; }
}
#ActionBox .select, #ActionBox .select select { width: 100%; }
/* ردیف تیک «انجام شده» */
#ActionBox .ax-check {
display: flex; align-items: center; gap: .5rem;
padding: .55rem .7rem; border: 1px solid #e5e7eb; border-radius: .5rem;
background: #fff; cursor: pointer; margin: 0;
}
#ActionBox .ax-check input { width: 1.05rem; height: 1.05rem; }
/* هشدار «آیا هماهنگی را انجام دادی؟» — فقط برای هماهنگیِ تیک‌خورده */
#ActionBox .ax-warn {
margin-top: .5rem; padding: .6rem .7rem;
border: 1px solid #fcd34d; border-radius: .5rem; background: #fffbeb;
color: #92400e; font-size: .78rem; line-height: 1.75;
}
#ActionBox .ax-warn .ax-warn-q { font-weight: 800; color: #78350f; margin: 0 0 .15rem; }
#ActionBox .ax-warn .ax-warn-hint { margin: 0; }
#ActionBox .ax-warn .ax-warn-actions {
display: none; gap: .4rem; margin-top: .55rem; flex-wrap: wrap;
}
#ActionBox .ax-warn .ax-warn-actions .button { margin: 0 !important; flex: 1 1 auto; }
@media (min-width: 768px) {
#ActionBox .ax-warn .ax-warn-actions .button { flex: 0 0 auto; }
}
/* وقتی ارسال متوقف شده تا کاربر تأیید کند */
#ActionBox .ax-warn.is-confirming {
border-color: #f59e0b; box-shadow: 0 0 0 3px #fde68a66; background: #fef3c7;
}
#ActionBox .ax-warn.is-confirming .ax-warn-actions { display: flex; }
#ActionBox .ax-warn:focus { outline: 2px solid #f59e0b; outline-offset: 2px; }
/* اعلان «تاریخ قرار عقب‌تر» — کلاس مستقل تا به CSS پنل «انجام شد» وابسته نباشد */
#ActionBox .ax-holdback {
margin-top: .5rem; padding: .6rem .7rem;
border: 1px solid #fcd34d; border-radius: .5rem; background: #fffbeb;
color: #92400e; font-size: .78rem; line-height: 1.75;
}
#ActionBox .ax-holdback.is-blocking {
border-color: #f59e0b; box-shadow: 0 0 0 3px #fde68a66; background: #fef3c7;
}
#ActionBox .ax-holdback .ax-hb-title { font-weight: 800; color: #78350f; margin: 0 0 .15rem; }
#ActionBox .ax-holdback .ax-hb-current { margin: 0 0 .4rem; }
#ActionBox .ax-holdback .ax-hb-current b { font-weight: 800; }
#ActionBox .ax-holdback .ax-hb-alt { margin: 0; }
#ActionBox .ax-holdback .ax-hb-check {
display: flex; align-items: flex-start; gap: .5rem; margin: 0;
padding: .5rem .6rem; border-radius: .45rem; background: #fff;
border: 1px solid #fbbf24; cursor: pointer; font-weight: 700; color: #7c2d12;
}
#ActionBox .ax-holdback .ax-hb-check input {
width: 1.05rem; height: 1.05rem; margin-top: .15rem; flex: 0 0 auto;
}
#ActionBox .ax-holdback:focus { outline: 2px solid #f59e0b; outline-offset: 2px; }
#ActionBox .ax-help-toggle {
display: flex; align-items: center; gap: .45rem; width: 100%;
padding: .55rem .7rem; border: 1px solid #bae6fd; border-radius: .5rem;
background: #f0f9ff; color: #0369a1; font-size: .78rem; font-weight: 700;
cursor: pointer; text-align: right; line-height: 1.4;
}
#ActionBox .ax-help-toggle:hover { background: #e0f2fe; }
#ActionBox .ax-help-toggle .ax-ico {
display: inline-flex; align-items: center; justify-content: center;
width: 1.25rem; height: 1.25rem; border-radius: 999px; flex: 0 0 auto;
background: #0284c7; color: #fff; font-size: .72rem; font-weight: 800;
}
#ActionBox .ax-help-toggle .ax-chev {
margin-inline-start: auto; transition: transform .15s ease; font-size: .8rem;
}
#ActionBox .ax-help-toggle[aria-expanded="true"] .ax-chev { transform: rotate(180deg); }
#ActionBox .ax-help-panel {
margin-top: .4rem; padding: .7rem .8rem; border: 1px solid #e0f2fe;
border-radius: .5rem; background: #fbfeff; font-size: .76rem; color: #334155;
line-height: 1.85;
}
#ActionBox .ax-help-panel h4 {
font-size: .78rem; font-weight: 800; color: #0f172a; margin: .6rem 0 .25rem;
}
#ActionBox .ax-help-panel h4:first-child { margin-top: 0; }
#ActionBox .ax-help-panel ul { margin: 0; padding-inline-start: 1.1rem; }
#ActionBox .ax-help-panel li { margin-bottom: .2rem; }
#ActionBox .ax-help-panel .ax-eg {
display: block; margin-top: .35rem; padding: .5rem .6rem;
background: #fff; border: 1px dashed #bae6fd; border-radius: .4rem;
}
</style>
{% if customer %}
<form id="ActionBox" class="modal" method="post" action="{% url 'admin_panel:customerNewAction' customer.id %}">
<form id="ActionBox" class="modal" method="post" action="{% url 'admin_panel:customerNewAction' customer.id %}"
data-customer-hold="{% if customer.visit_hold_until %}{{ customer.visit_hold_until|date:'c' }}{% endif %}">
{% else %}
<form id="ActionBox" class="modal" method="post" action="">
{% endif %}
{% csrf_token %}
{# تأیید صریح کاربر برای عقب‌بردن تاریخ قرار؛ فقط با زدن دکمهٔ تأیید پر می‌شود. #}
<input type="hidden" name="force_hold" id="forceHold" value="">
<div class="modal-background closeActionBox"></div>
<div class="modal-card">
<header class="modal-card-head">
<p class="modal-card-title is-hidden">ایجاد وظیفه</p>
<button type="button" class="delete closeActionBox" aria-label="close"></button>
<div class="modal-card ax-card">
<header class="modal-card-head ax-head">
<div>
<p class="ax-title">ایجاد وظیفه</p>
{% if customer %}<p class="ax-sub">{{ customer.name_family }}</p>{% endif %}
</div>
<button type="button" class="delete closeActionBox" aria-label="بستن"></button>
</header>
<section class="modal-card-body">
<section class="modal-card-body ax-body">
<div class="columns is-mobile is-multiline">
<div class="field column is-6-desktop is-12-mobile m-0">
<label class="label">نوع اقدام</label>
<div class="control">
<div class="select" style="width: 100%;">
<select id="actionType" required name="actionType" style="width: 100%;">
{# ---------- گام ۱: نوع اقدام و مسئول ---------- #}
<div class="ax-section">
<p class="ax-legend"><span class="ax-step">۱</span> نوع اقدام و مسئول</p>
<div class="ax-grid">
<div class="ax-field">
<label class="label ax-label" for="actionType">نوع اقدام</label>
<div class="select">
<select id="actionType" required name="actionType">
<option value="">انتخاب کنید</option>
<option value="bazdid">بازدید</option>
<option value="nasb">نصب</option>
@@ -192,29 +413,11 @@
</select>
</div>
</div>
</div>
<div class="field column is-6-desktop is-12-mobile m-0">
<label class="label">تاریخ و ساعتی که کار باید انجام شود</label>
<div class="control">
<input type="text" class="input dateTimePickerAnjam">
<input id="dateTimeAnjam" name="dateTimeAnjam" required type="text" class="input is-hidden dateTimePickerAnjam-alt">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<div class="control">
<label class="label mb-0">توضیحات برای یادآوری حین انجام کار:</label>
<p class="is-size-7">راجب کاری که در آینده میخواهید انجام دهید توضیحاتی را بنویسید</p>
<textarea id="desc" required name="desc" class="textarea" placeholder="مثلا: بامشتری تماس بگیرم برای هماهنگی تعویض فیلتر دستگاه"></textarea>
</div>
</div>
<div class="field column is-6-desktop is-12-mobile m-0">
<label class="label">توسط</label>
<div class="control">
<div class="select" style="width: 100%;">
<select id="userID" required name="userID" style="width: 100%;">
<div class="ax-field">
<label class="label ax-label" for="userID">توسط</label>
<div class="select">
<select id="userID" required name="userID">
<option value="">انتخاب کنید</option>
{% if perms.admin_panel.ViewStore %}
{% for auser in allUsers %}
@@ -228,47 +431,199 @@
</div>
</div>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<div class="control">
<label class="checkbox">
<input name="is_done" id="checkIsDone" type="checkbox">
این کار انجام شده
{# ---------- گام ۲: زمان‌بندی ---------- #}
<div class="ax-section">
<p class="ax-legend"><span class="ax-step">۲</span> زمان‌بندی</p>
<div class="ax-grid">
<div class="ax-field">
<label class="label ax-label">تاریخ و ساعتی که کار باید انجام شود</label>
<input type="text" class="input dateTimePickerAnjam" autocomplete="off">
<input id="dateTimeAnjam" name="dateTimeAnjam" required type="text" class="input is-hidden dateTimePickerAnjam-alt">
<p class="ax-help">تاریخ انجام این وظیفه (ثبت در «لیست وظایف» همان روز).</p>
</div>
{# فیلد «تا تاریخ پیگیری نشود» فقط برای «هماهنگی» #}
<div class="ax-field showWhenCoordination is-hidden">
<label class="label ax-label">تا تاریخ پیگیری نشود</label>
<input type="text" class="input dateTimePickerHoldUntil" autocomplete="off">
<input name="visitHoldUntil" id="visitHoldUntil" type="text" class="input is-hidden dateTimePickerHoldUntil-alt">
<p class="ax-help">تا پایان این روز، مشتری در «انتظار بازدید» دیده نمی‌شود. خالی = ۱۴ روز.</p>
</div>
</div>
{# اعلان «تاریخ عقب‌تر» — عرض کامل، بیرون از شبکهٔ دوستونه #}
<div class="ax-holdback is-hidden" id="holdBackwardNotice" tabindex="-1"
role="alert" aria-live="polite">
<p class="ax-hb-title">این تاریخ از قرار فعلی عقب‌تر است</p>
<p class="ax-hb-current">قرار فعلی: <b id="hbCurrent">—</b></p>
<label class="ax-hb-check is-hidden" id="hbForceRow" for="forceHoldCheck">
<input type="checkbox" id="forceHoldCheck">
<span>تاریخ قرار را عقب ببر</span>
</label>
<p class="ax-hb-alt is-hidden" id="hbCreateHint">
این تاریخ ذخیره نمی‌شود. برای تغییر قرار، وظیفهٔ هماهنگی فعلی را ویرایش کنید.
</p>
</div>
{# راهنمای بازشونده — فقط برای هماهنگی #}
<div class="ax-help-wrap showWhenCoordination is-hidden" style="margin-top: .6rem;">
<button type="button" class="ax-help-toggle" id="holdHelpToggle"
aria-expanded="false" aria-controls="holdHelpPanel">
<span class="ax-ico" aria-hidden="true">!</span>
<span>راهنمای «هماهنگی» و «تا تاریخ پیگیری نشود»</span>
<span class="ax-chev" aria-hidden="true">▾</span>
</button>
<div class="ax-help-panel is-hidden" id="holdHelpPanel">
<h4>این تاریخ چه کاری می‌کند؟</h4>
<p>می‌گوید «تا این تاریخ با این مشتری تماس نگیرید». در این بازه، مشتری از فهرست
<span class="has-text-weight-bold">انتظار بازدید</span> پنهان می‌شود و روز بعد از آن
تاریخ <span class="has-text-weight-bold">خودکار</span> برمی‌گردد. تاریخ تا
<span class="has-text-weight-bold">پایان همان روز</span> معتبر است.</p>
<h4>مثال</h4>
<div class="ax-eg">
امروز ۱ آذر است. مشتری می‌گوید «سه هفتهٔ دیگر زنگ بزنید».<br>
نوع = <b>هماهنگی</b> ← تیک «این کار انجام شده» ← «تا تاریخ پیگیری نشود» = <b>۲۲ آذر</b>.<br>
نتیجه: از ۱ تا ۲۲ آذر مشتری در فهرست نیست؛ از ۲۳ آذر خودکار برمی‌گردد.
</div>
<h4>نکات مهم</h4>
<ul>
<li><b>خالی + تیک</b> ← سیستم خودش ۱۴ روز می‌گذارد.</li>
<li><b>خالی + بدون تیک</b> ← هیچ تعویقی ثبت نمی‌شود؛ مشتری در فهرست می‌ماند.</li>
<li><b>فقط تمدید می‌کند، کوتاه نمی‌کند:</b> اگر قرار ۲۲ آذر باشد و همکار دیگری ۳۰ آذر بگذارد،
قرار به ۳۰ آذر می‌رود؛ تاریخ‌های عقب‌تر نادیده گرفته می‌شوند تا قرارِ دورتر از بین نرود.
اگر خودتان می‌خواهید قرار را عقب ببرید، وظیفه را <b>ویرایش</b> کنید و
گزینهٔ <b>«تاریخ قرار را عقب ببر»</b> را تیک بزنید
(در «ایجاد وظیفهٔ تازه» این گزینه وجود ندارد).</li>
<li><b>حذف یا لغو هماهنگی</b> ← قرار بی‌اثر می‌شود و مشتری بلافاصله برمی‌گردد.</li>
<li><b>سقف ۶ ماه</b> است؛ بیشتر از آن با پیام خطا رد می‌شود.</li>
<li>این فیلد <b>تاریخ بازدید پرسنل نیست</b> و <b>بازدید حساب نمی‌شود</b>؛
تاریخ آخرین بازدید و دورهٔ ۹ ماههٔ پیامک دست نمی‌خورد.
برای اعزام پرسنل از اقدام نوع <b>بازدید</b> استفاده کنید.</li>
<li>در مدت تعویق، <b>پیامک یادآوری ۹ ماههٔ بازدید</b> ارسال نمی‌شود.</li>
</ul>
</div>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0 showWhenDone is-hidden">
<label class="label">تاریخ و ساعت اتمام کار</label>
<div class="control">
<input id="FinishDateTime" type="text" class="input dateTimePickerFinish">
{# ---------- گام ۳: توضیحات ---------- #}
<div class="ax-section">
<p class="ax-legend"><span class="ax-step">۳</span> توضیحات و وضعیت</p>
<div class="ax-grid">
<div class="ax-field ax-span-2">
<label class="label ax-label" for="desc">توضیحات برای یادآوری حین انجام کار</label>
<textarea id="desc" required name="desc" class="textarea"
placeholder="مثلا: با مشتری تماس بگیرم برای هماهنگی تعویض فیلتر دستگاه"></textarea>
</div>
<div class="ax-field ax-span-2">
<label class="ax-check">
<input name="is_done" id="checkIsDone" type="checkbox">
<span>این کار انجام شده است</span>
</label>
{# هشدار/تأیید: فقط برای «هماهنگی» با تیکِ «انجام شده» #}
<div class="ax-warn is-hidden" id="holdDoneWarning" tabindex="-1"
role="alert" aria-live="polite">
<p class="ax-warn-q">آیا مطمئن هستی که هماهنگی را انجام دادی؟</p>
<p class="ax-warn-hint">اگر هنوز هماهنگی نکردی، این تیک را بردار.</p>
<div class="ax-warn-actions">
<button type="button" id="holdConfirmYes" class="button is-warning is-small">
بله، هماهنگی انجام شد
</button>
<button type="button" id="holdConfirmNo" class="button is-light is-small">
نه، تیک را بردار
</button>
</div>
</div>
</div>
<div class="ax-field showWhenDone is-hidden">
<label class="label ax-label" for="FinishDateTime">تاریخ و ساعت اتمام کار</label>
<input id="FinishDateTime" type="text" class="input dateTimePickerFinish" autocomplete="off">
<input name="FinishDateTime" type="text" class="input dateTimePickerFinish-alt is-hidden">
<p class="ax-help">خالی بماند، زمان ثبت در نظر گرفته می‌شود.</p>
</div>
<div class="ax-field showWhenDone is-hidden">
<label class="label ax-label" for="actionResult">نتیجه</label>
<textarea name="result" id="actionResult" class="textarea"
placeholder="نتیجهٔ کار یا پیگیری انجام‌شده را بنویسید"></textarea>
</div>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0 showWhenDone is-hidden">
<div class="control">
<label class="label mb-0">نتیجه</label>
<p class="is-size-7">نتیجه کار یا پیگیری که انجام داده اید را بنویسید</p>
<textarea name="result" id="actionResult" class="textarea" placeholder="نتیجه فعالیت انجام شده را بنویسید"></textarea>
</div>
</div>
</div>
</section>
<footer class="modal-card-foot">
<button type="button" class="button closeActionBox">لغو</button>
<footer class="modal-card-foot ax-foot">
<button type="button" class="button closeActionBox">انصراف</button>
<input id="sabtBtn05" type="submit" class="button is-success" value="ثبت"/>
</footer>
</div>
</form>
<script>
// وضعیت مودال:
// isEditMode ⇒ در حال ویرایش یک اقدام موجود (نه ایجاد)
// holdAutoChecked ⇒ تیک «انجام شده» را خودِ سیستم برای هماهنگی زده است
// holdConfirmed ⇒ کاربر تأیید کرده که هماهنگی انجام شده است
var isEditMode = false;
var holdAutoChecked = false;
var holdConfirmed = false;
// لایهٔ دوم محافظت: فرم «حذف» داخل کارتِ قابل‌کلیک است؛ رویداد را همان‌جا
// متوقف می‌کنیم تا به هندلرِ بازکردن مودالِ ویرایش نرسد.
// بایند «مستقیم» (نه delegated) چون این بلوک با هر ردیف تکرار می‌شود؛
// نام‌فضا (axdel) + off مانع از انباشته‌شدن هندلرها روی ردیف‌های تکراری می‌شود.
$('.ax-del-form, .ax-del')
.off('.axdel')
.on('click.axdel mousedown.axdel', function (e) {
e.stopPropagation();
});
// پیکر «تا تاریخ پیگیری نشود» را ریست می‌کند.
// نکته: pDatepicker یک Model برمی‌گرداند؛ اگر سلکتور هیچ المانی پیدا نکند
// مقدار undefined می‌شود. بدون این محافظ، یک ناهم‌خوانی نام کلاس باعث
// TypeError می‌شد و بقیهٔ منطقِ هندلر (پنهان‌کردن فیلدها، برداشتن تیک خودکار)
// اجرا نمی‌شد.
// پرکردن پیکر «تا تاریخ پیگیری نشود» از مقدار ذخیره‌شدهٔ مشتری.
// بدون این، هنگام بازکردن مجدد یک اقدام، فیلد همیشه خالی دیده می‌شد
// (مقدار در دیتابیس بود ولی مودال آن را بارگذاری نمی‌کرد).
function seedHoldPicker(isoValue) {
var box = $("#visitHoldUntil");
if (!isoValue) {
resetHoldPicker();
return;
}
var ms = new Date(isoValue).getTime();
if (isNaN(ms)) {
resetHoldPicker();
return;
}
if (dateTimePickerHoldUntil && typeof dateTimePickerHoldUntil.setDate === 'function') {
dateTimePickerHoldUntil.setDate(ms);
}
box.val(String(ms));
}
function resetHoldPicker() {
if (dateTimePickerHoldUntil && typeof dateTimePickerHoldUntil.setDate === 'function') {
dateTimePickerHoldUntil.setDate();
}
$("#visitHoldUntil").val('');
}
$(".closeActionBox").click(function(){
$("#ActionBox").removeClass("is-active");
});
$("#showActionBox").click(function(){
isEditMode = false;
holdAutoChecked = false;
holdConfirmed = false;
$("#holdDoneWarning").addClass("is-hidden").removeClass("is-confirming");
$("#ActionBox").addClass("is-active");
{% if customer %}
var NewActionUrl = "{% url 'admin_panel:customerNewAction' customer.id %}";
@@ -282,22 +637,190 @@
$("#actionResult").val('');
dateTimePickerAnjam.setDate();
dateTimePickerFinish.setDate();
resetHoldPicker();
syncHoldBackward();
$(".showWhenCoordination").addClass("is-hidden");
closeHoldHelp();
$("#sabtBtn05").val("ثبت");
});
$("#checkIsDone").change(function() {
if(this.checked) {
$(".showWhenDone").removeClass("is-hidden");
} else {
$(".showWhenDone").addClass("is-hidden");
// نمایش/پنهان‌کردن فیلدهای «انجام شده».
function syncDoneFields() {
$(".showWhenDone").toggleClass("is-hidden", !$("#checkIsDone").prop("checked"));
}
// هشدار «آیا هماهنگی را انجام دادی؟» فقط برای هماهنگیِ تیک‌خورده نمایش داده می‌شود.
function syncHoldWarning() {
var active = ($("#actionType").val() === 'hamahangi') && $("#checkIsDone").prop("checked");
$("#holdDoneWarning").toggleClass("is-hidden", !active);
if (!active) {
$("#holdDoneWarning").removeClass("is-confirming");
holdConfirmed = false;
}
}
$("#checkIsDone").change(function() {
// تغییر دستی کاربر ⇒ دیگر «تیک خودکار» نیست.
holdAutoChecked = false;
holdConfirmed = false;
syncDoneFields();
syncHoldWarning();
});
$(".actionBoxOpenB").click(function(){
// تأیید یا ردِ هشدار در لحظهٔ ثبت
function showHoldConfirm() {
var box = $("#holdDoneWarning");
box.removeClass("is-hidden").addClass("is-confirming");
if (box[0].scrollIntoView) {
box[0].scrollIntoView({ block: 'center', behavior: 'smooth' });
}
box.trigger('focus');
}
$("#holdConfirmYes").click(function() {
holdConfirmed = true;
// submit مستقیم روی المان فرم؛ اعتبارسنجی HTML5 در تلاش اول انجام شده است.
$("#ActionBox")[0].submit();
});
$("#holdConfirmNo").click(function() {
holdConfirmed = false;
holdAutoChecked = false;
$("#checkIsDone").prop("checked", false);
$("#holdDoneWarning").addClass("is-hidden").removeClass("is-confirming");
syncDoneFields();
$("#checkIsDone").trigger('focus');
});
// ══════════ عقب‌بردن تاریخ قرار ══════════
// قاعدهٔ سیستم: تاریخ «تا تاریخ پیگیری نشود» فقط رو به جلو می‌رود تا قرارِ
// دورتری که ثبت شده از بین نرود. در «ویرایش» اگر کاربر خودش بخواهد عقب ببرد،
// قرار فعلی را می‌بیند و با تیک زدن اجازهٔ صریح می‌دهد. در «ایجادِ» وظیفهٔ تازه
// این اجازه داده نمی‌شود؛ چون کاربر قصد اصلاح قرارِ موجود را ندارد و ممکن است
// ناخواسته قولِ ثبت‌شدهٔ قبلی را کوتاه کند.
function holdCurrentMs() {
var iso = ($("#ActionBox").attr('data-customer-hold') || '').trim();
if (!iso) { return null; }
var ms = new Date(iso).getTime();
return isNaN(ms) ? null : ms;
}
// مقدار پیکر در فیلد مخفی به‌صورت timestamp میلی‌ثانیه‌ای است؛ اگر پیکر
// تاریخ شمسی متنی گذاشت، همان را هم می‌پذیریم.
function holdTargetMs() {
var raw = ($("#visitHoldUntil").val() || '').trim();
if (!raw) { return null; }
if (/^\d+$/.test(raw)) {
var n = parseInt(raw, 10);
return isNaN(n) ? null : n;
}
var parsed = Date.parse(raw.replace(/\//g, '-'));
return isNaN(parsed) ? null : parsed;
}
function sameLocalDay(a, b) {
var da = new Date(a), db = new Date(b);
return da.getFullYear() === db.getFullYear()
&& da.getMonth() === db.getMonth()
&& da.getDate() === db.getDate();
}
function jalaliDay(ms) {
if (ms === null) { return '—'; }
try {
if (typeof persianDate !== 'undefined') {
return new persianDate(ms).format('YYYY/MM/DD');
}
} catch (err) { /* کتابخانه در دسترس نیست ⇒ تاریخ میلادی */ }
var d = new Date(ms);
return d.getFullYear() + '/' + (d.getMonth() + 1) + '/' + d.getDate();
}
// آیا تاریخ انتخابی از قرار فعلی عقب‌تر است؟ (مستقل از تیک کاربر)
function holdIsBackward() {
if ($("#actionType").val() !== 'hamahangi') { return false; }
var current = holdCurrentMs(), target = holdTargetMs();
if (current === null || target === null) { return false; }
if (sameLocalDay(current, target)) { return false; }
return target < current;
}
// به‌روزرسانی اعلان (و اجازهٔ عقب‌بردن فقط در ویرایش) — با هر تغییر تاریخ/نوع.
function syncHoldBackward() {
var notice = $("#holdBackwardNotice");
var needed = holdIsBackward();
var canForce = needed && isEditMode;
// تیک فقط وقتی معنا دارد که عقب‌بردن مجاز باشد؛ در غیر این صورت پاک می‌شود.
$("#hbForceRow").toggleClass("is-hidden", !canForce);
$("#hbCreateHint").toggleClass("is-hidden", !needed || canForce);
if (!canForce) {
$("#forceHoldCheck").prop('checked', false);
$("#forceHold").val('');
}
if (!needed) {
notice.addClass("is-hidden").removeClass("is-blocking");
return;
}
$("#hbCurrent").text(jalaliDay(holdCurrentMs()));
notice.removeClass("is-hidden");
}
// تیک «عقب ببر» ⇒ فیلد مخفی force_hold برای سرور.
$("#forceHoldCheck").on('change', function() {
var checked = $(this).prop('checked');
$("#forceHold").val(checked ? '1' : '');
$("#holdBackwardNotice").toggleClass("is-blocking", !checked);
});
// هر تغییر تاریخ/نوع اقدام ⇒ وضعیت دوباره محاسبه می‌شود.
$("#ActionBox").on('change input', "#visitHoldUntil, #actionType",
function() { syncHoldBackward(); });
// پیکر تاریخ هم بعد از انتخاب، فیلد مخفی را پر می‌کند.
$(document).on('change', ".dateTimePickerHoldUntil, .dateTimePickerHoldUntil-alt",
function() { syncHoldBackward(); });
// گرفتن تأیید پیش از ثبتِ هماهنگیِ «انجام‌شده» (فقط در حالت ایجاد، نه ویرایش).
$("#ActionBox").on('submit', function(event) {
// (۱) در ویرایش: تاریخ عقب‌تر از قرار فعلی ⇒ تا تیک تأیید نزده، ارسال نمی‌شود.
// در «ایجاد»، وظیفه ذخیره می‌شود و فقط تاریخ قرار عقب نمی‌رود؛ سرور
// همین را با پیام روشن به کاربر می‌گوید، پس ارسال بلاک نمی‌شود.
if (isEditMode && holdIsBackward() && !$("#forceHoldCheck").prop('checked')) {
event.preventDefault();
var notice = $("#holdBackwardNotice").removeClass("is-hidden").addClass("is-blocking");
if (notice[0].scrollIntoView) {
notice[0].scrollIntoView({ block: 'center', behavior: 'smooth' });
}
notice.trigger('focus');
return;
}
// (۲) هماهنگیِ «انجام‌شده»: تأیید یک‌بارهٔ انجام کار.
if (isEditMode || holdConfirmed) {
return; // ویرایش، یا تأیید قبلی ⇒ ارسال آزاد
}
if ($("#actionType").val() !== 'hamahangi') {
return; // سایر انواع اقدام دست‌نخورده
}
if (!$("#checkIsDone").prop("checked")) {
return; // هماهنگیِ انجام‌نشده ⇒ بدون تعویق
}
event.preventDefault();
showHoldConfirm();
});
$(".actionBoxOpenB").click(function(event){
// کلیک روی کنترل‌های «حذف» نباید مودال ویرایش را باز کند.
// (دکمه داخل کارت است و رویداد به والد بالا می‌رفت.)
if ($(event.target).closest('.ax-del-form, .ax-del').length) {
return;
}
isEditMode = true;
$("#sabtBtn05").val("ویرایش");
var actionEditUrl = "{% url 'admin_panel:customerEditAction' 1111 2222 %}";
var action_id = $(this).parent().attr("action_id");
var customer_id = $(this).parent().attr("customer_id");
var row = $(this).parent();
var action_id = row.attr("action_id");
var customer_id = row.attr("customer_id");
var customerHold = row.attr("customer_hold") || "";
actionEditUrl = actionEditUrl.replace('1111', customer_id);
actionEditUrl = actionEditUrl.replace('2222', action_id);
$("#ActionBox").prop("action", actionEditUrl);
@@ -316,6 +839,16 @@
}
$("#ActionBox").addClass("is-active");
$("#actionType").val(ActionParseData[0]['fields']['actionType']);
// در ویرایش، تیکِ خودکار و تأیید نباید درگیر شوند.
holdAutoChecked = false;
holdConfirmed = false;
// فیلد «تا تاریخ پیگیری نشود» با نوع اقدام هم‌راستا شود (در حالت ویرایش هم).
closeHoldHelp();
toggleCoordinationField(ActionParseData[0]['fields']['actionType']);
// مقدار ذخیره‌شدهٔ «قرار بعدی» را در همان فیلد نشان بده (بعد از toggle،
// چون toggle برای انواع غیرهماهنگی فیلد را پاک می‌کند).
seedHoldPicker(customerHold);
syncHoldBackward();
$("#desc").val(ActionParseData[0]['fields']['desc']);
$("#userID").val(ActionParseData[0]['fields']['forUser']);
if(ActionParseData[0]['fields']['status'] == 'finish'){
@@ -326,6 +859,8 @@
$(".showWhenDone").addClass("is-hidden");
}
$("#actionResult").val(ActionParseData[0]['fields']['result']);
// هشدار «هماهنگی انجام شد» در ویرایش هم صرفاً نمایش داده می‌شود (بدون تأیید).
syncHoldWarning();
});
});
@@ -347,6 +882,79 @@
},
});
var dateTimePickerHoldUntil = $(".dateTimePickerHoldUntil").pDatepicker({
altField: '.dateTimePickerHoldUntil-alt',
initialValue: false,
format: 'YYYY/MM/DD',
calendar:{
persian: {
locale: 'fa'
}
},
timePicker: {
enabled: false,
second:{
enabled: false,
}
},
// بعد از انتخاب تاریخ، وضعیت «عقب‌تر بودن» فوراً بازمحاسبه شود
// (پیکر مقدار altField را برنامه‌نویسی‌شده می‌نویسد و ممکن است change رخ ندهد).
onSelect: function () {
setTimeout(function () { syncHoldBackward(); }, 0);
},
});
// اگر پیکر ساخته نشد (مثلاً نام کلاس در قالب عوض شده باشد) هشدار بده؛
// این کار جلوی خطاهای خاموش مثل «تقویم باز نمی‌شود» را می‌گیرد.
if (!dateTimePickerHoldUntil) {
console.warn('[ActionBox] pDatepicker برای «تا تاریخ پیگیری نشود» ساخته نشد؛ ' +
'کلاس .dateTimePickerHoldUntil را در قالب بررسی کنید.');
}
// فیلد «تا تاریخ پیگیری نشود» فقط برای اقدام «هماهنگی» نمایش داده می‌شود.
function toggleCoordinationField(actionType) {
var isCoordination = (actionType === 'hamahangi');
$(".showWhenCoordination").toggleClass("is-hidden", !isCoordination);
if (!isCoordination) {
resetHoldPicker();
closeHoldHelp(); // راهنما هم بسته شود تا در اقدام بعدی باز نماند
}
}
// ---- راهنمای بازشوندهٔ «هماهنگی» ----
function closeHoldHelp() {
$("#holdHelpPanel").addClass("is-hidden");
$("#holdHelpToggle").attr("aria-expanded", "false");
}
$("#holdHelpToggle").click(function(){
var expanded = $(this).attr("aria-expanded") === "true";
$("#holdHelpPanel").toggleClass("is-hidden", expanded);
$(this).attr("aria-expanded", expanded ? "false" : "true");
});
$("select#actionType").on('change', function(){
var type = $(this).val();
toggleCoordinationField(type);
if (type === 'hamahangi') {
// پیش‌فرض: «هماهنگی» یعنی همین حالا تماس گرفته شد ⇒ تیک «انجام شده».
// هشدار و تأیید، جلوی ثبتِ ناخواسته را می‌گیرد.
if (!$("#checkIsDone").prop("checked")) {
$("#checkIsDone").prop("checked", true);
holdAutoChecked = true;
}
} else if (holdAutoChecked) {
// تیک را خودمان زده بودیم ⇒ با تغییر نوع برمی‌داریم (به‌ویژه برای «بازدید»).
$("#checkIsDone").prop("checked", false);
holdAutoChecked = false;
}
holdConfirmed = false;
syncDoneFields();
syncHoldWarning();
});
var dateTimePickerAnjam = $(".dateTimePickerAnjam").pDatepicker({
altField: '.dateTimePickerAnjam-alt',
initialValue: true,
@@ -6,74 +6,7 @@
<div class="">
<div class="columns m-0">
<div class="column is-12-mobile is-4-desktop">
<form action="{% url 'admin_panel:customerEdit' customer.id %}" id="formcsEdit" class="has-background-white brad5" method="post">
{% csrf_token %}
<div class="buttons m-0 level p-2 is-hidden-tablet">
<p class="level-item">محمد جواد فصاحت</p>
<span id="showUserDT" class="button level-item">مشاهده مشخصات</span>
</div>
<div id="userDT" class="is-hidden-mobile">
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">نام ونام خانوادگی</label>
<div class="control">
<input disabled value="{{ customer.name_family }}" name="an_name" class="input an_name" type="text" placeholder="نام نام خانوادگی">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">آدرس</label>
<div class="control">
<input disabled name="an_address" value="{{ customer.address }}" class="input an_address" type="text" placeholder="آدرس کامل">
</div>
</div>
<div class="field column is-9-desktop is-9-mobile m-0">
<label class="label">تلفن همراه</label>
<div class="control">
{% if perms.admin_panel.ViewStore %}
<input disabled value="{{ customer.phone1 }}" name="phone1" id="phone-1" class="input an_phone" type="text" placeholder="تلفن 1">
<input disabled value="{{ customer.phone2 }}" name="phone2" id="phone-2" class="input an_phone" type="text" placeholder="تلفن 2">
<input disabled value="{{ customer.phone3 }}" name="phone3" id="phone-3" class="input an_phone" type="text" placeholder="تلفن 3">
{% else %}
<p class="pb-4">
<a href="tel:{% if customer.phone1|first in '0' %}{{ customer.phone1 }}{% else %}0{{ customer.phone1 }}{% endif %}">{{ customer.phone1 }}</a>
</p>
<p class="pb-4">
<a href="tel:0{% if customer.phone2|first in '0' %}{{ customer.phone2 }}{% else %}0{{ customer.phone2 }}{% endif %}">{{ customer.phone2 }}</a>
</p>
<p class="pb-4">
<a href="tel:0{% if customer.phone3|first in '0' %}{{ customer.phone3 }}{% else %}0{{ customer.phone3 }}{% endif %}">{{ customer.phone3 }}</a>
</p>
{% endif %}
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">تاریخ نصب</label>
<div class="control">
<input disabled name="installDate" value="{{ customer.installDate | toJalali }}" id="persianDateP" class="input installDate" type="text" placeholder="مثل: 1400/06/01">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">کدشناسایی</label>
<div class="control">
<input disabled value="{{ customer.idCode }}" name="idnCode" class="input idnCode" type="text" placeholder="">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
{% if perms.admin_panel.DelCustomer %}
<span class="button is-danger" id="del_customer">حذف مشتری</span>
{% endif %}
<span class="button is-success" id="enEdit">ویرایش</span>
<input class="button is-danger is-hidden" id="editCs" value="ثبت" type="submit">
</div>
</div>
</form>
{% include "./_customer_info.html" %}
</div>
<div class="column is-12-mobile is-8-desktop">
@@ -248,11 +181,6 @@
});
$("#del_customer").click(function(){
if(confirm("با حذف مشتری، تمام سوابق، فاکتورها و اطلاعات از سیستم حذف میشود، مطمئن هستید؟")){
window.location.href = "/panel/customer/{{ customer.id }}/del";
}
});
$(".closeNewIteam").click(function(){
$("#addNewIteam").removeClass("is-active");
@@ -337,22 +265,6 @@ $(document).ready(function() {
var test = 0
$("#enEdit").click(function(){
$("#formcsEdit").find("input").prop('disabled', false);
$("#enEdit").addClass("is-hidden");
$("#editCs").removeClass("is-hidden");
});
$("#showUserDT").click(function(){
if( $(this).html()=='مشاهده مشخصات' ){
$(this).html('مخفی کردن');
$("#userDT").removeClass("is-hidden-mobile");
}else{
$(this).html('مشاهده مشخصات');
$("#userDT").addClass("is-hidden-mobile");
}
});
$(".closeSearch").click(function(){
$(".SearchBox").removeClass("is-active")
});
@@ -7,7 +7,7 @@
<div class="columns m-0">
<div class="column is-12 px-2 pt-3 pb-0">
{% for message in messages %}
<div class="notification {% if message.tags == 'error' %}is-danger{% elif message.tags == 'success' %}is-success{% else %}is-info{% endif %} is-light mb-2">
<div class="notification {% if message.tags == 'error' %}is-danger{% elif message.tags == 'warning' %}is-warning{% elif message.tags == 'success' %}is-success{% else %}is-info{% endif %} is-light mb-2">
<button class="delete close-notification" type="button"></button>
<strong>{{ message }}</strong>
</div>
@@ -18,108 +18,7 @@
<div class="">
<div class="columns m-0">
<div class="column is-12-mobile is-4-desktop">
<form action="{% url 'admin_panel:customerEdit' customer.id %}" id="formcsEdit" class="has-background-white brad5" method="post">
{% csrf_token %}
<div class="buttons m-0 level p-2 is-hidden-tablet">
<p class="level-item">
{{ customer.name_family }}
</p>
<span id="showUserDT" class="button level-item">مشاهده مشخصات</span>
</div>
<div id="userDT" class="is-hidden-mobile">
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">نام ونام خانوادگی</label>
<div class="control">
<input required disabled value="{{ customer.name_family }}" name="an_name" class="input an_name" type="text" placeholder="نام نام خانوادگی">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">آدرس</label>
<div class="control">
<input disabled name="an_address" value="{{ customer.address }}" class="input an_address" type="text" placeholder="آدرس کامل">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">شماره‌های تماس</label>
<div id="dynamic-phones-edit">
{# همهٔ شماره‌ها از هر منبعی که ذخیره شده‌اند (جدول شماره‌ها + فیلدهای قدیمی)، بدون تکرار #}
{% for entry in sms_phone_entries %}
<div class="field has-addons mt-2 ss02">
<div class="control" style="width: 30%;">
<input disabled value="{{ entry.title }}" name="phone_titles" class="input" type="text" placeholder="عنوان">
</div>
<div class="control is-expanded">
<input disabled value="{{ entry.display }}" name="phones" class="input an_phone" type="text" placeholder="تلفن">
</div>
<div class="control">
<a href="tel:{{ entry.display }}" class="button is-success" title="تماس با {{ entry.display }}">
📞
</a>
</div>
{% if perms.admin_panel.ViewStore %}
<div class="control">
<button type="button" disabled class="button is-danger remove-phone-btn">-</button>
</div>
{% endif %}
</div>
{% empty %}
<p class="help mt-2">شماره‌ای برای این مشتری ثبت نشده است.</p>
{% endfor %}
</div>
{% if perms.admin_panel.ViewStore %}
<button type="button" disabled id="add-more-phone-edit" class="button is-small is-info mt-2 w-100 add-phone-btn">
+ افزودن شماره دیگر
</button>
{% endif %}
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">تاریخ نصب</label>
<div class="control">
<input disabled name="installDate" value="{{ customer.installDate | toJalali }}" id="persianDateP" class="input ss02 installDate" type="text" placeholder="مثل: 1400/06/01">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">کدشناسایی</label>
<div class="control">
<input disabled value="{{ customer.idCode }}" name="idnCode" class="input idnCode ss02 " type="text" placeholder="">
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">توضیحات</label>
<div class="control">
<textarea disabled name="notes" class="textarea ss02 an_notes" rows="4" placeholder="یادداشت آزاد">{{ customer.notes }}</textarea>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">لغو بازدید</label>
<div class="control">
<select name="laghv_bazdid" style="width: 100%" class="select" id="LaghvBazdid">
<option value="false">خیر</option>
<option value="true">بله</option>
</select>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
{% if perms.admin_panel.DelCustomer %}
<span class="button is-danger" id="del_customer">حذف مشتری</span>
{% endif %}
<span class="button is-success" id="enEdit">ویرایش</span>
<input class="button is-danger is-hidden" id="editCs" value="ثبت" type="submit">
</div>
</div>
</form>
{% include "./_customer_info.html" %}
</div>
<div class="column is-12-mobile is-8-desktop">
@@ -134,6 +33,7 @@
<li id="newFactorOpen" class="{% if url_name == 'customerNew' %}is-active{% else %} {% endif %} "><a href="{% url 'admin_panel:customerNew' customer.id %}">ایجاد فاکتور</a></li>
<li id="FactorHaOpen" class="{% if url_name == 'customerFactors' %}is-active{% else %} {% endif %} "><a href="{% url 'admin_panel:customerFactors' customer.id %}">فاکتورها </a></li>
<li class=""><a href="{% url 'admin_panel:customerAction' customer.id %}">بازاریابی</a></li>
{% if perms.admin_panel.ManageSMS %}<li class="{% if url_name == 'customerSmsHistory' %}is-active{% else %} {% endif %} "><a href="{% url 'admin_panel:customerSmsHistory' customer.id %}">سوابق پیامک</a></li>{% endif %}
{% endwith %}
@@ -505,11 +405,6 @@
});
$("#del_customer").click(function(){
if(confirm("با حذف مشتری، تمام سوابق، فاکتورها و اطلاعات از سیستم حذف میشود، مطمئن هستید؟")){
window.location.href = "/panel/customer/{{ customer.id }}/del";
}
});
$(".closeNewIteam").click(function(){
$("#addNewIteam").removeClass("is-active");
@@ -635,50 +530,6 @@ $(document).ready(function() {
var test = 0;
$("#enEdit").click(function(){
$("#formcsEdit").find("input, textarea").prop('disabled', false);
// فعال کردن دکمه‌های کنترل تلفن
$("#formcsEdit").find("button.remove-phone-btn, button.add-phone-btn").prop('disabled', false);
$("#enEdit").addClass("is-hidden");
$("#editCs").removeClass("is-hidden");
});
// توابع داینامیک فرم ویرایش
$(document).on('click', '.add-phone-btn', function() {
var phoneRow = `
<div class="field has-addons mt-2 ss02">
<div class="control" style="width: 35%;">
<input name="phone_titles" class="input" type="text" placeholder="عنوان">
</div>
<div class="control is-expanded">
<input name="phones" class="input an_phone" type="text" placeholder="شماره تماس جدید">
</div>
<div class="control">
<button type="button" class="button is-danger remove-phone-btn">-</button>
</div>
</div>`;
$("#dynamic-phones-edit").append(phoneRow);
});
$(document).on('click', '.remove-phone-btn', function() {
if ($("#dynamic-phones-edit .has-addons").length > 1) {
$(this).closest('.field.has-addons').remove();
} else {
alert("حداقل یک شماره تماس باید وجود داشته باشد.");
}
});
$("#showUserDT").click(function(){
if( $(this).html()=='مشاهده مشخصات' ){
$(this).html('مخفی کردن');
$("#userDT").removeClass("is-hidden-mobile");
}else{
$(this).html('مشاهده مشخصات');
$("#userDT").addClass("is-hidden-mobile");
}
});
$(".closeSearch").click(function(){
$(".SearchBox").removeClass("is-active")
});
@@ -180,9 +180,12 @@
</form>
</div>
{% include "./_customer_sms.html" %}
</div>
{% comment %}
باکس «پیامک» از این صفحه حذف شد: تنظیمات پیامک به تب «سوابق پیامک» مشتری
(/panel/customer/<id>/sms/) منتقل شده تا فرم فاکتور تمام‌عرض بماند و سوابق و
تنظیمات هر دو در یک صفحهٔ اختصاصی دیده شوند.
{% endcomment %}
{% endblock %}
@@ -0,0 +1,587 @@
{% extends "./customerBaseNew.html" %}
{% load custom_tags %}
{% load static %}
{% block BodyCustomer1 %}
{% comment %}
صفحهٔ «پیامک مشتری» = سوابق + تنظیمات در یک صفحه.
قاعدهٔ طراحی: تنظیمات هرگز روی سوابق نمی‌نشیند؛ فقط آمار + دکمه‌ها بالاست و
تنظیمات/ارسال سفارشی/شماره‌های اصلی داخل مودال باز می‌شوند.
همهٔ کلاس‌ها با پیشوند csmsx و محدود به #customerSmsHistory هستند تا به
صفحات دیگر نشت نکنند.
{% endcomment %}
<style>
{% verbatim %}
#customerSmsHistory, #customerSmsHistory *, #customerSmsHistory *::before,
#customerSmsHistory *::after { box-sizing: border-box; }
/* متغیرها روی خودِ صفحه و روی ریشهٔ مودال‌ها تعریف می‌شوند؛ مودال‌ها در بلوک
جدا (BodyCustomer2) رندر می‌شوند و خارج از #customerSmsHistory هستند. */
#customerSmsHistory, .csmsx-modal { --cs-line: #e8ecf3; --cs-ink: #363636;
--cs-muted: #7a7a7a; --cs-brand: #3273dc; --cs-ok: #48c774; }
/* ---------- نوار بالای صفحه ---------- */
.csmsx-head { display: flex; flex-wrap: wrap; gap: 1rem; align-items: flex-start;
justify-content: space-between; padding: 1.1rem 1.2rem; margin-bottom: 1rem;
border: 1px solid var(--cs-line); border-radius: 14px;
background: linear-gradient(180deg, #fbfdff 0%, #f5f8fd 100%); }
.csmsx-head__main { min-width: 0; }
.csmsx-title { font-size: 1.15rem; font-weight: 700; color: var(--cs-ink);
margin: 0 0 .25rem; overflow-wrap: anywhere; }
.csmsx-sub { margin: 0; color: var(--cs-muted); font-size: .82rem; line-height: 1.8; }
.csmsx-sub b { color: var(--cs-ink); }
.csmsx-stats { display: flex; flex-wrap: wrap; gap: .45rem; margin-top: .7rem; }
.csmsx-stat { display: inline-flex; align-items: center; gap: .35rem;
font-size: .78rem; padding: .25rem .65rem; border-radius: 999px;
background: #fff; border: 1px solid var(--cs-line); color: #4a4a4a; white-space: nowrap; }
.csmsx-stat b { font-variant-numeric: tabular-nums; }
.csmsx-stat.is-sent { border-color: #c8ebd5; background: #f2fbf6; }
.csmsx-stat.is-pending { border-color: #ffeaa7; background: #fffdf3; }
.csmsx-stat.is-failed { border-color: #ffd0d9; background: #fff5f7; }
.csmsx-head__actions { display: flex; flex-wrap: wrap; gap: .5rem; }
{% endverbatim %}
</style>
<style>
{% verbatim %}
/* ---------- نوار فیلترها ---------- */
.csmsx-filters { display: flex; flex-wrap: wrap; gap: .6rem; align-items: flex-end;
padding: .85rem 1rem; margin-bottom: 1rem; background: #fff;
border: 1px solid var(--cs-line); border-radius: 12px; }
.csmsx-filters .control { margin: 0; }
.csmsx-filters label { display: block; font-size: .75rem; color: var(--cs-muted);
margin-bottom: .25rem; }
.csmsx-filters select { min-width: 10.5rem; }
.csmsx-filters__note { margin-inline-start: auto; font-size: .78rem;
color: var(--cs-muted); }
/* ---------- فهرست سوابق ---------- */
.csmsx-history { background: #fff; border: 1px solid var(--cs-line);
border-radius: 14px; overflow: hidden; }
.csmsx-history__scroll { overflow-x: auto; }
.csmsx-history table { margin: 0 !important; background: transparent; }
.csmsx-history thead th { position: sticky; top: 0; z-index: 1; background: #f7f9fc;
color: #4a4a4a; font-size: .78rem; font-weight: 700;
border-bottom: 1px solid var(--cs-line) !important; }
.csmsx-history tbody tr:hover { background: #fafcff; }
.csmsx-msg { white-space: pre-wrap; overflow-wrap: anywhere; max-width: 34rem;
line-height: 1.95; font-size: .84rem; }
/* پیامک‌های بلند (متن قالب‌ها چندخطی است) کل جدول را بی‌اندازه بلند می‌کردند؛
متن در ۴ خط خلاصه می‌شود و با «نمایش کامل» باز می‌شود. */
.csmsx-msg.is-clamped { display: -webkit-box; -webkit-line-clamp: 4;
-webkit-box-orient: vertical; overflow: hidden; }
.csmsx-expand { margin-top: .25rem; font-size: .72rem; padding: .1rem .45rem;
border-radius: 6px; border: 1px solid var(--cs-line); background: #fff;
color: var(--cs-brand); cursor: pointer; }
.csmsx-expand:hover { background: #f4f8ff; }
.csmsx-meta { font-size: .76rem; line-height: 1.7; color: var(--cs-muted); }
.csmsx-badge { white-space: nowrap; }
.csmsx-type-chip { display: inline-block; font-size: .75rem; padding: .1rem .5rem;
border-radius: 999px; background: #f1f5fb; color: #33507d; white-space: nowrap; }
{% endverbatim %}
</style>
<style>
{% verbatim %}
/* ---------- مودال‌ها ---------- */
.csmsx-modal .modal-content { max-width: 46rem; width: calc(100% - 1.5rem); }
.csmsx-modal .box { padding: 0; overflow: hidden; border-radius: 14px; }
.csmsx-modal__head { display: flex; align-items: flex-start; justify-content: space-between;
gap: .75rem; padding: 1rem 1.15rem; border-bottom: 1px solid var(--cs-line);
background: linear-gradient(180deg, #fbfdff 0%, #f4f8fd 100%); }
.csmsx-modal__title { margin: 0; font-size: 1.02rem; font-weight: 700; color: var(--cs-ink); }
.csmsx-modal__sub { margin: .2rem 0 0; font-size: .78rem; color: var(--cs-muted); line-height: 1.8; }
.csmsx-modal__body { padding: 1rem 1.15rem; max-height: min(68vh, 34rem); overflow-y: auto; }
.csmsx-modal__foot { display: flex; flex-wrap: wrap; gap: .5rem; justify-content: flex-end;
padding: .85rem 1.15rem; border-top: 1px solid var(--cs-line); background: #fcfcfd; }
.csmsx-section-title { display: flex; align-items: center; gap: .45rem; margin: 0 0 .6rem;
font-size: .82rem; font-weight: 700; color: #4a4a4a; }
.csmsx-section + .csmsx-section { margin-top: 1.15rem; padding-top: 1.15rem;
border-top: 1px dashed var(--cs-line); }
/* ردیف هر نوع پیامک داخل مودال تنظیمات */
.csmsx-type { display: grid; grid-template-columns: auto minmax(0, 1fr) auto;
gap: .6rem .75rem; align-items: center; padding: .6rem .7rem; border-radius: 10px; }
.csmsx-type + .csmsx-type { margin-top: .3rem; }
.csmsx-type:hover { background: #fafcff; }
.csmsx-type.is-off { background: #fcfcfc; }
.csmsx-type.is-off .csmsx-type__label { color: #9a9a9a; }
.csmsx-type__icon { font-size: 1.15rem; line-height: 1; }
.csmsx-type__main { min-width: 0; }
.csmsx-type__label { display: block; font-size: .85rem; font-weight: 600;
color: var(--cs-ink); overflow-wrap: anywhere; }
.csmsx-type__meta { display: flex; flex-wrap: wrap; gap: .3rem; margin-top: .2rem; }
.csmsx-tag { font-size: .7rem; padding: .1rem .45rem; border-radius: 999px;
border: 1px solid var(--cs-line); background: #fff; color: var(--cs-muted); white-space: nowrap; }
.csmsx-tag.is-auto { border-color: #cfe0ff; background: #f4f8ff; color: #2f5fb3; }
/* کلید فعال/غیرفعال (دکمهٔ submit داخل فرم) */
.csmsx-switch { display: inline-flex; align-items: center; gap: .45rem;
background: none; border: 0; padding: .25rem; cursor: pointer; min-height: 2.4rem; }
.csmsx-switch__track { position: relative; flex: 0 0 auto; width: 44px; height: 25px;
border-radius: 13px; background: #dbdbdb; transition: background .18s; }
.csmsx-switch__track::after { content: ""; position: absolute; top: 3px;
inset-inline-start: 3px; width: 19px; height: 19px; border-radius: 50%;
background: #fff; box-shadow: 0 1px 3px rgba(0,0,0,.3); transition: transform .18s; }
.csmsx-switch.is-on .csmsx-switch__track { background: var(--cs-ok); }
.csmsx-switch.is-on .csmsx-switch__track::after { transform: translateX(-19px); }
.csmsx-switch:focus-visible .csmsx-switch__track { outline: 2px solid var(--cs-brand); outline-offset: 2px; }
.csmsx-switch__text { font-size: .76rem; color: #4a4a4a; white-space: nowrap; min-width: 3.2rem; text-align: start; }
/* شماره‌های اصلی داخل مودال */
.csmsx-phones { display: flex; flex-wrap: wrap; gap: .5rem; }
.csmsx-phone { display: inline-flex; align-items: center; gap: .4rem; padding: .3rem .4rem .3rem .65rem;
border: 1px solid var(--cs-line); border-radius: 999px; background: #fff; }
.csmsx-phone__num { direction: ltr; font-size: .82rem; color: var(--cs-ink); }
.csmsx-phone .sms-primary-toggle { border-radius: 999px; font-size: .72rem; height: 1.9rem; padding-inline: .6rem; }
.csmsx-empty { font-size: .8rem; color: var(--cs-muted); margin: 0; }
/* ارسال سفارشی */
.csmsx-chips { display: flex; flex-wrap: wrap; gap: .35rem; margin-bottom: .5rem; }
.csmsx-chip { font-size: .72rem; padding: .2rem .55rem; border-radius: 999px;
border: 1px solid var(--cs-line); background: #fff; color: #4a4a4a; cursor: pointer;
direction: ltr; font-family: ui-monospace, Menlo, Consolas, monospace; }
.csmsx-chip:hover { border-color: var(--cs-brand); color: var(--cs-brand); }
.csmsx-counter { display: flex; justify-content: space-between; gap: .5rem;
font-size: .74rem; color: var(--cs-muted); margin-top: .4rem; }
/* ---------- واکنش‌گرا ---------- */
@media (max-width: 768px) {
.csmsx-head { padding: .9rem; }
.csmsx-head__actions { width: 100%; }
.csmsx-head__actions .button { flex: 1 1 auto; }
.csmsx-filters { padding: .75rem; }
.csmsx-filters select { min-width: 0; width: 100%; }
.csmsx-filters .control { flex: 1 1 45%; }
.csmsx-filters__note { margin-inline-start: 0; width: 100%; }
.csmsx-modal__body { max-height: 72vh; }
/* موبایل: جدول به کارت تبدیل می‌شود. اسکرول افقی روی موبایل، متن پیامک را
می‌بُرد و خواندن سوابق را عملاً غیرممکن می‌کرد؛ در این حالت هر پیامک یک
کارت کامل با برچسب هر خانه است و هیچ اسکرول افقی لازم نیست. */
.csmsx-history__scroll { overflow: visible; }
.csmsx-history table, .csmsx-history tbody, .csmsx-history tr,
.csmsx-history td { display: block; width: auto !important; }
.csmsx-history thead { display: none; }
.csmsx-history tbody tr { padding: .7rem .85rem; border-bottom: 1px solid var(--cs-line); }
.csmsx-history tbody tr:last-child { border-bottom: 0; }
.csmsx-history tbody td { display: flex; gap: .5rem; align-items: flex-start;
padding: .18rem 0 !important; border: 0 !important; }
.csmsx-history tbody td::before { content: attr(data-label); flex: 0 0 5.5rem;
font-size: .72rem; color: var(--cs-muted); line-height: 1.9; }
.csmsx-history tbody td[data-label=""]::before { content: none; }
/* ستون متن: برچسب بالای متن (نه کنارش) تا عرض خواندن کم نشود. */
.csmsx-history tbody td[data-label="متن"] { display: block; }
.csmsx-history tbody td[data-label="متن"]::before { display: block;
flex: none; margin-bottom: .15rem; }
.csmsx-history tbody td > * { min-width: 0; }
.csmsx-expand { white-space: nowrap; }
.csmsx-msg { max-width: none; }
.csmsx-col-id, .csmsx-col-sent, .csmsx-col-delivery-check { display: none !important; }
}
{% endverbatim %}
</style>
<div id="customerSmsHistory" class="column is-12-mobile is-12-desktop" dir="rtl">
{# ---------- ۱) نوار بالای صفحه: آمار + دکمه‌های تنظیمات ---------- #}
<div class="csmsx-head">
<div class="csmsx-head__main">
<h1 class="csmsx-title">پیامک‌های {{ customer.name_family }}</h1>
<p class="csmsx-sub">
جمعاً <b>{{ total_count }}</b> پیامک در سابقه ·
<b>{{ sms_enabled_count }}</b> از <b>{{ sms_type_total }}</b> نوع پیامک برای این مشتری فعال است.
</p>
<div class="csmsx-stats">
<span class="csmsx-stat is-sent">✅ ارسال‌شده <b>{{ stat_sent }}</b></span>
<span class="csmsx-stat is-pending">⏳ در صف <b>{{ stat_pending }}</b></span>
<span class="csmsx-stat is-failed">⚠️ ناموفق <b>{{ stat_failed }}</b></span>
</div>
</div>
<div class="csmsx-head__actions">
{% if perms.admin_panel.ManageSMS %}
<button type="button" class="button is-link is-light js-csmsx-open" data-target="smsSettingsModal"
aria-haspopup="dialog">
⚙️ تنظیمات پیامک
</button>
<button type="button" class="button is-info is-light js-csmsx-open" data-target="smsCustomModal"
aria-haspopup="dialog">
✉️ ارسال پیامک
</button>
{% endif %}
{% if perms.admin_panel.ManageSMSSettings %}
<a class="button is-white" href="{% url 'admin_panel:sms_templates' %}"
title="ویرایش متن قالب‌های پیامک">🗂️ متن قالب‌ها</a>
{% endif %}
</div>
</div>
{# ---------- ۲) فیلترها ---------- #}
<form method="get" class="csmsx-filters">
<div class="control">
<label for="csmsx-status">وضعیت ارسال</label>
<div class="select">
<select id="csmsx-status" name="status">
<option value="">همهٔ وضعیت‌ها</option>
{% for value, label in status_choices %}
<option value="{{ value }}" {% if status == value %}selected{% endif %}>{{ label }}</option>
{% endfor %}
</select>
</div>
</div>
<div class="control">
<label for="csmsx-delivery">وضعیت تحویل</label>
<div class="select">
<select id="csmsx-delivery" name="delivery">
<option value="">همهٔ وضعیت‌ها</option>
{% for value, label in delivery_choices %}
<option value="{{ value }}" {% if delivery == value %}selected{% endif %}>{{ label }}</option>
{% endfor %}
</select>
</div>
</div>
<div class="control">
<button class="button is-link" type="submit">اعمال فیلتر</button>
</div>
{% if status or delivery %}
<div class="control">
<a class="button is-light" href="{% url 'admin_panel:customerSmsHistory' customer.id %}">حذف فیلتر</a>
</div>
{% endif %}
<span class="csmsx-filters__note">
{% if status or delivery %}
نمایش <b>{{ filtered_count }}</b> از <b>{{ total_count }}</b> پیامک
{% else %}
نمایش <b>{{ total_count }}</b> پیامک، جدیدترین‌ها ابتدا
{% endif %}
</span>
</form>
{# ---------- ۳) سوابق ---------- #}
<div class="csmsx-history">
<div class="csmsx-history__scroll">
<table class="table is-fullwidth is-narrow is-hoverable is-striped">
<thead>
<tr>
<th class="csmsx-col-id">شناسه</th>
<th style="min-width: 8.5rem;">نوع پیامک</th>
<th style="min-width: 8rem;">گیرنده</th>
<th style="min-width: 16rem;">متن پیامک</th>
<th>وضعیت ارسال</th>
<th style="min-width: 8rem;">وضعیت تحویل</th>
<th style="min-width: 7rem;">تاریخ ایجاد</th>
<th class="csmsx-col-sent" style="min-width: 7rem;">تاریخ ارسال</th>
</tr>
</thead>
<tbody>
{% for item in items %}
<tr>
<td class="csmsx-col-id csmsx-meta" data-label="شناسه">{{ item.id }}</td>
<td data-label="نوع">
{% if item.sms_type %}
<span class="csmsx-type-chip">{{ item.get_sms_type_display }}</span>
{% else %}
<span class="csmsx-type-chip">سفارشی</span>
{% endif %}
{% if item.attempts %}
<div class="csmsx-meta">تلاش: {{ item.attempts }}</div>
{% endif %}
</td>
<td class="csmsx-meta" dir="ltr" data-label="گیرنده">{{ item.phone_number }}</td>
<td data-label="متن">
<div class="csmsx-msg {% if item.message|length > 170 %}is-clamped{% endif %}">{{ item.message }}</div>
{% if item.message|length > 170 %}
<button type="button" class="csmsx-expand js-csmsx-expand" aria-expanded="false">نمایش کامل</button>
{% endif %}
</td>
<td data-label="ارسال">
<span class="tag csmsx-badge
{% if item.status == 'sent' %}is-success
{% elif item.status == 'failed' %}is-danger
{% elif item.status == 'pending' %}is-warning
{% elif item.status == 'approved' %}is-info
{% else %}is-light{% endif %}">
{{ item.get_status_display }}
</span>
{% if item.last_error %}
<div class="has-text-danger csmsx-meta" title="{{ item.last_error }}">
خطا: {{ item.last_error|truncatechars:80 }}
</div>
{% endif %}
</td>
<td data-label="تحویل">
<span class="tag csmsx-badge
{% if item.delivery_status == 'delivered' %}is-success
{% elif item.delivery_status == 'not_delivered' %}is-danger
{% elif item.delivery_status == 'expired' %}is-danger
{% elif item.delivery_status == 'pending' %}is-warning
{% else %}is-light{% endif %}">
{{ item.get_delivery_status_display|default:'بدون پیگیری' }}
</span>
{% if item.delivery_checked_at %}
<div class="csmsx-meta csmsx-col-delivery-check">استعلام: {{ item.delivery_checked_at|toJalaliDT }}</div>
{% endif %}
</td>
<td class="csmsx-meta" data-label="تاریخ">{{ item.created_at|toJalaliDT }}</td>
<td class="csmsx-meta csmsx-col-sent" data-label="ارسال‌شده">{{ item.sent_at|toJalaliDT|default:'—' }}</td>
</tr>
{% empty %}
<tr>
<td colspan="8" class="has-text-centered py-5" data-label="">پیامکی برای این مشتری ثبت نشده است.</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
</div>
{% if items.has_other_pages %}
<nav class="pagination is-centered mt-4" role="navigation" aria-label="pagination">
{% if items.has_previous %}
<a class="pagination-previous" href="?page={{ items.previous_page_number }}{% if status %}&status={{ status }}{% endif %}{% if delivery %}&delivery={{ delivery }}{% endif %}">قبلی</a>
{% else %}
<a class="pagination-previous" disabled>قبلی</a>
{% endif %}
{% if items.has_next %}
<a class="pagination-next" href="?page={{ items.next_page_number }}{% if status %}&status={{ status }}{% endif %}{% if delivery %}&delivery={{ delivery }}{% endif %}">بعدی</a>
{% else %}
<a class="pagination-next" disabled>بعدی</a>
{% endif %}
<ul class="pagination-list">
<li><span class="pagination-link">صفحهٔ {{ items.number }} از {{ items.paginator.num_pages }}</span></li>
</ul>
</nav>
{% endif %}
</div>
{% endblock %}
{% block BodyCustomer2 %}
{% if perms.admin_panel.ManageSMS %}
{# ---------- مودال ۱: تنظیمات پیامک (نوع‌ها + شماره‌های اصلی) ---------- #}
<div class="modal csmsx-modal" id="smsSettingsModal" role="dialog" aria-modal="true"
aria-labelledby="smsSettingsTitle">
<div class="modal-background js-csmsx-close"></div>
<div class="modal-content">
<div class="box" dir="rtl">
<div class="csmsx-modal__head">
<div>
<h2 class="csmsx-modal__title" id="smsSettingsTitle">⚙️ تنظیمات پیامک این مشتری</h2>
<p class="csmsx-modal__sub">
هر تغییر بلافاصله ذخیره می‌شود. خاموش‌کردن یک نوع، فقط برای همین مشتری است؛
متن پیامک‌ها از <b>قالب‌های پیامک</b> می‌آید.
</p>
</div>
<button type="button" class="delete js-csmsx-close" aria-label="بستن"></button>
</div>
<div class="csmsx-modal__body">
{% if notice_text and request.GET.open == 'settings' %}
<div class="notification {{ notice_kind }} is-light py-2 px-3 mb-3">
<strong>{{ notice_text }}</strong>
</div>
{% endif %}
{# --- بخش الف: شماره‌های اصلی پیامک --- #}
<section class="csmsx-section">
<h3 class="csmsx-section-title">📱 شماره‌های اصلی پیامک</h3>
{% if phone_entries %}
<div class="csmsx-phones">
{% for entry in phone_entries %}
{% if entry.is_mobile %}
<span class="csmsx-phone">
<span class="csmsx-phone__num">{{ entry.display }}</span>
<button type="button"
class="button sms-primary-toggle {% if entry.is_primary %}is-warning{% else %}is-light{% endif %}"
data-url="{% url 'admin_panel:sms_primary_toggle' customer.id %}"
data-phone="{{ entry.raw }}"
data-primary="{% if entry.is_primary %}true{% else %}false{% endif %}"
title="{% if entry.is_primary %}برداشتن از شماره‌های اصلی پیامک{% else %}تعیین به‌عنوان شمارهٔ اصلی پیامک{% endif %}">
{% if entry.is_primary %}★ اصلی{% else %}☆ اصلی{% endif %}
</button>
</span>
{% endif %}
{% endfor %}
</div>
<p class="csmsx-empty mt-2">
پیامک‌ها به شماره‌های «★ اصلی» می‌روند؛ اگر هیچ شماره‌ای اصلی نباشد، شمارهٔ اول مشتری.
</p>
{% else %}
<p class="csmsx-empty">شماره‌ای برای این مشتری ثبت نشده است.</p>
{% endif %}
</section>
{# --- بخش ب: فعال/غیرفعال کردن هر نوع پیامک --- #}
<section class="csmsx-section">
<h3 class="csmsx-section-title">
🔔 انواع پیامک
<span class="csmsx-tag">{{ sms_enabled_count }} از {{ sms_type_total }} فعال</span>
</h3>
{% for item in sms_toggles %}
<form method="post" action="{% url 'admin_panel:sms_customer_toggle' customer.id %}"
class="csmsx-type {% if not item.enabled %}is-off{% endif %}">
{% csrf_token %}
<input type="hidden" name="sms_type" value="{{ item.code }}">
<input type="hidden" name="is_enabled" value="{% if item.enabled %}false{% else %}true{% endif %}">
<span class="csmsx-type__icon" aria-hidden="true">{{ item.icon }}</span>
<div class="csmsx-type__main">
<span class="csmsx-type__label">{{ item.label }}</span>
<span class="csmsx-type__meta">
{% if item.when %}<span class="csmsx-tag">{{ item.when }}</span>{% endif %}
<span class="csmsx-tag {% if item.auto_send %}is-auto{% endif %}">
{% if item.auto_send %}ارسال خودکار{% else %}نیازمند تأیید مدیر{% endif %}
</span>
</span>
</div>
<button type="submit" class="csmsx-switch {% if item.enabled %}is-on{% endif %}"
role="switch" aria-checked="{% if item.enabled %}true{% else %}false{% endif %}"
title="{% if item.enabled %}خاموش کردن{% else %}روشن کردن{% endif %} این نوع پیامک">
<span class="csmsx-switch__track" aria-hidden="true"></span>
<span class="csmsx-switch__text">{% if item.enabled %}فعال{% else %}غیرفعال{% endif %}</span>
</button>
</form>
{% endfor %}
</section>
</div>
<div class="csmsx-modal__foot">
<button type="button" class="button is-light js-csmsx-close">بستن</button>
</div>
</div>
</div>
</div>
{# ---------- مودال ۲: ارسال پیامک سفارشی ---------- #}
<div class="modal csmsx-modal" id="smsCustomModal" role="dialog" aria-modal="true"
aria-labelledby="smsCustomTitle">
<div class="modal-background js-csmsx-close"></div>
<div class="modal-content">
<form class="box" dir="rtl" method="post"
action="{% url 'admin_panel:sms_send_custom' customer.id %}">
{% csrf_token %}
<div class="csmsx-modal__head">
<div>
<h2 class="csmsx-modal__title" id="smsCustomTitle">✉️ ارسال پیامک سفارشی</h2>
<p class="csmsx-modal__sub">
به شماره‌های «★ اصلی» این مشتری ارسال می‌شود و بی‌درنگ در صف قرار می‌گیرد.
</p>
</div>
<button type="button" class="delete js-csmsx-close" aria-label="بستن"></button>
</div>
<div class="csmsx-modal__body">
{% if notice_text and request.GET.open == 'custom' %}
<div class="notification {{ notice_kind }} is-light py-2 px-3 mb-3">
<strong>{{ notice_text }}</strong>
</div>
{% endif %}
<div class="csmsx-chips">
<button type="button" class="csmsx-chip js-csmsx-token" data-token="{name}">{name}</button>
<button type="button" class="csmsx-chip js-csmsx-token" data-token="{balance_sep}">{balance_sep}</button>
</div>
<textarea id="csmsxCustomText" class="textarea" name="text" rows="5"
placeholder="متن پیامک…" required
data-counter="#csmsxCustomCounter"></textarea>
<div class="csmsx-counter">
<span>{name} با نام مشتری، {balance_sep} با مانده حساب جایگزین می‌شود.</span>
<span id="csmsxCustomCounter">۰ نویسه</span>
</div>
</div>
<div class="csmsx-modal__foot">
<button type="button" class="button is-light js-csmsx-close">انصراف</button>
<button type="submit" class="button is-info">ارسال پیامک</button>
</div>
</form>
</div>
</div>
<script>
// باز/بسته کردن مودال‌های این صفحه + درج متغیر در متن + شمارندهٔ نویسه.
// بدون کتابخانهٔ جدید؛ کلید Esc و کلیک روی پس‌زمینه هم مودال را می‌بندد.
(function () {
if (window.__csmsxModalInit) { return; }
window.__csmsxModalInit = true;
function openModal(id) {
var modal = document.getElementById(id);
if (!modal) { return; }
modal.classList.add('is-active');
var field = modal.querySelector('textarea');
if (field) { field.focus(); }
}
function closeModal(modal) {
if (modal) { modal.classList.remove('is-active'); }
}
document.addEventListener('click', function (event) {
if (!event.target.closest) { return; }
var opener = event.target.closest('.js-csmsx-open');
if (opener) {
event.preventDefault();
openModal(opener.getAttribute('data-target'));
return;
}
var closer = event.target.closest('.js-csmsx-close');
if (closer) {
event.preventDefault();
closeModal(closer.closest('.modal'));
return;
}
var expand = event.target.closest('.js-csmsx-expand');
if (expand) {
event.preventDefault();
var box = expand.parentNode.querySelector('.csmsx-msg');
if (box) {
var opened = box.classList.toggle('is-clamped') === false;
expand.setAttribute('aria-expanded', opened ? 'true' : 'false');
expand.textContent = opened ? 'خلاصه' : 'نمایش کامل';
}
return;
}
var chip = event.target.closest('.js-csmsx-token');
if (chip) {
event.preventDefault();
var field = document.getElementById('csmsxCustomText');
if (!field) { return; }
var token = chip.getAttribute('data-token') || '';
var start = field.selectionStart == null ? field.value.length : field.selectionStart;
var end = field.selectionEnd == null ? field.value.length : field.selectionEnd;
field.value = field.value.slice(0, start) + token + field.value.slice(end);
field.selectionStart = field.selectionEnd = start + token.length;
field.dispatchEvent(new Event('input', { bubbles: true }));
field.focus();
}
});
document.addEventListener('keydown', function (event) {
if (event.key !== 'Escape' && event.key !== 'Esc') { return; }
var active = document.querySelector('#smsSettingsModal.is-active, #smsCustomModal.is-active');
closeModal(active);
});
document.addEventListener('input', function (event) {
var field = event.target;
if (!field || field.id !== 'csmsxCustomText') { return; }
var target = document.querySelector(field.getAttribute('data-counter'));
if (!target) { return; }
// ارقام فارسی، هم‌خوان با بقیهٔ متن صفحه.
var count = String(field.value.length)
.replace(/[0-9]/g, function (d) { return '۰۱۲۳۴۵۶۷۸۹'.charAt(Number(d)); });
target.textContent = count + ' نویسه';
});
// باز شدن خودکار مودال بر اساس ?open= (بعد از ذخیرهٔ تنظیمات یا خطای ارسال).
var wanted = new URLSearchParams(window.location.search).get('open');
if (wanted === 'settings') { openModal('smsSettingsModal'); }
if (wanted === 'custom') { openModal('smsCustomModal'); }
})();
</script>
{% endif %}
{% endblock %}
+599 -176
View File
@@ -2,219 +2,642 @@
{% load custom_tags %}
{% block bodyPage %}
<div class="">
<div class="columns m-0">
<style>
/* ===================================================================
صفحهٔ انتظار بازدید — mobile first
مقیاس فاصله: ۰٫۲۵rem (۴px) — همهٔ فاصله‌ها مضرب همین واحد است.
=================================================================== */
.ez-wrap { padding: .5rem; }
@media (min-width: 769px) { .ez-wrap { padding: 1rem 1.25rem; } }
<div class="column is-12">
<div class="buttons">
<a href="#" id="openSearchBox" class="button is-info is-outlined is-rounded mr-0">جستجو</a>
/* ---------- نوار آمار ---------- */
.ez-stats-head { margin: 0 0 .55rem; }
.ez-stats-title { font-size: .92rem; font-weight: 800; color: #0f172a; margin: 0; }
.ez-stats-hint {
font-size: .72rem; color: #64748b; margin: .2rem 0 0; line-height: 1.7;
}
.ez-stats-hint b { color: #334155; }
.ez-stats {
display: grid; grid-auto-flow: column; grid-auto-columns: minmax(11rem, 1fr);
gap: .5rem; overflow-x: auto; padding-bottom: .35rem;
-webkit-overflow-scrolling: touch;
}
@media (min-width: 1024px) {
.ez-stats { grid-auto-flow: row; grid-template-columns: repeat(4, 1fr); overflow: visible; }
}
.ez-stat {
display: flex; flex-direction: column; gap: .18rem;
border: 1px solid #e2e8f0; border-radius: .625rem; background: #fff;
padding: .55rem .65rem .6rem; text-decoration: none; color: #334155;
border-top: 3px solid #cbd5e1;
transition: border-color .15s ease, background-color .15s ease, box-shadow .15s ease;
}
.ez-stat:hover { border-color: #94a3b8; box-shadow: 0 1px 6px rgba(15, 23, 42, .08); }
/* نوار رنگی بالای هر کارت = همان رنگ برچسب وضعیت در جدول */
.ez-stat.total { border-top-color: #64748b; }
.ez-stat.danger { border-top-color: #dc2626; }
.ez-stat.success { border-top-color: #16a34a; }
.ez-stat.warning { border-top-color: #d97706; }
.ez-stat.link { border-top-color: #0284c7; }
.ez-stat.violet { border-top-color: #7c3aed; }
.ez-stat.followup { border-top-color: #0e7490; }
.ez-stat-top {
display: flex; align-items: baseline; justify-content: space-between; gap: .4rem;
}
.ez-stat .ez-lbl {
font-size: .74rem; font-weight: 700; color: #334155; line-height: 1.35;
}
.ez-stat .ez-num {
font-size: 1.25rem; font-weight: 800; line-height: 1.1;
font-variant-numeric: tabular-nums; flex: 0 0 auto;
}
.ez-stat .ez-desc {
font-size: .68rem; color: #7c8798; line-height: 1.6;
}
.ez-stat.is-active {
border-color: #33b5d3; background: #f1fbff;
box-shadow: inset 0 -3px 0 #33b5d3, 0 1px 6px rgba(51, 181, 211, .18);
}
.ez-stat.is-active .ez-lbl { color: #0e7490; }
.ez-stat.is-active .ez-desc { color: #0e7490; }
/* ---------- تفکیک تأخیر ---------- */
.ez-legend {
display: flex; flex-wrap: wrap; gap: .25rem .9rem;
margin: .6rem 0 .5rem; font-size: .72rem; color: #64748b;
}
.ez-legend b { font-variant-numeric: tabular-nums; color: #334155; }
/* ---------- نوار تاریخ (نمای «نیازمند پیگیری») ---------- */
.ez-datebar {
display: flex; flex-wrap: wrap; align-items: flex-end; gap: .4rem;
padding: .5rem .6rem; margin: .5rem 0 .4rem;
background: #f8fbfd; border: 1px solid #d9e8f0; border-radius: .5rem;
}
.ez-datebar .button { margin: 0 !important; }
.ez-dateform { margin: 0; }
.ez-datefield { display: flex; flex-direction: column; gap: .15rem; margin: 0; }
.ez-datefield-row { display: flex; gap: .25rem; align-items: center; }
.ez-datefield-row .input {
height: 2.1rem; font-size: .78rem; width: 8.5rem;
font-variant-numeric: tabular-nums; direction: ltr; text-align: center;
}
.ez-datenote {
flex: 1 1 100%; font-size: .7rem; color: #64748b; line-height: 1.7;
}
.ez-datenote b { color: #334155; }
@media (min-width: 700px) {
.ez-datenote { flex: 1 1 auto; }
}
/* ---------- هشدار مینیمال «پیگیری‌های عقب‌افتاده» ---------- */
.ez-overdue-alert,
.ez-overdue-mode {
flex: 1 1 100%; display: inline-flex; align-items: center; gap: .35rem;
font-size: .72rem; line-height: 1.6; text-decoration: none;
}
.ez-overdue-alert { color: #b91c1c; font-weight: 600; }
.ez-overdue-alert:hover { color: #991b1b; text-decoration: underline; }
.ez-overdue-alert b { font-variant-numeric: tabular-nums; font-size: .8rem; }
.ez-overdue-dot {
width: .42rem; height: .42rem; border-radius: 50%;
background: #dc2626; flex: 0 0 auto;
}
.ez-overdue-mode {
color: #7f1d1d; background: #fef2f2;
border: 1px solid #fecaca; border-radius: .375rem; padding: .2rem .5rem;
}
.ez-overdue-mode b { font-variant-numeric: tabular-nums; }
.ez-overdue-mode a {
color: #b91c1c; font-weight: 700; text-decoration: none;
margin-inline-start: .35rem;
}
.ez-overdue-mode a:hover { text-decoration: underline; }
/* ---------- نوار فیلتر ---------- */
.ez-filters {
display: flex; flex-wrap: wrap; align-items: flex-end;
gap: .5rem; margin: .6rem 0 .4rem;
}
.ez-filter { display: flex; flex-direction: column; gap: .15rem; margin: 0; }
.ez-filter-grow { flex: 1 1 18rem; min-width: 14rem; }
.ez-filter-lbl { font-size: .68rem; color: #64748b; font-weight: 700; }
.ez-filters .select select { font-size: .76rem; height: 2.1rem; }
.ez-search { display: flex; gap: .25rem; align-items: center; }
.ez-search .input { height: 2.1rem; font-size: .76rem; }
.ez-search .button { margin: 0 !important; }
.ez-clear { margin: 0 !important; }
/* ---------- سرستون‌های مرتب‌شدنی ---------- */
.ez-th > a {
display: inline-flex; align-items: center; gap: .15rem;
color: #06323d; text-decoration: none; white-space: nowrap;
}
.ez-th > a:hover { text-decoration: underline; }
.ez-th.is-sorted > a { color: #0b4e60; }
.ez-arrow { font-size: .62rem; opacity: .55; }
.ez-th.is-sorted .ez-arrow { opacity: 1; }
/* ---------- تفکیک تأخیر (کلیک‌پذیر) ---------- */
.ez-legend a {
color: #64748b; text-decoration: none; padding: .05rem .35rem;
border-radius: .25rem; white-space: nowrap;
}
.ez-legend a:hover { background: #f1f5f9; }
.ez-legend a.is-active { background: #33b5d3; color: #fff; }
.ez-legend a.is-active b { color: #fff; }
/* ---------- جدول ---------- */
.ez-table { width: 100%; margin: 0; font-size: .82rem; border-collapse: collapse; }
@media (min-width: 900px) { .ez-table { table-layout: fixed; } }
.ez-table thead th {
position: sticky; top: 0; z-index: 2; background: #33b5d3; color: #06323d;
font-size: .72rem; font-weight: 700; padding: .5rem .35rem; white-space: nowrap;
border: 0; border-bottom: 1px solid #22a5c1;
}
.ez-table tbody td {
padding: .45rem .3rem; vertical-align: middle; text-align: center;
line-height: 1.4; border: 0; border-bottom: 1px solid #eef2f6;
overflow-wrap: anywhere;
}
/* تاریخ‌ها و شماره‌ها هرگز به دو خط نشکنند */
.ez-table tbody td.ez-nowrap { white-space: nowrap; }
.ez-table tbody tr:hover td { background: #f8fbfd; }
/* شمارندهٔ ردیف: به‌جای یک ستون کامل، چیپ کنار نام */
.ez-idx {
display: inline-block; min-width: 1.55rem; margin-inline-end: .3rem;
padding: .05rem .25rem; border-radius: .3rem; background: #f1f5f9;
color: #64748b; font-size: .68rem; font-weight: 700;
font-variant-numeric: tabular-nums; text-align: center;
}
.ez-name { font-weight: 700; font-size: .84rem; color: #0f172a; }
.ez-name:hover { color: #0e7490; }
.ez-sub { font-size: .68rem; color: #94a3b8; margin-top: .1rem; }
/* اعداد و شماره‌ها */
.ez-num { font-variant-numeric: tabular-nums; }
.ez-phone {
direction: ltr; unicode-bidi: isolate;
font-variant-numeric: tabular-nums; letter-spacing: .01em;
}
.ez-muted { color: #cbd5e1; }
.ez-badge {
display: inline-block; padding: .1rem .45rem; border-radius: 999px;
font-size: .68rem; font-weight: 700; white-space: nowrap; line-height: 1.6;
}
.ez-badge.danger { background: #fee2e2; color: #b91c1c; }
.ez-badge.success { background: #dcfce7; color: #15803d; }
.ez-badge.warning { background: #fef3c7; color: #b45309; }
.ez-badge.mixed { background: #e0f2fe; color: #0369a1; }
.ez-badge.coordination { background: #ede9fe; color: #6d28d9; }
/* تأخیر به‌صورت چیپ (خوانا در یک نگاه) */
.ez-late {
display: inline-block; min-width: 4.4rem; padding: .1rem .4rem;
border-radius: .3rem; font-size: .72rem; font-weight: 700;
font-variant-numeric: tabular-nums;
}
.ez-late.lv0 { background: #f8fafc; color: #94a3b8; }
.ez-late.lv1 { background: #fffbeb; color: #b45309; }
.ez-late.lv2 { background: #fef2f2; color: #dc2626; }
.ez-late.lv3 { background: #fde8e8; color: #991b1b; }
/* آدرس: حداکثر دو خط (بدون شکستن چیدمان) */
.ez-addr {
display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical;
overflow: hidden; text-align: right; font-size: .78rem; color: #475569;
}
/* ---------- حالت کارت (موبایل) ---------- */
.ez-only-desktop { display: none !important; }
@media (max-width: 899px) {
.ez-table thead { display: none; }
.ez-table, .ez-table tbody, .ez-table tr, .ez-table td { display: block; width: 100%; }
.ez-table tbody tr {
display: flex; flex-wrap: wrap; align-items: baseline;
background: #fff; border: 1px solid #e5e7eb; border-radius: .625rem;
margin-bottom: .5rem; padding: .55rem .7rem;
}
.ez-table tbody tr:hover td { background: transparent; }
.ez-table tbody td {
flex: 1 0 100%; display: flex; flex-wrap: wrap; align-items: baseline;
gap: .3rem; padding: .12rem 0; border: 0; text-align: right;
}
.ez-table tbody td::before {
content: attr(data-label); flex: 0 0 6.5rem;
font-size: .7rem; color: #94a3b8;
}
/* سرِ کارت: نام مشتری، بدون برچسب */
.ez-table tbody td.ez-card-head {
padding-bottom: .35rem; margin-bottom: .25rem;
border-bottom: 1px dashed #eef2f6;
}
.ez-table tbody td.ez-card-head::before,
.ez-table tbody td.ez-nolabel::before { content: none; }
.ez-actions { flex: 1 0 100%; display: flex; gap: .35rem; margin-top: .4rem; }
.ez-actions .button { margin: 0 !important; flex: 1 1 0; }
.ez-addr { -webkit-line-clamp: 3; }
.ez-legend { font-size: .7rem; }
}
@media (min-width: 900px) {
.ez-table thead { display: table-header-group; }
.ez-table tbody { display: table-row-group; }
.ez-table tr { display: table-row; }
.ez-table td { display: table-cell; }
.ez-table td::before { content: none; }
.ez-only-desktop { display: table-cell !important; }
.ez-only-mobile { display: none !important; }
.ez-actions { display: none; }
}
</style>
<div class="ez-wrap">
<div class="columns m-0">
<div class="column is-12 p-0">
{# ===== نوار آمار: چهار کارت، هر عدد لینک فیلتر ===== #}
<div class="ez-stats-head">
<p class="ez-stats-title">وضعیت پیگیری مشتریان</p>
<p class="ez-stats-hint">
«عقب‌افتاده» یعنی از آخرین بازدید
<b>بیش از {{ counts.period_months }} ماه</b> گذشته باشد.
روی هر کارت بزنید تا فقط همان گروه نمایش داده شود؛
<b>کل = تعیین‌تکلیف‌نشده + تعیین‌تکلیف‌شده</b>.
</p>
</div>
<div class="ez-stats">
{# کارت «نیازمند پیگیری امروز» — مستقل از «عقب‌افتاده»؛ بازدیدها حذف می‌شوند. #}
<a href="{{ view_links.today }}"
class="ez-stat followup {% if view == followup_view %}is-active{% endif %}"
title="مشتریانی که موعد پیگیری/تماسشان امروز است و برایشان بازدید برنامه‌ریزی نشده">
<span class="ez-stat-top">
<span class="ez-lbl">نیازمند پیگیری امروز</span>
<span class="ez-num has-text-info">{{ counts.followup_today }}</span>
</span>
<span class="ez-desc">موعد تماسشان امروز است — بازدید ندارند</span>
</a>
<a href="{{ view_links.all }}"
class="ez-stat total {% if view == 'all' %}is-active{% endif %}"
title="همهٔ مشتریانی که بازدیدشان عقب افتاده، با هر وضعیت پیگیری">
<span class="ez-stat-top">
<span class="ez-lbl">همهٔ مشتریان عقب‌افتاده</span>
<span class="ez-num">{{ counts.total }}</span>
</span>
<span class="ez-desc">با هر وضعیت پیگیری</span>
</a>
<a href="{{ view_links.uncoordinated }}"
class="ez-stat danger {% if view == 'uncoordinated' %}is-active{% endif %}"
title="مشتریانی که هنوز هیچ وقت بازدید/پیگیری برایشان تعیین نشده است">
<span class="ez-stat-top">
<span class="ez-lbl">تعیین تکلیف نشده</span>
<span class="ez-num has-text-danger">{{ counts.uncoordinated }}</span>
</span>
<span class="ez-desc">هنوز وقت بازدید تعیین نشده — نیاز به تماس</span>
</a>
<a href="{{ view_links.coordinated }}"
class="ez-stat success {% if view == 'coordinated' %}is-active{% endif %}"
title="مشتریانی که وقت بازدید یا پیگیریِ بعدی برایشان تعیین شده است">
<span class="ez-stat-top">
<span class="ez-lbl">تعیین تکلیف شده</span>
<span class="ez-num has-text-success">{{ counts.coordinated }}</span>
</span>
<span class="ez-desc">وقت بعدی‌شان مشخص است</span>
</a>
</div>
{# ===== نوار تاریخ در نمای «نیازمند پیگیری» ===== #}
{% if is_followup_view %}
<div class="ez-datebar">
<a href="{{ followup_nav.prev }}" class="button is-small is-light"
title="روز قبل">‹ روز قبل</a>
<form method="get" class="ez-dateform">
<input type="hidden" name="view" value="{{ followup_view }}">
{% if searchVal %}<input type="hidden" name="searchVal" value="{{ searchVal }}">{% endif %}
{% if searchVal %}<input type="hidden" name="searchOn" value="{{ searchOn }}">{% endif %}
<label class="ez-datefield">
<span class="ez-filter-lbl">تاریخ پیگیری (شمسی)</span>
<span class="ez-datefield-row">
<input type="text" name="fdate" id="followupDatePicker"
value="{{ followup_date_jalali }}" class="input is-small ss02"
placeholder="۱۴۰۵/۰۸/۲۹" autocomplete="off" inputmode="numeric">
<button type="submit" class="button is-info is-small">نمایش</button>
</span>
</label>
</form>
<a href="{{ followup_nav.next }}" class="button is-small is-light"
title="روز بعد">روز بعد ›</a>
{% if not followup_nav.is_today %}
<a href="{{ followup_nav.today }}" class="button is-success is-light is-small">
بازگشت به امروز
</a>
{% endif %}
<span class="ez-datenote">
{% if followup_nav.is_today %}
فقط موعدهای <b>امروز</b> نمایش داده می‌شوند.
{% else %}
نمایش موعدهای <b>{{ followup_date_jalali }}</b> (نه امروز).
{% endif %}
مشتریانی که برایشان <b>بازدید</b> گذاشته شده در این فهرست نمی‌آیند.
</span>
{# هشدار مینیمال: موعدهایی که گذشته‌اند و هنوز تعیین تکلیف نشده‌اند. #}
{% if counts.followup_overdue and not show_missed %}
<a class="ez-overdue-alert"
href="{{ followup_overdue_link }}"
title="موعد پیگیری‌شان گذشته و هنوز تعیین تکلیف نشده‌اند — برای دیدن فهرستشان کلیک کنید">
<span class="ez-overdue-dot" aria-hidden="true"></span>
<b>{{ counts.followup_overdue }}</b> مورد نیازمند پیگیری از روزهای قبل باقی مانده
</a>
{% endif %}
{% if show_missed %}
<span class="ez-overdue-mode">
نمایش <b>{{ counts.followup_overdue }}</b> پیگیریِ عقب‌افتاده
<a href="{{ followup_ontime_link }}" title="بازگشت به فهرست امروز">✕ بازگشت به امروز</a>
</span>
{% endif %}
</div>
{% endif %}
{# ===== نوار فیلتر و جست‌وجو: یک ردیف، همهٔ کنترل‌ها ===== #}
<form class="ez-filters" method="get" action="">
{% if is_followup_view %}
<input type="hidden" name="fdate" value="{{ followup_date_jalali }}">
{% endif %}
{# حالت «فقط عقب‌افتاده‌ها» هنگام جست‌وجو/فیلتر حفظ شود. #}
{% if show_missed %}
<input type="hidden" name="missed" value="1">
{% endif %}
<label class="ez-filter">
<span class="ez-filter-lbl">نوع قرار</span>
<span class="select is-small">
<select name="view" class="ez-auto-submit">
<option value="today" {% if is_followup_view %}selected{% endif %}>نیازمند پیگیری (تاریخ انتخابی)</option>
<option value="all" {% if view == 'all' %}selected{% endif %}>همه (با و بدون قرار)</option>
<option value="uncoordinated" {% if view == 'uncoordinated' %}selected{% endif %}>تعیین تکلیف نشده</option>
<option value="coordinated" {% if view == 'coordinated' %}selected{% endif %}>تعیین تکلیف شده (همه)</option>
<option value="manual" {% if view == 'manual' %}selected{% endif %}>تعویق دستی</option>
<option value="scheduled" {% if view == 'scheduled' %}selected{% endif %}>بازدید برنامه‌ریزی‌شده</option>
<option value="coordination" {% if view == 'coordination' %}selected{% endif %}>پیگیری تلفنی</option>
</select>
</span>
</label>
{% if not is_followup_view %}
<label class="ez-filter">
<span class="ez-filter-lbl">میزان تأخیر</span>
<span class="select is-small">
<select name="delay" class="ez-auto-submit">
<option value="" {% if not delay %}selected{% endif %}>همه</option>
<option value="lt30" {% if delay == 'lt30' %}selected{% endif %}>تا ۳۰ روز ({{ counts.buckets.lt30 }})</option>
<option value="30to90" {% if delay == '30to90' %}selected{% endif %}>۳۰ تا ۹۰ روز ({{ counts.buckets.30to90 }})</option>
<option value="90to180" {% if delay == '90to180' %}selected{% endif %}>۹۰ تا ۱۸۰ روز ({{ counts.buckets.90to180 }})</option>
<option value="gt180" {% if delay == 'gt180' %}selected{% endif %}>بیش از ۶ ماه ({{ counts.buckets.gt180 }})</option>
</select>
</span>
</label>
{% endif %}
<label class="ez-filter">
<span class="ez-filter-lbl">مرتب‌سازی</span>
<span class="select is-small">
<select name="sort" class="ez-auto-submit">
<option value="last_visit" {% if sort == 'last_visit' and sort_dir == 'asc' %}selected{% endif %}>قدیمی‌ترین بازدید</option>
<option value="last_visit-desc" {% if sort == 'last_visit' and sort_dir == 'desc' %}selected{% endif %}>جدیدترین بازدید</option>
<option value="overdue" {% if sort == 'overdue' %}selected{% endif %}>بیشترین تأخیر</option>
<option value="name" {% if sort == 'name' %}selected{% endif %}>نام (الفبا)</option>
<option value="status" {% if sort == 'status' %}selected{% endif %}>وضعیت قرار</option>
<option value="coordination" {% if sort == 'coordination' %}selected{% endif %}>تاریخ پیگیری</option>
</select>
</span>
</label>
<label class="ez-filter ez-filter-grow">
<span class="ez-filter-lbl">جست‌وجو</span>
<span class="ez-search">
<input type="text" name="searchVal" value="{{ searchVal }}"
class="input is-small" placeholder="نام، تلفن، کد یا آدرس">
<span class="select is-small">
<select name="searchOn">
<option value="name" {% if searchOn == 'name' %}selected{% endif %}>نام</option>
<option value="phone" {% if searchOn == 'phone' %}selected{% endif %}>تلفن</option>
<option value="code" {% if searchOn == 'code' %}selected{% endif %}>کد</option>
<option value="address" {% if searchOn == 'address' %}selected{% endif %}>آدرس</option>
</select>
</span>
<button type="submit" class="button is-info is-small">جست‌وجو</button>
</span>
</label>
{% if has_filters %}
<a href="{{ clear_link }}" class="button is-light is-small ez-clear">✕ حذف فیلترها</a>
{% endif %}
</form>
{# تفکیک مدت تأخیر در نمای جاری (کلیک‌پذیر) #}
{% if not is_followup_view %}
<div class="ez-legend">
<span>میزان تأخیر در همین نما:</span>
<a href="{{ delay_links.ez_all }}" class="{% if not delay %}is-active{% endif %}">
<b>{{ counts.view_total }}</b> همه
</a>
<a href="{{ delay_links.lt30 }}" class="{% if delay == 'lt30' %}is-active{% endif %}">
<b>{{ counts.buckets.lt30 }}</b> تا ۳۰ روز
</a>
<a href="{{ delay_links.30to90 }}" class="{% if delay == '30to90' %}is-active{% endif %}">
<b>{{ counts.buckets.30to90 }}</b> ۳۰ تا ۹۰ روز
</a>
<a href="{{ delay_links.90to180 }}" class="{% if delay == '90to180' %}is-active{% endif %}">
<b>{{ counts.buckets.90to180 }}</b> ۹۰ تا ۱۸۰ روز
</a>
<a href="{{ delay_links.gt180 }}" class="{% if delay == 'gt180' %}is-active{% endif %}">
<b>{{ counts.buckets.gt180 }}</b> بیش از ۶ ماه
</a>
</div>
{% endif %}
<div class="table-container">
<table class="table has-text-centered is-bordered is-striped is-narrow is-hoverable is-fullwidth">
<!-- Your table content -->
<table class="table ez-table">
<colgroup>
{% for col in table_columns %}
<col style="width: {{ col.width }}%">
{% endfor %}
</colgroup>
<thead>
<tr style="
background: #33b5d3;
">
<th >ردیف</th>
<th style="min-width: 200px;">نام و نام خانودگی</th>
<th >آخرین بازدید</th>
<th >تلفن</th>
<th style="min-width: 400px;">آدرس</th>
<tr>
{% for col in sort_header %}
<th class="ez-th {% if col.active %}is-sorted{% endif %}">
<a href="{{ col.link }}" title="مرتب‌سازی بر اساس {{ col.label }}">
{{ col.label }}<span class="ez-arrow">{% if col.active %}{% if col.dir == 'asc' %}▲{% else %}▼{% endif %}{% else %}⇅{% endif %}</span>
</a>
</th>
{% endfor %}
</tr>
</thead>
<tbody>
{% for customer in customers %}
<tr>
<td>{{ forloop.counter }}</td>
<td>
{# سرِ ردیف: چیپ شماره + نام (شمارهٔ ردیف دیگر ستون جداگانه ندارد) #}
<td data-label="نام" class="ez-card-head" style="text-align: right;">
<input class="is-hidden fid fidv-20" value="20">
<a target="_blank" href="{% url 'admin_panel:customerAction' customer.id %}" class="tdvl name">
{% if customer.name_family|length >= 2 %} {{ customer.name_family }} {% else %} نامعلوم {% endif %}
<span class="ez-idx">{{ forloop.counter0|add:customers.start_index }}</span>
<a target="_blank" href="{% url 'admin_panel:customerAction' customer.id %}" class="tdvl name ez-name">
{% if customer.name_family|length >= 2 %}{{ customer.name_family }}{% else %}نامعلوم{% endif %}
</a>
{% if customer.idCode %}<div class="ez-sub">کد: {{ customer.idCode }}</div>{% endif %}
</td>
<td>
<div class="tdvl lastView">
{{ customer.last_bazdid_dt | toJalali }}
</div>
{% with appt=appointment_rows|row_for:customer.id %}
<td data-label="وضعیت" class="ez-nolabel">
{% if appt.source_count > 1 %}
<span class="ez-badge mixed">{{ appt.source_count }} قرار</span>
{% elif appt.manual %}
<span class="ez-badge warning">قرار دستی</span>
{% elif appt.scheduled %}
<span class="ez-badge success">بازدید برنامه</span>
{% elif appt.coordination %}
<span class="ez-badge coordination">هماهنگی</span>
{% else %}
<span class="ez-badge danger">بدون قرار</span>
{% endif %}
</td>
<td data-label="قرار دستی" class="ez-num ez-nowrap">
{% if appt.manual %}{{ appt.manual|toJalali }}{% else %}<span class="ez-muted">—</span>{% endif %}
</td>
<td data-label="بازدید برنامه" class="ez-num ez-nowrap">
{% if appt.scheduled %}{{ appt.scheduled|toJalali }}{% else %}<span class="ez-muted">—</span>{% endif %}
</td>
<td data-label="هماهنگی" class="ez-num ez-nowrap">
{% if appt.coordination %}{{ appt.coordination|toJalali }}{% else %}<span class="ez-muted">—</span>{% endif %}
</td>
<td data-label="آخرین بازدید" class="ez-num ez-nowrap lastView">
{% if appt.last_visit %}{{ appt.last_visit|toJalali }}{% else %}<span class="ez-muted">بدون بازدید</span>{% endif %}
</td>
{% if 'overdue' not in hidden_columns %}
<td data-label="تأخیر" class="ez-nowrap">
{% if appt.overdue_days >= 180 %}
<span class="ez-late lv3">{{ appt.overdue_days }} روز</span>
{% elif appt.overdue_days >= 90 %}
<span class="ez-late lv2">{{ appt.overdue_days }} روز</span>
{% elif appt.overdue_days >= 30 %}
<span class="ez-late lv1">{{ appt.overdue_days }} روز</span>
{% else %}
<span class="ez-late lv0">{{ appt.overdue_days }} روز</span>
{% endif %}
</td>
{% endif %}
{% endwith %}
<td>
<div class="tdvl mobile_1">
{{ customer.phone1 }}
</div>
<div class="tdvl is-hidden mobile_2">
09384999655
</div>
<div class="tdvl is-hidden mobile_3">
{{ customer.phone2 }}
<td data-label="تلفن" class="ez-nowrap">
<span class="tdvl mobile_1 ez-phone">
{% if customer.phone1 %}{{ customer.phone1 }}{% else %}<span class="ez-muted">—</span>{% endif %}
</span>
<span class="tdvl is-hidden mobile_2">{{ customer.phone2 }}</span>
<span class="tdvl is-hidden mobile_3">{{ customer.phone3 }}</span>
{# دکمه‌های اقدام سریع — فقط موبایل #}
<div class="ez-actions">
{% if customer.phone1 %}
<a href="tel:{{ customer.phone1 }}" class="button is-success is-small">تماس</a>
{% endif %}
<a target="_blank" href="{% url 'admin_panel:customerAction' customer.id %}" class="button is-info is-small">ثبت اقدام</a>
</div>
</td>
<td>
<div class="tdvl address">
{{ customer.address }}
</div>
<td data-label="آدرس">
<div class="tdvl address ez-addr" title="{{ customer.address }}">{{ customer.address }}</div>
</td>
</tr>
{% empty %}
<tr>
<td colspan="{{ column_count }}" class="has-text-centered py-5">
<span class="has-text-grey">
{% if is_followup_view %}
برای تاریخ {{ followup_date_jalali }} موردی برای پیگیری نیست.
{% else %}
موردی در این نما پیدا نشد.
{% endif %}
</span>
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
<div class="">
{# ===== صفحه‌بندی ===== #}
<div class="is-flex is-align-items-center is-justify-content-space-between mt-3 mb-5">
{% if customers.has_previous %}
<a class="button is-danger" href="?{% if searchVal %}searchVal={{ searchVal }}&searchOn={{ searchOn }}{% endif %}&page={{ customers.previous_page_number }}">صفحه قبل</a>
{% endif %}
<a class="button is-danger is-small" href="{{ page_prev }}">صفحه قبل</a>
{% else %}<span></span>{% endif %}
<span class="is-size-7 has-text-grey">
صفحهٔ {{ customers.number }} از {{ customers.paginator.num_pages }} ·
{{ customers.paginator.count }} مورد
</span>
{% if customers.has_next %}
<a class="button is-danger" href="?{% if searchVal %}searchVal={{ searchVal }}&searchOn={{ searchOn }}{% endif %}&page={{ customers.next_page_number }}">صفحه بعد</a>
{% endif %}
<a class="button is-danger is-small" href="{{ page_next }}">صفحه بعد</a>
{% else %}<span></span>{% endif %}
</div>
</div>
</div>
</div>
</div>
<div class="modal SearchBox">
<div class="modal-background closeSearch"></div>
<div class="modal-content">
<!-- -->
<form method="get" class="columns is-mobile is-multiline">
<div class="field column is-7-desktop is-12-mobile m-0">
<label class="label">جستجو کنید</label>
<div class="control">
<input name="searchVal" class="input search" type="text" placeholder="">
</div>
</div>
<div class="field column is-5-desktop is-12-mobile m-0">
<label class="label">فیلد</label>
<div class="select">
<select name="searchOn">
<!--
<option value="name">نام و نام خانوادگی</option>
<option value="code">کدمشتری</option>
<option value="phone">تلفن</option> !-->
<option value="address">آدرس</option>
</select>
</div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<input class="button is-success" id="searchbtn" value="جستجو مشتری" type="submit">
</div>
<!-- -->
</form>
</div>
<button class="modal-close is-large closeSearch" aria-label="close"></button>
</div>
<div class="modal BazdidF">
<div class="modal-background closeBazdidF"></div>
<div class="modal-content">
<div class="columns is-mobile is-multiline">
<div class="field column is-12-desktop is-12-mobile m-0">
<label class="label">نام ونام خانوادگی</label>
<div class="control">
<input class="input rf_name" id="bz_name" type="text" placeholder="نام نام خانوادگی">
</div>
</div>
<div class="field column is-4-desktop is-12-mobile m-0">
<label class="label">تلفن همراه</label>
<div class="control">
<input class="input rf_mobile" id="phone-1" type="text" placeholder="">
</div>
</div>
<div class="field column is-4-desktop is-12-mobile m-0">
<label class="label">تاریخ</label>
<div class="control">
<input name="bazdidDateTime" id="persianDateP" class="input bz_DateTime" type="text" placeholder="">
</div>
</div>
<div class="field column is-4-desktop is-12-mobile m-0">
<label class="label">توسط</label>
<div class="select">
<select>
<option>کدام خدمات؟</option>
<option>خدمات 1</option>
<option>خدمات 2</option>
<option>خدمات 3</option>
</select>
</div>
</div>
<div class="field column is-4-desktop is-12-mobile m-0">
<label class="label">زمان مراجعه</label>
<div class="select">
<select>
<option>زمان را انتخاب کنید</option>
<option>صبح</option>
<option>ظهر</option>
<option>بعد از ظهر</option>
<option>غروب</option>
<option>شب</option>
</select>
</div>
</div>
<div class="field column is-8-desktop is-12-mobile m-0">
<label class="label">توضیحات</label>
<div class="control">
<textarea class="textarea" placeholder="توضیحات"></textarea> </div>
</div>
<div class="field column is-12-desktop is-12-mobile m-0">
<input class="button is-success" id="editCS" value="ایجاد بازدید" type="submit">
</div>
</div>
</div>
<button class="modal-close is-large closeBazdidF" aria-label="close"></button>
</div>
{% endblock %}
{% block jsEnd %}
<script>
$(document).ready(function() {
kamaDatepicker('persianDateP', { buttonsColor: "red", forceFarsiDigits: true });
$(".closeBazdidF").click(function(){
$(".BazdidF").removeClass("is-active")
// تغییر هر دراپ‌داون ⇒ ارسال خودکار فرم فیلترها.
$(".ez-auto-submit").on('change', function () {
$(this).closest('form').trigger('submit');
});
$("#openSearchBox").click(function(){
$(".SearchBox").addClass("is-active")
// مقدار «مرتب‌سازی» با علامتِ جهت ترکیب می‌شود (مثلاً last_visit-desc)
// تا یک دراپ‌داون بتواند هر دو جهت را پوشش دهد.
$(".ez-filters select[name=sort]").on('change', function () {
var value = $(this).val() || '';
var form = $(this).closest('form');
var dash = value.lastIndexOf('-');
if (dash > -1) {
form.find("input[name=sort]").val(value.slice(0, dash));
form.find("input[name=dir]").val(value.slice(dash + 1));
} else {
form.find("input[name=sort]").val(value);
form.find("input[name=dir]").val('');
}
});
$(".closeSearch").click(function(){
$(".SearchBox").removeClass("is-active")
// تقویم شمسی برای ناوبری روزهای نمای «نیازمند پیگیری».
// همان کامپوننت pDatepicker که در بقیهٔ صفحه‌ها استفاده شده است.
{% if is_followup_view %}
var $followupDate = $("#followupDatePicker");
if ($followupDate.length && typeof $followupDate.pDatepicker === 'function') {
$followupDate.pDatepicker({
initialValue: false,
initialValueType: 'persian',
format: 'YYYY/MM/DD',
autoClose: true,
calendar: {
persian: { locale: 'fa', leapYearMode: 'astronomical' }
},
onSelect: function () {
// انتخاب تاریخ ⇒ فوراً همان روز نمایش داده شود.
$followupDate.closest('form').trigger('submit');
}
});
$(".openRow").click(function(){
var id = $(this).parent().parent().find('.fid').val().trim();
var name = $(this).parent().parent().find('.name').text().trim();
var mobile_1 = $(this).parent().parent().find('.mobile_1').text().trim();
var address = $(this).parent().parent().find('.address').text().trim();
//alert(id)
$(".BazdidF").find('#bz_name').val(name);
$(".BazdidF").find('#phone-1').val(mobile_1);
//$("#bedehiStatus").val('وضعیت')
$(".BazdidF").addClass("is-active")
});
} );
}
{% endif %}
});
</script>
{% endblock %}
@@ -12,6 +12,9 @@
حذف یک مورد، فقط همان نوبت را کنسل می‌کند. یادآوری‌های دوره‌ای (بازدید و ثبت
اطلاعات چک) در <strong>دورهٔ بعدی</strong> دوباره ساخته می‌شوند؛ پس با حذف یک
مورد، پیامک برای آن مشتری برای همیشه قطع نمی‌شود.
<br>
پیامک‌های <strong>ارسال‌شده</strong> از این صف بیرون می‌روند؛ فهرست و سابقهٔ
کامل‌شان در <a href="{% url 'admin_panel:sms_report' %}">گزارش ارسال</a> است.
</div>
<div class="columns is-multiline mb-2" dir="rtl">
@@ -21,6 +24,13 @@
<p class="title is-5 mb-0">{{ total_count }}</p>
</div>
</div>
<div class="column is-narrow">
<a href="{% url 'admin_panel:sms_report' %}" class="box py-3 px-4 has-text-centered"
title="مشاهدهٔ سوابق ارسال‌شده‌ها در گزارش ارسال">
<p class="heading mb-0">ارسال‌شده (در گزارش)</p>
<p class="title is-5 mb-0 has-text-success">{{ sent_count }}</p>
</a>
</div>
{% for code, label, count in status_stats %}
<div class="column is-narrow">
<a href="?status={{ code }}" class="box py-3 px-4 has-text-centered"
@@ -71,11 +81,12 @@
</form>
<div class="notification is-danger is-light is-flex is-align-items-center is-justify-content-space-between mb-3">
<span>خالی کردن کل صف: همهٔ پیامک‌ها (در هر وضعیتی) حذف می‌شوند و دیگر بازنمی‌گردند.</span>
<span>خالی کردن صف: همهٔ موارد باقی‌مانده (در انتظار تأیید، تأییدشده، در حال پردازش و ناموفق)
حذف می‌شوند و دیگر بازنمی‌گردند. پیامک‌های ارسال‌شده دست‌نخورده می‌مانند (در گزارش ارسال).</span>
<form method="post" action="{% url 'admin_panel:sms_queue_empty' %}"
onsubmit="return confirm('کل صف پیامک خالی شود؟ این پیامک‌ها دیگر هرگز ارسال یا بازسازی نمی‌شوند.');">
onsubmit="return confirm('صف پیامک خالی شود؟ این پیامک‌ها دیگر هرگز ارسال یا بازسازی نمی‌شوند.');">
{% csrf_token %}
<button class="button is-danger" type="submit">خالی کردن کل صف</button>
<button class="button is-danger" type="submit">خالی کردن صف</button>
</form>
</div>
@@ -119,11 +130,17 @@
<button class="button is-small is-warning" type="submit">ارسال مجدد</button>
</form>
{% endif %}
{% if item.status != 'sent' %}
<form method="post" action="{% url 'admin_panel:sms_queue_delete' item.id %}"
onclick="return confirm('این پیامک از صف حذف شود؟');">
{% csrf_token %}
<button class="button is-small is-danger" type="submit">حذف</button>
</form>
{% else %}
<a class="button is-small is-light"
href="{% url 'admin_panel:sms_report' %}?q={{ item.phone_number }}"
title="این پیامک ارسال شده است؛ سابقهٔ آن در گزارش ارسال است">در گزارش</a>
{% endif %}
</div>
</td>
</tr>
@@ -0,0 +1,189 @@
{% extends "./base.html" %}
{% load custom_tags %}
{% block bodyPage %}
<div class="container mt-5" dir="rtl">
<h1 class="title is-4">گزارش ارسال پیامک</h1>
<p class="has-text-grey mb-3">
پیامک‌های <strong>تأییدشده و ارسال‌شده</strong> (موارد «در انتظار تأیید» و «لغو‌شده»
در این گزارش نمی‌آیند) به‌همراه «تعداد پیامکی که اپراتور محاسبه کرده»
(بر اساس کدگذاری GSM-7 برای انگلیسی/عدد و UCS-2 برای فارسی/یونیکد) — برای تحلیل هزینه.
</p>
{# --- کارت‌های خلاصه (روی کل نتیجهٔ فیلترشده) --- #}
<div class="columns is-multiline mb-2">
<div class="column is-narrow">
<div class="box py-3 px-4 has-text-centered">
<p class="heading mb-0">تعداد پیامک (رکورد)</p>
<p class="title is-5 mb-0">{{ total_records }}</p>
</div>
</div>
<div class="column is-narrow">
<div class="box py-3 px-4 has-text-centered">
<p class="heading mb-0">مجموع پیامک محاسبه‌شده</p>
<p class="title is-5 mb-0 has-text-danger">{{ total_parts }}</p>
</div>
</div>
<div class="column is-narrow">
<div class="box py-3 px-4 has-text-centered">
<p class="heading mb-0">GSM-7 / UCS-2</p>
<p class="title is-6 mb-0">{{ gsm7_parts }} / {{ ucs2_parts }}</p>
</div>
</div>
{% for code, label, count in status_stats %}
<div class="column is-narrow">
<a href="?status={{ code }}" class="box py-3 px-4 has-text-centered"
{% if status == code %}style="border:2px solid #3273dc"{% endif %}>
<p class="heading mb-0">{{ label }}</p>
<p class="title is-5 mb-0">{{ count }}</p>
</a>
</div>
{% endfor %}
</div>
{# --- فرم فیلتر --- #}
<form method="get" class="box">
<div class="columns is-multiline is-variable is-2">
<div class="column is-2">
<label class="label is-small">از تاریخ (شمسی)</label>
<input class="input" type="text" id="dateFromP" name="date_from"
value="{{ date_from }}" placeholder="1404/01/01" autocomplete="off">
</div>
<div class="column is-2">
<label class="label is-small">تا تاریخ (شمسی)</label>
<input class="input" type="text" id="dateToP" name="date_to"
value="{{ date_to }}" placeholder="1404/12/29" autocomplete="off">
</div>
<div class="column is-2">
<label class="label is-small">وضعیت ارسال</label>
<div class="select is-fullwidth">
<select name="status">
<option value="">همه</option>
{% for value, label in status_choices %}
<option value="{{ value }}" {% if status == value %}selected{% endif %}>{{ label }}</option>
{% endfor %}
</select>
</div>
</div>
<div class="column is-2">
<label class="label is-small">وضعیت تحویل</label>
<div class="select is-fullwidth">
<select name="delivery">
<option value="">همه</option>
{% for value, label in delivery_choices %}
<option value="{{ value }}" {% if delivery == value %}selected{% endif %}>{{ label }}</option>
{% endfor %}
</select>
</div>
</div>
<div class="column is-2">
<label class="label is-small">نوع پیامک</label>
<div class="select is-fullwidth">
<select name="sms_type">
<option value="">همه</option>
{% for value, label in type_choices %}
<option value="{{ value }}" {% if sms_type == value %}selected{% endif %}>{{ label }}</option>
{% endfor %}
</select>
</div>
</div>
<div class="column is-2">
<label class="label is-small">جستجو (متن/شماره/نام مشتری)</label>
<input class="input" type="text" name="q" value="{{ query }}" placeholder="جستجو…">
</div>
</div>
<div class="buttons">
<button class="button is-link" type="submit">اعمال فیلتر</button>
{% if has_filter %}
<a class="button is-light" href="{% url 'admin_panel:sms_report' %}">حذف فیلترها</a>
{% endif %}
</div>
</form>
{# --- جدول --- #}
<div class="table-container">
<table class="table is-fullwidth is-narrow is-hoverable is-striped is-bordered">
<thead>
<tr>
<th>شناسه</th>
<th style="min-width: 16rem;">متن دقیق پیامک</th>
<th style="min-width: 8rem;">شماره گیرنده</th>
<th>نوع پیامک</th>
<th style="min-width: 8rem;">مشتری</th>
<th>سوابق</th>
<th>تعداد پیامک</th>
<th>وضعیت ارسال</th>
<th>تحویل</th>
<th style="min-width: 8rem;">تاریخ ایجاد</th>
<th style="min-width: 8rem;">تاریخ ارسال</th>
</tr>
</thead>
<tbody>
{% for row in rows %}
<tr>
<td>{{ row.item.id }}</td>
<td class="smsrep-msg">{{ row.item.message }}</td>
<td dir="ltr">{{ row.item.phone_number }}</td>
<td>{{ row.item.get_sms_type_display|default:'دستی/سفارشی' }}</td>
<td>
{% if row.item.customer_id %}
<a href="{% url 'admin_panel:customer' row.item.customer_id %}">{{ row.item.customer.name_family }}</a>
{% else %}—{% endif %}
</td>
<td>
{% if row.item.customer_id %}
<a class="button is-small is-light"
href="{% url 'admin_panel:customerSmsHistory' row.item.customer_id %}"
title="مشاهدهٔ سوابق پیامک این مشتری">سوابق پیامک</a>
{% else %}—{% endif %}
</td>
<td class="has-text-centered">
<span class="tag {% if row.parts > 1 %}is-danger{% else %}is-success{% endif %} is-light"
title="{{ row.encoding }} · {{ row.length }} واحد">{{ row.parts }}</span>
</td>
<td>{{ row.item.get_status_display }}</td>
<td>{{ row.item.get_delivery_status_display|default:'—' }}</td>
<td>{{ row.item.created_at|toJalaliDT }}</td>
<td>{{ row.item.sent_at|toJalaliDT|default:'—' }}</td>
</tr>
{% empty %}
<tr><td colspan="11" class="has-text-centered">پیامکی با این شرایط یافت نشد.</td></tr>
{% endfor %}
</tbody>
</table>
</div>
{% if page.has_other_pages %}
<nav class="pagination is-centered" role="navigation" aria-label="pagination">
{% if page.has_previous %}
<a class="pagination-previous" href="?{{ base_query }}&page={{ page.previous_page_number }}">قبلی</a>
{% else %}<a class="pagination-previous" disabled>قبلی</a>{% endif %}
{% if page.has_next %}
<a class="pagination-next" href="?{{ base_query }}&page={{ page.next_page_number }}">بعدی</a>
{% else %}<a class="pagination-next" disabled>بعدی</a>{% endif %}
<ul class="pagination-list">
<li><span class="pagination-link">صفحهٔ {{ page.number }} از {{ page.paginator.num_pages }}</span></li>
</ul>
</nav>
{% endif %}
</div>
{% endblock %}
{% block cssEnd %}
<style>
/* متن پیامک با حفظ شکست خطوط و شکستن متن‌های طولانی/بدون‌فاصله */
.smsrep-msg { white-space: pre-wrap; overflow-wrap: anywhere; max-width: 26rem; line-height: 1.9; }
</style>
{% endblock %}
{% block jsEnd %}
<script>
(function () {
if (typeof kamaDatepicker !== 'function') { return; }
var opts = { buttonsColor: "red", forceFarsiDigits: true, sync: true };
['dateFromP', 'dateToP'].forEach(function (id) {
if (document.getElementById(id)) { kamaDatepicker(id, opts); }
});
})();
</script>
{% endblock %}
@@ -7,6 +7,13 @@
<div class="box">
<form method="post" action="{% url 'admin_panel:sms_settings' %}">
{% csrf_token %}
<h2 class="title is-5">اتصال به سامانه پیامک</h2>
<p class="help mb-3">
این بخش مشخص می‌کند پیامک‌ها <strong>از چه مسیری و با چه حساب کاربری</strong> به
اپراتور سپرده می‌شوند. تا وقتی «وضعیت ارسال» روشن نباشد، هیچ‌کدام از سرویس‌های
پس‌زمینه (worker) پیامکی نمی‌فرستند.
</p>
<div class="columns is-multiline">
<div class="field column is-4-desktop is-12-mobile">
<label class="label">سرویس‌دهنده</label>
@@ -19,6 +26,19 @@
</select>
</div>
</div>
<p class="help">
<strong>مسیر فنی ارسال را تعیین می‌کند</strong> و روی بقیهٔ فیلدها اثر دارد:
<br>• <span dir="ltr">0098SMS (لینکی HTTP)</span>: ساده‌ترین حالت؛ درخواست به
آدرس <span dir="ltr">api_url</span> زده می‌شود. <strong>شناسهٔ پیامک برنمی‌گردد</strong>،
پس استعلام «تحویل به گوشی» ممکن نیست.
<br>• <span dir="ltr">0098SMS (وب‌سرویس)</span>: ارسال SOAP به
<span dir="ltr">webservice_url</span>؛ <strong>شناسهٔ پیامک (smsid)</strong> برمی‌گردد و
می‌توان وضعیت واقعی تحویل را استعلام کرد.
<br>• <span dir="ltr">HTTP عمومی</span>: برای سرویس‌های دلخواه؛ با
<span dir="ltr">api_token</span> احراز هویت می‌شود.
<br>• <span dir="ltr">Console</span>: فقط برای تست/دیباگ؛ پیامک واقعی نمی‌رود و
متن در لاگ چاپ می‌شود.
</p>
</div>
<div class="field column is-4-desktop is-12-mobile">
@@ -29,6 +49,11 @@
فعال باشد
</label>
</div>
<p class="help">
<strong>کلید اصلی خاموش/روشن ارسال.</strong> اگر تیک نخورد، سرویس worker هیچ
پیامکی نمی‌فرستد (ردیف‌ها در صف می‌مانند). اسکنر و صف‌کردن مستقل از این است،
پس می‌توانید پیامک‌ها را از قبل در صف بچینید و بعد ارسال را روشن کنید.
</p>
</div>
<div class="field column is-4-desktop is-12-mobile">
@@ -36,6 +61,13 @@
<div class="control">
<input class="input" type="number" name="timeout_seconds" value="{{ config.timeout_seconds }}">
</div>
<p class="help">
<strong>حداکثر زمان انتظار worker برای پاسخ سرویس‌دهنده</strong> در هر تلاش.
اگر پاسخ دیرتر بیاید، آن تلاش «ناموفق» ثبت می‌شود و بر اساس سیاست تلاش مجدد
دوباره در نوبت قرار می‌گیرد. مقدار کم (مثل ۵) ممکن است در سرویس کند، ارسال‌های
سالم را هم ناموفق کند؛ مقدار زیاد (مثل ۱۲۰) در قطعی سرویس، worker را بیکار
نگه می‌دارد. پیش‌فرض ۳۰ ثانیه متعادل است.
</p>
</div>
<div class="field column is-12-mobile">
@@ -44,9 +76,14 @@
<input class="input" type="text" name="api_url" value="{{ config.api_url }}" dir="ltr">
</div>
<p class="help">
برای 0098SMS همین آدرس لینکی ارسال است
<strong>آدرس درخواست ارسال برای providerهای «لینکی HTTP» و «HTTP عمومی».</strong>
<br>• برای 0098SMS لینکی همین آدرس است
(<span dir="ltr">http://www.0098sms.com/sendsmslink.aspx</span>)؛ این سرویس
WSDL/SOAP ندارد و آدرس WSDL باعث خطای «Invalid XML content» می‌شود.
WSDL/SOAP ندارد و اگر آدرس WSDL بگذارید خطای «Invalid XML content» می‌گیرید.
<br>• برای provider وب‌سرویس، این فیلد استفاده <strong>نمی‌شود</strong> (آن یکی
<span dir="ltr">webservice_url</span> را می‌خواند).
<br>• اگر آدرس اشتباه یا در دسترس نباشد، پیامک‌ها «ناموفق» می‌شوند و در صف تلاش
مجدد می‌خورند.
</p>
</div>
@@ -56,8 +93,9 @@
<input class="input" type="text" name="webservice_url" value="{{ config.webservice_url }}" dir="ltr">
</div>
<p class="help">
ارسال با شناسهٔ پیامک (<span dir="ltr">smsid</span>) و استعلام تحویل به گوشی
از همین آدرس انجام می‌شود. پیش‌فرض:
<strong>فقط وقتی provider = «وب‌سرویس» معنا دارد.</strong> هم ارسال با شناسهٔ
پیامک (<span dir="ltr">smsid</span>) و هم استعلام تحویل به گوشی از همین آدرس
انجام می‌شود. با providerهای دیگر این فیلد نادیده گرفته می‌شود. پیش‌فرض:
<span dir="ltr">https://webservice.0098sms.com/service.asmx</span>
</p>
</div>
@@ -67,7 +105,11 @@
<div class="control">
<input class="input" type="text" name="panel_no" value="{{ config.panel_no }}" dir="ltr">
</div>
<p class="help">اگر خالی بماند از «شماره خط فرستنده» استفاده می‌شود.</p>
<p class="help">
<strong>شمارهٔ اختصاصی حساب شما در وب‌سرویس</strong> (فقط provider وب‌سرویس).
اگر خالی بماند، سیستم از «شماره خط فرستنده» استفاده می‌کند. مقدار اشتباه باعث
رد شدن ارسال با خطای احراز هویت می‌شود.
</p>
</div>
<div class="field column is-4-desktop is-12-mobile">
@@ -75,6 +117,10 @@
<div class="control">
<input class="input" type="text" name="username" value="{{ config.username }}" dir="ltr">
</div>
<p class="help">
<strong>نام کاربری حساب سامانهٔ پیامک</strong> (در همهٔ providerها به‌جز Console
لازم است). اگر اشتباه باشد، ارسال‌ها رد می‌شوند و در «خطا» صف ثبت می‌گردد.
</p>
</div>
<div class="field column is-4-desktop is-12-mobile">
@@ -82,6 +128,11 @@
<div class="control">
<input class="input" type="password" name="password" placeholder="{% if config.password %}(بدون تغییر)‌{% endif %}" dir="ltr">
</div>
<p class="help">
<strong>رمز حساب سامانهٔ پیامک.</strong> برای امنیت، مقدار ذخیره‌شده بازخوانی
نمی‌شود؛ این کادر را <strong>خالی بگذارید</strong> تا رمز قبلی بماند و فقط وقتی
رمز عوض شده، مقدار جدید را وارد کنید.
</p>
</div>
<div class="field column is-4-desktop is-12-mobile">
@@ -89,6 +140,12 @@
<div class="control">
<input class="input" type="text" name="sender" value="{{ config.sender }}" dir="ltr">
</div>
<p class="help">
<strong>شماره یا عنوان خطی که پیامک با آن به دست مشتری می‌رسد.</strong> باید
جزو خطوط مجاز حساب شما باشد؛ در غیر این صورت اپراتور ارسال را رد می‌کند.
همچنین در provider وب‌سرویس، اگر «شمارهٔ پنل» خالی باشد همین مقدار جای آن
استفاده می‌شود.
</p>
</div>
<div class="field column is-12-mobile">
@@ -96,15 +153,23 @@
<div class="control">
<input class="input" type="password" name="api_token" placeholder="{% if config.api_token %}(بدون تغییر)‌{% endif %}" dir="ltr">
</div>
<p class="help">
<strong>کلید/توکن احراز هویت providerهای «HTTP عمومی».</strong> برای 0098SMS
لازم نیست. مثل رمز، خالی گذاشتن آن یعنی «بدون تغییر».
</p>
</div>
</div>
<hr>
<h2 class="title is-5">کنترل جریان ارسال</h2>
<p class="help mb-3">
برای جلوگیری از سیل پیامک: تنها مواردی ارسال می‌شوند که پنجرهٔ یادآوری‌شان از
«خط شروع» به بعد باز شود. موارد قدیمی‌تر تنها با روشن‌کردن «اجازهٔ موارد قدیمی»
و در سقف تعیین‌شده ارسال می‌شوند. بین هر پیامک هم فاصلهٔ زمانی رعایت می‌شود.
این بخش تعیین می‌کند اسکنر دوره‌ای <strong>چه چیزی و چقدر</strong> در هر اجرا در صف
بگذارد. اسکنر هر چند دقیقه یک‌بار اجرا می‌شود و بر اساس «سررسیدها» تصمیم می‌گیرد
کدام مشتری باید یادآوری بگیرد. منطق بودجه به این شکل است:
<strong>سقف هر اجرا</strong> ← تعیین می‌کند کلاً چند مورد صف شود؛
<strong>خط شروع</strong> ← موارد قدیمی‌تر از آن را کنار می‌گذارد؛
<strong>اجازهٔ موارد قدیمی + سقف آن</strong> ← تصمیم می‌گیرد از آن موارد کنارگذاشته‌شده
چند تا (اگر لازم بود) ارسال شود.
</p>
<div class="columns is-multiline">
@@ -116,9 +181,15 @@
placeholder="مثلاً 1403/07/18 — خالی = همین حالا" dir="ltr">
</div>
<p class="help">
فقط یادآوری‌هایی صف می‌شوند که «پنجرهٔ» آن‌ها از این تاریخ به بعد باز شده باشد.
مشتریان قدیمی‌تری که پنجره‌شان پیش از این تاریخ باز شده، وارد صف نمی‌شوند.
قالب: <span dir="ltr">YYYY/MM/DD</span> (شمسی) — خالی = همین حالا.
<strong>خط جداکنندهٔ «موارد جدید» از «موارد قدیمی».</strong>
هر مورد (چک، نسیه، بازدید) یک «لحظهٔ باز شدن پنجرهٔ یادآوری» دارد. اگر این
لحظه <strong>از این تاریخ به بعد</strong> باشد، مورد «جدید» است و آزادانه صف
می‌شود؛ اگر <strong>قبل از</strong> آن باشد، «قدیمی» (backlog) حساب می‌شود.
<br>• هدف اصلی: در نخستین راه‌اندازی، هزاران مشتری قدیمیِ واجد شرط یک‌باره پیامک
نگیرند.
<br>• قالب: <span dir="ltr">YYYY/MM/DD</span> شمسی — خالی = همین حالا.
<br>• عوض‌کردن آن به گذشته، مشتریان قدیمی‌تر را «جدید» می‌کند و ممکن است سیل پیامک
بسازد؛ با احتیاط تغییر دهید.
</p>
</div>
@@ -127,6 +198,19 @@
<div class="control">
<input class="input" type="number" min="0" name="max_per_run" value="{{ config.max_per_run }}">
</div>
<p class="help">
<strong>سقف کل صف‌کردن در یک اجرا — به‌ازای هر اسکنر جداگانه.</strong>
<br>• «هر اسکنر» یعنی این عدد برای هر نوع یادآوری مستقل اعمال می‌شود
(تأمین موجودی چک، سررسید نسیه، بازدید دورهای)؛ پس اگر ۱۰۰ باشد و هر سه اسکنر
واجد شرط باشند، در یک اجرا حداکثر ۱۰۰ + ۱۰۰ + ۱۰۰ = ۳۰۰ ردیف صف می‌شود.
<br>• شمارش از مجموع «جدیدها + موارد قدیمی» است، نه فقط جدیدها.
<br>• <strong>۰ = بی‌نهایت</strong> (هیچ سقفی اعمال نمی‌شود).
<br>• چون اسکنر دوره‌ای اجرا می‌شود، سقف باعث «دسته‌دسته» شدن ارسال‌های انبوه
می‌شود (بقیه در اجراهای بعدی می‌آیند) و از ریختن یک‌بارهٔ صدها پیامک روی ارسال
جلوگیری می‌کند.
<br>• نکته: این سقف‌ها روی «صف‌کردن» اثر دارند، نه سرعت ارسال واقعی؛ سرعت ارسال
به «فاصلهٔ بین هر پیامک» بستگی دارد.
</p>
</div>
<div class="field column is-3-desktop is-6-mobile">
@@ -134,6 +218,11 @@
<div class="control">
<input class="input" type="number" min="0" name="send_interval_seconds" value="{{ config.send_interval_seconds }}">
</div>
<p class="help">
<strong>مکث سرویس worker پس از هر ارسال</strong> تا اپراتور زیر بار زیاد نرود.
مثال: با مقدار ۳، ارسال ۱۰۰ پیامک حدود ۵ دقیقه طول می‌کشد. مقدار ۰ یعنی بدون
مکث (سریع ولی پرخطر — ممکن است سرویس‌دهنده محدودتان کند).
</p>
</div>
<div class="field column is-3-desktop is-6-mobile">
@@ -144,6 +233,12 @@
فعال باشد
</label>
</div>
<p class="help">
<strong>دربِ موارد «قدیمی‌تر از تاریخ شروع دوره».</strong> به‌صورت پیش‌فرض بسته
است. تا وقتی بسته باشد، موارد قدیمی <strong>هرگز</strong> صف نمی‌شوند (حتی اگر
سقف باقی باشد). اگر لازم بود این موارد هم پردازش شوند، آن را روشن کنید و مقدار
«حداکثر موارد قدیمی در هر اجرا» را تعیین کنید.
</p>
</div>
<div class="field column is-3-desktop is-6-mobile">
@@ -151,7 +246,15 @@
<div class="control">
<input class="input" type="number" min="0" name="backlog_max" value="{{ config.backlog_max }}">
</div>
<p class="help">صفر = هیچ مورد قدیمی ارسال نمی‌شود.</p>
<p class="help">
<strong>سقف ارسال موارد قدیمی در هر اجرا، به‌ازای هر اسکنر.</strong>
<br>• فقط وقتی «اجازهٔ ارسال موارد قدیمی» روشن باشد اثر دارد.
<br>• صفر = هیچ مورد قدیمی ارسال نمی‌شود (حتی با روشن‌بودن کلید).
<br>• این سقف <strong>در کنار</strong> «حداکثر پیامک هر اسکنر» اعمال می‌شود؛ پس
ممکن است ابتدا سقف کل (max_per_run) پر شود.
<br>• برای پاک‌کردن تدریجی انبار قدیمی، عدد کوچکی مثل ۵۰ بگذارید تا در هر اجرا
دسته‌ای ارسال شود.
</p>
</div>
</div>
+28
View File
@@ -20,6 +20,34 @@ def toJalaliDT(value):
def has_group(user, group_name):
return user.groups.filter(name=group_name).exists()
def row_for(mapping, key):
"""مقدار یک نگاشت با کلید دلخواه (برای دسترسی به دیکشنری در قالب).
``{{ appointment_rows|row_for:customer.id }}`` ⇒ مقدار مربوط به همان مشتری،
یا ``None`` اگر نبود. (جایگزین سبکِ ``.get()`` در قالب‌های Django.)
"""
if not mapping:
return None
try:
return mapping.get(key)
except AttributeError:
return None
@register.simple_tag
def customer_phones(customer):
"""شماره‌های مشتری برای ستون اطلاعات مشتری.
قبلاً این داده فقط از context view می‌آمد و صفحاتی که آن را پاس نمی‌دادند
«شماره‌ای ثبت نشده» نشان می‌دادند؛ حالا از خودِ شیء ``customer`` استخراج
می‌شود تا هر صفحه‌ای که این ستون را رندر می‌کند یکسان باشد.
"""
if not getattr(customer, 'pk', None):
return []
from admin_panel.sms.phones import customer_phone_entries
return customer_phone_entries(customer)
register.filter('has_group', has_group)
register.filter('toJalali', toJalali)
register.filter('toJalaliDT', toJalaliDT)
register.filter('row_for', row_for)
+3
View File
@@ -37,6 +37,7 @@ urlpatterns = [
path('customer/<int:c_id>/nazar/', views.customerNazar, name='customerNazar'),
path('customer/<int:c_id>/action/new', views.customerNewAction, name='customerNewAction'),
path('customer/<int:c_id>/action/<int:action_id>/edit', views.customerEditAction, name='customerEditAction'),
path('customer/<int:c_id>/action/<int:action_id>/delete', views.customerActionDelete, name='customerActionDelete'),
path('customer/<int:c_id>/del', views.customerDel, name='customerDel'),
path('customer/<int:c_id>/factors/', views.customerFactors, name='customerFactors'),
path('customer/<int:c_id>/factor/<int:f_id>', views.customerFactor, name='customerFactor'),
@@ -81,6 +82,7 @@ urlpatterns = [
path('pardakhtNesiye/<int:cs_id>', views.pardakhtNesiye, name='pardakhtNesiye'),
# === مدیریت پیامک ===
path('customer/<int:c_id>/sms/', views.customer_sms_history, name='customerSmsHistory'),
path('sms/settings', views.sms_settings, name='sms_settings'),
path('sms/templates', views.sms_templates, name='sms_templates'),
path('sms/template/<int:t_id>/edit', views.sms_template_edit, name='sms_template_edit'),
@@ -88,6 +90,7 @@ urlpatterns = [
path('sms/customer/<int:c_id>/primary', views.sms_primary_toggle, name='sms_primary_toggle'),
path('sms/customer/<int:c_id>/send', views.sms_send_custom, name='sms_send_custom'),
path('sms/queue', views.sms_queue, name='sms_queue'),
path('sms/report', views.sms_report, name='sms_report'),
path('sms/queue/bulk', views.sms_queue_bulk, name='sms_queue_bulk'),
path('sms/queue/empty', views.sms_queue_empty, name='sms_queue_empty'),
path('sms/queue/<int:q_id>/approve', views.sms_queue_approve, name='sms_queue_approve'),
+331 -78
View File
@@ -1,12 +1,24 @@
import datetime
from django.core.exceptions import ValidationError
from django.db.models import Q
from django.shortcuts import render, redirect, get_object_or_404
from django.http import HttpResponse
from django.contrib import messages
from django.contrib.auth.models import User
from django.contrib.auth.decorators import login_required
from django.utils import timezone
from persiantools.jdatetime import JalaliDate
from ..models import Action, Customer
from ..sms.triggers import notify_install_scheduled, notify_visit_scheduled
from ..visit_policy import (REASON_CANCEL, REASON_CREATE, REASON_EDIT,
ActionDeleteError, as_aware,
cancel_pending_sms_for_action, clear_visit_hold,
default_hold_until, normalize_finish_datetime,
normalize_hold_until, refresh_last_bazdid,
set_visit_hold, soft_delete_action,
validate_action_payload)
@login_required(login_url='/panel/p_login/')
@@ -18,8 +30,12 @@ def customerAction(request, c_id):
filter_type = request.GET.get('actionType', 'all')
filter_status = request.GET.get('status', 'all')
# کوئری پایه برای اقدامات این مشتری
# کوئری پایه برای اقدامات این مشتری.
# اقدام‌های حذف‌شده (soft-delete) به‌طور پیش‌فرض نمایش داده نمی‌شوند؛ با
# فیلتر صریح `status=cancell` می‌توان آن‌ها را دید (برای حسابرسی).
actions = Action.objects.filter(customer=customer)
if filter_status != 'cancell':
actions = actions.filter(deleted_at__isnull=True)
# اعمال فیلتر بر اساس نوع اقدام (بازدید، نصب و ...)
if filter_type != 'all':
@@ -48,48 +64,216 @@ def customerAction(request, c_id):
@login_required(login_url='/panel/p_login/')
def customerNazar(request ,c_id):
customer = Customer.objects.get(id=c_id)
actions = Action.objects.filter(customer=customer, nazarDT__isnull=False).order_by("-createdDT")
actions = Action.objects.filter(
customer=customer, nazarDT__isnull=False, deleted_at__isnull=True,
).order_by("-createdDT")
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
data = {'customer': customer, 'actions': actions, 'allUsers': allUsers}
return render(request, 'admin_panel/customer/nazar.html', data)
def _parse_form_datetime(raw):
"""timestamp میلی‌ثانیه‌ای فرم → دیتاتایم aware (یا ``None``).
کد قبلی ``datetime.datetime.fromtimestamp`` (naive) می‌ساخت که هنگام ذخیره
با ``USE_TZ=True`` هشدار ``RuntimeWarning`` می‌داد؛ اینجا صریح aware می‌شود.
"""
try:
return as_aware(datetime.datetime.fromtimestamp(int(raw) / 1e3))
except (TypeError, ValueError, OverflowError, OSError):
return None
def _action_payload_from_request(request):
"""استخراج و نرمال‌سازی ورودی فرم اقدام (مشترک ایجاد و ویرایش)."""
is_done = bool(request.POST.get('is_done'))
return {
'actionType': (request.POST.get('actionType') or '').strip(),
'status': Action.Status.FINISH if is_done else Action.Status.WAITE,
'actionDateTime': _parse_form_datetime(request.POST.get('dateTimeAnjam')),
'finishDateTime': _parse_form_datetime(request.POST.get('FinishDateTime')),
# فقط برای «هماهنگی» معنا دارد؛ تاریخِ «تا کِی پیگیری نشود».
'holdRaw': _parse_form_datetime(request.POST.get('visitHoldUntil')),
# تأیید صریح کاربر برای «عقب بردن» تاریخ قرار دستی.
'force_hold': bool(request.POST.get('force_hold')),
'desc': request.POST.get('desc', None),
'result': request.POST.get('result', None),
'userID': request.POST.get('userID', None),
'is_done': is_done,
}
def _apply_visit_hold(customer_obj, payload, *, status, is_new, force_hold=False):
"""هم‌راستاکردن «قرار بعدی» با اقدام ثبت/ویرایش‌شده.
قواعد:
* برای اقدام نوع «هماهنگی»:
- تاریخ قرار داده شده ⇒ ``set_visit_hold`` (فقط رو به جلو، مگر تأیید کاربر)
- «انجام شد» تیک خورده و تاریخ خالی ⇒ پیش‌فرض ۱۴ روز
- لغو شده ⇒ (در ایجاد) پاک می‌شود
* برای **هر اقدام دیگری** (از جمله «بازدید»):
- در حالت **ایجاد**، این اقدام آخرین فعالیت مشتری است ⇒ قرار دستی پاک
می‌شود (سناریوی گزارش‌شده: ثبت بازدید پس از هماهنگی).
- در حالت **ویرایش**، رکوردی تاریخی است و ممکن است قرارِ فعلی از یک
هماهنگیِ *جدیدتر* آمده باشد؛ پس دست نمی‌زنیم. اعتبارسنجی
:func:`manual_holds_map` (شرط «آخرین فعالیت = هماهنگی») خودش تصمیم
می‌گیرد. بدون این تفکیک، ویرایش یک اقدام قدیمی قرار معتبر را پاک می‌کرد.
خروجی (دیکشنری، برای بازخورد شفاف به کاربر)::
{'ok': bool, 'reason': 'written'|'default'|'forward_only'|'cleared'|'',
'current': datetime|None, 'target': datetime|None}
``reason='forward_only'`` یعنی تاریخ درخواستی از قرار فعلی عقب‌تر است و
نوشته **نشد**؛ لایهٔ ویو باید همین را با تاریخ‌ها به کاربر نشان بدهد و اگر
خودش تأیید کرد، با ``force_hold=True`` دوباره صدا بزند.
"""
result = {'ok': True, 'reason': '', 'current': None, 'target': None,
'force_allowed': not is_new}
# «عقب‌بردن قرار» فقط در ویرایش مجاز است. در ایجادِ وظیفهٔ تازه، کاربر قصد
# اصلاح قرارِ موجود را ندارد و اجازه دادن به آن می‌تواند قولِ قبلیِ ثبت‌شده
# (شاید توسط کارشناس دیگر) را بی‌آنکه کسی بخواهد کوتاه کند.
force_hold = bool(force_hold) and not is_new
is_coordination = payload['actionType'] == Action.ActionType.HAMAHANGI
if not is_coordination or status == Action.Status.CANCELL:
if is_new:
result['ok'] = bool(clear_visit_hold(customer_obj))
result['reason'] = 'cleared' if result['ok'] else ''
return result
raw = payload.get('holdRaw')
if raw is not None:
target = normalize_hold_until(raw)
reason = 'written'
elif payload['status'] == Action.Status.FINISH:
target = default_hold_until()
reason = 'default'
else:
return result
current = as_aware(customer_obj.visit_hold_until)
result['current'] = current
result['target'] = target
written = set_visit_hold(customer_obj, target, force=force_hold)
result['ok'] = written
result['reason'] = reason if written else 'forward_only'
return result
# نگاشت «نوع اقدام → (تریگر پیامک، نوع پیامک)». تنها منبعِ تصمیم است تا مسیر
# «ایجاد» و «ویرایش» هرگز واگرا نشوند (باگ قبلی: ویرایش تریگر را صدا نمی‌زد).
_ACTION_EVENT_SMS = {
Action.ActionType.BAZDID: (notify_visit_scheduled, 'visit_created'),
Action.ActionType.NASB: (notify_install_scheduled, 'install_created'),
}
def _sync_action_event_sms(customer, action, *, previous_type=None, user=None):
"""هم‌راستاسازی پیامک رویدادی با نوع اقدام (مشترکِ ایجاد و ویرایش).
* نوع جدید **رویدادی** است (بازدید/نصب):
- اگر نوع عوض شده باشد (یا رکورد تازه باشد) ⇒ تریگر همان نوع صدا زده
می‌شود. تکرار ممکن نیست: کلید یکتاسازی ``{sms_type}:{action.pk}`` است.
- اگر نوع همان بوده باشد (ویرایش عادی متن/تاریخ) ⇒ هیچ پیامکی ساخته
نمی‌شود، پس ویرایش‌های پیاپی اسپم تولید نمی‌کنند.
* نوع جدید **غیررویدادی** است ولی قبلاً رویدادی بود ⇒ پیامک معلقِ همان رکورد
لغو می‌شود (کاربر عملاً بازدید/نصب را پس گرفته است).
خروجی: تعداد پیامک‌های ساخته‌شده.
"""
current = _ACTION_EVENT_SMS.get(action.actionType)
previous = _ACTION_EVENT_SMS.get(previous_type) if previous_type else None
# نوع رویدادی عوض شده (بازدید ↔ نصب) ⇒ پیامک معلقِ نوع قبلی همین رکورد لغو شود،
# وگرنه هر دو پیامک در صف می‌مانند.
if previous is not None and previous_type != action.actionType:
cancel_pending_sms_for_action(
customer, action_id=action.pk, sms_type=previous[1],
)
if current is None:
# نوع جدید رویدادی نیست؛ اگر قبلاً بود، پیامکش همین بالا لغو شد.
return 0
if previous_type == action.actionType:
return 0 # ویرایش عادی همان نوع ⇒ پیامک تازه‌ای لازم نیست
return current[0](customer, action, created_by=user)
def _jalali_day(value):
"""تاریخ شمسی روز (به وقت محلی) برای پیام‌های کاربر."""
if value is None:
return '—'
return JalaliDate(timezone.localtime(value)).strftime('%Y/%m/%d')
def _report_hold_result(request, result):
"""بازخورد شفافِ نتیجهٔ نوشتن «تا تاریخ پیگیری نشود» به کاربر.
قاعدهٔ «فقط رو به جلو» بی‌صدا نیست: اگر تاریخ درخواستی از قرار فعلی عقب‌تر
باشد، اینجا گفته می‌شود که ذخیره نشد و کاربر چطور می‌تواند خودش انجامش دهد.
"""
if result.get('reason') != 'forward_only':
return
current, target = result.get('current'), result.get('target')
tz = timezone.get_current_timezone()
if current is not None and target is not None \
and target.astimezone(tz).date() >= current.astimezone(tz).date():
# همان روز ⇒ تغییر واقعی‌ای لازم نیست؛ پیام دادن گمراه‌کننده است.
return
tail = ('برای ثبت، گزینهٔ «تاریخ قرار را عقب ببر» را تیک بزنید.'
if result.get('force_allowed')
else 'برای تغییر قرار، همان وظیفهٔ هماهنگی را ویرایش کنید.')
messages.warning(
request,
'تاریخ قرار ذخیره نشد؛ از قرار فعلی این مشتری (%s) عقب‌تر است. %s'
% (_jalali_day(current), tail)
)
def _reject(request, error, redirect_to):
"""پیام فارسی خطا به کاربر و بازگشت بدون ذخیرهٔ چیزی."""
messages.error(request, '؛ '.join(error.messages))
return redirect(redirect_to)
@login_required(login_url='/panel/p_login/')
def customerNewAction(request ,c_id):
actionType = request.POST.get('actionType', None)
dateTimeAnjam = request.POST.get('dateTimeAnjam', None)
#return HttpResponse(float(dateTimeAnjam+".0"))
payload = _action_payload_from_request(request)
try:
dateTimeAnjam = datetime.datetime.fromtimestamp(int(dateTimeAnjam)/1e3)
except:
pass
desc = request.POST.get('desc', None)
userID = request.POST.get('userID', None)
is_done = request.POST.get('is_done', None)
result = request.POST.get('result', None)
FinishDateTime = request.POST.get('FinishDateTime', None)
try:
FinishDateTime = datetime.datetime.fromtimestamp(int(FinishDateTime)/1e3)
except:
pass
validate_action_payload(payload)
# اعتبارسنجی «قرار بعدی» پیش از هر نوشتنی (سقف ۶ ماه و تاریخ گذشته).
if payload['actionType'] == Action.ActionType.HAMAHANGI and payload['holdRaw']:
normalize_hold_until(payload['holdRaw'])
except ValidationError as error:
return _reject(request, error, '/panel/customer/' + str(c_id) + '/action')
customer_obj = Customer.objects.get(id=int(c_id))
newAction = Action()
newAction.actionType = actionType
newAction.actionDateTime = dateTimeAnjam
newAction.desc = desc
newAction.forUser = User.objects.get(id=int(userID))
newAction.actionType = payload['actionType']
newAction.actionDateTime = payload['actionDateTime']
newAction.desc = payload['desc']
newAction.forUser = User.objects.get(id=int(payload['userID']))
newAction.customer = customer_obj
if is_done:
newAction.status = 'finish'
newAction.finishDateTime = FinishDateTime
newAction.result = result
if payload['is_done']:
newAction.status = Action.Status.FINISH
# تاریخ اتمام خالی نباید None ذخیره شود (سابقه را پاک می‌کرد).
newAction.finishDateTime = normalize_finish_datetime(payload['finishDateTime'])
newAction.result = payload['result']
else:
newAction.status = 'waite'
newAction.status = Action.Status.WAITE
newAction.save()
if newAction.status == 'finish' and newAction.actionType == 'bazdid':
customer_obj.last_bazdid_dt = newAction.finishDateTime
customer_obj.save()
# last_bazdid_dt فقط از تابع واحد بازمحاسبه می‌شود؛ نه از finishDateTime.
refresh_last_bazdid(customer_obj, reason=REASON_CREATE, user=request.user)
# «قرار بعدی» فقط برای هماهنگی.
hold_result = _apply_visit_hold(
customer_obj, payload, status=newAction.status, is_new=True,
force_hold=payload.get('force_hold', False),
)
_report_hold_result(request, hold_result)
# پیامک «بازدید/نصب شما برای تاریخ … ثبت شد» (برای اقدام از نوع بازدید یا نصب).
_sync_action_event_sms(customer_obj, newAction, user=request.user)
return redirect('/panel/customer/'+str(c_id)+'/action')
@@ -111,61 +295,133 @@ def ActionListUser(request, u_id):
@login_required(login_url='/panel/p_login/')
def customerEditAction(request ,c_id, action_id):
actionType = request.POST.get('actionType', None)
dateTimeAnjam = request.POST.get('dateTimeAnjam', None)
print("ok")
#return HttpResponse(float(dateTimeAnjam+".0"))
payload = _action_payload_from_request(request)
try:
dateTimeAnjam = datetime.datetime.fromtimestamp(int(dateTimeAnjam)/1e3)
except:
pass
desc = request.POST.get('desc', None)
userID = request.POST.get('userID', None)
is_done = request.POST.get('is_done', None)
result = request.POST.get('result', None)
FinishDateTime = request.POST.get('FinishDateTime', None)
try:
FinishDateTime = datetime.datetime.fromtimestamp(int(FinishDateTime)/1e3)
except:
pass
validate_action_payload(payload)
if payload['actionType'] == Action.ActionType.HAMAHANGI and payload['holdRaw']:
normalize_hold_until(payload['holdRaw'])
except ValidationError as error:
return _reject(
request, error,
request.META.get('HTTP_REFERER', '/panel/customer/' + str(c_id) + '/action'),
)
customer_obj = Customer.objects.get(id=int(c_id))
newAction = Action.objects.get(id=action_id)
newAction.actionType = actionType
newAction.actionDateTime = dateTimeAnjam
newAction.desc = desc
newAction.forUser = User.objects.get(id=int(userID))
was_done = newAction.status == Action.Status.FINISH
# نوع **قبلی** رکورد (پیش از بازنویسی) — برای تشخیص گذار «غیربازدید → بازدید»
# و برعکس. اگر بعد از ``save()`` خوانده شود، همیشه مقدار جدید است.
previous_type = newAction.actionType
newAction.actionType = payload['actionType']
newAction.actionDateTime = payload['actionDateTime']
newAction.desc = payload['desc']
newAction.forUser = User.objects.get(id=int(payload['userID']))
newAction.customer = customer_obj
if is_done:
newAction.status = 'finish'
newAction.finishDateTime = FinishDateTime
newAction.result = result
if payload['is_done']:
newAction.status = Action.Status.FINISH
newAction.finishDateTime = normalize_finish_datetime(payload['finishDateTime'])
newAction.result = payload['result']
else:
newAction.status = 'waite'
newAction.status = Action.Status.WAITE
newAction.save()
if newAction.status == 'finish' and newAction.actionType == 'bazdid':
customer_obj.last_bazdid_dt = newAction.finishDateTime
customer_obj.save()
# بازمحاسبهٔ واحد: هم پس از ویرایش، هم وقتی رکورد از «انجام‌شده» برگشت می‌خورد
# (تا مقداری که این رکورد ساخته بود با منبع حقیقت هم‌راستا شود).
reason = REASON_CANCEL if (was_done and not payload['is_done']) else REASON_EDIT
refresh_last_bazdid(customer_obj, reason=reason, user=request.user)
# «قرار بعدی»: با ویرایش هم‌راستا می‌شود. برای اقدام غیرهماهنگی عمداً
# پاک نمی‌کنیم؛ رکورد ویرایش‌شده ممکن است قدیمی‌تر از یک هماهنگیِ جدیدتر
# باشد و پاک‌کردن، قرار معتبر را از بین ببرد.
hold_result = _apply_visit_hold(
customer_obj, payload, status=newAction.status, is_new=False,
force_hold=payload.get('force_hold', False),
)
_report_hold_result(request, hold_result)
# پیامک «بازدید/نصب شما برای تاریخ … ثبت شد».
# فقط *گذار* نوع اقدام بررسی می‌شود، نه هر ویرایش (جزئیات در
# ``_sync_action_event_sms``):
# * غیررویدادی → بازدید/نصب ⇒ تریگر همان نوع صدا زده می‌شود.
# * بازدید/نصب → نوع دیگر ⇒ پیامک معلقِ همان رکورد لغو می‌شود.
_sync_action_event_sms(
customer_obj, newAction, previous_type=previous_type, user=request.user,
)
#return redirect('/panel/customer/'+str(c_id)+'/action')
return redirect(request.META.get('HTTP_REFERER', 'redirect_if_referer_not_found'))
@login_required(login_url='/panel/p_login/')
def customerActionDelete(request, c_id, action_id):
"""«حذف» یک اقدام (soft-delete).
فقط POST مجاز است (تغییر وضعیت داده). اقدام فیزیکی حذف **نمی‌شود**؛
``status`` به ``cancell`` می‌رود و ``deleted_at``/``deleted_by`` پر می‌شوند.
چرا soft-delete؟ چون سابقهٔ CRM باید قابل حسابرسی بماند و منطق محاسبات
(entezar / ActionList / داشبورد) از قبل فقط ``waite``/``finish`` را می‌بیند؛
پس همین مقدار، اقدام را از همهٔ خروجی‌ها کنار می‌گذارد.
"""
customer_obj = get_object_or_404(Customer, id=c_id)
action = get_object_or_404(Action, id=action_id, customer=customer_obj)
back_url = '/panel/customer/%d/action' % customer_obj.pk
if request.method != 'POST':
# دسترسی مستقیم با GET نباید چیزی را عوض کند.
return redirect(back_url)
try:
cancelled = soft_delete_action(action, user=request.user)
except ActionDeleteError as error:
messages.error(request, str(error))
return redirect(back_url)
label = action.get_actionType_display() or 'اقدام'
message = '«%s» حذف شد و از فهرست‌های انتظار/وظایف خارج شد.' % label
if cancelled:
message += ' %d پیامک ارسال‌نشدهٔ مرتبط هم لغو شد.' % cancelled
messages.success(request, message)
return redirect(back_url)
@login_required(login_url='/panel/p_login/')
def ActionListAll(request):
actions = Action.objects.filter().order_by("-id")
# اقدام‌های حذف‌شده (soft-delete) در فهرست «همه» نمایش داده نمی‌شوند.
actions = Action.objects.filter(deleted_at__isnull=True).order_by("-id")
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
data = {'actions': actions, 'allUsers': allUsers}
return render(request, 'admin_panel/ActionList.html', data)
def _local_day_range(day=None):
"""بازهٔ ``[آغاز روز، پایان روز]`` به وقت محلی و aware.
قبلاً این دو ویو رشته‌های naive می‌ساختند (``'%Y-%m-%d 00:00:00'``) و Django
آن‌ها را با منطقهٔ زمانی پیش‌فرض تفسیر می‌کرد؛ هر تغییر ساعت/تایم‌زون باعث
جابه‌جایی مرز «وظایف امروز» می‌شد. حالا مرز صریح و aware است.
در روزهای تغییر ساعت (مثلاً ۲۲ مارس در تهران) نیمه‌شب ممکن است وجود نداشته
باشد؛ آن حالت با ``is_dst=False`` پوشش داده می‌شود تا یک تاریخ مرزی، صفحهٔ
وظایف را نشکند (همان کاری که ``visit_policy.as_aware`` می‌کند).
"""
day = day or timezone.localdate()
bounds = []
for moment in (datetime.datetime.combine(day, datetime.time.min),
datetime.datetime.combine(day, datetime.time.max)):
try:
bounds.append(timezone.make_aware(moment))
except Exception:
bounds.append(timezone.make_aware(moment, is_dst=False))
return bounds[0], bounds[1]
@login_required(login_url='/panel/p_login/')
def ActionListToday(request):
startTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 00:00:00')
endTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 23:59:59')
#startTodayDT = datetime.datetime.strptime(startTodayDT, '%Y-%m-%d-00:00:00')
#endTodayDT = datetime.datetime.strptime(endTodayDT, '%Y-%m-%d-23:59:59')
#return HttpResponse(todayDT)
actions = Action.objects.filter(actionDateTime__gte=startTodayDT,actionDateTime__lte=endTodayDT, forUser__id=request.user.id, status='waite').order_by("-actionDateTime")[:50]
startTodayDT, endTodayDT = _local_day_range()
actions = Action.objects.filter(
actionDateTime__range=(startTodayDT, endTodayDT),
forUser__id=request.user.id, status='waite',
).order_by("-actionDateTime")[:50]
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
data = {'actions': actions, 'allUsers': allUsers}
return render(request, 'admin_panel/ActionList.html', data)
@@ -176,22 +432,19 @@ def ActionListUserToday(request, u_id):
status = request.GET.get('status', None)
unixADT = dateTimeAction
if dateTimeAction:
dateTimeAction = datetime.datetime.fromtimestamp(int(dateTimeAction)/1e3)
startTodayDT = dateTimeAction.strftime('%Y-%m-%d 00:00:00')
endTodayDT= dateTimeAction.strftime('%Y-%m-%d 23:59:59')
# timestamp میلی‌ثانیه‌ای GET → تاریخ محلی (نه naive UTC).
moment = as_aware(datetime.datetime.fromtimestamp(int(dateTimeAction) / 1e3))
day = moment.astimezone(timezone.get_current_timezone()).date()
else:
startTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 00:00:00')
endTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 23:59:59')
#startTodayDT = datetime.datetime.strptime(startTodayDT, '%Y-%m-%d-00:00:00')
#endTodayDT = datetime.datetime.strptime(endTodayDT, '%Y-%m-%d-23:59:59')
#return HttpResponse(todayDT)
day = timezone.localdate()
startTodayDT, endTodayDT = _local_day_range(day)
if status == 'waite' or status == None or status == '' or status == ' ':
status = 'waite'
actions = Action.objects.filter(actionDateTime__gte=startTodayDT,actionDateTime__lte=endTodayDT, forUser__id=u_id, status=status).order_by("-actionDateTime")[:50]
actions = Action.objects.filter(actionDateTime__range=(startTodayDT, endTodayDT), forUser__id=u_id, status=status).order_by("-actionDateTime")[:50]
actionPr = Action.objects.filter(actionDateTime__lt=startTodayDT, forUser__id=u_id, status=status).order_by("-actionDateTime")[:200]
elif status == 'finish':
actionPr = None
actions = Action.objects.filter(actionDateTime__gte=startTodayDT,actionDateTime__lte=endTodayDT, forUser__id=u_id, status=status).order_by("-actionDateTime")[:50]
actions = Action.objects.filter(actionDateTime__range=(startTodayDT, endTodayDT), forUser__id=u_id, status=status).order_by("-actionDateTime")[:50]
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
data = {'actions': actions, 'allUsers': allUsers, 'u_id': u_id, "unixADT": unixADT, "status": status, 'actionPr': actionPr}
@@ -200,7 +453,7 @@ def ActionListUserToday(request, u_id):
@login_required(login_url='/panel/p_login/')
def rezayat(request):
statusRezayat = request.GET.get('status', 'waite')
now = datetime.datetime.now()
now = timezone.now()
# محاسبه بازه‌های زمانی ۳۰ روز و ۶۰ روز قبل
dt_30_days_ago = now - datetime.timedelta(days=30)
@@ -241,20 +494,20 @@ def rezayatEdit(request, ac_id):
# عدم موفقیت: تنظیم nextNazarDT برای ۳ روز بعد (nazarDT پر نمی‌شود تا نهایی نشود)
action.nazar = csDesc
action.grade = int(csGrade)
action.nextNazarDT = datetime.datetime.now() + datetime.timedelta(days=3)
action.nextNazarDT = timezone.now() + datetime.timedelta(days=3)
elif csGrade == '-2':
# کنسل کردن: پر کردن nazarDT برای خروج کامل از لیست کارهای در انتظار
action.nazar = csDesc
action.grade = int(csGrade)
action.nazarDT = datetime.datetime.now()
action.nazarDT = timezone.now()
action.nextNazarDT = None
else:
# ثبت امتیاز عادی
action.nazar = csDesc
action.grade = int(csGrade)
action.nazarDT = datetime.datetime.now()
action.nazarDT = timezone.now()
action.nextNazarDT = None
action.save()
+529 -62
View File
@@ -2,21 +2,63 @@ import datetime
import os
from django.db import models
from django.db.models import Sum, Q
from django.db.models import Sum, Q, Case, When, Value
from django.shortcuts import redirect, render, get_object_or_404
from django.core.paginator import Paginator
from django.utils import timezone
from django.views.decorators.csrf import csrf_exempt
from django.contrib import messages
from django.contrib.auth.decorators import login_required, permission_required
from persiantools.jdatetime import JalaliDate
from ..models import (Customer, PhoneNumber, ProductCategory, Product, Factor,
FactorIteam, Article, Sarresid, Action, CacheTable, SMSType)
from ..sms.enqueue import enqueue_sms
from ..sms.phones import (customer_phone_entries, normalize_primary_values,
FactorIteam, Article, Sarresid, Action, CacheTable)
from ..sms.balance import customer_balance
from ..sms.phones import (normalize_primary_values,
save_primary_normalized)
from ..sms.recipients import resolve_recipients
from ..sms.rules import customer_toggle_map
from ..sms.triggers import notify_payment_thanks, notify_welcome
from ..visit_policy import (SOURCE_COORDINATION, SOURCE_MANUAL, SOURCE_SCHEDULED,
appointment_sources_map, as_aware,
followups_on_date, last_visit_map, overdue_followups,
visit_due_at, visit_due_date, visit_period_months)
# نماهای صفحهٔ «انتظار» (فیلتر ?view=).
# پیش‌فرض = «نیازمند پیگیری امروز»: فهرست کاریِ روزانهٔ کارشناس (موعد تماس‌های
# امروز). سایر نماها با کارت‌ها/دراپ‌داون «نوع قرار» در دسترس‌اند.
# ``today`` یک نمای **مستقل** است: پایهٔ آن «عقب‌افتاده بودن» نیست — مشتری
# سالمی هم که با او قرار تماس گذاشته شده باید در این فهرست دیده شود.
ENTEZAR_VIEWS = ('today', 'uncoordinated', 'manual', 'scheduled', 'coordination',
'coordinated', 'all')
ENTEZAR_DEFAULT_VIEW = 'today'
# نمای «نیازمند پیگیری» — برای بررسی «آیا این نما فعال است؟» در قالب/ویو.
ENTEZAR_FOLLOWUP_VIEW = 'today'
# تعداد ردیف در هر صفحه. فهرست کاری روزانه با یک نگاه مرور می‌شود، پس صفحه‌بندی
# دیرتر فعال شود.
ENTEZAR_PAGE_SIZE = 100
# فیلتر «میزان تأخیر» (?delay=). مرزها با «مدت تأخیر» (روز) مقایسه می‌شوند.
ENTEZAR_DELAYS = ('lt30', '30to90', '90to180', 'gt180')
# ستون‌های قابل مرتب‌سازی: نام فیلد ⇒ جهت پیش‌فرضِ اولین کلیک.
# ``oldest``/``newest``/``overdue`` مقادیر قدیمی‌اند و برای سازگاری با
# بوکمارک‌های قبلی نگه داشته شده‌اند (به ``last_visit``/``overdue`` نگاشت می‌شوند).
ENTEZAR_SORT_COLUMNS = {
'name': 'asc',
'status': 'asc',
'manual': 'desc',
'scheduled': 'desc',
'coordination': 'desc',
'last_visit': 'asc',
'overdue': 'desc',
'phone': 'asc',
'address': 'asc',
}
_ENTEZAR_LEGACY_SORTS = {
'oldest': ('last_visit', 'asc'),
'newest': ('last_visit', 'desc'),
'overdue': ('overdue', 'desc'),
}
from ._helpers import logger, _parse_jalali_date, _parse_phone_rows
@@ -121,16 +163,9 @@ def customerNew2(request ,c_id):
#all_prd = serializers.serialize("json", all_prda)
#return JsonResponse(all_prd,safe = False)
dateNow = datetime.datetime.now().date
sms_toggles = customer_toggle_map(customer)
# همهٔ شماره‌ها از هر منبعی که ذخیره شده‌اند (PhoneNumber و phone1/2/3 قدیمی).
sms_phone_entries = customer_phone_entries(customer)
sms_effective = {n for n in resolve_recipients(customer)}
data = {
'customer': customer, 'categorys': categorys, 'dateNow': dateNow,
'factorha': factorha, 'mandehesabCs': mandehesabCs,
'sms_toggles': sms_toggles, 'sms_phone_entries': sms_phone_entries,
'sms_effective': sms_effective,
'sms_recipients': sorted(sms_effective),
}
return render(request, 'admin_panel/customerNew2.html', data)
@@ -271,12 +306,7 @@ def customersAdd(request):
)
# پیامک خوش‌آمدگویی (در صورت فعال بودن قالب و تنظیم مشتری)
enqueue_sms(
customer=newCs, sms_type=SMSType.WELCOME,
context={'name': newCs.name_family},
dedup_key=f'welcome:{newCs.id}',
created_by=request.user,
)
notify_welcome(newCs, created_by=request.user)
return redirect('/panel/customers/')
@@ -337,63 +367,496 @@ def customerEdit(request, c_id):
@login_required(login_url='/panel/p_login/')
def entezar(request):
a = datetime.datetime.now()
"""فهرست «منتظر بازدید» + تفکیک بر اساس **نوع قرار**.
منبع حقیقت تاریخ بازدید ``visit_policy.last_visit_map`` است و منبع قرارها
``appointment_sources_map`` که سه منبع مستقل دارد:
* ``manual`` — قرار دستی روی مشتری (تعویق از فرم هماهنگی)
* ``scheduled`` — اقدام «بازدید» با تاریخ آینده
* ``coordination`` — اقدام «هماهنگی» با تاریخ پیگیری در آینده
هر فیلتر فقط منبع خودش را نشان می‌دهد (یک مشتری می‌تواند چند منبع داشته
باشد و در چند فیلتر دیده شود). فیلتر با ``?view=`` و قابل ترکیب با جست‌وجو.
"""
searchVal = request.GET.get('searchVal', '')
searchOn = request.GET.get('searchOn', '')
view = (request.GET.get('view') or ENTEZAR_DEFAULT_VIEW).strip().lower()
if view not in ENTEZAR_VIEWS:
view = ENTEZAR_DEFAULT_VIEW # مقدار نامعتبر ⇒ پیش‌فرض، بدون خطا
delay = (request.GET.get('delay') or '').strip().lower()
if delay not in ENTEZAR_DELAYS:
delay = '' # '' یعنی بدون فیلتر تأخیر
# مرتب‌سازی: ``?sort=<ستون>&dir=asc|desc``؛ مقادیر قدیمی هم پذیرفته می‌شوند.
# نکته: اگر ``dir`` صریح آمده باشد، مقدم است — وگرنه کلیک روی سرستون
# «تأخیر» با جهت صعودی، به‌خاطر نگاشت قدیمی، نادیده گرفته می‌شد.
raw_sort = (request.GET.get('sort') or '').strip().lower()
raw_dir = (request.GET.get('dir') or '').strip().lower()
if raw_sort in ENTEZAR_SORT_COLUMNS:
sort_field = raw_sort
if raw_dir in ('asc', 'desc'):
sort_dir = raw_dir
else:
sort_dir = 'desc' if raw_sort in _ENTEZAR_LEGACY_SORTS else \
ENTEZAR_SORT_COLUMNS[raw_sort]
elif raw_sort in _ENTEZAR_LEGACY_SORTS:
sort_field, sort_dir = _ENTEZAR_LEGACY_SORTS[raw_sort]
else:
sort_field, sort_dir = _ENTEZAR_LEGACY_SORTS['oldest']
searchStatus = True
full_path = request.get_full_path()
from django.db.models import Q
now = timezone.now()
due_cut = visit_due_at(now=now)
# دوره فقط یک بار خوانده می‌شود (جلوگیری از N+1 در حلقهٔ محاسبهٔ تأخیر).
period_months = visit_period_months()
# مرز تاریخ به وقت محلی (نه UTC) تا صفحه و اسکنر پیامک یک جواب بدهند.
current_tz = timezone.get_current_timezone()
today_date = now.astimezone(current_tz).date()
due_cut_date = due_cut.astimezone(current_tz).date()
bazdid = os.environ.get('bazdid', 9)
# تاریخ نمای «نیازمند پیگیری»: از تقویم شمسی می‌آید (``?fdate=1405/08/29``).
# خالی/نامعتبر ⇒ امروز. مقدار گذشته و آینده هر دو مجازند.
followup_date_raw = (request.GET.get('fdate') or '').strip()
followup_date = _parse_jalali_date(followup_date_raw) or today_date
followup_date_jalali = JalaliDate(followup_date).strftime('%Y/%m/%d')
is_followup_view = view == ENTEZAR_FOLLOWUP_VIEW
bazdid = int ( int(bazdid) * 4.3 )
dateTime6MonthAgo = a - datetime.timedelta(weeks=bazdid)
''' customers = Customer.objects.filter(name_family__isnull=False)
m6mbazdid = []
for customerObj in customers:
try:
actionAa = Action.objects.filter(customer=customerObj, actionType='bazdid', status='finish').last()
if actionAa.status == 'finish':
customerObj.last_bazdid_dt = actionAa.actionDateTime
customerObj.save()
if actionAa.actionDateTime.date() < dateTime6MonthAgo.date():
m6mbazdid.append(actionAa)
except:
pass '''
visits = last_visit_map(now=now)
sources = appointment_sources_map(now=now)
# جست‌وجو: نام، آدرس، تلفن (همه شماره‌ها) و کد شناسایی.
def _apply_search(queryset):
"""فیلتر جست‌وجو؛ فیلد نامعتبر ⇒ بدون فیلتر (سازگاری با رفتار قبلی)."""
if not searchVal:
return queryset
if searchOn == 'address':
print("addressaddressaddressaddressaddress")
customers_objj = Customer.objects.filter(Q(last_bazdid_dt__lte=dateTime6MonthAgo) | Q(last_bazdid_dt__isnull=True),
installDate__lte=dateTime6MonthAgo,
laghv_bazdid=False, name_family__isnull=False, address__contains=searchVal).order_by('last_bazdid_dt')
else:
searchStatus = False
customers_objj = Customer.objects.filter(Q(last_bazdid_dt__lte=dateTime6MonthAgo) | Q(last_bazdid_dt__isnull=True),
installDate__lte=dateTime6MonthAgo,
laghv_bazdid=False, name_family__isnull=False).order_by('last_bazdid_dt')
return queryset.filter(address__contains=searchVal)
if searchOn == 'name':
return queryset.filter(name_family__contains=searchVal)
if searchOn == 'phone':
return queryset.filter(
Q(phone1__contains=searchVal) | Q(phone2__contains=searchVal)
| Q(phone3__contains=searchVal)
)
if searchOn == 'code':
return queryset.filter(idCode__contains=searchVal)
return queryset
#customers_objj = Customer.objects.filter(name_family__isnull=False, last_bazdid_dt__lte=dateTime6MonthAgo)
searchStatus = bool(searchVal) and searchOn in (
'address', 'name', 'phone', 'code')
# پایهٔ فهرست انتظار: فقط مشتریانی که دوره‌شان گذشته (کارت‌های آمار).
customers_objj = Customer.objects.filter(
laghv_bazdid=False, name_family__isnull=False,
installDate__lte=due_cut_date,
)
customers_objj = _apply_search(customers_objj)
# مشتریان عقب‌افتاده: بدون بازدید معتبر، یا بازدید معتبرشان پیش از مقطع دوره.
stale_ids = [
customer_id for customer_id in customers_objj.values_list('id', flat=True)
if visits.get(customer_id) is None or visits[customer_id] <= due_cut
]
# تفکیک بر اساس **منبعِ** قرار: هر مشتری می‌تواند صفر تا سه منبع داشته باشد
# (قرار دستی، بازدید برنامه‌ریزی‌شده، هماهنگی). قبلاً «هماهنگی» با «بازدید»
# در یک گروه جمع می‌شد و در نمای «بازدید برنامه‌ریزی‌شده» دیده می‌شد؛ حالا
# هر منبع گروه نمایشیِ خودش را دارد.
with_manual, with_scheduled, with_coordination = set(), set(), set()
for customer_id in stale_ids:
customer_sources = sources.get(customer_id) or {}
if SOURCE_MANUAL in customer_sources:
with_manual.add(customer_id)
if SOURCE_SCHEDULED in customer_sources:
with_scheduled.add(customer_id)
if SOURCE_COORDINATION in customer_sources:
with_coordination.add(customer_id)
coordinated_ids = [cid for cid in stale_ids if cid in (
with_manual | with_scheduled | with_coordination)]
selected_map = {
# نداشتن هیچ قرار
'uncoordinated': [cid for cid in stale_ids if cid not in (
with_manual | with_scheduled | with_coordination)],
# هر مشتری که این منبع را دارد (حتی اگر منبع دیگری هم داشته باشد)
'manual': [cid for cid in stale_ids if cid in with_manual],
'scheduled': [cid for cid in stale_ids if cid in with_scheduled],
'coordination': [cid for cid in stale_ids if cid in with_coordination],
# اجتماع هر سه منبع
'coordinated': coordinated_ids,
'all': stale_ids,
}
# ---------- نمای «نیازمند پیگیری» (یک تاریخ مشخص) ----------
# این نما **مستقل** از «عقب‌افتاده» است: مشتری سالمی که با او قرار تماس
# گذاشته شده هم باید دیده شود. قاعدهٔ حذفِ «بازدید/نصب» در خود
# ``followups_on_date`` اعمال می‌شود (مشتریِ دارای قرار بازدید یا نصب نمی‌آید).
today_followups = followups_on_date(today_date, now=now)
# پیگیری‌های عقب‌افتاده: موعدشان گذشته و هنوز تعیین تکلیف نشده‌اند.
# فقط در نمای پیگیری محاسبه می‌شود (کوئری اضافه برای بقیهٔ نماها لازم نیست).
overdue_map = overdue_followups(now=now, target_date=today_date) \
if is_followup_view else {}
overdue_oldest = min(overdue_map.values()) if overdue_map else None
# فیلتر «فقط عقب‌افتاده‌ها» (?missed=1) — همان نما با منبعِ دیگر.
show_missed = is_followup_view and \
(request.GET.get('missed') or '').strip().lower() in ('1', 'true', 'on')
if is_followup_view:
if show_missed:
# تاریخِ موعدِ ازدست‌رفته به‌صورت datetime تا با بقیهٔ مسیرها یکسان باشد.
followups = {
cid: {SOURCE_COORDINATION: as_aware(day)}
for cid, day in overdue_map.items()
}
elif followup_date == today_date:
followups = today_followups
else:
followups = followups_on_date(followup_date, now=now)
else:
followups = {}
def _followup_ids(mapping):
"""شناسه‌های واجد شرایط (فعال/لغو‌نشده/دارای نام + جست‌وجو) با ترتیب زمانی."""
if not mapping:
return []
eligible = _apply_search(
Customer.objects.filter(
id__in=list(mapping),
is_active=True,
laghv_bazdid=False,
name_family__isnull=False,
)
)
allowed = set(eligible.values_list('id', flat=True))
return sorted(
(cid for cid in mapping if cid in allowed),
key=lambda cid: (min(mapping[cid].values()), cid),
)
followup_ids = _followup_ids(followups) if is_followup_view else []
# شمارنده‌ها از همان مسیرِ فهرست می‌آیند تا «عدد هشدار = تعداد ردیف‌ها» بماند
# (مشتری غیرفعال/لغو‌شده/بی‌نام یا فیلترشده شمرده نمی‌شود).
today_followup_count = len(_followup_ids(today_followups))
overdue_followup_count = len(_followup_ids(
{cid: {SOURCE_COORDINATION: as_aware(day)} for cid, day in overdue_map.items()}
))
selected_map[ENTEZAR_FOLLOWUP_VIEW] = followup_ids
selected = selected_map[view]
# برای نمای پیگیری، فهرست مشتریان از همان شناسه‌های تأییدشده می‌آید
# (ممکن است در «عقب‌افتاده» نباشند).
if is_followup_view:
customers_objj = _apply_search(
Customer.objects.filter(id__in=followup_ids)
)
# «مدت تأخیر» = از چه زمانی بازدید عقب افتاده است (به روز).
# مبنای محاسبه «موعد بازدید» است، نه خود بازدید: موعد = بازدید + دوره.
# این‌طور مشتریِ تازه‌معوق هم در بازهٔ کوتاه قرار می‌گیرد و عدد معنا پیدا می‌کند.
# محاسبه روی کلِ نمای جاری انجام می‌شود تا شمارنده‌های بازه‌ها با فیلتر
# «میزان تأخیر» هم‌خوان باشند (اول نمای جاری، بعد فیلتر تأخیر).
today = today_date
overdue_days = {}
for customer_id in selected:
anchor = visits.get(customer_id)
if anchor is not None:
due = visit_due_date(anchor, months=period_months)
base = due.astimezone(timezone.get_current_timezone()).date()
else:
# بدون بازدید: مقطع دوره (تاریخ نصب خیلی قدیمی، عدد را بی‌معنا می‌کند).
base = due_cut_date
overdue_days[customer_id] = max((today - base).days, 0)
# آمار «تأخیر» روی نمای جاری (قبل از اعمال فیلتر تأخیر).
buckets = {'lt30': 0, '30to90': 0, '90to180': 0, 'gt180': 0}
for days in overdue_days.values():
if days < 30:
buckets['lt30'] += 1
elif days < 90:
buckets['30to90'] += 1
elif days < 180:
buckets['90to180'] += 1
else:
buckets['gt180'] += 1
# اعمال فیلتر «میزان تأخیر».
delay_ranges = {
'lt30': (0, 30),
'30to90': (30, 90),
'90to180': (90, 180),
'gt180': (180, None),
}
# فیلتر «میزان تأخیر» فقط برای نمای «عقب‌افتاده» معنا دارد؛ در نمای
# «پیگیری امروز» مشتری ممکن است اصلاً تأخیری نداشته باشد.
if delay and not is_followup_view:
low, high = delay_ranges[delay]
selected = [
cid for cid in selected
if overdue_days.get(cid, 0) >= low
and (high is None or overdue_days.get(cid, 0) < high)
]
# ---------- مرتب‌سازی (روی همهٔ ستون‌ها) ----------
# یک کوئری سبک برای فیلدهای Customer که برای مرتب‌سازی لازم است.
info = {
row['id']: row
for row in Customer.objects.filter(id__in=selected).values(
'id', 'name_family', 'phone1', 'address')
} if selected else {}
def _source_date(cid, key):
return (sources.get(cid) or {}).get(key)
def _sort_value(cid):
"""مقدار مرتب‌سازی برای هر ستون (تاریخ‌ها aware یا None)."""
if sort_field == 'name':
return (info.get(cid, {}).get('name_family') or '')
if sort_field == 'phone':
return (info.get(cid, {}).get('phone1') or '')
if sort_field == 'address':
return (info.get(cid, {}).get('address') or '')
if sort_field == 'status':
# ترتیب منطقی: بدون قرار ← قرار دستی ← بازدید ← هماهنگی ← چندقراره
entry = sources.get(cid) or {}
if not entry:
return 0
days = {value.astimezone(current_tz).date() for value in entry.values()}
if len(days) > 1:
return 4
if SOURCE_MANUAL in entry:
return 1
if SOURCE_SCHEDULED in entry:
return 2
return 3
if sort_field == 'manual':
return _source_date(cid, SOURCE_MANUAL)
if sort_field == 'scheduled':
return _source_date(cid, SOURCE_SCHEDULED)
if sort_field == 'coordination':
return _source_date(cid, SOURCE_COORDINATION)
if sort_field == 'overdue':
return overdue_days.get(cid, 0)
# last_visit: مشتریِ بدون بازدید، قدیمی‌ترین حساب می‌شود.
return visits.get(cid) or due_cut
if selected:
if is_followup_view and not raw_sort:
# در نمای پیگیری، ترتیب طبیعی «زودترین موعد پیگیری» است
# (ترتیب از ``_followup_ids`` آمده) — نه قدیمی‌ترین بازدید.
ordered_ids = list(selected)
else:
values = {cid: _sort_value(cid) for cid in selected}
with_value = [cid for cid in selected if values[cid] is not None]
without_value = [cid for cid in selected if values[cid] is None]
with_value.sort(key=lambda cid: (values[cid], cid),
reverse=(sort_dir == 'desc'))
# مقادیر خالی همیشه آخر می‌آیند (مستقل از جهت مرتب‌سازی) تا فهرست
# با ستون‌های «قرار دستی/بازدید/هماهنگی» بی‌معنا نشود.
ordered_ids = with_value + without_value
else:
ordered_ids = []
customers_objj = customers_objj.filter(id__in=ordered_ids)
if ordered_ids:
ordering = Case(
*[When(id=cid, then=Value(index))
for index, cid in enumerate(ordered_ids)],
output_field=models.IntegerField(),
)
customers_objj = customers_objj.order_by(ordering)
else:
customers_objj = customers_objj.order_by('id')
counts = {
'total': len(stale_ids),
'uncoordinated': len(selected_map['uncoordinated']),
# عددِ هر کارت دقیقاً همان چیزی است که با کلیک روی آن دیده می‌شود.
# یک مشتری می‌تواند چند منبع داشته باشد، پس جمع سه منبع می‌تواند از
# «تعیین تکلیف شده» بیشتر شود؛ جزئیات در دراپ‌داون «نوع قرار» است.
'manual': len(selected_map['manual']),
'scheduled': len(selected_map['scheduled']),
'coordination': len(selected_map['coordination']),
'coordinated': len(selected_map['coordinated']),
# کارت «نیازمند پیگیری امروز» — همیشه عدد امروز را نشان می‌دهد،
# مستقل از تاریخی که کاربر در تقویم انتخاب کرده است.
'followup_today': today_followup_count,
# پیگیری‌های موعدگذشته که هنوز تعیین تکلیف نشده‌اند (هشدار قرمز).
'followup_overdue': overdue_followup_count,
'selected': len(selected),
'view_total': len(selected_map[view]),
'buckets': buckets,
# برای متن راهنمای بالای صفحه («بیش از N ماه از بازدید گذشته»).
'period_months': period_months,
}
try:
entezar_bazdid = CacheTable.objects.get(key='9mahbazdid')
entezar_bazdid.value = Customer.objects.filter(
Q(last_bazdid_dt__lte=dateTime6MonthAgo) | Q(last_bazdid_dt__isnull=True),
installDate__lte=dateTime6MonthAgo,
laghv_bazdid=False, name_family__isnull=False).count()
entezar_bazdid.save()
except:
# کارت داشبورد = «کارِ فوری» = تعیین تکلیف نشده.
# فقط در صورت تغییر می‌نویسیم تا یک GET ساده بی‌دلیل دیتابیس را تغییر ندهد.
if str(entezar_bazdid.value) != str(counts['uncoordinated']):
entezar_bazdid.value = str(counts['uncoordinated'])
entezar_bazdid.save(update_fields=['value'])
except CacheTable.DoesNotExist:
pass
paginator = Paginator(customers_objj, 20) # Show 25 contacts per page.
paginator = Paginator(customers_objj, ENTEZAR_PAGE_SIZE)
page_number = request.GET.get('page', None)
customerHa = paginator.get_page(page_number)
return render(request, 'admin_panel/entezar.html', {'customers': customerHa, 'searchStatus': searchStatus, 'full_path': full_path, 'searchVal': searchVal, 'searchOn':searchOn})
# لینک صفحه‌بندی با حفظ همهٔ فیلترهای فعلی.
def _page_link(number):
params = request.GET.copy()
params['page'] = number
return '?' + params.urlencode()
page_prev = _page_link(customerHa.previous_page_number()) if customerHa.has_previous() else ''
page_next = _page_link(customerHa.next_page_number()) if customerHa.has_next() else ''
# ---------- لینک‌های حفظ‌کنندهٔ فیلترها ----------
def _qs(**overrides):
"""پارامترهای فعلی + تغییرهای داده‌شده (بدون page). None ⇒ حذف."""
params = request.GET.copy()
params.pop('page', None)
for key, value in overrides.items():
if value is None:
params.pop(key, None)
else:
params[key] = value
query = params.urlencode()
return '?' + query if query else '?'
view_links = {name: _qs(view=name) for name in ENTEZAR_VIEWS}
# کارت «نیازمند پیگیری امروز» همیشه به امروز می‌رود (تاریخ انتخابی پاک می‌شود).
view_links[ENTEZAR_FOLLOWUP_VIEW] = _qs(view=ENTEZAR_FOLLOWUP_VIEW, fdate=None)
# ---------- ناوبری تقویم در نمای پیگیری ----------
def _followup_link(target_date):
return _qs(view=ENTEZAR_FOLLOWUP_VIEW,
fdate=JalaliDate(target_date).strftime('%Y/%m/%d'))
followup_nav = {
'prev': _followup_link(followup_date - datetime.timedelta(days=1)),
'next': _followup_link(followup_date + datetime.timedelta(days=1)),
'today': _followup_link(today_date),
'is_today': followup_date == today_date,
}
# لینک هشدار «عقب‌افتاده‌ها» و لینک بازگشت از آن حالت.
followup_overdue_link = _qs(view=ENTEZAR_FOLLOWUP_VIEW, fdate=None, missed=1)
followup_ontime_link = _qs(view=ENTEZAR_FOLLOWUP_VIEW, fdate=None, missed=None)
delay_links = {'ez_all': _qs(delay=None)}
delay_links.update({name: _qs(delay=name) for name in ENTEZAR_DELAYS})
sort_links = {}
for column, default_dir in ENTEZAR_SORT_COLUMNS.items():
# کلیک دوباره روی همان ستون، جهت را برمی‌گرداند.
next_dir = ('desc' if sort_dir == 'asc' else 'asc') \
if sort_field == column else default_dir
sort_links[column] = _qs(sort=column, dir=next_dir)
# سرستون‌های مرتب‌شدنی (به همان ترتیب ستون‌های جدول).
# در نمای «نیازمند پیگیری امروز» ستون «تأخیر» نمایش داده **نمی‌شود**:
# این فهرست دربارهٔ «موعد امروز» است، نه عقب‌افتادگی بازدید.
columns = [
('name', 'نام و نام خانوادگی', 21),
('status', 'وضعیت قرار', 12),
('manual', 'قرار دستی', 10),
('scheduled', 'بازدید برنامه‌ریزی‌شده', 10),
('coordination', 'هماهنگی', 10),
('last_visit', 'آخرین بازدید', 9),
('overdue', 'تأخیر', 8),
('phone', 'تلفن', 9),
('address', 'آدرس', 11),
]
if is_followup_view:
hidden_width = next(width for key, _, width in columns if key == 'overdue')
columns = [col for col in columns if col[0] != 'overdue']
# عرض ستون حذف‌شده به نام اضافه می‌شود تا مجموع همچنان ۱۰۰٪ بماند.
columns[0] = (columns[0][0], columns[0][1], columns[0][2] + hidden_width)
table_columns = [{'key': key, 'label': label, 'width': width}
for key, label, width in columns]
hidden_columns = ['overdue'] if is_followup_view else []
sort_header = [
{
'key': column,
'label': label,
'link': sort_links[column],
'active': sort_field == column,
'dir': sort_dir if sort_field == column else '',
}
for column, label in ((key, label) for key, label, _ in columns)
]
# لینک «حذف همهٔ فیلترها»: نمای پیش‌فرض (امروز)، بدون تأخیر/جست‌وجو/مرتب‌سازی.
clear_link = '?view=' + ENTEZAR_DEFAULT_VIEW
has_filters = bool(
delay or searchVal or sort_field != 'last_visit'
or sort_dir != 'asc'
# تاریخِ انتخاب‌شده یا حالت «فقط عقب‌افتاده‌ها» هم فیلتر است.
or (is_followup_view and followup_date != today_date)
or show_missed
)
# اطلاعات هر ردیف برای قالب: قرارها + مدت تأخیر + آخرین بازدید مؤثر.
appointment_rows = {}
for customer in customerHa.object_list:
entry = dict(sources.get(customer.id) or {})
# در نمای پیگیری، تاریخ همان روز ملاک نمایش است (حتی اگر گذشته باشد و
# در ``appointment_sources_map`` که فقط آینده را می‌بیند، نباشد).
followup_entry = followups.get(customer.id) or {}
entry.update(followup_entry)
flags = [key for key in (SOURCE_MANUAL, SOURCE_SCHEDULED,
SOURCE_COORDINATION) if key in entry]
# «N قرار» = تعداد **روزهای یکتای** قرار، نه تعداد منابع. یک هماهنگی
# که تاریخ تعویقش همان روز است، هم‌زمان «manual» و «coordination»
# تولید می‌کند ولی دو قرارِ متفاوت نیست (برچسب «۲ قرار» گمراه‌کننده بود).
appointment_days = {
entry[key].astimezone(current_tz).date() for key in flags
}
appointment_rows[customer.id] = {
'manual': entry.get(SOURCE_MANUAL),
'scheduled': entry.get(SOURCE_SCHEDULED),
'coordination': entry.get(SOURCE_COORDINATION),
'overdue_days': overdue_days.get(customer.id, 0),
'last_visit': visits.get(customer.id),
# تعداد قرارهای یکتا (۱ تا ۳ روز متمایز) — قالب بر اساس آن برچسب می‌سازد.
'source_count': len(appointment_days),
# تاریخ پیگیری این نمای خاص (برای ستون اختصاصی نمای «امروز»).
'followup_at': (min(followup_entry.values())
if followup_entry else None),
}
return render(request, 'admin_panel/entezar.html', {
'customers': customerHa, 'searchStatus': searchStatus, 'full_path': full_path,
'searchVal': searchVal, 'searchOn': searchOn,
'view': view, 'counts': counts, 'appointment_rows': appointment_rows,
'view_links': view_links, 'delay_links': delay_links,
'sort_links': sort_links, 'sort_header': sort_header,
'clear_link': clear_link,
'has_filters': has_filters,
'delay': delay, 'delays': ENTEZAR_DELAYS,
'sort': sort_field, 'sort_dir': sort_dir,
'sort_columns': ENTEZAR_SORT_COLUMNS,
'table_columns': table_columns,
'hidden_columns': hidden_columns,
'column_count': len(table_columns),
'page_prev': page_prev, 'page_next': page_next,
'views': ENTEZAR_VIEWS,
# نمای «نیازمند پیگیری»
'is_followup_view': is_followup_view,
'followup_view': ENTEZAR_FOLLOWUP_VIEW,
'followup_date': followup_date,
'followup_date_jalali': followup_date_jalali,
'followup_nav': followup_nav,
'show_missed': show_missed,
'followup_overdue_link': followup_overdue_link,
'followup_ontime_link': followup_ontime_link,
})
@login_required(login_url='/panel/p_login/')
@@ -448,14 +911,13 @@ def customerDel(request, c_id):
@login_required(login_url='/panel/p_login/')
def customerHesabdari(request ,c_id):
customer = Customer.objects.get(id=c_id)
# مانده حساب از همان تابع مشترکی می‌آید که قالب‌های پیامک استفاده می‌کنند تا
# عددِ این صفحه و پیامک هرگز واگرا نشوند (منبع حقیقت: sms/balance.py).
mandehesabCs = customer_balance(customer)
try:
debit = Article.objects.filter(customer=customer).aggregate(Sum('debit'))['debit__sum']
credit = Article.objects.filter(customer=customer).aggregate(Sum('credit'))['credit__sum']
mandehesabCs = debit - credit
articls = Article.objects.filter(customer=customer).order_by('-createdDT')
except:
articls =None
mandehesabCs = 0
articls = None
dateNow = datetime.datetime.now().date
data = {'customer': customer, 'mandehesabCs': mandehesabCs, 'articls': articls}
@@ -494,4 +956,9 @@ def customerHesabdariAdd(request ,c_id):
newArticl.user = user_op
newArticl.nahvePardakht = nahvePardakhat
newArticl.save()
# سند بستانکار (credit>0 و debit=0) یعنی مشتری پول پرداخت کرده ⇒ پیامک تشکر.
if type == 'credit':
notify_payment_thanks(newArticl.customer, newArticl.credit,
article_id=newArticl.id, method=nahvePardakhat,
created_by=user_op)
return redirect('/panel/customer/'+str(c_id)+'/hesabdari')
+15 -2
View File
@@ -12,6 +12,7 @@ from persiantools import digits
from ..models import (Customer, StoreRoom, Factor, FactorIteam, Product,
ProductInStore, Article, Sarresid)
from ..sms.triggers import notify_factor_survey, notify_payment_thanks
from ._helpers import logger, _safe_int, _parse_jalali_date, _parse_timestamp, InventoryException
@@ -196,6 +197,8 @@ def newFactor2(request, c_id):
if not str(item.get('garanty_Esh', '')).strip()
)
new_factor = None
payment_articles = []
try:
with transaction.atomic():
@@ -231,7 +234,7 @@ def newFactor2(request, c_id):
if key in payment_map:
nahve_pardakht = payment_map[key]
Article.objects.create(
payment_articles.append((Article.objects.create(
debit=0,
credit=amount,
customer=customer_obj,
@@ -240,7 +243,7 @@ def newFactor2(request, c_id):
nahvePardakht=nahve_pardakht,
payStatus="true",
user=user_op
)
), nahve_pardakht))
elif key in ['l_nesiye', 'l_checkPrice']:
is_nesiye = (key == 'l_nesiye')
@@ -359,6 +362,16 @@ def newFactor2(request, c_id):
logger.error(f"Error creating factor for customer {c_id}: {str(e)}", exc_info=True)
return HttpResponse("خطایی غیرمنتظره در سرور رخ داد. اطلاعات ذخیره نشد.", status=500)
# تریگرهای پیامک پس از تأیید تراکنش (خارج از atomic تا در صورت rollback ساخته نشوند).
if new_factor is not None:
# نظرسنجی بی‌واسطه پس از ثبت فاکتور.
notify_factor_survey(customer_obj, new_factor, created_by=user_op)
# تشکر برای هر پرداخت نقدی/کارتیِ ثبت‌شده روی همین فاکتور (تخفیف مستثناست).
for art, method in payment_articles:
notify_payment_thanks(customer_obj, art.credit,
article_id=art.id, method=method,
created_by=user_op)
return redirect(f'/panel/customer/{c_id}/factors/')
+18 -4
View File
@@ -16,6 +16,7 @@ from persiantools.jdatetime import JalaliDate
from ..models import (Article, Sarresid, Customer, Factor, ProductInStore,
StoreRoom, Action)
from ..sms.triggers import notify_payment_thanks
from ._helpers import logger, _safe_int
@@ -155,9 +156,10 @@ def report_debtors_no_vosol(request):
).values('customer').annotate(c=Count('id')).values('c')
# استخراج آخرین سابقه اکشن وصول
# نکته: اقدام حذف‌شده/لغوشده نباید «آخرین اقدام وصول» به‌حساب بیاید.
latest_vosol_qs = Action.objects.filter(
customer=OuterRef('pk'), actionType='vosol'
).order_by('-createdDT')
customer=OuterRef('pk'), actionType='vosol',
).exclude(status='cancell').order_by('-createdDT')
# --- ۳. ساخت کوئری پایه (فقط مشتریان فعال و دارای معوقه) ---
base_qs = Customer.objects.filter(is_active=True).annotate(
@@ -713,6 +715,11 @@ def passCheck(request, articl_id):
sarresidINC.desc = desc
sarresidINC.save()
# سند وصول (credit>0 و debit=0) یعنی مشتری پول داده ⇒ پیامک تشکر از پرداخت.
notify_payment_thanks(articleHesabDari2.customer, articleHesabDari2.credit,
article_id=articleHesabDari2.id,
method=articleHesabDari2.nahvePardakht, created_by=user_op)
return HttpResponse("ok")
#return redirect(request.META.get('HTTP_REFERER'))
@@ -916,6 +923,11 @@ def pardakhtNesiye(request, cs_id):
articleHesabDariObj.user = user_op
articleHesabDariObj.save()
# پرداخت نسیه (بستانکار) ⇒ پیامک تشکر از پرداخت (تخفیف مستثناست).
notify_payment_thanks(customerObj, articleHesabDariObj.credit,
article_id=articleHesabDariObj.id,
method=nahvePardakht, created_by=user_op)
return redirect(request.META.get('HTTP_REFERER'))
except:
@@ -928,7 +940,8 @@ def rezayat_dashboard(request):
# دریافت تمامی نظرسنجی‌های ثبت شده معتبر (که تاریخ نظرسنجی دارند)
valid_surveys = Action.objects.filter(
nazarDT__isnull=False,
grade__in=[5, 10, 15, 20]
grade__in=[5, 10, 15, 20],
deleted_at__isnull=True,
)
# ۱. محاسبات شاخص‌های کلیدی (KPIs)
@@ -954,7 +967,8 @@ def rezayat_dashboard(request):
# ۴. واکشی لیست مشتریان نیازمند پیگیری (شامل متوسط ۱۵، ضعیف ۱۰ و بد ۵)
low_score_actions = Action.objects.filter(
nazarDT__isnull=False,
grade__in=[5, 10, 15] # <-- امتیاز ۱۵ (متوسط) نیز اضافه شد
grade__in=[5, 10, 15], # <-- امتیاز ۱۵ (متوسط) نیز اضافه شد
deleted_at__isnull=True,
).order_by('-nazarDT')
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
+318 -42
View File
@@ -1,11 +1,11 @@
"""ویوهای مدیریت پیامک در پنل (نیازمند پرمیشن ``admin_panel.ManageSMS``)."""
import re
from datetime import datetime, time
from datetime import datetime, time, timedelta
from urllib.parse import urlencode
from django.contrib.auth.decorators import login_required, permission_required
from django.core.paginator import Paginator
from django.db.models import Count
from django.db.models import Count, Q
from django.shortcuts import get_object_or_404, redirect, render
from django.urls import reverse
from django.utils import timezone
@@ -13,12 +13,37 @@ from django.utils import timezone
from ..models import (Customer, SMSDedup, SMSProviderConfig, SMSQueue,
SMSTemplate, SMSType)
from ..sms.enqueue import enqueue_sms
from ..sms.parts import ENCODING_LABELS, describe, parts_count
from ..sms.phones import (customer_phone_entries, save_primary_normalized,
stored_primary_normalized)
from ..sms.render import format_jalali, render_template
from ..sms.rules import customer_toggle_map
from ..sms.timing import apply_timing, current_timing_value, timing_for
_manage_required = permission_required("admin_panel.ManageSMS", raise_exception=True)
# صفحات «تنظیمات سامانه» و «قالب‌ها» یک سطح دسترسی جداگانه دارند تا مدیر بتواند
# فقط به کاربران موردنظرش اجازهٔ دیدن/ویرایش بدهد (نه هر کاربر دارای ManageSMS).
_settings_required = permission_required(
"admin_panel.ManageSMSSettings", raise_exception=True,
)
# گزارش هزینه فقط روی پیامک‌هایی است که از مرحلهٔ «تأیید مدیر» گذشته و واقعاً به
# سامانه/اپراتور سپرده شده‌اند. موارد «در انتظار تأیید» (هنوز ارسال نشده) و
# «لغو‌شده» (هرگز ارسال نمی‌شود) نباید در تحلیل هزینه بیایند.
SENT_STATUSES = [
SMSQueue.Status.APPROVED,
SMSQueue.Status.PROCESSING,
SMSQueue.Status.SENT,
SMSQueue.Status.FAILED,
]
# وضعیت‌های «پایانی» که دیگر کاری روی آن‌ها لازم نیست. صفحهٔ «صف ارسال» فقط مواردِ
# نیازمند اقدام را نشان می‌دهد؛ پیامکِ ارسال‌شده از صف بیرون می‌رود و سابقه‌اش در
# صفحهٔ «گزارش ارسال» (/panel/sms/report) دیده می‌شود. این کار جلوی حذفِ ناخواستهٔ
# تاریخچه از روی صف را می‌گیرد و صف را به فهرستِ کاریِ تمیز تبدیل می‌کند.
# پیامک «لغوشده» هم دیگر کاری برای انجام ندارد (مثلاً چون اقدامِ مرتبطش حذف شده)،
# پس از صف بیرون می‌رود.
DONE_STATUSES = [SMSQueue.Status.SENT, SMSQueue.Status.CANCELLED]
def _notice(url, code, **extra):
@@ -34,6 +59,16 @@ def _notice(url, code, **extra):
def _customer_url(c_id):
return reverse("admin_panel:customer", kwargs={"c_id": c_id})
def _customer_sms_url(c_id):
"""صفحهٔ «سوابق و تنظیمات پیامک» مشتری — مقصد بازگشتِ عملیات پیامکی.
تنظیمات پیامک از صفحهٔ فاکتور به این صفحه منتقل شده؛ پس بعد از هر تغییر
(تیک نوع پیامک، شمارهٔ اصلی، ارسال سفارشی) کاربر باید همین‌جا بماند، نه به
صفحهٔ اصلی مشتری پرتاب شود.
"""
return reverse("admin_panel:customerSmsHistory", kwargs={"c_id": c_id})
# متغیرهای قابل استفاده در متن قالب‌ها (برای راهنمای پنل).
TEMPLATE_VARIABLES = [
("{name}", "نام مشتری"),
@@ -42,19 +77,22 @@ TEMPLATE_VARIABLES = [
("{date}", "تاریخ جلالی"),
("{days}", "تعداد روز"),
("{check_row}", "شمارهٔ ردیف چک"),
("{sayyad_id}", "شناسهٔ چک صیاد (۱۶ رقم)"),
("{owner_name}", "نام مالک چک"),
("{balance}", "مانده حساب مشتری (بدهکار − بستانکار)"),
("{balance_sep}", "مانده حساب با جداکنندهٔ هزارگان"),
]
# فقط برای نمایش: آیکن و توضیح کوتاه «چه زمانی ارسال می‌شود» هر نوع (لایهٔ UI، نه دامنه).
SMS_TYPE_UI = {
SMSType.WELCOME: {"icon": "👋", "when": "بیدرنگ پس از ثبت مشتری"},
SMSType.CHEQUE_DUE: {"icon": "🧾", "when": "پیش از سررسید چک"},
SMSType.WELCOME: {"icon": "👋", "when": "بی‌درنگ پس از ثبت مشتری"},
SMSType.SURVEY: {"icon": "⭐", "when": "بی‌درنگ پس از ثبت فاکتور"},
SMSType.CHEQUE_REGISTRATION: {"icon": "🧾", "when": "چند روز پیش از سررسید چک"},
SMSType.VISIT: {"icon": "🔧", "when": "پس از گذشت دورهٔ بازدید دستگاه"},
SMSType.VISIT_CREATED: {"icon": "📅", "when": "پس از ثبت اقدام بازدید"},
SMSType.INSTALL_CREATED: {"icon": "🛠️", "when": "پس از ثبت اقدام نصب"},
SMSType.PAYMENT_THANKS: {"icon": "🙏", "when": "پس از ثبت پرداخت"},
SMSType.NESIYE_DUE: {"icon": "💳", "when": "پیش از سررسید نسیه"},
SMSType.CHEQUE_REGISTRATION: {"icon": "⏳", "when": "تا ثبت‌شدن اطلاعات چک"},
SMSType.DEBT_DUE: {"icon": "💰", "when": "روز سررسید وصول مطالبات"},
SMSType.SURVEY: {"icon": "⭐", "when": "پس از صدور فاکتور"},
SMSType.VISIT: {"icon": "🔧", "when": "پس از گذشت دورهٔ بازدید"},
SMSType.CUSTOM: {"icon": "✍️", "when": "ارسال دستی از صفحهٔ مشتری"},
}
# نمونهٔ داده برای «پیش‌نمایش زندهٔ» متن در پنل (هیچ پیامکی با این مقادیر ارسال نمی‌شود).
@@ -65,12 +103,15 @@ SAMPLE_CONTEXT = {
"date": None, # در زمان ساخت ویو با تاریخ امروز پر می‌شود
"days": 2,
"check_row": "1234",
"sayyad_id": "1234567890123456",
"owner_name": "نام مالک",
"balance": 3500000,
"balance_sep": "3,500,000",
}
@login_required(login_url='/panel/p_login/')
@_manage_required
@_settings_required
def sms_settings(request):
config = SMSProviderConfig.load()
if request.method == "POST":
@@ -82,7 +123,7 @@ def sms_settings(request):
config.test_message = test_text
config.save(update_fields=["test_message"])
enqueue_sms(
customer=None, sms_type=SMSType.CUSTOM,
customer=None, sms_type="",
message=test_text or config.test_message,
recipients=resolve_recipients_test(phone), created_by=request.user,
approved=True, # ارسال دستیِ مدیر؛ نیاز به بازبینی صف ندارد.
@@ -192,7 +233,7 @@ def _sample_context():
@login_required(login_url='/panel/p_login/')
@_manage_required
@_settings_required
def sms_templates(request):
raw_sample, text_sample = _sample_context()
rows = []
@@ -236,7 +277,7 @@ def _templates_redirect(anchor="", notice="", **extra):
@login_required(login_url='/panel/p_login/')
@_manage_required
@_settings_required
def sms_template_edit(request, t_id):
"""ویرایش یک قالب. فیلد زمانی بر اساس نوع پیامک انتخاب و اعتبارسنجی می‌شود.
@@ -284,8 +325,12 @@ def sms_customer_toggle(request, c_id):
)
setting.is_enabled = enabled
setting.save()
return _notice(_customer_url(c_id), "customer_sms_saved")
return redirect("admin_panel:customer", c_id=c_id)
# ``open=settings`` ⇒ صفحه با همان مودال تنظیمات باز می‌شود تا کاربر
# چند نوع را پشت‌سرهم روشن/خاموش کند و هر بار مودال را باز نکند.
return _notice(
_customer_sms_url(c_id), "customer_sms_saved", open="settings",
)
return redirect("admin_panel:customerSmsHistory", c_id=c_id)
@login_required(login_url='/panel/p_login/')
@@ -307,13 +352,13 @@ def sms_primary_toggle(request, c_id):
"",
)
if not normalized:
return _notice(_customer_url(c_id), "primary_not_found")
return _notice(_customer_sms_url(c_id), "primary_not_found")
current = [n for n in stored_primary_normalized(customer) if n != normalized]
if enabled:
current.append(normalized)
save_primary_normalized(customer, current)
return _notice(_customer_url(c_id), "primary_updated")
return redirect("admin_panel:customer", c_id=c_id)
return _notice(_customer_sms_url(c_id), "primary_updated")
return redirect("admin_panel:customerSmsHistory", c_id=c_id)
@login_required(login_url='/panel/p_login/')
@@ -321,36 +366,42 @@ def sms_primary_toggle(request, c_id):
def sms_send_custom(request, c_id):
"""ارسال پیامک با متن سفارشی برای همین مشتری.
اگر کادر متن خالی بماند، متن قالب «پیام سفارشی» استفاده می‌شود. متغیرهایی مثل
متن باید توسط مدیر نوشته شود (قالب پیش‌فرضی وجود ندارد)؛ متغیرهایی مثل
``{name}`` در متن واردشده هم رندر می‌شوند.
"""
customer = get_object_or_404(Customer, id=c_id)
if request.method == "POST":
text = (request.POST.get("text", "") or "").strip()
if not text:
template = SMSTemplate.objects.filter(
sms_type=SMSType.CUSTOM, is_enabled=True,
).first()
text = (template.text if template else "").strip()
rendered = render_template(text, {"name": customer.name_family}).strip()
if not rendered:
return _notice(_customer_url(c_id), "custom_empty")
# خطا ⇒ همان مودال ارسال سفارشی دوباره باز شود تا متن از دست نرود.
return _notice(_customer_sms_url(c_id), "custom_empty", open="custom")
created = enqueue_sms(
customer=customer, sms_type=SMSType.CUSTOM, message=rendered,
customer=customer, sms_type="", message=rendered,
created_by=request.user,
approved=True, # متن را خودِ مدیر نوشته و ارسال را خواسته است.
)
code = "custom_queued" if created else "custom_no_phone"
return _notice(_customer_url(c_id), code)
return redirect("admin_panel:customer", c_id=c_id)
return _notice(_customer_sms_url(c_id), code)
return redirect("admin_panel:customerSmsHistory", c_id=c_id)
@login_required(login_url='/panel/p_login/')
@_manage_required
def sms_queue(request):
"""صف ارسال: فقط مواردی که هنوز «کارِ باقی‌مانده» دارند.
پیامک‌های ارسال‌شده (``sent``) از این فهرست بیرون می‌مانند چون کارشان تمام است و
سابقه‌شان در «گزارش ارسال» دیده می‌شود؛ ماندن‌شان در صف فقط باعث می‌شد دکمهٔ
«حذف» روی تاریخچه ظاهر شود. بقیهٔ وضعیت‌ها (در انتظار تأیید، تأییدشده، در حال
پردازش، ناموفق) در صف می‌مانند چون هنوز نیاز به اقدام دارند.
"""
status = request.GET.get("status", "")
delivery = request.GET.get("delivery", "")
qs = SMSQueue.objects.all().select_related("customer").order_by("-created_at")
qs = (
SMSQueue.objects.exclude(status__in=DONE_STATUSES)
.select_related("customer").order_by("-created_at")
)
if status:
qs = qs.filter(status=status)
if delivery:
@@ -364,24 +415,226 @@ def sms_queue(request):
counts = dict(
SMSQueue.objects.order_by().values_list("status").annotate(n=Count("id"))
)
# «کل صف» = موارد باقی‌مانده (بدون ارسال‌شده‌ها).
queue_total = sum(n for code, n in counts.items() if code not in DONE_STATUSES)
data = {
"queue": page,
"status": status,
"delivery": delivery,
"status_choices": SMSQueue.Status.choices,
# گزینه‌های فیلتر وضعیت: فقط وضعیت‌های درون صف (ارسال‌شده حذف می‌شود).
"status_choices": [
(code, label) for code, label in SMSQueue.Status.choices
if code not in DONE_STATUSES
],
"delivery_choices": SMSQueue.DeliveryStatus.choices,
"pending_count": counts.get(SMSQueue.Status.PENDING, 0),
"total_count": sum(counts.values()),
"total_count": queue_total,
# تعداد ارسال‌شده‌ها جداگانه نمایش داده می‌شود (برای رفتن به گزارش).
"sent_count": counts.get(SMSQueue.Status.SENT, 0),
"filtered_count": paginator.count,
# (کد وضعیت، برچسب، تعداد) — به ترتیب تعریف Status.
# (کد وضعیت، برچسب، تعداد) — فقط وضعیت‌های درون صف.
"status_stats": [
(code, label, counts.get(code, 0))
for code, label in SMSQueue.Status.choices
if code not in DONE_STATUSES
],
}
return render(request, "admin_panel/sms_queue.html", data)
@login_required(login_url='/panel/p_login/')
@_manage_required
def customer_sms_history(request, c_id):
"""سوابق + تنظیمات پیامک یک مشتری (همه در یک صفحه).
ساختار صفحه عمداً دو لایه است تا **تنظیمات، سوابق را شلوغ نکند**:
* لایهٔ اول (همیشه دیده می‌شود): آمار کوتاه، فیلترها و فهرست سوابق.
* لایهٔ دوم (فقط با کلیک): تنظیمات پیامک، شماره‌های اصلی و ارسال سفارشی،
همه داخل مودال‌های Bulma.
تنظیماتی که قبلاً داخل باکس «پیامک» صفحهٔ ایجاد فاکتور بود
(``_customer_sms.html``) حالا اینجاست؛ آن باکس حذف شد تا فاکتور و سوابق هر
دو تمام‌عرض بمانند.
"""
customer = get_object_or_404(Customer, id=c_id)
status = request.GET.get("status", "")
delivery = request.GET.get("delivery", "")
qs = (
SMSQueue.objects.filter(customer=customer).order_by("-created_at")
)
if status:
qs = qs.filter(status=status)
if delivery:
qs = qs.filter(delivery_status=delivery)
paginator = Paginator(qs, 20)
page = paginator.get_page(request.GET.get("page"))
# --- آمار کارت‌های بالای صفحه (کل تاریخچهٔ همین مشتری، بدون فیلتر) ---
all_items = SMSQueue.objects.filter(customer=customer)
status_counts = dict(
all_items.order_by().values_list("status").annotate(n=Count("id"))
)
total_count = all_items.count()
# --- تنظیمات: نوع‌های پیامک با وضعیت مؤثر همین مشتری + «ارسال خودکار» قالب ---
# ``auto_send`` تنظیمی سراسری است (صفحهٔ قالب‌ها)، ولی دانستنش اینجا کمک
# می‌کند کاربر بداند پیامکِ این نوع بی‌درنگ می‌رود یا منتظر تأیید می‌ماند.
auto_send = dict(
SMSTemplate.objects.values_list("sms_type", "auto_send")
)
type_labels = dict(SMSType.choices)
sms_toggles = [
{
"code": item["code"],
"label": item["label"],
"enabled": item["enabled"],
"auto_send": bool(auto_send.get(item["code"])),
"icon": SMS_TYPE_UI.get(item["code"], {}).get("icon", "✉️"),
"when": SMS_TYPE_UI.get(item["code"], {}).get("when", ""),
}
for item in customer_toggle_map(customer)
]
enabled_count = sum(1 for item in sms_toggles if item["enabled"])
data = {
"customer": customer,
"items": page,
"status": status,
"delivery": delivery,
"status_choices": SMSQueue.Status.choices,
"delivery_choices": SMSQueue.DeliveryStatus.choices,
"total_count": total_count,
"filtered_count": paginator.count,
# تنظیمات (مودال)
"sms_toggles": sms_toggles,
"sms_enabled_count": enabled_count,
"sms_type_total": len(type_labels),
"phone_entries": customer_phone_entries(customer),
# آمار (نوار بالای صفحه)
"status_counts": status_counts,
"stat_sent": status_counts.get(SMSQueue.Status.SENT, 0),
# «در صف» = هر چیزی که هنوز ارسال نشده و منتظر اقدام/worker است.
"stat_pending": (
status_counts.get(SMSQueue.Status.PENDING, 0)
+ status_counts.get(SMSQueue.Status.APPROVED, 0)
+ status_counts.get(SMSQueue.Status.PROCESSING, 0)
),
"stat_failed": status_counts.get(SMSQueue.Status.FAILED, 0),
}
return render(request, "admin_panel/customerSmsHistory.html", data)
@login_required(login_url='/panel/p_login/')
@_manage_required
def sms_report(request):
"""گزارش پیامک‌های ارسال‌شده برای تحلیل هزینه.
امکان فیلتر بر اساس **بازهٔ تاریخ شمسی** (از/تا)، وضعیت ارسال، وضعیت تحویل و
نوع پیامک، به‌همراه جستجوی متنی روی متن پیامک/شماره/نام مشتری.
برای هر ردیف، «تعداد پیامکی که اپراتور محاسبه کرده» (parts) بر اساس کدگذاری
واقعی متن (GSM-7 برای انگلیسی/عدد، UCS-2 برای فارسی/یونیکد) محاسبه و نمایش
داده می‌شود؛ جمع کل بخش‌ها هم برای برآورد هزینه گزارش می‌شود.
"""
date_from_raw = (request.GET.get("date_from") or "").strip()
date_to_raw = (request.GET.get("date_to") or "").strip()
status = request.GET.get("status", "")
delivery = request.GET.get("delivery", "")
sms_type = request.GET.get("sms_type", "")
query = (request.GET.get("q") or "").strip()
qs = (
SMSQueue.objects.select_related("customer")
.filter(status__in=SENT_STATUSES)
.order_by("-created_at")
)
# بازهٔ تاریخ شمسی روی «زمان ایجاد» (ثبت در سیستم) اعمال می‌شود. بازهٔ «تا» تا
# پایان همان روز در نظر گرفته می‌شود تا پیامک‌های همان روز هم بیایند.
parsed_from = parse_jalali_date(date_from_raw) if date_from_raw else None
parsed_to = parse_jalali_date(date_to_raw) if date_to_raw else None
if parsed_from is not None:
qs = qs.filter(created_at__gte=parsed_from)
if parsed_to is not None:
qs = qs.filter(created_at__lt=parsed_to + timedelta(days=1))
if status:
qs = qs.filter(status=status)
if delivery:
qs = qs.filter(delivery_status=delivery)
if sms_type:
qs = qs.filter(sms_type=sms_type)
if query:
qs = qs.filter(
Q(message__icontains=query)
| Q(phone_number__icontains=query)
| Q(customer__name_family__icontains=query)
)
# --- آمار کلی روی کل نتیجهٔ فیلترشده (نه فقط صفحهٔ جاری) ---
status_counts = dict(
qs.order_by().values_list("status").annotate(n=Count("id"))
)
total_records = sum(status_counts.values())
# جمع بخش‌ها (parts) باید در پایتون حساب شود چون به کدگذاری هر متن بستگی دارد.
total_parts = 0
gsm7_parts = ucs2_parts = 0
for message in qs.values_list("message", flat=True).iterator(chunk_size=500):
info = describe(message)
total_parts += info["parts"]
if info["encoding"] == "gsm7":
gsm7_parts += info["parts"]
else:
ucs2_parts += info["parts"]
paginator = Paginator(qs, 50)
page = paginator.get_page(request.GET.get("page"))
# برای هر ردیف صفحه، محاسبهٔ کدگذاری/طول/بخش (نمایشی).
rows = []
for item in page:
info = describe(item.message)
rows.append({"item": item, "parts": info["parts"],
"encoding": info["encoding_label"], "length": info["length"]})
# برای لینک صفحه‌بندی که همهٔ فیلترها را حفظ کند (بدون خودِ page).
params = request.GET.copy()
params.pop("page", None)
base_query = params.urlencode()
data = {
"rows": rows,
"page": page,
"status": status,
"delivery": delivery,
"sms_type": sms_type,
"query": query,
"date_from": date_from_raw,
"date_to": date_to_raw,
"status_choices": [
(code, label) for code, label in SMSQueue.Status.choices
if code in SENT_STATUSES
],
"delivery_choices": SMSQueue.DeliveryStatus.choices,
"type_choices": SMSType.choices,
"total_records": total_records,
"total_parts": total_parts,
"gsm7_parts": gsm7_parts,
"ucs2_parts": ucs2_parts,
"encoding_labels": ENCODING_LABELS,
"status_stats": [
(code, label, status_counts.get(code, 0))
for code, label in SMSQueue.Status.choices
if code in SENT_STATUSES
],
"filtered": paginator.count,
"base_query": base_query,
"has_filter": any([date_from_raw, date_to_raw, status, delivery, sms_type, query]),
}
return render(request, "admin_panel/sms_report.html", data)
def _approve(queryset):
"""پیامک‌های «در انتظار تأیید» را تأیید و آمادهٔ ارسال می‌کند."""
return queryset.filter(status=SMSQueue.Status.PENDING).update(
@@ -403,9 +656,19 @@ def sms_queue_approve(request, q_id):
@login_required(login_url='/panel/p_login/')
@_manage_required
def sms_queue_delete(request, q_id):
"""حذف یک پیامک از صف (مثلاً پس از بازبینی و رد آن)."""
"""حذف یک پیامک از صف (مثلاً پس از بازبینی و رد آن).
پیامکِ ارسال‌شده حذف نمی‌شود؛ سابقهٔ آن در «گزارش ارسال» می‌ماند و حذفش یعنی
پاک‌کردنِ تاریخچه. برای چنین موردی فقط پیام هشدار برمی‌گردد.
"""
item = get_object_or_404(SMSQueue, id=q_id)
if request.method == "POST":
if item.status in DONE_STATUSES:
return _notice(reverse("admin_panel:sms_queue"), "delete_done_blocked")
# تصمیم محصولی: حذف توسط مدیر = «کنسل همین دوره». برای همین کلید یکتاسازی
# پیش از حذف در دفتر ثبت می‌شود؛ وگرنه اسکنر در اجرای بعدی همان پیامک را
# دوباره می‌ساخت.
_remember_keys([item])
item.delete()
return _notice(reverse("admin_panel:sms_queue"), "deleted")
return redirect("admin_panel:sms_queue")
@@ -427,7 +690,10 @@ def sms_queue_bulk(request):
count = _approve(selected)
code, extra = "bulk_approved", {"count": count}
elif action == "delete_selected":
# تاریخچهٔ ارسال‌شده‌ها از طریق صف حذف نمی‌شود.
selected = selected.exclude(status__in=DONE_STATUSES)
count = selected.count()
_remember_keys(selected)
selected.delete()
code, extra = "bulk_deleted", {"count": count}
else:
@@ -436,21 +702,31 @@ def sms_queue_bulk(request):
return redirect("admin_panel:sms_queue")
def _remember_keys(rows):
"""کلیدهای یکتاسازیِ رکوردهای صف را پیش از حذف در دفتر ``SMSDedup`` ثبت می‌کند.
قرارداد: وقتی مدیر یادآوری را حذف می‌کند، یعنی «همین دوره کنسل شد»؛ وگرنه
اسکنر در اجرای بعدی همان پیامک را از نو می‌سازد و حذفِ مدیر بی‌اثر می‌شود.
"""
keys = [k for k in (row.dedup_key for row in rows) if k]
if keys:
SMSDedup.objects.bulk_create(
[SMSDedup(key=key) for key in keys], ignore_conflicts=True,
)
@login_required(login_url='/panel/p_login/')
@_manage_required
def sms_queue_empty(request):
"""خالی کردن کل صف — هر وضعیتی، بدون بازگشت.
"""خالی کردن صف — فقط موارد باقی‌مانده (بدون بازگشت).
پیش از حذف، کلید یکتاسازیِ هر رکورد در دفتر ``SMSDedup`` تضمین می‌شود تا اسکنر
در اجرای بعدی همان پیامک‌ها را از نو نسازد. رکوردهایی که کلید ندارند (مثلاً
پیامک دستی) کلید مشتق از خودشان را می‌گیرند.
پیامک‌های ارسال‌شده جزو صف نیستند و حذف نمی‌شوند؛ تاریخچه‌شان در «گزارش ارسال»
لازم است. پیش از حذف، کلید یکتاسازیِ هر رکورد در دفتر ``SMSDedup`` تضمین می‌شود
تا اسکنر در اجرای بعدی همان پیامک‌ها را از نو نسازد.
"""
if request.method == "POST":
rows = SMSQueue.objects.all()
keys = [k for k in rows.values_list("dedup_key", flat=True) if k]
SMSDedup.objects.bulk_create(
[SMSDedup(key=k) for k in keys], ignore_conflicts=True,
)
rows = SMSQueue.objects.exclude(status__in=DONE_STATUSES)
_remember_keys(rows)
count = rows.count()
rows.delete()
return _notice(reverse("admin_panel:sms_queue"), "queue_emptied", count=count)
File diff suppressed because it is too large. Load diff
+34 -19
View File
@@ -1,43 +1,58 @@
# راه‌اندازی چهار سرویس از یک ایمیج مشترک:
# web → وب‌سرور Gunicorn (می‌گریشن/استاتیک فقط اینجا اجرا می‌شود)
# worker → تخلیه صف پیامک (sms_worker)
# scheduler → اسکن دوره‌ای و صف‌کردن یادآوری‌ها (sms_scan --loop)
# delivery → استعلام وضعیت تحویل پیامک‌ها (sms_delivery --sleep 30)
#
# توجه: دیتابیس SQLite است؛ مقیاس افقی (چند replica) ممنوع.
version: '3.8'
x-app: &app
build: .
image: khatibi-app:latest
env_file: production.env
volumes:
- ./sqlite:/app/sqlite
# دقیقاً نام کامل ولوم را اینجا بگذارید:
- khatibi-sqlite-db:/app/sqlite:rw
restart: unless-stopped
networks:
- coolify
services:
# سرویس یک‌بارهٔ مایگریشن: تنها جایی که اسکیما را جلو می‌برد.
# بقیهٔ سرویس‌ها منتظر «اتمام موفق» آن می‌مانند، پس هیچ‌وقت با اسکیمای عقب
# بالا نمی‌آیند (خطای no such column). اجرای دوباره‌اش بی‌خطر است.
migrate:
<<: *app
restart: "no"
command: ["python", "manage.py", "migrate", "--noinput"]
web:
<<: *app
ports:
- "8000:8000"
healthcheck:
test: ["CMD-SHELL", "python -c \"import urllib.request;urllib.request.urlopen('http://127.0.0.1:8000/').read()\""]
interval: 30s
timeout: 10s
retries: 5
start_period: 60s
expose:
- "8000"
depends_on:
migrate:
condition: service_completed_successfully
worker:
<<: *app
command: ["python", "manage.py", "sms_worker", "--sleep", "3"]
depends_on:
- web
migrate:
condition: service_completed_successfully
scheduler:
<<: *app
command: ["python", "manage.py", "sms_scan", "--loop", "--interval", "300"]
depends_on:
- web
migrate:
condition: service_completed_successfully
delivery:
<<: *app
command: ["python", "manage.py", "sms_delivery", "--sleep", "30"]
depends_on:
- web
migrate:
condition: service_completed_successfully
# در انتهای فایل بدون هیچ فاصله‌ای از سر سطر:
volumes:
khatibi-sqlite-db:
networks:
coolify:
external: true
File diff suppressed because it is too large. Load diff
+770
View File
@@ -0,0 +1,770 @@
# تحلیل کامل: دو فیلد تاریخِ «اقدام»، صفحهٔ انتظار و پیامک‌های بازدید
> دامنه: `Action` (ایجاد/ویرایش/حذف)، `Customer.visit_hold_until`، ویوی
> `/panel/entezar/` (`?view=today` و `?view=today&missed=1`)، و اسکنر/تریگرهای پیامک.
> روش: خواندن کدِ تولیدی + `ripwire` (blast radius) + `rg` + **ممیزی فقط-خواندنی روی
> کپیِ دیتابیس واقعی** + شبیه‌سازیِ ۳۲ سناریو در تست‌های Django.
> **هیچ خطی از کدِ تولیدی تغییر نکرد.** مصنوعات این بررسی:
>
> | فایل | نقش |
> |---|---|
> | `scripts/entezar_action_audit.py` | ممیزی عددیِ فقط-خواندنی روی دیتابیس واقعی (کپی موقت در /tmp) |
> | `tests/test_entezar_action_simulation.py` | ۳۲ سناریوی شبیه‌سازی (فرم، انتظار، پیامک، باگ missed) |
> | `docs/entezar_action_fields_report.md` | همین سند |
> | `docs/entezar_action_fields_report.html` | نسخهٔ بصریِ تک‌فایل (Tailwind CDN، RTL، نمودار و خط زمانی) |
>
> تاریخ اجرای ممیزی: ۲۰۲۶-۱۰-۲۲ (۱۴۰۵/۰۷/۳۰) — دیتابیس
> `data9/khatibi92669266_backups_db_backup_20261021_223009.sqlite3`.
---
## ۰. پاسخ کوتاه (Executive Summary)
| پرسش | پاسخ |
|---|---|
| فیلد «تاریخ و ساعتی که کار باید انجام شود» چیست؟ | `Action.actionDateTime` — «زمانِ انجام/تماس» وظیفه. برای «بازدید» = زمان قرار بازدید؛ برای «هماهنگی» = **زمان تماس**؛ برای بقیه = زمان انجام وظیفه. |
| فیلد «تا تاریخ پیگیری نشود» چیست؟ | `Customer.visit_hold_until` (پایانِ روز) — فقط برای «هماهنگی» ذخیره می‌شود؛ قرارِ بعدیِ مشتری. |
| اثر فیلد اول کجاست؟ | ۸ مصرف‌کننده: لیست وظایف پنل، «آخرین بازدید» و دورهٔ بازدید، لنگر چرخهٔ پیامک، قرار «بازدید برنامه‌ریزی‌شده»، قرار «هماهنگی»، فهرست پیگیری یک روز، فهرست «عقب‌افتاده‌ها»، و متن پیامک «ثبت بازدید». |
| اثر فیلد دوم کجاست؟ | ۳ مصرف‌کننده: ستون/برچسب «قرار دستی» در صفحهٔ انتظار، فهرست پیگیری روزِ همان قرار، و **مسدودسازی یادآوری دوره‌ای «بازدید» (SMS)** تا پایان آن روز. |
| روی SMS چه اثری دارد؟ | `visit` (دوره‌ای) با هر سه منبعِ قرار (دستی، بازدید برنامه‌ریزی‌شده، هماهنگی آینده) مسدود می‌شود؛ `visit_created` (رویدادی) **فقط** با ثبت اقدام «بازدید» ارسال می‌شود و از `actionDateTime` مقدار `{date}` می‌گیرد — فیلد تعویق روی آن هیچ اثری ندارد. |
| تیک «این کار انجام شده است» در هماهنگی؟ | تیک‌دار ⇒ `status=finish` + `finishDateTime` (خالی ⇒ زمان ثبت) + اگر تاریخ تعویق خالی باشد **پیش‌فرض ۱۴ روز** قرار. بدون تیک ⇒ `waite` و بدون پیش‌فرض؛ فقط اگر تاریخ تعویق پر شود قرار ثبت می‌شود. |
| چرا `missed=1` پر از مشتریِ بازدیدشده است؟ | چون `overdue_followups` **فقط بازدیدِ `waite` (در انتظار)** را حذف می‌کند و بازدیدِ `finish` را هرگز نمی‌بیند؛ همچنین ستون «تا تاریخ پیگیری نشود» را هم نمی‌بیند. |
| «۲ قرار» یعنی چه؟ | برچسب `source_count > 1` — مشتری هم‌زمان بیش از یک **منبعِ** قرار دارد (دستی/بازدید برنامه‌ریزی‌شده/هماهنگی)، نه لزوماً دو قرارِ متفاوت. |
| «قرار دستی» یعنی چه؟ | همان `Customer.visit_hold_until`؛ از فیلد «تا تاریخ پیگیری نشود» نوشته می‌شود و فقط وقتی معتبر است که آخرین فعالیتِ مشتری یک «هماهنگیِ فعال» باشد. |
---
## ۱. نقشهٔ داده و مسیر ذخیره‌سازی
### ۱.۱ ستون‌های دخیل
| موجودیت.ستون | نوع | نویسنده | خواننده‌ها |
|---|---|---|---|
| `Action.actionDateTime` | `DateTimeField(null=True)` | `dateTimeAnjam` فرم (`views/actions.py:90,151,209`) | ۸ مصرف‌کننده — بخش ۲ |
| `Action.finishDateTime` | `DateTimeField(null=True)` | `is_done` + `FinishDateTime` (خالی ⇒ `now`) | «تاریخ مؤثر بازدید»، فهرست پیگیری، تصمیم «انجام‌شده» |
| `Action.status` | `waite/finish/cancell` | تیک «انجام شد» | تمام تصمیم‌ها؛ `cancell` = لغو/حذف نرم |
| `Action.createdDT` | `auto_now_add` | سیستم | قاعدهٔ «آخرین فعالیت» در `_valid_manual_holds` |
| `Customer.visit_hold_until` | `DateTimeField(null=True)` | `visitHoldUntil` هماهنگی (`_apply_visit_hold`) | ۳ مصرف‌کننده — بخش ۳ |
| `Customer.visit_hold_set_at` | `DateTimeField(null=True)` | همان لحظهٔ ثبت (حسابرسی) | فقط نمایش/دیباگ |
| `Customer.last_bazdid_dt` | `DateTimeField(null=True)` | `refresh_last_bazdid` (مشتق) | داشبورد/گزارش‌های قدیمی |
### ۱.۲ مسیر فرم تا دیتابیس
```
customerActionInc.html
dateTimeAnjam ─────────────► _parse_form_datetime(ms) ─► payload['actionDateTime'] ─► Action.actionDateTime
visitHoldUntil ────────────► _parse_form_datetime(ms) ─► payload['holdRaw']
checkIsDone ───────────────► payload['status'] = finish | waite
FinishDateTime ────────────► normalize_finish_datetime (خالی ⇒ now)
│
└─ اگر نوع = هماهنگی:
holdRaw → normalize_hold_until (گذشته ✗، >۱۸۳ روز ✗) → set_visit_hold (فقط رو به جلو)
خالی + finish → default_hold_until() = +۱۴ روز
└─ اگر نوع ≠ هماهنگی و ایجاد تازه:
clear_visit_hold(customer)
```
نکتهٔ کلیدی: `visitHoldUntil` **فقط** زمانی نوشته می‌شود که `actionType == 'hamahangi'`
باشد (`views/actions.py:118-128`). برای «بازدید» و بقیهٔ انواع، حتی اگر مقدار بفرستید،
نادیده گرفته می‌شود (تست: `test_hold_until_ignored_for_visit_actions`).
---
## ۲. فیلد «تاریخ و ساعتی که کار باید انجام شود» — `actionDateTime`
### ۲.۱ یک فیلد، سه معنا (بسته به نوع اقدام)
| نوع اقدام | معنی `actionDateTime` | مرز زمانی در تصمیم‌ها |
|---|---|---|
| `bazdid` + `waite` | زمانِ **قرار بازدید** | تا **پایان روز** (`whole_day=True`) |
| `bazdid` + `finish` | زمانِ **انجام بازدید** | اگر گذشته باشد، «تاریخ مؤثر بازدید» |
| `hamahangi` (هر دو وضعیت) | زمانِ **تماس/هماهنگی** | **لحظه‌ای** (`whole_day=False`) — نه پایان روز |
| `nasb` / `vosol` / `inCall` / `outCall` | زمانِ انجام وظیفه | فقط لیست وظایف |
این تفکیک در `visit_policy._future_actions` (خط ۳۴۱-۳۶۱) صریح مستند شده است: در
هماهنگی، `actionDateTime` «زمان تماس» است، پس «تماسِ امروز» نباید مشتری را تا آخر
امروز پنهان کند؛ در بازدید برنامه‌ریزی‌شده برعکس، قرارِ امروز باید تا پایان امروز معتبر بماند.
### ۲.۲ جدول مصرف‌کننده‌ها
| # | مصرف‌کننده | فایل:تابع | چه می‌کند |
|---|---|---|---|
| ۱ | لیست وظایف امروز/عقب‌افتادهٔ کاربر | `views/actions.py:276-308` (`ActionListToday`, `ActionListUserToday`) | `actionDateTime` بین ۰۰:۰۰ تا ۲۳:۵۹ امروز + `status=waite` ⇒ «وظایف امروز»؛ `< شروع امروز` ⇒ «وظایف عقب‌افتاده» |
| ۲ | «آخرین بازدید» واقعی | `visit_policy.last_visit_map` (۱۴۳) و `effective_visit_dt` (۹۰) | فقط `bazdid+finish`؛ تاریخ مؤثر = `actionDateTime` اگر از حالا جلوتر نباشد، وگرنه `finishDateTime` |
| ۳ | لنگر چرخهٔ بازدید و پیامک | `visit_policy.cycle_anchor_map` (۲۱۴) → `sms/scanner.scan_visit` (۲۱۸-۲۴۵) | آخرین بازدید مؤثر (یا تاریخ نصب) + دورهٔ ۹ ماه ⇒ موعد یادآوری |
| ۴ | قرار «بازدید برنامه‌ریزی‌شده» | `scheduled_visits_map` (۳۸۰) — `bazdid+waite` با `actionDateTime ≥ آغاز امروز` | مشتری از «تعیین‌تکلیف‌نشده» خارج و از یادآوری SMS معاف می‌شود |
| ۵ | قرار «هماهنگی» | `coordination_holds_map` (۳۹۱) — `hamahangi` با `actionDateTime ≥ now` | همان اثر، ولی مرز **لحظه‌ای** |
| ۶ | فهرست پیگیری یک روز | `followups_on_date` (۵۲۲) | `hamahangi` با تاریخ همان روز (یا `finishDateTime` اگر `actionDateTime` خالی باشد) + قرار دستی همان روز |
| ۷ | فهرست «عقب‌افتاده‌ها» | `overdue_followups` (۵۹۰) | **آخرین** `hamahangi` با تاریخ قبل از امروز ⇒ «موعد ازدست‌رفته» (منشأ باگ — بخش ۶) |
| ۸ | متن پیامک «ثبت بازدید» | `sms/triggers.notify_visit_scheduled` (۵۲-۶۱) | `{date}` = `action.actionDateTime` (شمسی می‌شود) |
همچنین در قالب‌ها: ستون تاریخ در `customerActionInc.html:117,169`، `customerAction.html:42`
و مودال ویرایش (`ActionJson` → `dateTimePickerAnjam.setDate`).
### ۲.۳ اعتبارسنجی
* `validate_action_payload` (۹۰۳): نوع/وضعیت باید مجاز باشد؛ فقط برای
`bazdid+finish` سقف «۳۰ روز آینده» اعمال می‌شود (`FINISH_MAX_FUTURE_DAYS`).
* برای هماهنگی هیچ سقفی روی `actionDateTime` نیست.
* اگر تاریخ اتمام خالی بماند و تیک «انجام شد» زده شود، `finishDateTime = now`.
---
## ۳. فیلد «تا تاریخ پیگیری نشود» — `Customer.visit_hold_until`
### ۳.۱ قواعد نوشتن
| قاعده | پیاده‌سازی | اثر |
|---|---|---|
| فقط هماهنگی | `_apply_visit_hold` (`actions.py:101-128`) | برای بازدید/نصب/وصول بی‌اثر |
| پایانِ روز | `end_of_local_day` (۷۰۳) | «تا آخر ۲۳:۵۹:۵۹ همان روز» |
| خالی + تیک «انجام شد» | `default_hold_until()` با `HOLD_DEFAULT_DAYS=14` (۶۷۹، ۷۲۳) | ۱۴ روز تعویق خودکار |
| خالی + بدون تیک | هیچ نوشتنی | مشتری در فهرست می‌ماند |
| تاریخ گذشته | `normalize_hold_until` (۷۶۵) خطا | فرم با پیام فارسی رد می‌شود |
| بیش از ۱۸۳ روز | `HOLD_MAX_DAYS=183` (۶۸۰) خطا | جلوگیری از تعویق بی‌پایان |
| فقط رو به جلو | `set_visit_hold` (۷۲۹): مقدار فعلی ≥ هدف ⇒ نمی‌نویسد | هماهنگی دومِ کوتاه‌تر قرارِ دورتر را عقب نمی‌کشد |
| ثبت اقدام غیرهماهنگی در حالت ایجاد | `clear_visit_hold` | ستون پاک می‌شود (تست: `test_creating_visit_clears_hold_column`) |
| ویرایش اقدام | عمداً دست نمی‌زند | ویرایش گذشته نباید قرارِ فعلی را پاک کند |
### ۳.۲ قاعدهٔ اعتبار («ستون، مرجع نیست»)
`_valid_manual_holds` (۴۰۵-۴۶۰): یک قرار دستی فقط وقتی معتبر است که
1. برای مشتری یک اقدام `hamahangi` با وضعیت `waite` یا `finish` وجود داشته باشد، و
2. **آخرین فعالیتِ مشتری همان هماهنگی باشد** — اگر بعد از آن، اقدامِ غیرهماهنگی
(بازدید، وصول، تماس، …) با `createdDT` بزرگ‌تر ثبت شده باشد، قرار باطل است.
نتیجهٔ عملی: ستون ممکن است پر باشد ولی «مرده». در دادهٔ واقعی از ۵۴ مقدار پرشده،
۵۱ معتبر و ۳ بی‌اعتبار است (۱ بدون هماهنگی فعال، ۲ به‌خاطر اقدام بعدی).
### ۳.۳ مصرف‌کننده‌ها
| مصرف‌کننده | فایل:تابع | اثر |
|---|---|---|
| منبع `manual` صفحهٔ انتظار | `manual_holds_map` (۴۶۳) → `appointment_sources_map` (۶۴۷) | مشتری از «تعیین‌تکلیف‌نشده» خارج و در `?view=manual` دیده می‌شود |
| فهرست پیگیری روزِ قرار | `followups_on_date` (۵۴۳-۵۵۴) | دقیقاً در همان روز (حتی گذشته) در `?view=today` ظاهر می‌شود |
| مسدودسازی یادآوری دوره‌ای SMS | `next_appointment_map` (۲۹۷) → `scan_visit` (`scanner.py:220,232`) | تا پایان آن روز پیامک `visit` صف نمی‌شود |
| نمایش در جدول | `entezar.html:516-518` | ستون «قرار دستی» + برچسب `قرار دستی` |
| مودال ویرایش | `customerActionInc.html:66,706` (`customer_hold`) | مقدار ذخیره‌شده در فیلد بارگذاری می‌شود |
---
## ۴. اثر دو فیلد بر پیامک‌ها
### ۴.۱ دو نوع پیامکِ بازدید — دو منطق کاملاً متفاوت
| نوع | زمان ارسال | تصمیم‌گیر | داده‌های دخیل |
|---|---|---|---|
| `visit` (دوره‌ای) | اسکنر (`scan_visit`) وقتی موعدِ «آخرین بازدید + ۹ ماه» رسیده باشد | `cycle_anchor_map` + `next_appointment_map` | **هر دو فیلد** (فیلد اول به‌واسطهٔ لنگر، فیلد دوم به‌واسطهٔ قرار) |
| `visit_created` (رویدادی) | بلافاصله پس از ثبت اقدام **بازدید** — هم در «ایجاد» و هم وقتی نوع اقدام در «ویرایش» **به** بازدید تغییر کند | `notify_visit_scheduled` | فقط `actionDateTime` (برای متن `{date}`) |
| `install_created` (رویدادی) | بلافاصله پس از ثبت اقدام **نصب** — همان دو مسیر (ایجاد و تغییر نوع در ویرایش) | `notify_install_scheduled` | فقط `actionDateTime` (برای متن `{date}`) |
### ۴.۲ ماتریس اثر (نتیجهٔ شبیه‌سازی، همه با `scan_visit`)
| سناریو | یادآوری `visit` | پیامک `visit_created` |
|---|---|---|
| مشتری عقب‌افتاده، هیچ اقدامی | ✅ ارسال | — |
| «تا تاریخ پیگیری نشود» = +۱۰ روز (با هماهنگی فعال) | ⛔ تا پایان روزِ دهم؛ از فردای آن ✅ | — |
| ستون `visit_hold_until` پر، ولی **بدون** اقدام هماهنگی | ✅ ارسال (ستون بی‌اثر) | — |
| بازدید `waite` با تاریخ +۵ روز | ⛔ (تا پایان آن روز) | — |
| هماهنگی با تاریخ +۵ روز (بدون تعویق) | ⛔ | — |
| هماهنگی «انجام‌شده» با تاریخ گذشته و بدون تعویق | ✅ ارسال | — |
| ثبت اقدام بازدید (هر وضعیتی) | — | ✅ با `{date}` = `actionDateTime` |
| ثبت اقدام نصب (هر وضعیتی) | — | ✅ `install_created`، مستقل از `visit_created` |
| ثبت اقدام هماهنگی | — | ❌ |
| قرار دستی فعال + ثبت بازدید | — | ✅ (فیلد دوم مانع نیست) |
تست‌های متناظر: `SmsSimulationTests` در `tests/test_entezar_action_simulation.py`
(`test_hold_until_suppresses_visit_reminder`، `test_hold_column_without_coordination_is_inert`،
`test_scheduled_future_visit_suppresses_reminder`، `test_future_coordination_suppresses_reminder`،
`test_visit_action_sends_visit_created_with_action_datetime`، …).
### ۴.۳ چرا «تعویق» روی `visit_created` اثر ندارد؟
چون این پیامک در ویوهای اقدام (`views/actions.py`، تابع `_sync_action_event_sms`) فقط
برای `actionType == bazdid` صدا زده می‌شود، و اصلاً از `next_appointment_map` عبور
نمی‌کند. یعنی اگر هماهنگی بگذارید و بعد بازدیدی ثبت کنید، پیامکِ «بازدید شما برای
تاریخ … ثبت شد» می‌رود حتی اگر «تا تاریخ پیگیری نشود» فعال باشد. همین قاعده برای
`install_created` (اقدام از نوع نصب) هم برقرار است. (اگر رفتار مطلوب چیز دیگری است،
باید در `notify_visit_scheduled`/`notify_install_scheduled` یا در شرط فراخوانی آن‌ها
تغییر کند.)
### ۴.۴ جزئیات مهم `scan_visit`
* `next_appointment_map` = **اجتماع** سه منبع (`manual`، `scheduled`، `coordination`)؛
وجود هر کدام ⇒ `continue` (خط ۲۳۲). پس قرار دستی و تاریخ بازدید و تاریخ هماهنگی هر سه
یادآوری را متوقف می‌کنند — این همان «یک جواب برای صفحه و پیامک» است.
* `dedup_key = visit:{customer_id}:{YYYY-MM موعد}` ⇒ هر دوره حداکثر یک پیامک؛ حذف از صف
فقط همان دوره را کنسل می‌کند.
* خط شروع (`scan_since`) و سقف‌ها می‌توانند ارسال موارد قدیمی را متوقف کنند.
* لنگر چرخه **تماس تلفنی را ریست نمی‌کند**؛ فقط بازدیدِ `finish` (یا نصب) لنگر است.
---
## ۵. تیک «این کار انجام شده است» در اقدام هماهنگی
مسیر تصمیم (`_action_payload_from_request` + `_apply_visit_hold`):
| وضعیت فرم | `Action.status` | `finishDateTime` | `visit_hold_until` | اثر بر فهرست انتظار | اثر بر SMS |
|---|---|---|---|---|---|
| تیک + تاریخ تعویق پر | `finish` | اگر خالی ⇒ `now` | همان تاریخ (پایان روز، فقط رو به جلو) | مشتری تا آن روز پنهان؛ همان روز در `?view=today` برمی‌گردد | یادآوری `visit` تا آن روز قطع |
| تیک + تاریخ تعویق خالی | `finish` | `now` | **+۱۴ روز** | همان | همان |
| بدون تیک + تاریخ تعویق پر | `waite` | `NULL` | همان تاریخ | همان | همان |
| بدون تیک + تاریخ خالی | `waite` | `NULL` | بدون تغییر | مشتری در فهرست می‌ماند | بدون اثر |
نکته‌های ریز:
* در UI، برای هماهنگیِ تیک‌خورده پیش از submit یک **تأیید دو مرحله‌ای** نمایش داده می‌شود
(`holdDoneWarning` / `holdConfirmYes` / `holdConfirmNo` در `customerActionInc.html:609-665`).
اگر کاربر «نه» را بزند، تیک به‌صورت سمت‌کلاینت برداشته می‌شود ⇒ همان سطر سوم/چهارم جدول.
* «انجام شد» هیچ اثر مستقیمی روی «آخرین بازدید» (`last_bazdid_dt`) ندارد؛ هماهنگی هرگز
وارد `last_visit_map` نمی‌شود (`HamahangiIsolationTests`).
* «انجام شد» بدون تاریخ تعویق، **همیشه** ۱۴ روز تعویق می‌سازد؛ اگر کارشناس فقط می‌خواست
تماس را لاگ کند، این پیش‌فرض ناخواسته مشتری را دو هفته پنهان می‌کند.
* در حالت **ویرایش**، `_apply_visit_hold` قرار را پاک نمی‌کند؛ حتی تغییر نوع اقدام از
هماهنگی به بازدید، ستون را دست‌نخورده می‌گذارد (ولی قاعدهٔ «آخرین فعالیت» می‌تواند
آن را بی‌اعتبار کند).
---
## ۶. صفحهٔ `/panel/entezar/` — نمای `?view=today`
### ۶.۱ مسیر محاسبه (گام‌به‌گام)
`views/customers.py:entezar` (۳۷۲-۸۵۳):
1. `now`, `due_cut = visit_due_at(now)` (امروز − ۹ ماه)، `period_months`.
2. `visits = last_visit_map()` — منبع «آخرین بازدید».
3. `sources = appointment_sources_map()` — سه منبع قرارِ **آینده**:
`manual` (ستون تعویق معتبر)، `scheduled` (`bazdid+waite` با تاریخ ≥ آغاز امروز)،
`coordination` (`hamahangi` با تاریخ ≥ همین لحظه).
4. پایهٔ نمای «عقب‌افتاده» (سایر `view`ها): مشتریان `laghv_bazdid=False`، نام‌دار،
`installDate ≤ due_cut`، و سپس `stale_ids` = کسانی که «بازدید معتبر ندارند یا بازدیدشان
≤ `due_cut` است».
5. نمای `today` **جدا** است: `today_followups = followups_on_date(today)` — یعنی
«قرار دستیِ همان روز» + «هماهنگی با تاریخ همان روز»؛ منهای مشتریانی که بازدیدِ
**در انتظار** از آغاز امروز دارند.
6. `_followup_ids`: فیلتر `is_active`، `laghv_bazdid=False`، نام غیرتهی + جست‌وجو؛
مرتب‌سازی بر اساس زودترین موعد.
7. `appointment_rows` برای هر ردیف: ادغام `sources[cid]` با `followups[cid]`، سپس
`source_count` = تعداد کلیدهای موجود از میان `manual/scheduled/coordination`.
8. شمارنده‌ها: `counts['followup_today']` و `counts['followup_overdue']` از همان مسیر
فهرست ⇒ «عدد = تعداد ردیف».
9. عارضهٔ جانبی: ویو در هر GET مقدار `CacheTable('9mahbazdid')` را با
`counts['uncoordinated']` بازنویسی می‌کند (خط ۶۹۹-۷۰۵) — یعنی یک صفحهٔ خواندنی،
نوشتن در دیتابیس دارد.
### ۶.۲ ستون «وضعیت قرار» — معنی برچسب‌ها
قالب `entezar.html:502-515`:
```django
{% if appt.source_count > 1 %} <span>{{ appt.source_count }} قرار</span> ← «۲ قرار»
{% elif appt.manual %} قرار دستی
{% elif appt.scheduled %} بازدید برنامه
{% elif appt.coordination %} هماهنگی
{% else %} بدون قرار
```
* **«N قرار»** = تعداد **منابعِ** قرار، نه تعداد قرارهای واقعی. سه منبع مستقل‌اند و
می‌توانند هم‌زمان وجود داشته باشند.
* «قرار دستی» = ستون `visit_hold_until` (فیلد «تا تاریخ پیگیری نشود»).
* «بازدید برنامه» = اقدام `bazdid` با وضعیت `waite` و تاریخ ≥ آغاز امروز.
* «هماهنگی» = اقدام `hamahangi` (وضعیت `waite` یا `finish`) با تاریخ ≥ همین لحظه.
* ترتیب اولویت برچسب: چندقراره ← دستی ← بازدید ← هماهنگی ← بدون قرار. (ستون
`sort=status` هم همین ترتیب را دارد: 0 بدون، 1 دستی، 2 بازدید، 3 هماهنگی، 4 چندقراره.)
### ۶.۳ شواهد واقعی «۲ قرار»
اعداد زیر روی **کل مشتریان فعالی** که در لحظهٔ ممیزی حداقل یک منبع قرار آینده دارند
محاسبه شده است (نه فقط ردیف‌های یک نما):
| سنجه | مقدار |
|---|---|
| مشتریان با ۱ منبع | ۲٫۲۶۷ |
| مشتریان با ۲ منبع | ۱۶ |
| ترکیب `manual + coordination` | ۱۲ (۱۱ مورد تاریخ‌های **متفاوت**، ۱ مورد هم‌روز) |
| ترکیب `scheduled + coordination` | ۴ |
| بیش از ۲ منبع | ۰ |
نمونه‌ها: `#833` دستی ۲۰۲۶-۱۱-۰۴ / هماهنگی ۲۰۲۶-۱۲-۳۰ — `#2888` هر دو ۲۰۲۶-۱۱-۱۱
(همان یک هماهنگی هم «هماهنگی» شمرده شده هم «قرار دستی»).
**پیامد:** «۲ قرار» همیشه یعنی «دو توافق» نیست. یک هماهنگیِ انجام‌شده که تاریخ تعویق
همان روز را دارد، دو منبع تولید می‌کند و برچسب «۲ قرار» می‌گیرد. اگر هدف نمایش
«تعداد قرارهای واقعی» است، باید منابعِ هم‌منشأ (هماهنگی + قرار دستیِ حاصل از همان اقدام)
یک قرار شمرده شوند.
### ۶.۴ «قرار دستی» — تعریف دقیق
| جنبه | مقدار |
|---|---|
| منبع داده | `Customer.visit_hold_until` (پایانِ روز) |
| نویسنده | فقط اقدام `hamahangi` (فیلد «تا تاریخ پیگیری نشود» / پیش‌فرض ۱۴ روز) |
| شرط اعتبار | یک `hamahangi` فعال + «آخرین فعالیت همان هماهنگی» (`_valid_manual_holds`) |
| شرط نمایش در `?view=today` | `visit_hold_until` داخل بازهٔ همان روز |
| شرط نمایش در `sources` | `visit_hold_until > now` (یعنی قرارِ آینده) |
| اثر | خروج از «تعیین‌تکلیف‌نشده»، ورود به فیلتر `manual`، قطع یادآوری SMS تا آن روز |
عدد واقعی: ۵۴ مشتری ستون پر دارند (۵۱ معتبر)، فقط ۴ ردیف در نمای امروز با منبع
`manual` دیده می‌شوند (۲ فقط-دستی، ۲ دستی+هماهنگی).
---
## ۷. باگ `?view=today&missed=1` — چرا این فهرست پر از مشتریِ بازدیدشده بود؟
> این باگ **رفع شد** (بخش ۹): فهرست از ۱۱۲ ردیف به ۴۲ ردیف رسید و هیچ ردیف
> متناقضی (قرار معتبر + عقب‌افتاده) باقی نماند. متن زیر تحلیل زمان کشف است.
### ۷.۱ تعریف فعلی «عقب‌افتاده» در کد
`visit_policy.overdue_followups` (۵۹۰-۶۴۴):
```python
# آخرین موعد هماهنگی هر مشتری (فقط اقدام hamahangi با waite/finish)
when = as_aware(action_dt) or as_aware(finish_dt) # ← finish هم با actionDateTime
latest[cid] = max(روز when)
overdue = {cid: day for ... if day < today} # ← موعد در گذشته
# تنها حذف‌کننده: بازدیدهای «در انتظار» از زودترین موعد به بعد
pending_visits = _pending_visit_customer_ids(since=آغاز روزِ زودترین موعد)
```
و `_pending_visit_customer_ids` (۴۹۹-۵۱۹) فقط:
```python
actionType='bazdid', status='waite'
```
### ۷.۲ سه ریشهٔ خطا (هم‌راستا با هم)
| # | ریشه | چرا باعث حضور مشتریِ «انجام‌شده» می‌شود |
|---|---|---|
| R1 | **بازدیدِ `finish` هرگز دیده نمی‌شود** | قرار بازدید فقط با `waite` تعریف شده؛ بازدیدی که انجام و بسته شده (`finish`) هیچ اثری در حذف ندارد |
| R2 | **ستون «تا تاریخ پیگیری نشود» نادیده گرفته می‌شود** | `overdue_followups` اصلاً `visit_hold_until` را نمی‌خواند، پس مشتری‌ای که قرارِ آیندهٔ معتبر دارد هم در فهرست «عقب‌افتاده» می‌ماند (و در شمارندهٔ قرمز هم شمرده می‌شود) |
| R3 | **`finish` هم با `actionDateTime` سنجیده می‌شود** | برای هماهنگیِ انجام‌شده، `actionDateTime` «زمان تماس» است نه «قرار بعدی» — همان چیزی که `_future_actions` با `whole_day=False` مستند کرده. نتیجه: هر تماسِ تمام‌شده تا ابد «عقب‌افتاده» می‌ماند تا هماهنگی تازه‌ای ثبت شود |
قاعدهٔ موجود فقط وقتی کار می‌کند که کارشناس **بازدیدِ در انتظار** ثبت کرده باشد؛ یعنی
سناریوی واقعیِ «تماس گرفتم و فردا بازدید می‌کنم» درست عمل می‌کند، اما «تماس گرفتم،
بازدید انجام شد و ثبت شد» هرگز از فهرست خارج نمی‌شود.
### ۷.۳ اعداد واقعی (کپی دیتابیس ۲۰۲۶-۱۰-۲۱)
`?view=today&missed=1` = **۱۱۲ ردیف**:
| سنجه | تعداد | درصد |
|---|---|---|
| حداقل یک بازدیدِ `finish` دارند | ۹۹ | ۸۸٫۴٪ |
| بازدید **پس از ثبت هماهنگی** (createdDT بزرگ‌تر) | ۳۲ | ۲۸٫۶٪ |
| آخرین بازدید **بعد از موعد هماهنگی** | ۲۴ | ۲۱٫۴٪ |
| هیچ بازدیدی ندارند (واقعاً نیازمند پیگیری) | ۱۳ | ۱۱٫۶٪ |
| آخرین هماهنگی `finish` (تماس انجام شده) | ۹۹ | ۸۸٫۴٪ |
| آخرین هماهنگی `waite` | ۱۳ | ۱۱٫۶٪ |
| «قرار دستی» **معتبرِ آینده** دارند و باز هم در فهرست‌اند | ۳۸ | ۳۳٫۹٪ |
| `finish` بدون قرار دستیِ فعال | ۶۱ | ۵۴٫۵٪ |
| بازدیدِ در انتظار (هر تاریخی) دارند | ۰ | ۰٪ |
### ۷.۴ دو نمونهٔ واقعی (خط زمانی کامل)
**#236 — خانم مرضیه جمالی** (`--customer 236`):
```
#77042 hamahangi finish action=2026-10-17 14:31 finish=2026-10-17 15:26 created=2026-10-15
#77176 bazdid finish action=2026-10-18 15:26 finish=2026-10-19 16:12 created=2026-10-17
```
هماهنگی ۱۵ اکتبر ثبت شده، تماس ۱۷ اکتبر انجام شده، **بازدید ۱۸ اکتبر ثبت شده** — ولی
مشتری هنوز در `missed` است، چون R1 و R3 (تاریخِ هماهنگی گذشته است و بازدید `finish`
نادیده گرفته می‌شود).
**#1431 — آقای حمید جمالی:**
```
#63749 hamahangi finish action=2026-10-16 finish=2026-10-17 created=2026-02-09
#77122 bazdid finish action=2026-10-18 created=2026-10-17
#77262 bazdid finish action=2026-10-20 created=2026-10-18
```
دو بازدیدِ انجام‌شده بعد از تماس؛ باز هم در `missed`.
### ۷.۵ چرا «بازدید انجام شده» در ستون «آخرین بازدید» دیده می‌شود ولی چیزی را عوض نمی‌کند؟
ستون «آخرین بازدید» از `last_visit_map` می‌آید (که `bazdid+finish` را می‌بیند)، اما
تصمیم حضور در فهرست از `overdue_followups` می‌آید (که آن را نمی‌بیند). یعنی **دو
تعریف واگرا**؛ دقیقاً همان چیزی که خود `visit_policy` در docstring ابتدایی می‌خواست از
بین ببرد.
### ۷.۶ نمای `today` هم آلوده است (به شکل دیگری)
`?view=today` = **۱۳ ردیف**:
| سنجه | مقدار |
|---|---|
| فقط `coordination` | ۹ |
| فقط `manual` | ۲ |
| `coordination + manual` | ۲ |
| هماهنگی‌های امروز با وضعیت `finish` (تماس انجام‌شده) | ۱ |
| هماهنگی‌های امروز با وضعیت `waite` | ۸ |
| ردیف‌هایی که قرار دستیِ آینده هم دارند (بعداً دوباره می‌آیند) | ۴ |
| ردیف‌هایی که آخرین بازدیدشان در/بعد از همان روز موعد است | ۰ |
> «وضعیت» در دو سطر بالا، وضعیت **آخرین اقدام هماهنگی** همان مشتری است (ممکن است با
> اقدامی که منبع `coordination` امروز را ساخته یکی نباشد).
نتیجه: این نما «موعدِ تماس» را با «موعدِ پیگیری» مخلوط می‌کند؛ تماسِ انجام‌شدهٔ امروز هم
یک ردیف می‌سازد، و اگر همان تماس قرار دستی هم داده باشد، مشتری دو بار (امروز و روزِ
قرار) در فهرست‌های کاری ظاهر می‌شود. همچنین `_pending_visit_customer_ids` فقط
`waite` را حذف می‌کند، پس **بازدیدِ امروزِ انجام‌شده** هم ردیف امروز را حذف نمی‌کند.
### ۷.۷ تناقض آشکار: یک مشتری هم‌زمان «قرار دارد» و «عقب‌افتاده» است
۳۸ مشتری از ۱۱۲ ردیف، در `appointment_sources_map` (و در فیلتر `?view=manual`) قرار
معتبر دارند — یعنی از «تعیین‌تکلیف‌نشده» خارج‌اند — ولی همان لحظه در `missed=1` و در
شمارندهٔ قرمز دیده می‌شوند. مثال: `#3339` قرار دستی ۲۰۲۶-۱۰-۲۲ (امروز) دارد و در
`sources` هم منبع هماهنگی ۲۰۲۶-۱۲-۱۶ دارد؛ یعنی «۲ قرار» گرفته، در حالی که وضعیت
پیگیری‌اش متناقض نمایش داده می‌شود.
---
## ۸. جمع‌بندی ریشه‌ای و پیشنهاد رفع
> وضعیت: **اعمال شد** — فهرست نهایی رفع‌ها، کد تغییرکرده و اثر عددی در بخش ۹.
### ۸.۱ دو تعریف واگرا از «تعیین‌تکلیف شده»
| لایه | معیار فعلی |
|---|---|
| «تعیین‌تکلیف‌نشده» (کارت‌ها/فیلترها) | اجتماع سه منبع قرارِ آینده + اعتبار قرار دستی |
| «عقب‌افتاده» (`missed`) | فقط `hamahangi` + فقط بازدیدِ `waite` |
رفع باگ = هم‌ترازکردن لایهٔ دوم با لایهٔ اول.
### ۸.۲ حداقل تغییرِ ممکن (پیشنهاد، بدون اعمال)
۱. **در `overdue_followups`** بعد از حذف `pending_visits`:
```python
# الف) هر بازدیدِ انجام‌شده که تاریخ مؤثرش از روزِ موعد عقب‌تر است، تکلیف را روشن کرده
for customer_id, action_dt, finish_dt in Action.objects.filter(
actionType=Action.ActionType.BAZDID, status=Action.Status.FINISH,
).values_list('customer_id', 'actionDateTime', 'finishDateTime').iterator():
eff = as_aware(action_dt) if action_dt and as_aware(action_dt) <= now else as_aware(finish_dt)
if eff and eff.date() >= overdue.get(customer_id, today):
overdue.pop(customer_id, None)
# ب) قرار دستیِ معتبر همان چیزی است که کاربر صریحاً گفته «تا این تاریخ پیگیری نکن»
for customer_id in manual_holds_map(now=now):
overdue.pop(customer_id, None)
```
۲. **در `followups_on_date`**: همان قاعدهٔ «بازدید انجام‌شدهٔ بعد از موعد» را هم اعمال
کنید (فیلتر سوم بعد از `pending_visits`)، و اگر مشتری هم `manual` دارد و هم
`coordination` از **همان اقدام**، فقط `manual` را نگه دارید تا ردیف تکراری/«۲ قرار»
کاذب ساخته نشود.
۳. **معنای تاریخ `finish` در هماهنگی**: تصمیم محصولی لازم است؛ پیشنهاد: موعدِ
`finish` را `visit_hold_until` بدانید و `actionDateTime` را فقط برای `waite`
به‌عنوان موعد بشمارید. این تنها راه حذف ۹۹ ردیفِ «تماس انجام‌شده» از فهرست
عقب‌افتاده‌ها بدون از دست دادن قرارهای واقعی است.
۴. **`_valid_manual_holds`**: ابطال قرار را به اقدام‌های «واقعاً جایگزین قرار» محدود کنید
(`bazdid`/`nasb`) نه هر اقدام غیرهماهنگی؛ الان یک سند وصول یا تماس ورودی، قرار را
باطل می‌کند.
۵. **برچسب «N قرار»**: تعداد را بر اساس **تاریخ‌های یکتا** یا **اقدام‌های یکتا** حساب
کنید (نه تعداد کلیدهای منابع)، یا منابع هم‌منشأ را در `appointment_rows` ادغام کنید.
۶. **نوشتن در GET**: بازنویسی `CacheTable('9mahbazdid')` را از ویو به یک دستور/سیگنال
منتقل کنید (کش باید مشتق باشد، نه منبع).
### ۸.۳ ریسک‌ها
* هر تغییر در `overdue_followups` روی شمارندهٔ قرمزِ هدر (`entezarbazdid`/`followup_overdue`)
و هشدارهای صفحه اثر می‌گذارد؛ تست `test_overdue_counter_equals_missed_rows` را حفظ کنید.
* `scan_visit` از `next_appointment_map` می‌خواند، نه از `overdue_followups`؛ پس تغییر
فهرست، پیامک‌ها را جابه‌جا **نمی‌کند** (خوب است).
* تست‌های `MissedViewSimulationTests` رفتار فعلی را قفل کرده‌اند؛ بعد از رفع، باید
`assertIn` به `assertNotIn` تبدیل شود.
---
## ۹. باگ‌های شناسایی‌شده و رفع‌شده
> تاریخ رفع: ۲۰۲۶-۱۰-۲۲ · بدون تغییر در قرارداد داده‌ها (بدون migration) ·
> ۲۶۹ + ۱۹۹ تست قبلی سبز ماند + ۴۶ تست شبیه‌سازی/رگرسیون.
### ۹.۱ چرخهٔ کسب‌وکار (مبنا همهٔ تصمیم‌ها)
```
نصب دستگاه ──► ۹ ماه ──► «موعد بازدید» (کارت عقب‌افتاده + پیامک visit)
│
▼
تماس کارشناس (hamahangi)
├── انجام نشده (waite) ──► موعد تماس = actionDateTime ──► نمای «امروز»
└── انجام شد (finish) ───► «تا تاریخ پیگیری نشود» ──► پنهان تا آن روز + قطع SMS
│
▼
بازدید انجام شد (bazdid + finish)
──► لنگر چرخه از نو (۹ ماه) + پیامک visit_created
```
اصل حاکم بر همهٔ رفع‌ها: **قرار/بازدیدِ انجام‌شده باید فهرست کار را ببندد، ولی هیچ
مشتریِ بدون قرار نباید بی‌صدا از فهرست کار ناپدید شود.**
### ۹.۲ جدول باگ‌ها
| # | نوع | باگ | ریشه | رفع |
|---|---|---|---|---|
| B1 | کسب‌وکار | فهرست `missed=1` پر از مشتریانی که بازدیدشان انجام شده بود (۹۹ از ۱۱۲) | `overdue_followups` فقط بازدیدِ `waite` را حذف می‌کرد | بازدیدِ `finish` با تاریخ مؤثر ≥ موعد ⇒ حذف از فهرست |
| B2 | کسب‌وکار | ۳۸ ردیف هم‌زمان «قرار معتبر آینده» و «عقب‌افتاده» بودند | ستون `visit_hold_until` در `overdue_followups` خوانده نمی‌شد | قرار دستیِ معتبر ⇒ حذف از فهرست |
| B3 | کسب‌وکار | نمای «امروز» بعد از بازدیدِ همان روز، ردیف را نگه می‌داشت | `followups_on_date` فقط `waite` را حذف می‌کرد | بازدیدِ انجام‌شده از همان روز به بعد ⇒ حذف ردیف (فقط امروز/آینده) |
| B4 | کسب‌وکار | یک سند وصول یا تماس ورودی، «قرار دستی» را بی‌صدا باطل می‌کرد | `_valid_manual_holds` هر اقدام غیرهماهنگی را «جایگزین قرار» می‌گرفت | فقط `bazdid`/`nasb` قرار را باطل می‌کنند (`_SUPERSEDING_TYPES`) |
| B5 | کسب‌وکار | «۲ قرار» برای یک توافق (هماهنگی + تعویقِ همان روز) | `source_count` تعداد منابع بود، نه تعداد قرار | شمارش روزهای یکتا (و همان قاعده در `sort=status`) |
| B6 | فنی | مرز «وظایف امروز» با رشتهٔ naive ساخته می‌شد (وابسته به تایم‌زون/DST) | `strftime('%Y-%m-%d 00:00:00')` در `ActionListToday`/`ActionListUserToday` | `_local_day_range()` صریح و aware با پوشش DST |
| B7 | فنی | هر GET صفحهٔ انتظار، `CacheTable` را می‌نوشت (حتی بدون تغییر) | `save()` بی‌قید در ویو | فقط در صورت تغییر + `update_fields` |
| B8 | فنی (تست) | تست `test_overdue_column_hidden_only_in_followup_view` به ساعت اجرا وابسته بود | هماهنگی «امروز ساعت ۱۲» می‌توانست «آینده» شمرده شود | تست با مشتری بدون قرار، مستقل از ساعت |
| B9 | کسب‌وکار | اقدام **«نصب»** ردیف را از فهرست‌های کار (`?view=today` و `?view=today&missed=1`) حذف نمی‌کرد؛ فقط «بازدید» حذف می‌کرد | `followups_on_date`/`overdue_followups` در دو مرحلهٔ «قرار در انتظار» و «انجام‌شده» فقط `bazdid` را می‌دیدند (`_pending_visit_customer_ids` و `last_visit_map`) | آن دو مرحله به `_pending_appointment_ids` (با `_CYCLE_RESET_TYPES` = `bazdid`/`nasb`) و `cycle_anchor_map` منتقل شدند؛ `last_visit_map` دست‌نخورده ماند |
| B10 | رویداد | تغییر نوع یک اقدام از «هماهنگی» به «بازدید» در فرم **ویرایش**، پیامک `visit_created` نمی‌فرستاد | تریگر `notify_visit_scheduled` فقط در `customerNewAction` صدا زده می‌شد (یک فراخوان در کل کد) | در `customerEditAction` گذار نوع بررسی می‌شود: غیربازدید → بازدید ⇒ تریگر؛ بازدید → غیربازدید ⇒ `cancel_pending_sms_for_action(action_id=…)`. تکرار با `dedup_key=visit_created:{action.pk}` مهار می‌شود |
| F1 | قابلیت | نوع پیامک «ثبت نصب» (اقدام از نوع نصب) وجود نداشت | فرم‌های اقدام از نوع نصب هیچ تریگر پیامکی نداشتند | `SMSType.INSTALL_CREATED` + `notify_install_scheduled` + قالب قابل ویرایش در `/panel/sms/templates` + تریگر در هر دو ویوی ایجاد/ویرایش (مهاجرت ۰۰۸۱) |
> **F1 — قیدهای ایمنی مهاجرت ۰۰۸۱:** مهاجرت فقط `choices` را گسترش می‌دهد
> (`AlterField` = متادیتا، بدون تغییر داده) و **یک** ردیف تازه با
> `get_or_create` می‌سازد. هیچ `update`/`save` روی قالب‌های موجود ندارد؛ اگر قالب
> `install_created` از قبل باشد هم دست نمی‌خورد. قالب تازه:
> `is_enabled=True` (در پنل دیده شود) و **`auto_send=False`** ⇒ پیامک‌ها در صف
> «در انتظار تأیید» می‌مانند تا مدیر خودش تأیید کند. تست‌های نگهبان:
> `InstallTemplateMigrationTests` و `test_install_template_is_seeded_with_auto_send_off`
> در `tests/test_sms.py`.
> **B9 — جزئیات (۲۰۲۶-۱۰-۲۷):** «نصب» از قبل در `_SUPERSEDING_TYPES` (ابطال قرار
> دستی) و `_CYCLE_RESET_TYPES` (ریست چرخهٔ ۹ ماهه در اسکنر پیامک) بود، ولی فهرست
> کار روزانه آن را نمی‌دید. حالا:
>
> * `nasb + waite` با تاریخ از آغاز روز مورد نظر به بعد ⇒ ردیف پنهان می‌شود
> (همان قاعدهٔ `bazdid + waite`؛ «قرار امروز» تا پایان امروز معتبر است).
> نصبِ در انتظارِ **قدیمی‌تر** از آن روز، قرار فعال نیست و ردیف را باز نمی‌گذارد.
> * `nasb + finish` با تاریخ مؤثر از موعد به بعد ⇒ ردیف بسته می‌شود (همان قاعدهٔ
> `bazdid + finish`).
> * `last_visit_map` (تاریخ آخرین **بازدید**، ستون جدول، `last_bazdid_dt` و پیامک)
> عمداً تغییر نکرد؛ «نصب» فقط لنگر چرخه است، نه بازدید.
### ۹.۳ اثر روی دادهٔ واقعی (همان نسخهٔ پشتیبان)
| سنجه | قبل | بعد |
|---|---|---|
| ردیف‌های `?view=today&missed=1` | **۱۱۲** | **۴۲** |
| ردیف با قرار دستیِ معتبر و هم‌زمان در فهرست | ۳۸ | **۰** |
| ردیف با بازدیدِ بعد از موعد (بسته‌شده) | ۶۲ (۳۲ + ۲۴ + …) | **۰** |
| ردیف با بازدیدِ قدیمی‌تر از موعد (واقعاً نیازمند) | ۳۱ | ۳۱ |
| ردیف بدون هیچ بازدید | ۱۳ | ۱۳ |
نمونه‌های گزارش‌شده: `#236` و `#1431` دیگر در فهرست نیستند (بازدیدشان بعد از موعد
هماهنگی ثبت شده بود).
### ۹.۴ چرا این رفع‌ها چرخه را نمی‌شکنند
* `next_appointment_map` (منبع تصمیم اسکنر پیامک) دست نخورده است ⇒ **هیچ پیامکی
جابه‌جا نشد**؛ فقط نمایش فهرست کار درست شد.
* هیچ فیلد/معنای داده‌ای تغییر نکرد؛ `visit_hold_until` همچنان مشتق و بی‌اعتبار
به‌تنهایی است.
* هر رفع، «حذف از فهرست کار» است نه «حذف مشتری»: مشتریِ بدون قرار همچنان در
`?view=uncoordinated` (تعیین‌تکلیف‌نشده) دیده می‌شود.
* قاعدهٔ «عدد هشدار = تعداد ردیف فهرست» حفظ شد (شمارنده از همان تابع می‌آید).
* `followups_on_date` برای **روزهای گذشته** رفتار قبلی را نگه می‌دارد تا مرور
تقویم، سندِ کاریِ همان روز را بازنویسی نکند.
### ۹.۵ باقی‌مانده (تصمیم محصولی، عمداً تغییر نکرد)
* موعدِ هماهنگیِ `finish` همچنان «زمان تماس» است. اگر تعویق منقضی شود و بازدیدی
ثبت نشود، مشتری دوباره «نیازمند پیگیری» می‌شود. این عمدی است: «ناپدید شدن
بی‌صدای مشتریِ بی‌قرار» خطرناک‌تر از «یک ردیف اضافه» است. اگر کسب‌وکار تصمیم
بگیرد تماسِ انجام‌شده چرخه را ۹ ماه عقب بیندازد، تغییر فقط افزودن `hamahangi`
به `_CYCLE_RESET_TYPES` است — با اثر جانبی روی پیامک‌ها.
* `Customer.visit_hold_until` همچنان ستون مشتق است (بدون migration)؛ تنها
نویسنده‌اش باید `set_visit_hold` بماند.
### ۹.۶ بازخورد شفاف + تأیید کاربر برای «عقب‌بردن» تاریخ قرار
> پیاده‌سازی‌شده · بدون migration · منطق تصمیم‌گیری عوض نشده (قاعدهٔ «فقط رو به جلو» پابرجاست).
پیش از این، اگر تاریخ «تا تاریخ پیگیری نشود» از قرار فعلی عقب‌تر بود،
`set_visit_hold` مقدار `False` برمی‌گرداند و لایهٔ فراخوان آن را دور می‌ریخت:
نه نوشتنی، نه پیامی، نه نشانه‌ای. حالا زنجیره کامل و شفاف است:
| لایه | تغییر |
|---|---|
| `visit_policy.set_visit_hold(..., force=False)` | پارامتر تأیید صریح؛ پیش‌فرض همان قاعدهٔ «فقط رو به جلو» |
| `views/actions._apply_visit_hold(...)` | خروجی ساخت‌یافته: `{'ok', 'reason', 'current', 'target', 'force_allowed'}` — `reason='forward_only'` یعنی نوشته نشد |
| `views/actions._report_hold_result(...)` | `messages.warning` کوتاه: «تاریخ قرار ذخیره نشد؛ از قرار فعلی این مشتری (تاریخ) عقب‌تر است.» + مسیر انجام (تیک/ویرایش) |
| `customerNewAction` / `customerEditAction` | مقدار `force_hold` فرم و گزارش نتیجه به کاربر |
| `customerActionInc.html` | اعلان `holdBackwardNotice` + `force_hold` + تیک «تاریخ قرار را عقب ببر» (فقط در ویرایش) |
| `customerBaseNew.html` | پیام `warning` با رنگ هشدار (کهربایی) نمایش داده می‌شود |
### تجربهٔ کاربر
1. تاریخ عقب‌تر را انتخاب می‌کند؛ همان لحظه (نه فقط هنگام ثبت) اعلان کوتاه باز می‌شود:
«این تاریخ از قرار فعلی عقب‌تر است» / «قرار فعلی: ۱۴۰۵/۰۸/۰۲».
2. **در ویرایش**: تیک «تاریخ قرار را عقب ببر» ⇒ `force_hold=1` و ذخیره می‌شود.
بدون تیک، ثبت بلاک می‌شود و فوکوس روی همان اعلان می‌رود.
3. **در ایجاد وظیفهٔ تازه**: تیک وجود ندارد؛ به‌جای آن یک خط راهنما:
«این تاریخ ذخیره نمی‌شود. برای تغییر قرار، وظیفهٔ هماهنگی فعلی را ویرایش کنید.»
دلیل: در ایجاد، کاربر قصد اصلاح قرار موجود را ندارد و اجازه دادن می‌توانست
ناخواسته قولِ ثبت‌شدهٔ قبلی (شاید کارِ کارشناس دیگر) را کوتاه کند. خودِ وظیفه
ثبت می‌شود؛ فقط تاریخ قرار عقب نمی‌رود.
4. اگر جاوااسکریپت اجرا نشود یا کاربر مستقیم POST بزند، **سرور** هم مستقل بررسی
می‌کند: نه می‌نویسد، نه ساکت می‌ماند — پیام هشدار روی صفحهٔ اقدام نمایش داده می‌شود
(برای ایجاد، پیام «همان وظیفه را ویرایش کنید» را نشان می‌دهد).
5. همان روز ⇒ تغییر واقعی لازم نیست؛ هیچ پیامی هم ساخته نمی‌شود.
### تست‌ها (`HoldBackwardConfirmTests` — ۸ مورد)
| تست | چه چیزی را تضمین می‌کند |
|---|---|
| `test_earlier_date_is_not_saved_and_user_is_told` | نوشته نمی‌شود + پیام شامل «ذخیره نشد»، قرار فعلی و مسیر تأیید؛ پیام در HTML صفحه هم دیده می‌شود |
| `test_user_confirmation_writes_the_earlier_date` | با `force_hold` تاریخ عقب‌تر ذخیره می‌شود |
| `test_forward_date_needs_no_confirmation` | تاریخ جلوتر مثل قبل بدون پرسش ذخیره می‌شود |
| `test_same_day_is_silent` | همان روز ⇒ بدون پیام |
| `test_create_does_not_move_the_hold_backward` | در ایجاد، حتی با `force_hold=1` ستون عقب نمی‌رود، ولی خودِ وظیفه ثبت می‌شود + پیام «ویرایش کنید» |
| `test_apply_visit_hold_reports_reason` | قرارداد تابع: `reason='forward_only'` و `force_allowed=True` در ویرایش |
| `test_apply_visit_hold_ignores_force_on_create` | `force_hold` در ایجاد نادیده گرفته می‌شود |
| `test_modal_exposes_confirmation_controls` | قالب شامل `data-customer-hold`، `force_hold`، `hbForceRow`، `hbCreateHint` است |
علاوه بر آن، منطق جاوااسکریپت با اجرای همان کدِ قالب (نه کپی) در Node آزموده شد:
«عقب‌تر ⇒ هشدار»، «جلوتر/همان روز/بدون قرار/نوع غیرهماهنگی ⇒ بی‌هشدار».
---
## ۱۰. سناریوی «تعویق پیش از تاریخ کار» (۱۴۰۵/۰۸/۰۳ در برابر ۱۴۰۵/۰۸/۰۵)
> بازتولید: `scripts/coordination_hold_order_probe.py --customer 5124`
> قفل رفتاری: `tests/test_entezar_action_simulation.py::HoldBeforeWorkDateSimulationTests`
### ۱۰.۱ چه اتفاقی می‌افتد
| ورودی | مقدار ذخیره‌شده |
|---|---|
| نوع = هماهنگی · «تاریخ و ساعتی که کار باید انجام شود» = ۱۴۰۵/۰۸/۰۵ | `Action.actionDateTime` = ۲۰۲۶-۱۰-۲۷ |
| «تا تاریخ پیگیری نشود» = ۱۴۰۵/۰۸/۰۳ | `Customer.visit_hold_until` = ۲۰۲۶-۱۰-۲۵ ۲۳:۵۹:۵۹ |
هر دو تاریخ در آینده‌اند، پس `normalize_hold_until` قبول می‌کند:
**هیچ اعتبارسنجی‌ای «تعویقِ زودتر از تاریخ کار» را رد نمی‌کند** (نه در فرم، نه در سرور).
نتیجه: دو تاریخ متفاوت برای یک مشتری ⇒ منبع `manual` (۱۰-۲۵) + منبع `coordination` (۱۰-۲۷).
### ۱۰.۲ گاه‌شمار رفتار (شبیه‌سازی‌شده، هم با تیک و هم بدون تیک)
| روز | منابع قرار | برچسب | «نیازمند پیگیری امروز» | «عقب‌افتاده» | یادآوری SMS |
|---|---|---|---|---|---|
| ۱۰-۲۲ تا ۱۰-۲۴ | manual + coordination | **۲ قرار** | خیر | خیر | ارسال نمی‌شود |
| ۱۰-۲۵ (روزِ تعویق) | manual + coordination | ۲ قرار | **بله** ← ردیف کاری اضافه | خیر | ارسال نمی‌شود |
| ۱۰-۲۶ | coordination | ۱ قرار | خیر | خیر | ارسال نمی‌شود |
| ۱۰-۲۷ (تاریخ کار) | coordination | ۱ قرار | **بله** (روز قرار) | خیر | ارسال نمی‌شود |
| ۱۰-۲۸ به بعد | — | بدون قرار | خیر | **بله** | (موعد چرخه) |
مقایسه با حالت سالم (تعویق ۱۱-۰۱ ≥ تاریخ کار ۱۰-۲۷): از ۱۰-۲۸ به بعد
`manual` باقی می‌ماند، «۱ قرار» می‌شود و مشتری «عقب‌افتاده» نمی‌شود.
### ۱۰.۳ اثر تیک «انجام شد»
| مورد | با تیک | بدون تیک |
|---|---|---|
| `status` | `finish` | `waite` |
| `finishDateTime` | اگر خالی ⇒ **همین حالا** (نه ۱۰-۲۷) | `NULL` |
| `visit_hold_until` | همان ۱۰-۲۵ | همان ۱۰-۲۵ |
| پنهان‌سازی/«۲ قرار»/SMS | **یکسان** | **یکسان** |
| «لیست وظایف» و شمارندهٔ داشبورد (`status='waite'`) | خارج می‌شود | می‌ماند (وظیفهٔ ۱۰-۲۷) |
| صف «نظرسنجی» (`finish` و `nazarDT` خالی) | **وارد می‌شود** | وارد نمی‌شود |
| تشخیص «قرار دستی» | معتبر (همهٔ شرط‌ها) | معتبر |
یعنی تیک روی «قرار» اثری ندارد؛ فقط «وظیفه بسته شد» را اعلام می‌کند و در عوض
مشتری را به صف نظرسنجی می‌برد.
### ۱۰.۴ پیامدهای کسب‌وکاری این ورودی
1. **ردیف کاری تکراری**: در ۱۰-۲۵ (روز تعویق) مشتری در «نیازمند پیگیری» ظاهر می‌شود،
در حالی که قرارِ توافق‌شده ۱۰-۲۷ است ⇒ تماسِ بی‌مورد.
2. **برچسب گمراه‌کننده**: «۲ قرار» نشان می‌دهد دو توافق وجود دارد، ولی در واقع یک
توافق است با تعویقی که زودتر از موعدِ کار تمام می‌شود.
3. **سقوطِ یک‌روزه به «عقب‌افتاده»**: فردای تاریخ کار، تعویق قبلاً منقضی شده، پس
«بدون قرار» و «عقب‌افتاده» می‌شود.
4. **بدون ارسال پیامک در فاصلهٔ ۱۰-۲۵ تا ۱۰-۲۷**: چون `next_appointment_map` (که اسکنر
می‌خواند) هنوز منبع `coordination` را دارد؛ صفحه و پیامک واگرا نمی‌شوند.
### ۱۰.۵ توصیه
* برای یک توافق، **تاریخ تعویق = تاریخ کار** (یا دورتر) بگذارید؛ آن‌وقت «۱ قرار» می‌شود
و ردیف تکراری ساخته نمی‌شود.
* اگر می‌خواهید سیستم جلوی این ورودی را بگیرد، حداقل تغییر: در
`normalize_hold_until`/ویو، اگر `hold < actionDateTime` بود، **هشدار** بدهید
(نه خطا) — چون در برخی سناریوها («تعویق تا این تاریخ، بعدش خودم تماس می‌گیرم»)
ممکن است عمدی باشد.
---
## ۱۱. بازتولید و اعتبارسنجی
### ۱۱.۱ ممیزی روی دیتابیس واقعی (فقط خواندن)
```bash
.venv/Scripts/python.exe scripts/entezar_action_audit.py
.venv/Scripts/python.exe scripts/entezar_action_audit.py --samples 10
.venv/Scripts/python.exe scripts/entezar_action_audit.py --customer 236
.venv/Scripts/python.exe scripts/entezar_action_audit.py --db data9/<backup>.sqlite3
```
اسکریپت ابتدا کل فایل sqlite (به‌همراه `-wal`/`-shm`) را در پوشهٔ موقت کپی می‌کند و
همهٔ کوئری‌ها/توابع `visit_policy` را روی همان کپی اجرا می‌کند؛ دیتابیس اصلی دست‌نخورده
می‌ماند. خروجی شامل پنج بخش است (missed، today، برچسب‌ها، ستون قرار، هماهنگی‌ها) و با
`--customer` خط زمانی کامل یک مشتری.
### ۱۱.۲ شبیه‌سازی‌ها
```bash
.venv/Scripts/python.exe manage.py test tests.test_entezar_action_simulation -v 2
```
نتیجهٔ اجرا: **۵۵ تست، OK** (Django 3.2.25، SQLite حافظه‌ای). پوشش:
| کلاس | تعداد | چه چیزی را ثابت می‌کند |
|---|---|---|
| `ActionFormSimulationTests` | ۹ | نگاشت دو فیلد، پیش‌فرض ۱۴ روز، رد تاریخ گذشته/بیش از ۶ ماه، «فقط رو به جلو»، بی‌اثری روی بازدید |
| `EntezarDecisionSimulationTests` | ۸ | «۲ قرار» فقط برای دو روز متفاوت، «قرار دستی»، ابطال با بازدید، روزِ پیگیری، خروج با بازدید آینده |
| `AppointmentLifetimeSimulationTests` | ۴ | سند وصول/تماس قرار را باطل نمی‌کند؛ بازدید/نصب باطل می‌کند (B4) |
| `FollowupDaySimulationTests` | ۳ | بازدیدِ امروز ردیف امروز را می‌بندد؛ بازدید دیروز نه؛ مرور روز گذشته دست‌نخورده (B3) |
| `TaskListBoundaryTests` | ۲ | مرز ۰۰:۳۰/۲۳:۳۰ به وقت محلی؛ وظیفهٔ انجام‌شده در «امروز» نمی‌آید (B6) |
| `CacheTableWriteTests` | ۱ | عدد کش داشبورد = شمارندهٔ «تعیین‌تکلیف‌نشده» (B7) |
| `MissedViewSimulationTests` | ۹ | رفع B1/B2: بازدید `finish` و قرار دستی معتبر از فهرست خارج می‌کنند؛ قرارِ مرده نه |
| `SmsSimulationTests` | ۱۱ | قطع/بازگشت یادآوری دوره‌ای، بی‌اثری ستون تنها، `visit_created` با تاریخ، پاک‌شدن ستون با ثبت بازدید |
| `HoldBeforeWorkDateSimulationTests` | ۹ | سناریوی «تعویق پیش از تاریخ کار»: پذیرش، «۲ قرار»، ردیف تکراری، سکوت SMS، سقوط به missed، تفاوت تیک/بدون‌تیک |
> سناریوی ۱۴۰۵/۰۸/۰۳ در برابر ۱۴۰۵/۰۸/۰۵ در بخش ۱۰ به‌تفصیل آمده و با
> `scripts/coordination_hold_order_probe.py` قابل بازپخش است.
### ۱۱.۳ محدودیت‌ها / فرض‌ها
* همهٔ اعداد از **یک نسخهٔ پشتیبان** (۲۰۲۶-۱۰-۲۱) است؛ با دادهٔ فردا تغییر می‌کنند.
* ممیزی «تاریخ مؤثر» را با قاعدهٔ `effective_visit_dt` بازسازی می‌کند؛ اگر رکوردی
`actionDateTime` آینده داشته باشد، `finishDateTime` مبنا می‌شود.
* «بازدید انجام‌شده پس از هماهنگی» بر اساس `createdDT` (زمان ثبت) سنجیده شده، نه تاریخ
واقعی بازدید؛ چون `createdDT` تنها ستونی است که ترتیب ثبت را تضمین می‌کند.
* هیچ‌کدام از تست‌ها به «امروزِ واقعی» وابسته نیستند مگر از طریق `timezone.now()` در
لحظهٔ اجرا؛ برای همین در هر تاریخ دیگری هم باید سبز بمانند (تاریخ‌ها نسبی‌اند).
### ۱۱.۴ فایل‌های مرتبط
| فایل | نقش |
|---|---|
| `admin_panel/visit_policy.py` | تنها منبع حقیقت قرار/بازدید (`last_visit_map`، `appointment_sources_map`، `followups_on_date`، `overdue_followups`، `manual_holds_map`) |
| `admin_panel/views/actions.py` | ایجاد/ویرایش/حذف اقدام، `_apply_visit_hold`، لیست وظایف |
| `admin_panel/views/customers.py` | ویوی `entezar` و ساخت `appointment_rows` |
| `admin_panel/sms/scanner.py` | `scan_visit` (یادآوری دوره‌ای) |
| `admin_panel/sms/triggers.py` | `notify_visit_scheduled` (پیامک ثبت بازدید) |
| `admin_panel/templates/admin_panel/entezar.html` | برچسب‌های وضعیت و ستون‌های قرار |
| `admin_panel/templates/admin_panel/customerActionInc.html` | فرم و JS دو فیلد + تأیید «هماهنگی انجام شد» |
| `docs/visit_hold_entezar.md` | طراحیِ موردنظر (سند قبلی) — بخش‌هایی از آن در کد فعلی رعایت نشده (R2/R3) |
+744
View File
@@ -0,0 +1,744 @@
# «قرار بعدی» بازدید و صفحهٔ انتظار — توضیح کامل عملکرد
این سند رفتار نهایی صفحهٔ `/panel/entezar/`، فیلد «تا تاریخ پیگیری نشود» در فرم
اقدام، و قواعد محاسبه را توضیح می‌دهد. هدف: بعد از این تغییر، **هماهنگیِ انجام‌شده
هم** مشتری را تا تاریخ توافق از فهرست خارج کند و کاربر بتواند بازدیدهای
«هماهنگ‌شده» را از «هماهنگ‌نشده» جدا ببیند.
---
## ۱. صورت مسئله
پیش از این تغییر، فقط دو حالت مشتری را از فهرست خارج می‌کرد:
1. اقدام `bazdid` با وضعیت `waite` و تاریخ آینده (بازدید برنامه‌ریزی‌شده)
2. اقدام `hamahangi` با تاریخ **آینده** در فیلد تاریخ اقدام
اما سناریوی واقعی کارشناس این بود:
> «همین حالا با مشتری تماس گرفتم، توافق کردیم هفتهٔ بعد بیاییم، و تیک *انجام شد* را
> زدم.»
در این حالت، فیلد «تاریخ اقدام» روی **همین حالا** می‌نشیند، پس هیچ قرار آینده‌ای
وجود نداشت و مشتری در فهرست می‌ماند و کارشناس دیگری دوباره تماس می‌گرفت.
**ریشه:** «تاریخ تماس» و «تاریخ قرار بعدی» دو مفهوم متفاوت‌اند ولی در یک فیلد
(`actionDateTime`) جمع شده بودند.
---
## ۲. راه‌حل: ستون «قرار بعدی»
دو ستون به مدل `Customer` اضافه شد:
| ستون | نوع | معنا |
|---|---|---|
| `visit_hold_until` | `DateTimeField(null=True)` | تا **پایان** این روز پیگیری لازم نیست |
| `visit_hold_set_at` | `DateTimeField(null=True)` | زمان ثبت، برای حسابرسی |
### قاعدهٔ طلایی: ستون، «مرجع» نیست
> `visit_hold_until` هیچ اعتباری به‌تنهایی ندارد. یک قرار دستی فقط وقتی اثر دارد
> که **هر سه** شرط برقرار باشد:
>
> ۱. تاریخش از حالا جلوتر باشد،
> ۲. برای همان مشتری یک اقدام **هماهنگیِ فعال** (`waite` یا `finish`) وجود داشته باشد،
> ۳. **آخرین اقدامِ جایگزین‌کنندهٔ قرار، همان هماهنگی باشد** — اگر بعد از آن
> «بازدید» (`bazdid`) یا «نصب» (`nasb`) ثبت شده باشد، قرار منتفی است.
> اقدام‌های دیگر (وصول، تماس ورودی/خروجی، …) قرار را باطل **نمی‌کنند**.
شرط ۳ برای این است که «ثبت بازدید پس از هماهنگی» قرار را خودکار باطل کند.
بدون آن، قرار قدیمی تا تاریخش زنده می‌ماند و مشتری در فهرست «با قرار» می‌ماند،
هرچند بازدید جای هماهنگی را گرفته است.
> **اصلاح ۲۰۲۶-۱۰-۲۲:** قبلاً «هر اقدام غیرهماهنگی» قرار را باطل می‌کرد؛ نتیجه
> این بود که یک سند وصول یا یک تماس ثبت‌شده، قرارِ توافق‌شده را بی‌صدا از بین
> می‌برد و مشتری دوباره در فهرست تماس ظاهر می‌شد. حالا فقط `bazdid`/`nasb`
> (یعنی اقدام‌هایی که واقعاً جای قرار می‌نشینند) قرار را باطل می‌کنند
> (`visit_policy._SUPERSEDING_TYPES`).
نتیجهٔ این قاعده:
| رویداد | اثر روی قرار |
|---|---|
| حذف اقدام هماهنگی | قرار **خودکار بی‌اثر** می‌شود |
| لغو هماهنگی (`cancell`) | بی‌اثر می‌شود |
| ویرایش تاریخ هماهنگی | قرار با تاریخ جدید هم‌راستا می‌شود |
| **ثبت بازدید یا نصب پس از هماهنگی** | قرار **خودکار بی‌اثر** می‌شود |
| ثبت سایر اقدام‌ها (وصول، تماس…) | قرار دست‌نخورده می‌ماند |
| کهنه ماندن ستون | **هیچ اثر مخربی ندارد** |
> **تکمیل ۲۰۲۶-۱۰-۲۷:** «نصب» در فهرست‌های کار هم مثل «بازدید» عمل می‌کند:
> `nasb + waite` با تاریخ از امروز به بعد و `nasb + finish` از موعد به بعد، ردیف را
> از `?view=today` و `?view=today&missed=1` خارج می‌کند
> (`visit_policy._pending_appointment_ids` و `cycle_anchor_map`). این دو نوع همان
> `_CYCLE_RESET_TYPES` هستند که چرخهٔ ۹ ماهه و قرار دستی را هم بازنشانی می‌کنند.
به همین دلیل دیگر خطر «کش کهنه» وجود ندارد: منبع حقیقت همیشه جدول `Action` است.
---
## ۳. سه منبع «قرار بعدی»
تصمیم «مشتری در فهرست هست یا نه» از اجتماع سه منبع گرفته می‌شود:
| منبع | تعریف | تاریخ قرار | مرز زمانی |
|---|---|---|---|
| `manual` | ستون `visit_hold_until` (با اعتبارسنجی بالا) | همان ستون (پایان روز) | پایان امروز |
| `scheduled` | `bazdid + waite` | `actionDateTime` | **پایان روز** |
| `coordination` | `hamahangi` با `waite` یا `finish` | `actionDateTime` (یا `finishDateTime`) | **لحظه‌ای** |
تابع واحد: `visit_policy.next_appointment_map(now)` — **همان تابعی که اسکنر پیامک
هم استفاده می‌کند**، پس صفحه و پیامک هرگز واگرا نمی‌شوند.
**چرا مرز زمانیِ دو منبع فرق دارد؟**
* در `scheduled`، `actionDateTime` یک **قرارِ آینده** است که کارشناس با تقویم
روزانه انتخاب می‌کند؛ پس «قرار امروز» باید تا پایان امروز معتبر بماند. با
مقایسهٔ لحظه‌ای، بازدیدِ امروز بلافاصله پس از گذشتن ساعتش از فهرست ناپدید
می‌شد (باگی که گزارش شد).
* در `coordination`، `actionDateTime` **زمانِ تماس** است، نه قرار آینده. اگر آن
را هم تا پایان روز معتبر بگیریم، هر تماسِ امروز مشتری را تا آخر امروز از
گروه «قرار دستی» بیرون می‌برد و سناریوی اصلی (تماس امروز + قرار دو هفته بعد)
بی‌اثر می‌شد.
اگر مشتری چند قرار داشته باشد، **زودترین** تاریخ ملاک نمایش است؛ اما برای
«بازگشت به فهرست» کافی است **آخرین** قرار منقضی شود.
---
## ۴. فرم ثبت اقدام (UI)
در مودال «ایجاد وظیفه» (`customerActionInc.html`):
| مورد | رفتار |
|---|---|
| نمایش فیلد | فقط وقتی نوع اقدام = **هماهنگی** انتخاب شود |
| برچسب | «تا تاریخ پیگیری نشود» |
| کنترل | تقویم شمسی (همان `pDatepicker` پروژه) |
| پیش‌فرض | اگر خالی بماند و تیک «انجام شد» زده شود ⇒ **+۱۴ روز** |
| سقف | **۶ ماه** (اعتبارسنجی سروری) |
| حالت ویرایش | فیلد با نوع اقدام هم‌راستا می‌شود (نمایش/پنهان) **و مقدار ذخیره‌شدهٔ مشتری در آن بارگذاری می‌شود** |
نکتهٔ مهم: فیلد «تاریخ و ساعتی که کار باید انجام شود» (`dateTimeAnjam`) همچنان
«زمان تماس» است و دست نخورده باقی می‌ماند. دو مفهوم، دو فیلد.
### ۴.۱ چیدمان مودال (mobile first)
مودال به سه گام شماره‌دار تقسیم شده تا کاربر بداند چه چیزی را کجا وارد کند:
| گام | محتوا |
|---|---|
| ۱ | نوع اقدام + مسئول (توسط) — کنار هم در دسکتاپ، زیر هم در موبایل |
| ۲ | زمان‌بندی: تاریخ انجام، «تا تاریخ پیگیری نشود»، و راهنمای بازشونده |
| ۳ | توضیحات، تیک «انجام شده»، تاریخ اتمام و نتیجه |
نکات پیاده‌سازی:
* پیشوند همهٔ کلاس‌ها `ax-` و همهٔ انتخابگرها زیر `#ActionBox` است ⇒ هیچ استایلی
به سایر صفحات نشت نمی‌کند.
* روی موبایل: کارت تمام‌عرض (`calc(100% - 1rem)`)، بدنهٔ اسکرول‌شونده، هدف لمسی
حداقل ۲٫۶rem، و دکمه‌های پاصفحه تمام‌عرض.
* روی دسکتاپ (≥۷۶۸px): شبکهٔ دوستونه، عرض حداکثر ۴۴rem.
* سرصفحه نام مشتری را نشان می‌دهد تا کاربر بداند برای چه کسی وظیفه می‌سازد.
* **همان تقویم شمسی قبلی** استفاده می‌شود: `dateTimePickerAnjam`،
`dateTimePickerFinish` و `dateTimePickerHoldUntil` با `pDatepicker` و
`calendar.persian.locale = 'fa'`. هیچ کتابخانهٔ جدیدی اضافه نشده است.
* **نام کلاس فیلد باید با سلکتور JS یکی باشد.** هر فیلد تاریخ دو المان دارد:
ورودی نمایشی (با کلاس `dateTimePickerXxx`) و ورودی مخفیِ ارسال (با کلاس
`dateTimePickerXxx-alt`). اگر این نام‌ها هم‌خوانی نداشته باشند،
`pDatepicker` روی مجموعهٔ خالی اجرا می‌شود، `undefined` برمی‌گرداند و
`setDate()` با `TypeError` کل هندلر را می‌شکند — نتیجه: تقویم باز نمی‌شود و
بقیهٔ منطق (پنهان‌کردن فیلدها، برداشتن تیک خودکار) هم اجرا نمی‌شود.
دو تست اختصاصی
(`test_every_picker_selector_matches_markup` و
`test_every_alt_field_class_exists_in_markup`) همین را قفل کرده‌اند.
* `altField` با فرمت پیش‌فرض `unix` مقدار می‌دهد؛ بنابراین `visitHoldUntil`
یک timestamp میلی‌ثانیه‌ای است که `_parse_form_datetime` آن را می‌خواند.
* تقویم به `body` اضافه می‌شود (نه داخل مودال) ⇒ اسکرول بدنهٔ مودال آن را نمی‌برد.
### ۴.۲ هشدار زمان‌بندی و پیش‌فرض «انجام شده» (فقط هماهنگی)
چون در عمل «ثبت هماهنگی» یعنی «همین حالا با مشتری تماس گرفتم»، انتخاب نوع
**هماهنگی** به‌طور خودکار تیک «این کار انجام شده است» را می‌زند (و فیلدهای
تاریخ اتمام و نتیجه را نمایش می‌دهد). برای جلوگیری از ثبتِ ناخواسته، دو لایه
محافظ اضافه شده است:
**۱) هشدار همیشگی** — به‌محض تیک‌خوردن و تا وقتی نوع هماهنگی است، یک کادر
کهربایی زیر تیک نمایش داده می‌شود:
> آیا مطمئن هستی که هماهنگی را انجام دادی؟
> اگر هنوز هماهنگی نکردی، این تیک را بردار.
**۲) تأیید در لحظهٔ ثبت** — اگر کاربر روی «ثبت» بزند و نوع هماهنگی و تیک
«انجام شده» فعال باشد، ارسال متوقف می‌شود و همان کادر برجسته شده و دو دکمه
نشان می‌دهد:
| دکمه | نتیجه |
|---|---|
| بله، هماهنگی انجام شد | فرم ارسال می‌شود (هماهنگی با وضعیت `finish` ثبت می‌شود) |
| نه، تیک را بردار | تیک برداشته می‌شود، فیلدهای اتمام پنهان می‌شوند و ارسال نمی‌شود |
قواعد ایمنی:
* **فقط هماهنگی**: سایر انواع اقدام (بازدید، نصب، وصول، تماس…) هیچ تیک
خودکار و هیچ تأییدی ندارند و رفتارشان دقیقاً مثل قبل است.
* **تغییر نوع = برداشتن تیک خودکار**: اگر سیستم تیک زده باشد و کاربر نوع را
به غیر هماهنگی تغییر دهد، تیک برداشته می‌شود (تا ناخواسته `last_bazdid_dt`
یا وضعیت «انجام شده» ثبت نشود). اگر کاربر خودش تیک زده باشد، دست‌نخورده
می‌ماند.
* **حالت ویرایش**: تأیید گرفته نمی‌شود (کاربر فقط رکورد موجود را اصلاح می‌کند)؛
اما کادر هشدار برای هماهنگیِ انجام‌شده به‌صورت اطلاعاتی نمایش داده می‌شود.
* **باز شدن مجدد مودال**: تیک، هشدار و وضعیت تأیید همیشه ریست می‌شوند.
#### بارگذاری مقدار ذخیره‌شده در حالت ویرایش
هر ردیف اقدام، مقدار فعلی `Customer.visit_hold_until` را به‌صورت ISO در
صفت `customer_hold` نگه می‌دارد. هنگام کلیک روی ردیف (باز کردن فرم ویرایش)،
تابع `seedHoldPicker()` آن را به تقویم شمسی و فیلد مخفی `visitHoldUntil`
می‌نویسد.
> **باگی که این بخش رفع می‌کند:** قبلاً فرم ویرایش مقدار را از دیتابیس
> نمی‌خواند. مقدار در سرور **درست ذخیره می‌شد** ولی چون فیلد هنگام باز شدن
> مجدد خالی نمایش داده می‌شد، کاربر فکر می‌کرد «ثبت نشده است».
ترتیب کار مهم است: `seedHoldPicker()` **بعد از** `toggleCoordinationField()`
صدا زده می‌شود، چون برای انواع غیرهماهنگی، `toggle` فیلد را پاک می‌کند.
#### ایمنی ویرایش رکوردهای قدیمی
در حالت **ویرایش**، تغییر نوع اقدام به غیرهماهنگی، قرار دستی را پاک
**نمی‌کند**؛ زیرا رکورد ویرایش‌شده ممکن است قدیمی‌تر از یک هماهنگیِ جدیدتر
باشد و پاک‌کردن، قرار معتبر را از بین می‌برد. اعتبارسنجی `manual_holds_map`
(شرط «آخرین فعالیت = هماهنگی») خودش قرار را بی‌اثر می‌کند.
در حالت **ایجاد** برعکس است: اقدام تازه آخرین فعالیت مشتری است، پس ثبت
بازدید جدید قرار قبلی را پاک می‌کند.
### ۴.۳ راهنمای بازشونده (فقط «هماهنگی»)
زیر فیلد تاریخ پیگیری، یک دکمهٔ راهنما با آیکون `!` قرار دارد که پنل توضیحات را
باز/بسته می‌کند. محتوای پنل:
* «این تاریخ چه کاری می‌کند؟» — تعریف ساده + اینکه تا پایان همان روز معتبر است.
* «مثال» — سناریوی واقعی با تاریخ نمونه.
* «نکات مهم» — خالی + تیک ⇒ ۱۴ روز، خالی + بدون تیک ⇒ بدون تعویق،
فقط تمدید (نه کوتاه‌کردن)، حذف/لغو هماهنگی ⇒ بازگشت فوری، سقف ۶ ماه،
تفاوت با «تاریخ بازدید پرسنل»، و توقف پیامک یادآوری در مدت تعویق.
رفتار:
| رویداد | نتیجه |
|---|---|
| انتخاب نوع = هماهنگی | دکمهٔ راهنما ظاهر می‌شود (پنل بسته) |
| کلیک روی دکمه | پنل باز/بسته می‌شود و `aria-expanded` به‌روز می‌شود |
| تغییر نوع به غیر هماهنگی | فیلد و راهنما پنهان و پنل بسته می‌شود |
| باز شدن مجدد مودال (ایجاد یا ویرایش) | پنل همیشه بسته شروع می‌شود |
دسترسی‌پذیری: دکمه `aria-expanded` و `aria-controls="holdHelpPanel"` دارد و
پنل با `is-hidden` کنترل می‌شود.
### قواعد اعتبارسنجی (سرور)
* تاریخ قرار نباید **پیش از امروز** باشد ⇒ پیام: «تاریخ قرار نمی‌تواند پیش از امروز باشد.»
* حداکثر **۱۸۳ روز** (≈۶ ماه) جلوتر ⇒ پیام: «قرار بعدی حداکثر می‌تواند ۱۸۳ روز (۶ ماه) جلوتر باشد.»
* تاریخ «امروز» پذیرفته است و به **۲۳:۵۹:۵۹ همان روز** تبدیل می‌شود (تا پایان روز معتبر).
* اگر اعتبارسنجی رد شود، **هیچ اقدامی ذخیره نمی‌شود**.
### قاعدهٔ «تمدید مجاز، کوتاه‌کردن ممنوع» (max)
قرار ذخیره‌شده همیشه **بزرگ‌ترین** تاریخِ ثبت‌شده است:
```
visit_hold_until = max(مقدار فعلی، تاریخ جدید)
```
| وضعیت | نتیجه |
|---|---|
| قرار فعلی ۱ آذر، کارشناس جدید ۸ آذر | **تمدید می‌شود به ۸ آذر** ✅ |
| قرار فعلی ۸ آذر، کارشناس جدید ۱ آذر | **تغییری نمی‌کند** (۸ آذر می‌ماند) |
منطق: اگر مشتری گفته «۸ آذر تماس بگیرید»، سیستم نباید ۱ آذر زنگ بزند. در مقابل،
یک ثبت اشتباه نباید قرارِ طولانیِ قبلی را نابود کند.
**برای عقب‌بردن قرار** (مثلاً مشتری گفت زودتر بیایید): هماهنگی را **حذف** و دوباره
با تاریخ جدید ثبت کنید.
---
## ۵. صفحهٔ انتظار: چهار گروه و فیلترها
تفکیک بر اساس **نوعِ منبع** است، نه «چند گروه ثابت». هر مشتری می‌تواند صفر تا
سه منبع داشته باشد:
| منبع | تعریف | فیلتر |
|---|---|---|
| `manual` | ستون `visit_hold_until` (تعویق از فرم هماهنگی) | `?view=manual` |
| `scheduled` | اقدام `bazdid` + `waite` با تاریخ آینده | `?view=scheduled` |
| `coordination` | اقدام `hamahangi` (waite/finish) با تاریخ آینده | `?view=coordination` |
> **باگ قبلی:** `coordination` با `scheduled` در یک گروه جمع می‌شد؛ نتیجه اینکه
> مشتریانی که فقط «هماهنگی» داشتند در نمای «بازدید برنامه‌ریزی‌شده» دیده
> می‌شدند و برچسب «بازدید برنامه‌ریزی‌شده» می‌گرفتند. حالا هر منبع فیلتر و
> ستون خودش را دارد.
### فیلترها (قابل بوکمارک و ترکیب با جست‌وجو)
| URL | نمایش | شامل |
|---|---|---|
| `/panel/entezar/` (بدون پارامتر) | **پیش‌فرض = نیازمند پیگیری امروز** | موعد تماس‌های امروز |
| `/panel/entezar/?view=today` | نیازمند پیگیری امروز (یا تاریخ `fdate`) | موعد تماس‌های آن روز |
| `?view=uncoordinated` | بدون قرار | بدون هیچ منبع |
| `?view=manual` | قرار دستی | هر مشتری با `manual` |
| `?view=scheduled` | بازدید برنامه‌ریزی‌شده | هر مشتری با `scheduled` |
| `?view=coordination` | هماهنگی | هر مشتری با `coordination` |
| `?view=coordinated` | همهٔ دارای قرار | اجتماع هر سه منبع |
| `?view=all` | همهٔ معوق‌ها | همه |
| مقدار نامعتبر | برگشت به پیش‌فرض (`today`)، **بدون خطا** | موعد تماس‌های امروز |
چون یک مشتری می‌تواند چند منبع داشته باشد، در چند فیلتر دیده می‌شود؛ اما در
`?view=coordinated` فقط **یک‌بار** شمرده می‌شود. به همین دلیل جمع سه کارت منبع
می‌تواند از «با قرار» بیشتر باشد (صفحه این را در راهنمای بالای خود توضیح می‌دهد).
### ستون‌های جدول
| ستون | توضیح |
|---|---|
| وضعیت قرار | «بدون قرار» / «قرار دستی» / «بازدید برنامه» / «هماهنگی» / «N قرار» |
| قرار دستی | تاریخ شمسی قرار دستی (یا —) |
| بازدید برنامه‌ریزی‌شده | تاریخ شمسی اقدام بازدید با تاریخ آینده (یا —) |
| هماهنگی | تاریخ شمسی اقدام هماهنگی با تاریخ آینده (یا —) |
| آخرین بازدید | بدون تغییر نسبت به قبل |
### شمارندهٔ داشبورد
`CacheTable('9mahbazdid')` = **بدون قرار** (کارِ فوری). هر بار باز شدن صفحه
به‌روز می‌شود. با تغییر تفکیک، این عدد **تغییر نمی‌کند**.
---
## ۶. تعامل با سایر بخش‌ها
| بخش | اثر |
|---|---|
| **آخرین بازدید** (`last_visit_map`) | دست‌نخورده — فقط `bazdid + finish` |
| **چرخهٔ ۹ ماهه** (`cycle_anchor_map`) | دست‌نخورده — `bazdid` و `nasb` |
| **اسکنر پیامک** (`scan_visit`) | فقط یک منبع اضافه در `next_appointment_map` |
| **`recalc_last_bazdid`** | دست‌نخورده |
| **`last_bazdid_dt`** | بدون تغییر (نمایش/ترتیب) |
| **ایندکس `act_visit_idx`** | بدون تغییر |
قاعدهٔ طلایی حفظ شده است: **هماهنگی هرگز بازدید حساب نمی‌شود.**
---
## ۶.۱ حذف یک اقدام (soft-delete)
دکمهٔ «حذف» فقط در صفحهٔ اقدام‌های مشتری (`/panel/customer/<id>/action`) نمایش
داده می‌شود و **هیچ رکوردی فیزیکی حذف نمی‌شود**؛ به‌جای آن:
| ستون | مقدار |
|---|---|
| `status` | `cancell` |
| `deleted_at` | زمان حذف |
| `deleted_by` | کاربر حذف‌کننده |
### چرا `cancell` و نه ستون `is_deleted`؟
همهٔ محاسبات (`last_visit_map`، `cycle_anchor_map`، `appointment_sources_map`،
`followups_on_date`، `overdue_followups`) از قبل فقط `waite`/`finish` را
می‌بینند؛ و `ActionList*` و `ActionCount` هم با `status='waite'` فیلتر می‌شوند.
پس همین یک مقدار، اقدام را از **همهٔ** خروجی‌ها خارج می‌کند — بدون Manager
سفارشی، بدون تغییر ایندکس پوشا و بدون دست‌زدن به ۳۱ کوئری.
### قاعدهٔ محصولی: اقدام دارای نظرسنجی حذف نمی‌شود
اگر `nazarDT` پر باشد (نظرسنجی ثبت‌شده)، حذف انجام **نمی‌شود**؛ چون هیچ
آرشیو/کپی‌ای وجود ندارد و گزارش رضایت‌سنجی برای همیشه تغییر می‌کرد. در UI
دکمه به حالت قفل‌شده با برچسب «نظرسنجی» درمی‌آید.
### پیامدهای جانبی (در همان تراکنش)
۱. `last_bazdid_dt` بازمحاسبه می‌شود (کش کهنه نمی‌ماند).
۲. قرار دستی اگر دیگر مرجعی نداشته باشد، خودکار بی‌اثر می‌شود.
۳. پیامک‌های **ارسال‌نشدهٔ** «بازدید ثبت شد» همان مشتری به `cancelled` می‌روند
(پیامک‌های ارسال‌شده دست نمی‌خورند).
### اثر روی مصرف‌کننده‌ها
| بخش | اثر |
|---|---|
| `/panel/entezar/` (همهٔ نماها) | اقدام کاملاً نادیده گرفته می‌شود |
| `/panel/ActionList/<u>/today` | از صف وظایف خارج می‌شود |
| `ActionCount` داشبورد | بلافاصله کم می‌شود |
| فهرست اقدام‌های مشتری | به‌طور پیش‌فرض پنهان (با `?status=cancell` قابل مشاهده برای حسابرسی) |
| `/panel/customer/<id>/nazar/` | پنهان |
| `/panel/ActionList/all` | پنهان |
| گزارش وصول (`finance.py`) | آخرین اقدام وصول دیگر آن را نمی‌بیند |
| داشبورد رضایت‌سنجی و گزارش روزانه | `deleted_at__isnull=True` |
| صف پیامک | `CANCELLED` در `DONE_STATUSES` ⇒ از صف بیرون می‌رود |
### امنیت
- فقط **POST** مجاز است؛ درخواست GET ریدایرکت می‌شود و چیزی را عوض نمی‌کند.
- `get_object_or_404(Action, id=..., customer=customer)` ⇒ حذف اقدام مشتری دیگر
ممکن نیست (۴۰۴).
- توکن CSRF در فرم اجباری است.
- تأیید دو‌مرحله‌ای پیش از حذف (نوع اقدام در متن تأیید نمایش داده می‌شود).
---
## ۷. سناریوهای تست‌شده
| # | سناریو | نتیجهٔ انتظار | وضعیت |
|---|---|---|---|
| ۱ | هماهنگی با قرار «امروز» | تا پایان روز خارج از فهرست | ✅ |
| ۲ | هماهنگی finish بدون تاریخ قرار | پیش‌فرض ۱۴ روز | ✅ |
| ۳ | حذف اقدام هماهنگی | قرار بی‌اثر، مشتری برمی‌گردد | ✅ |
| ۴ | لغو هماهنگی (`cancell`) | قرار بی‌اثر | ✅ |
| ۵ | هماهنگی دوم با تاریخ کوچک‌تر | قرار قبلی حفظ می‌شود | ✅ |
| ۶ | هماهنگی دوم با تاریخ بزرگ‌تر | قرار تمدید می‌شود | ✅ |
| ۷ | قرار بیش از ۶ ماه | رد با پیام، هیچ ذخیره‌ای | ✅ |
| ۸ | قرار در گذشته | رد با پیام | ✅ |
| ۹ | بازدید واقعی بعد از قرار | مشتری از فهرست خارج می‌ماند | ✅ |
| ۱۰ | هماهنگی finish با تاریخ آینده (بدون ستون) | خارج از فهرست | ✅ |
| ۱۱ | تفکیک A/B/C/D و هر پنج فیلتر | اعداد و فهرست درست | ✅ |
| ۱۲ | `?view=nonsense` | پیش‌فرض، بدون خطا | ✅ |
| ۱۳ | اسکنر پیامک با قرار دستی | پیامک ارسال نمی‌شود | ✅ |
| ۱۴ | اجتماع منابع در `next_appointment_map` | زودترین تاریخ | ✅ |
جمع: **۳۷۶ تست موفق** در کل پروژه (۱۵ تست جدید مربوط به این قابلیت).
---
## ۸. استقرار
```bash
# ۱) بکاپ
python manage.py sqlite_db_backup # یا کپی فایل دیتابیس
# ۲) مهاجرت (دو ستون nullable — امن و سریع)
python manage.py migrate
# ۳) بررسی
python manage.py check
python manage.py test tests
```
### رفتار دادهٔ موجود
* همهٔ مشتریان با `visit_hold_until = NULL` شروع می‌کنند ⇒ **رفتار امروز دقیقاً حفظ می‌شود**.
* هماهنگی‌های قدیمی (۵ رکورد سال ۲۰۲۲) هیچ ستونی ندارند و فقط از مسیر `Action`
ارزیابی می‌شوند.
---
## ۹. نکات عملیاتی
1. **حذف هماهنگی** بهترین راه برای «لغو قرار» است.
2. اگر قرار اشتباه ثبت شد، هماهنگی را **حذف** و دوباره ثبت کنید (قرار جدید فقط
می‌تواند تمدید کند، نه آن را کوتاه‌تر کند).
---
# بخش دوم — امکانات جدید رابط کاربری صفحهٔ انتظار
این بخش قابلیت‌هایی را توضیح می‌دهد که برای «راحت دیدن اطلاعات و تصمیم درست
گرفتن» اضافه شده‌اند. طراحی **mobile first** است: در موبایل هر مشتری یک کارت
می‌شود و در دسکتاپ همان جدول قبلی؛ هیچ صفحه/منوی جدیدی اضافه نشده و شکل کلی
صفحه حفظ شده است.
## ۱. نوار آمار (بالای صفحه)
چهار کارت. عنوان‌ها با **زبان کسب‌وکار** انتخاب شده‌اند، نه زبان دیتابیس. هر کارت
هم عدد را نشان می‌دهد و هم **لینک فیلتر** است:
| کارت | معنا | توضیح زیر عدد |
|---|---|---|
| **نیازمند پیگیری امروز** | موعد تماسشان **امروز** است و بازدید ندارند — فهرست کارِ امروز | موعد تماسشان امروز است — بازدید ندارند |
| **همهٔ مشتریان عقب‌افتاده** | همه، با هر وضعیت پیگیری | با هر وضعیت پیگیری |
| **تعیین تکلیف نشده** | هنوز هیچ وقت بازدید/پیگیری ندارند | هنوز وقت بازدید تعیین نشده — نیاز به تماس |
| **تعیین تکلیف شده** | وقت بعدی‌شان مشخص است | وقت بعدی‌شان مشخص است |
> **چرا «مشتری» و نه «بازدید»؟** عددِ کارت دوم تعداد **مشتری** است، نه تعداد
> بازدید. یک مشتری می‌تواند ده‌ها بازدید گذشته داشته باشد ولی فقط **یک بار**
> در این فهرست شمرده شود.
### تفکیک نوع قرار — در دراپ‌داون، نه روی کارت
کارت‌ها **عمداً ساده** نگه داشته شده‌اند: فقط عنوان، عدد و یک توضیح. جزئیات سه
نوع قرار (تعویق / بازدید / پیگیری) روی کارت چاپ **نمی‌شود**؛ چون:
- شش عدد روی کارت‌ها باعث سردرگمی می‌شد (بازخورد کاربران).
- ارتفاع کارت‌ها نامساوی و چیدمان موبایل به‌هم می‌ریخت.
- همان اطلاعات از دراپ‌داون **«نوع قرار»** در نوار فیلتر در دسترس است.
> جمع سه منبع می‌تواند از عدد «تعیین تکلیف شده» بیشتر باشد، چون یک مشتری
> می‌تواند چند منبع قرار داشته باشد؛ در `?view=coordinated` هر مشتری فقط
> **یک‌بار** شمرده می‌شود.
## ۱.۱ نمای «نیازمند پیگیری امروز» (`?view=today`) — **پیش‌فرض صفحه**
> **پیش‌فرض:** با باز کردن `/panel/entezar/` (بدون پارامتر)، همین نما نمایش داده
> می‌شود؛ کاربر بلافاصله فهرست کارِ امروز را می‌بیند.
فهرست کاریِ روزانهٔ کارشناس: **با چه کسانی امروز باید تماس بگیریم؟**
### این فهرست از کجا می‌آید؟
دو منبع، هر دو با شرط «موعد = همان روز»:
| منبع | تعریف |
|---|---|
| **هماهنگی** | اقدام `hamahangi` با `status` در (`waite`/`finish`) و `actionDateTime` (وگرنه `finishDateTime`) در همان روز |
| **قرار دستی** | `Customer.visit_hold_until` که تاریخش همان روز است (با همان اعتبارسنجی «ستون، مرجع نیست») |
### قاعدهٔ قطعی: «بازدید» اینجا نمی‌آید
> اگر برای مشتری **قرار بازدید** (`bazdid + waite`) ثبت شده باشد، **هرگز** در این
> فهرست نمایش داده نمی‌شود — حتی اگر برای همان روز هم موعد پیگیری داشته باشد.
دلیلش روشن است: وقتی پرسنل برای بازدید می‌آید، تماس تلفنی لازم نیست.
**استثنای مهم:** بازدیدهای بسیار قدیمی که هرگز بسته نشده‌اند (backlog) قرار فعال
محسوب نمی‌شوند؛ وگرنه یک رکورد کهنه می‌توانست مشتری را برای همیشه از فهرست
پنهان کند. شرط دقیق: بازدیدِ در انتظار با تاریخ **≥ آغاز روز مورد نظر**.
### تفاوت با فهرست «عقب‌افتاده»
| | «نیازمند پیگیری» | «عقب‌افتاده» |
|---|---|---|
| شرط ورود | موعد تماس = آن روز | از آخرین بازدید بیش از دوره گذشته |
| مشتری سالم | ✅ اگر قرار تماس داشته باشد می‌آید | ❌ نمی‌آید |
| شرط `installDate` | ندارد | دارد |
| ترتیب پیش‌فرض | زودترین ساعت موعد | قدیمی‌ترین بازدید |
### تقویم شمسی (گذشته و آینده)
نوار تاریخ فقط در این نما ظاهر می‌شود و شامل این‌هاست:
- **تقویم شمسی** (`pDatepicker`) برای انتخاب هر روزی
- دکمه‌های **‹ روز قبل** و **روز بعد ›**
- دکمهٔ **بازگشت به امروز** (اگر تاریخ انتخابی امروز نباشد)
```
/panel/entezar/?view=today امروز
/panel/entezar/?view=today&fdate=1405/07/28 روز دیگر (شمسی)
```
- مقدار نامعتبر/خالی ⇒ **امروز** (بدون خطا).
- عدد کارت «نیازمند پیگیری امروز» **همیشه عدد امروز** را نشان می‌دهد، حتی وقتی
در تقویم روز دیگری را می‌بینید.
- فیلتر «میزان تأخیر» و تفکیک آن در این نما **پنهان** می‌شود (مشتری این فهرست
ممکن است اصلاً تأخیری نداشته باشد)؛ اما جست‌وجو و مرتب‌سازی فعال است.
### ستون «تأخیر» در این نما نمایش داده نمی‌شود
این فهرست دربارهٔ «موعد تماس امروز» است، نه عقب‌افتادگی بازدید؛ پس ستون «تأخیر»
فقط در سایر نماها دیده می‌شود. عرض آن (۸٪) به ستون «نام» اضافه می‌شود تا مجموع
عرض ستون‌ها همچنان دقیقاً ۱۰۰٪ بماند (۸ ستون به‌جای ۹).
### هشدار «پیگیری‌های عقب‌افتاده»
اگر موعد پیگیری مشتریانی گذشته باشد و هنوز تعیین تکلیف نشده باشند، زیر نوار تاریخ
یک هشدار مینیمال قرمز با نقطهٔ کوچک نمایش داده می‌شود:
```
● 72 مورد نیازمند پیگیری از روزهای قبل باقی مانده
```
قواعد محاسبه (`visit_policy.overdue_followups`):
- مبنای هر مشتری، **آخرین** اقدام هماهنگی (`waite`/`finish`) است.
- اگر آن تاریخ **پیش از امروز** باشد ⇒ عقب‌افتاده.
- اگر مشتری هماهنگیِ امروز یا آینده داشته باشد ⇒ عقب‌افتاده **نیست**
(یعنی تمدید شده و از فهرست بیرون می‌رود).
- اگر برایش **قرار بازدید** ثبت شده باشد ⇒ حذف می‌شود (همان قاعدهٔ «بازدید گذاشته
شده ⇒ تماس لازم نیست»).
- هماهنگیِ لغوشده (`cancell`) اصلاً دیده نمی‌شود.
کلیک روی هشدار، همان فهرست را باز می‌کند:
```
/panel/entezar/?view=today&missed=1
```
در این حالت یک چیپ قرمز «نمایش N پیگیریِ عقب‌افتاده ✕ بازگشت به امروز» نشان داده
می‌شود و هشدار پنهان می‌گردد. عدد هشدار **دقیقاً** برابر تعداد ردیف‌های همین
فهرست است (هر دو از یک مسیر محاسبه می‌شوند).
## ۲. فیلترها (نوار زیر کارت‌ها)
یک ردیف فشرده با چهار کنترل؛ همه با هم ترکیب‌پذیرند و در URL حفظ می‌شوند.
| کنترل | پارامتر | مقادیر |
|---|---|---|
| نوع قرار | `view` | `all` · `uncoordinated` · `coordinated` · `manual` · `scheduled` · `coordination` |
| میزان تأخیر | `delay` | `lt30` · `30to90` · `90to180` · `gt180` (خالی = همه) |
| مرتب‌سازی | `sort` + `dir` | `last_visit` · `overdue` · `name` · `status` · `coordination` (و هر ستون دیگر) |
| جست‌وجو | `searchVal` + `searchOn` | `name` · `phone` · `code` · `address` |
- تغییر هر دراپ‌داون ⇒ فرم **خودکار** ارسال می‌شود.
- دکمهٔ **✕ حذف فیلترها** فقط وقتی فیلتری فعال است ظاهر می‌شود و همه را به
حالت پیش‌فرض برمی‌گرداند.
- **کارت‌ها هیچ‌وقت با فیلتر تغییر نمی‌کنند** — همیشه کل جامعه را نشان می‌دهند.
فقط فهرست زیرشان فیلتر می‌شود.
## ۳. تفکیک مدت تأخیر (کلیک‌پذیر)
زیر نوار فیلتر، تعداد مشتریان بر اساس **مدت عقب‌افتادگی** در **نمای جاری**
نمایش داده می‌شود و هر عدد **لینک فیلتر** است:
- تا ۳۰ روز
- ۳۰ تا ۹۰ روز
- ۹۰ تا ۱۸۰ روز
- بیش از ۶ ماه
**مبنای محاسبه:** «موعد بازدید» = آخرین بازدید معتبر + دورهٔ قالب. برای
مشتریِ بدون بازدید، مبنای مقایسه مقطع دوره است تا عدد بی‌معنا نشود.
یعنی «۳ ماه تأخیر» = «۳ ماه از موعد بازدید گذشته»، نه «۳ ماه از خود بازدید».
> جمع این چهار عدد همیشه برابر تعداد ردیف‌های نمای جاری است (تست‌شده).
## ۴. مرتب‌سازی (ستون‌ها و دراپ‌داون)
**هر ۹ ستون** با کلیک روی سرستون مرتب می‌شوند؛ کلیک دوباره جهت را برمی‌گرداند:
| ستون | مبنا |
|---|---|
| نام و نام خانوادگی | الفبایی |
| وضعیت قرار | بدون قرار ← تعویق ← بازدید ← پیگیری ← چندقراره |
| قرار دستی | تاریخ قرار (خالی‌ها آخر) |
| بازدید برنامه‌ریزی‌شده | تاریخ قرار (خالی‌ها آخر) |
| هماهنگی | تاریخ پیگیری (خالی‌ها آخر) |
| آخرین بازدید | تاریخ مؤثر بازدید از `Action` |
| تأخیر | تعداد روز تأخیر |
| تلفن | مقدار `phone1` |
| آدرس | الفبایی |
- سرستون فعال با فلش **▲/▼** و ستون‌های دیگر با **⇅** مشخص می‌شوند.
- **مقادیر خالی همیشه آخر می‌آیند**، مستقل از جهت — وگرنه مرتب‌سازی ستون‌های
قرار، فهرست را بی‌معنا می‌کرد.
- دراپ‌داون «مرتب‌سازی» چند گزینهٔ پرکاربرد را کوتاه می‌کند.
- مقادیر قدیمی `sort=oldest|newest|overdue` همچنان کار می‌کنند (سازگاری با
بوکمارک‌های قبلی).
## ۵. جست‌وجو
| فیلد | جست‌وجو در |
|---|---|
| نام و نام خانوادگی | `name_family` |
| تلفن | `phone1`، `phone2`، `phone3` |
| آدرس | `address` |
| کد مشتری | `idCode` |
نما، فیلتر تأخیر و مرتب‌سازی هنگام جست‌وجو **حفظ می‌شوند**.
## ۵. چیدمان ستون‌ها (بازطراحی)
پیش‌تر ستون «ردیف» یک ستون کامل جدول را برای یک عدد دو رقمی می‌گرفت و دو ستون
با `min-width` ثابت (۱۹۰px و ۳۲۰px) تعیین عرض می‌کردند؛ نتیجه: بی‌تناسبی
فاصله‌ها و اسکرول افقی. تغییرات:
1. **ستون «ردیف» حذف شد.** شمارهٔ ردیف حالا یک **چیپ کوچک کنار نام** است
(`.ez-idx`) که هم فضا نمی‌خورد و هم برای پیدا کردن ردیف کافی است.
2. **عرض ستون‌ها با `<colgroup>` درصدی** تعیین می‌شود و جدول
`table-layout: fixed` است. بنابراین:
- مجموع عرض‌ها همیشه ۱۰۰٪ است،
- هیچ ستونی بی‌دلیل پهن نمی‌شود،
- اسکرول افقی در حالت جدول رخ نمی‌دهد.
3. **مقیاس فاصله یکسان:** همهٔ حاشیه‌ها مضرب ۰٫۲۵rem (۴px) هستند.
4. **سرستون چسبان (sticky)** هنگام اسکرول عمودی.
5. **اعداد هم‌عرض** (`tabular-nums`) تا ستون تاریخ‌ها لق نزند.
6. **تلفن با `direction: ltr`** تا ارقام در متن راست‌به‌چپ جابه‌جا نشوند.
7. **آدرس حداکثر دو خط** (`line-clamp`) با متن کامل در `title`.
8. **تأخیر به‌شکل چیپ رنگی** (خاکستری/کهربایی/قرمز/تیره) برای اسکن سریع.
| ستون | عرض | محتوا |
|---|---|---|
| نام و نام خانوادگی | ۲۳٪ | چیپ شماره + نام + کد مشتری |
| وضعیت قرار | ۱۳٪ | برچسب رنگی وضعیت |
| قرار هماهنگی | ۱۰٪ | تاریخ شمسی قرار دستی |
| بازدید برنامه‌ریزی‌شده | ۱۱٪ | تاریخ قرار از `Action` |
| آخرین بازدید | ۱۰٪ | تاریخ مؤثر واقعی |
| تأخیر | ۹٪ | چیپ تعداد روز |
| تلفن | ۱۱٪ | شمارهٔ اول (LTR) |
| آدرس | ۱۳٪ | دو خط + `title` |
**نقطهٔ شکست (breakpoint):** تا **۸۹۹px** حالت «کارت» و از **۹۰۰px** حالت
«جدول». این دو مرز باید همیشه یکی باشند؛ اگر نباشند، در بازه‌ای از عرض صفحه هر
دو حالت هم‌زمان اعمال می‌شوند و چیدمان می‌شکند. یک تست اختصاصی
(`test_card_and_table_breakpoints_agree`) همین را قفل کرده است.
## ۶. قابلیت‌های موبایل
- هر ردیف یک **کارت** می‌شود. نام مشتری سرِ کارت است (بدون برچسب) و بقیهٔ
مقادیر با برچسب ثابت ۶٫۵rem هم‌تراز می‌شوند.
- برچسب «وضعیت» حذف می‌شود چون خودِ برچسب رنگی گویاست.
- دکمهٔ **«تماس»** (`tel:`) و **«ثبت اقدام»** به‌صورت دو دکمهٔ تمام‌عرض.
- شماره‌های دوم و سوم در موبایل مخفی‌اند (برای تماس، شمارهٔ اول کافی است).
## ۷. نمای خالی
اگر در نما/جست‌وجوی جاری موردی نباشد، پیام «موردی در این نما پیدا نشد»
نمایش داده می‌شود (به‌جای جدولِ خالی و گمراه‌کننده).
## ۸. کارایی
| سنجه | مقدار |
|---|---|
| تعداد کوئری در بارگذاری صفحه | **۱۹** |
| رندر کامل صفحه روی دادهٔ واقعی (۳٬۲۴۳ معوق) | ~۱ ثانیه |
نکتهٔ پیاده‌سازی: دورهٔ قالب **یک بار** خوانده می‌شود و به حلقهٔ محاسبهٔ تأخیر
پاس داده می‌شود (`months=period_months`). اگر این پارامتر پاس نشود، برای هر
مشتری یک کوئری اضافه زده می‌شود (باگ N+1 که در تست‌ها کشف و رفع شد).
## ۹. آنچه تغییر نکرد
- منطق «چه کسی عقب‌افتاده است» (همان `last_visit_map` + `due_cut`).
- قاعدهٔ اعتبار قرار دستی (وجود هماهنگی فعال + آخرین فعالیت بودن).
- `visit_policy.py` به‌طور کامل: `next_appointment_map`، `scheduled_visits_map`،
`coordination_holds_map` — پس **اسکنر پیامک**، `recalc_last_bazdid` و چرخهٔ
۹ ماهه دقیقاً مثل قبل کار می‌کنند.
- شمارندهٔ داشبورد (`CacheTable('9mahbazdid')` = بدون قرار).
- لینک‌های قدیمی `?view=...` و رفتار پیش‌فرض (نمای «بدون قرار»).
## ۱۰. پارامترهای URL
```
/panel/entezar/ پیش‌فرض: نیازمند پیگیری امروز
?view=all همهٔ عقب‌افتاده‌ها
?view=coordinated تعیین تکلیف شده (اجتماع سه منبع)
?view=today نیازمند پیگیری امروز
?view=today&fdate=1405/07/28 نیازمند پیگیری در یک روز دیگر (شمسی)
?view=manual فقط تعویق دستی
?view=scheduled فقط بازدید برنامه‌ریزی‌شده
?view=coordination فقط پیگیری تلفنی
?delay=gt180 فقط بیش از ۶ ماه تأخیر
?sort=overdue&dir=desc بیشترین تأخیر اول
?sort=name&dir=asc الفبایی (صعودی)
?sort=manual&dir=desc تاریخ قرار دستی (نزولی)
?searchVal=رضایی&searchOn=name جست‌وجوی نام
?searchVal=0912&searchOn=phone جست‌وجوی تلفن
?view=all&delay=gt180&sort=name&dir=asc&page=3 همه با هم (ترکیب‌پذیر)
?view=today&missed=1 فقط پیگیری‌های عقب‌افتاده
```
- **اندازهٔ صفحه = ۱۰۰ ردیف** (`ENTEZAR_PAGE_SIZE`)؛ صفحه‌بندی فقط از ردیف ۱۰۱ به
بعد فعال می‌شود.
- مقدار نامعتبر `view`/`sort`/`delay` بی‌صدا به پیش‌فرض برمی‌گردد (بدون ۴۰۰/۵۰۰).
- مقادیر قدیمی `sort=oldest|newest|overdue` همچنان معتبرند.
- همهٔ لینک‌های داخلی (کارت‌ها، بازه‌های تأخیر، سرستون‌ها، صفحه‌بندی) **بقیهٔ
فیلترها را حفظ می‌کنند**.
---
3. پس از تاریخ قرار، مشتری **خودکار** در گروه «تعیین تکلیف نشده» ظاهر می‌شود؛
نیازی به کار دستی نیست.
4. عدد «تعیین تکلیف نشده» در داشبورد همان لیست کاریِ فوری است.
+642
View File
@@ -0,0 +1,642 @@
# افزودن پیشوند «آقای/خانم» به نام مشتریان
## چرا؟
فیلد `Customer.name_family` (همان «نام» مشتری) سال‌ها بدون پیشوند وارد شده:
`محمد یاوری`، `مریم احمدی`. برای پیامک و گزارش‌ها بهتر است نام با پیشوند
محترمانه بیاید: `آقای محمد یاوری`، `خانم مریم احمدی`.
اما این کار **فقط** وقتی مجاز است که جنسیتِ اولین کلمهٔ نام با اطمینان قابل
تعیین باشد. فایل `iranianNamesDataset.json` (حدود ۲۰ هزار نام، `M`/`F`) همین
مرجع است.
> **قاعدهٔ بنیادین:** اگر کوچک‌ترین ابهامی در تشخیص جنسیت باشد، **هیچ تغییری
> اعمال نمی‌شود.** حدس جنسیت، تطبیق تقریبی (fuzzy) و انتخاب تصادفی ممنوع است.
مسیرهای اصلی:
| جزء | مسیر |
|---|---|
| منطق تصمیم (بدون Django) | `admin_panel/name_fix.py` |
| دستور اجرا | `admin_panel/management/commands/fix_customer_names.py` |
| مدل وضعیت job | `CustomerNameFixJob` در `admin_panel/models/system.py` |
| مهاجرت | `admin_panel/migrations/0072_customernamefixjob.py` |
| تست‌ها | `tests/test_customer_name_fix.py` |
| فایل داده | `iranianNamesDataset.json` در ریشهٔ پروژه (`/app/iranianNamesDataset.json` در کانتینر) |
---
## سریع‌ترین مسیر روی Production (خلاصهٔ اجرایی)
روی VPS، `python` میزبان وجود ندارد؛ همه‌چیز داخل کانتینر `web` اجرا می‌شود:
```bash
cd /path/to/khatibi
# ۱) تأیید وجود فایل داده داخل ایمیج (پیش‌نیاز قطعی این دستور)
docker compose exec web ls -l /app/iranianNamesDataset.json
docker compose exec web sha256sum /app/iranianNamesDataset.json
# ۲) اعمال migration (فقط این دستور به جدول CustomerNameFixJob نیاز دارد)
docker compose run --rm migrate
# ۳) بکاپ دیتابیس
docker compose exec web python -c "
import sqlite3, pathlib, datetime
src = pathlib.Path('/app/sqlite/db.sqlite3')
dst = src.parent / f'db_backup_{datetime.datetime.now():%Y%m%d_%H%M%S}.sqlite3'
s = sqlite3.connect(f'file:{src}?mode=ro', uri=True, timeout=30); d = sqlite3.connect(dst)
s.backup(d, pages=250, sleep=0.05); d.close(); s.close(); print('backup:', dst)"
# ۴) شبیه‌سازی روی دیتابیس واقعی — هیچ نوشتنی ندارد
docker compose exec web python manage.py fix_customer_names --dry-run --batch-size 200 --samples 5
# ۵) اجرای واقعی (هر دو فلگ لازم است)
docker compose exec web python manage.py fix_customer_names --apply --confirm-production --batch-size 200
```
**چرا این ترتیب؟**
| مرحله | چرا |
|---|---|
| ۱ | دستور مسیر پیش‌فرض را از `settings.BASE_DIR` می‌سازد. اگر فایل داخل ایمیج نباشد، دستور با «فایل داده پیدا نشد» رد می‌شود. |
| ۲ | `fix_customer_names` پیش از هر نوشتن، وجود جدول `admin_panel_customernamefixjob` را چک می‌کند و بدون آن خطا می‌دهد. (روی این پروژه `entrypoint.sh` و سرویس `migrate` هم خودشان اجرا می‌کنند، ولی صریح زدن ضرری ندارد.) |
| ۳ | دستور Undo ندارد؛ برگشت فقط با بکاپ ممکن است. |
| ۴ | پیش‌فرض بدون نوشتن است؛ اعداد (خصوصاً تعداد قابل‌اصلاح و نام‌های مبهم) را می‌بینی. |
| ۵ | نوشتن نیازمند تأیید صریح اپراتور است، نه حدس از `DEBUG` یا نام محیط. |
### ✅ فایل JSON داخل ایمیج کپی می‌شود (تضمین‌شده)
`Dockerfile` حالا **صریحاً** این فایل را کپی می‌کند (خط ۶۳):
```dockerfile
COPY --chown=django:django iranianNamesDataset.json /app/iranianNamesDataset.json
```
یعنی مسیر پیش‌فرض دستور (`settings.BASE_DIR` = `/app`) همیشه داخل ایمیج
موجود است و به `COPY . .` یا محتوای `.dockerignore` وابسته نیست.
**عواقب این انتخاب:**
- اگر فایل در build context نباشد، **build شکست می‌خورد** (fail-fast) — این
رفتار مطلوب است: خطا همان‌جا در CI دیده می‌شود، نه بعداً روی سرور با
«فایل داده پیدا نشد».
- روی سرورهای میزبان (VPS/CI) باید فایل در build context حاضر باشد. اگر
Coolify/CI ایمیج را از **گیت** می‌سازد، فایل باید commit شده باشد (الان
`git status` آن را `??` نشان می‌دهد، یعنی هنوز track نشده).
برای تست سریع بدون commit و بدون rebuild:
```bash
# الف) کپی دستی داخل کانتینر در حال اجرا (تا بازسازی بعدی کانتینر پایدار است)
docker compose cp iranianNamesDataset.json web:/app/iranianNamesDataset.json
# ب) bind-mount از میزبان (فایل هرجا باشد، با هر rebuild هم می‌ماند)
# docker-compose.override.yml
# services:
# web:
# volumes:
# - ./iranianNamesDataset.json:/app/iranianNamesDataset.json:ro
docker compose exec web python manage.py fix_customer_names --dry-run \
--json-path /app/iranianNamesDataset.json
```
برای تأیید اینکه ایمیج ساخته‌شده واقعاً فایل را دارد:
```bash
docker compose exec web ls -l /app/iranianNamesDataset.json
docker compose exec web sha256sum /app/iranianNamesDataset.json # باید با hash گزارش دستور یکی باشد
```
> چون jobها با **SHA-256 فایل** شناسایی می‌شوند، فایل باید بایت‌به‌بایت همان
> چیزی باشد که dry-run دید. اگر فایل را عوض کردی، ادامهٔ job قدیمی رد می‌شود و
> باید `--new-job` بدهی.
### اگر وسط کار قطع شد
```bash
# الف) ادامهٔ خودکار: فقط همان دستور را دوباره بزن.
# خودش آخرین job ناتمام با همان hash و همان نسخهٔ الگوریتم را پیدا و ادامه می‌دهد.
docker compose exec web python manage.py fix_customer_names --apply --confirm-production --batch-size 200
# ب) ادامهٔ صریح یک job مشخص
docker compose exec web python manage.py fix_customer_names --apply --confirm-production --resume 3
# ج) اگر شمارهٔ job را نمی‌دانی:
docker compose exec web python manage.py shell -c "
from admin_panel.models import CustomerNameFixJob as J
print(list(J.objects.values('id','status','last_processed_pk','initial_max_pk','stats')))"
```
> اگر job قبلی `completed` باشد، اجرای دوباره **خطا می‌دهد** و خودکار job جدید
> نمی‌سازد (تا داده دوباره دست نخورد). برای اجرای عمدی از صفر: `--new-job`.
### بررسی نتیجه
```bash
docker compose exec web python manage.py shell -c "
from admin_panel.models import Customer
print('آقای:', Customer.objects.filter(name_family__startswith='آقای ').count())
print('خانم:', Customer.objects.filter(name_family__startswith='خانم ').count())"
```
---
**فقط** فیلد `name_family` مشتریان واجد شرایط. هیچ فیلدی به مدل مشتری اضافه
نشده، **هیچ جنسیتی ذخیره نمی‌شود**، و تلفن/آدرس/یادداشت/وضعیت حساب
دست‌نخورده می‌مانند. جدول `PhoneNumber` هم لمس نمی‌شود.
## الگوریتم تصمیم (به همین ترتیب)
| # | بررسی | نتیجه |
|---|---|---|
| ۱ | نام خالی / فقط فاصله / `NULL` | بدون تغییر |
| ۲ | اولین کلمه `آقا`، `آقای` یا `خانم` | بدون تغییر (پیشوند تکرار نمی‌شود) |
| ۳ | نام **تک‌کلمه‌ای** | بدون تغییر (ممکن است فقط فامیل باشد) |
| ۴ | اولین کلمه در فایل پیدا نشود | بدون تغییر |
| ۵ | جنسیت اولین کلمه مبهم/نامعتبر باشد | بدون تغییر |
| ۶ | وگرنه | افزودن قطعی پیشوند |
جست‌وجو **فقط** روی اولین کلمه انجام می‌شود؛ از فامیل و کلمات بعدی برای حدس
استفاده نمی‌شود.
### نمونه‌های رفتاری
| مقدار فعلی | نتیجه |
|---|---|
| `محمد یاوری` | `آقای محمد یاوری` |
| `مریم احمدی` | `خانم مریم احمدی` |
| `یاوری` | بدون تغییر — تک‌کلمه‌ای |
| `محمد` | بدون تغییر — تک‌کلمه‌ای |
| `آقا محمد یاوری` | بدون تغییر |
| `آقای محمد یاوری` | بدون تغییر |
| `خانم مریم احمدی` | بدون تغییر |
| `نام ناشناخته احمدی` | بدون تغییر — ناشناخته |
| `آرش محمدی` | بدون تغییر — جنسیت متناقض در فایل |
| ` محمد یاوری ` | `آقای محمد یاوری` (فاصله‌های سر/ته فقط در این حالت حذف می‌شوند) |
| ` نام ناشناخته احمدی ` | بدون تغییر، **با حفظ فاصله‌های اصلی** |
نکته: حذف فاصله‌های سر/ته به‌تنهایی هیچ‌وقت باعث تغییر نمی‌شود؛ فقط وقتی
تصمیم قطعی به افزودن پیشوند گرفته شد، خروجی از نام `strip()`شده ساخته می‌شود.
فاصله‌های **داخلی** دست‌نخورده می‌مانند (`محمد یاوری` → `آقای محمد یاوری`).
### نرمال‌سازی (فقط برای کلید جست‌وجو)
`NFC` + حذف فاصلهٔ سر/ته + یکسان‌سازی `ي→ی` و `ك→ک`. مقدارِ ذخیره‌شدهٔ مشتری
حرف‌به‌حرف همان مقدار اصلی است (`علي رضایی` → `آقای علي رضایی`).
### برخورد با نام‌های تکراری و متناقض
یک نام فقط وقتی قابل استفاده است که **همهٔ** رکوردهای همان کلید نرمال‌شده
جنسیت معتبر (`M`/`F`) و **یکسان** داشته باشند:
| وضعیت در فایل | تصمیم |
|---|---|
| چند رکورد، همه `M` یا همه `F` | قابل استفاده |
| همان نام هم `M` هم `F` | **مبهم** ⇒ بدون تغییر |
| جنسیت ناشناخته (`D`، `MF`، `FF`، خالی) | **غیرقابل استفاده** ⇒ بدون تغییر |
| رکورد ناقص/`Names` غیر رشته/نام خالی | رد می‌شود؛ کل آن نام کنار گذاشته می‌شود |
| یکی‌شدن دو کلید با جنسیت متناقض پس از نرمال‌سازی | **مبهم** ⇒ بدون تغییر |
«اولین رکورد» یا «پرتکرارترین جنسیت» بدون دلیل معتبر انتخاب نمی‌شود؛ تناقض
یعنی نام کنار گذاشته می‌شود.
وضعیت فایل دادهٔ فعلی پروژه:
```
SHA-256: f5953a216a0b71e59e20249f5bfa6a380a2c3179c6b15e4f0e60616b94948114
رکورد کل: 19881 | کلید قابل‌استفاده: 19870 | کلید غیرقابل‌استفاده: 5
جنسیت نامعتبر: 5 (فروزان/فروزن/فروزنده = D، گوهربانو = FF، مهروز = MF)
نام تکراری: 6، همه هم‌جنسیت (بدون تناقض)
```
## گزینه‌های دستور
| گزینه | پیش‌فرض | کار |
|---|---|---|
| `--json-path` | `iranianNamesDataset.json` در ریشهٔ پروژه | مسیر فایل داده |
| `--batch-size` | `200` | تعداد مشتری در هر batch |
| `--dry-run` | خاموش (اما **رفتار پیش‌فرض همین است**) | گزارش بدون هیچ نوشتنی؛ همراه `--apply` ناسازگار است |
| `--apply` | خاموش | نوشتن واقعی؛ بدون آن اجرا فقط گزارش است |
| `--confirm-production` | خاموش | تأیید صریح اپراتور؛ همراه `--apply` **الزامی** |
| `--resume <JOB_ID>` | — | ادامهٔ یک job مشخص |
| `--new-job` | خاموش | شروع عمدی job جدید، حتی اگر job تکمیل‌شده‌ای برای همین فایل باشد |
| `--samples` | `5` | تعداد نمونهٔ «قبل/بعد» در گزارش |
**پیش‌فرض دستور بدون نوشتن است.** هیچ‌کدام از این‌ها تغییر نمی‌دهند: نام مشتری،
رکورد job، ساختار دیتابیس، فایل JSON. حتی migration هم خودکار اجرا نمی‌شود.
## اجرای محلی (توسعه)
### ۱) اول همیشه شبیه‌سازی
از WSL:
```bash
cd /mnt/d/projects/khatibi
.venv/Scripts/python.exe manage.py fix_customer_names --dry-run --samples 5
```
از Windows (PowerShell / CMD):
```bat
cd D:\projects\khatibi
.venv\Scripts\python.exe manage.py fix_customer_names --dry-run --samples 5
```
خروجی نمونه (دادهٔ واقعی همین پروژه، ۱۰٬۴۲۶ مشتری):
```
مقصد دیتابیس: alias=default engine=django.db.backends.sqlite3
NAME: D:\Projects\khatibi\data9\kt.sqlite3
(فقط نام/مسیر دیتابیس چاپ می‌شود؛ credential چاپ نمی‌شود.)
اعتبارسنجی فایل داده
مسیر: D:\Projects\khatibi\iranianNamesDataset.json
SHA-256: f5953a21…
رکورد کل: 19881 | کلید قابل‌استفاده: 19870 | کلید غیرقابل‌استفاده: 5
ردشده → malformed: 0 | نام خالی: 0 | جنسیت نامعتبر: 5
نام تکراری: 6 (هم‌جنسیت: 6 | متناقض: 0)
گزارش dry-run — هیچ تغییری نوشته نشد
مشتریان بررسی‌شده: 10426
قابل اصلاح / اصلاح‌شده: 7303
بدون تغییر: 3123
تک‌کلمه‌ای: 1576 | دارای پیشوند: 89 | خالی/نامعتبر: 0
ناشناخته در JSON: 1457 | جنسیت مبهم/نامعتبر: 1
batchهای تکمیل‌شده: 53
نمونهٔ تغییرات (قبل → بعد):
«مجتبی سالاری» → «آقای مجتبی سالاری»
«مرتضی محمد باقری » → «آقای مرتضی محمد باقری»
«محمد فصاحت » → «آقای محمد فصاحت»
برای اجرای واقعی: --apply --confirm-production
```
### ۲) اجرای واقعی (فقط روی مقصد دلخواه)
```bash
.venv/Scripts/python.exe manage.py fix_customer_names --apply --confirm-production
```
بدون `--confirm-production`:
```
CommandError: برای نوشتن واقعی، هم --apply و هم --confirm-production لازم است.
```
## اجرا روی سرور Production
**پیش‌نیاز: migration باید اعمال شده باشد.** روی این پروژه migration سرویس وب
خودکار اجرا می‌شود (`entrypoint.sh` و سرویس `migrate` در `docker-compose.yml`)،
ولی برای اطمینان:
```bash
docker compose run --rm migrate # یا: python manage.py migrate
```
اگر جدول job نباشد، دستور **پیش از هر تغییری** خطا می‌دهد و هیچ نامی را
تغییر نمی‌دهد:
```
CommandError: جدول «admin_panel_customernamefixjob» وجود ندارد.
ابتدا migration را اعمال کن: python manage.py migrate
```
### ترتیب دقیق اجرا
خلاصهٔ اجرایی و کامل این ترتیب در بخش
**«سریع‌ترین مسیر روی Production»** بالای همین سند آمده؛ این همان نسخهٔ
جزئی‌تر با تأکید بر فایل داده:
```bash
# ۰) فایل داده داخل کانتینر — تأیید وجود و هش
docker compose exec web ls -l /app/iranianNamesDataset.json
docker compose exec web sha256sum /app/iranianNamesDataset.json
# ۱) اعمال migration (لازم؛ جدول CustomerNameFixJob را می‌سازد)
docker compose run --rm migrate
# ۲) بکاپ دیتابیس (بخش «بکاپ پیش از اجرای واقعی» را ببین)
docker compose exec web python manage.py sqlite_db_backup # نیازمند env های S3
# اگر S3 تنظیم نیست، اسنیپت WAL-safe بخش «سریع‌ترین مسیر» را بزن.
# ۳) شبیه‌سازی روی دیتابیس واقعی — هیچ نوشتنی ندارد
docker compose exec web python manage.py fix_customer_names --dry-run --batch-size 200 --samples 5
# ۴) اگر اعداد منطقی بود: اجرای واقعی
docker compose exec web python manage.py fix_customer_names --apply --confirm-production --batch-size 200
# ۵) بررسی خلاصه و وضعیت job
docker compose exec web python manage.py shell -c "from admin_panel.models import CustomerNameFixJob as J; print(list(J.objects.values('id','status','source_hash','last_processed_pk','initial_max_pk','stats')))"
```
> **چرا `docker compose exec web` و نه `python manage.py`؟** روی VPS پایتون
> پروژه فقط داخل کانتینر است و دیتابیس هم در ولوم `/app/sqlite` همان کانتینر
> قرار دارد. اجرای `python manage.py` روی میزبان یا به دیتابیس اشتباه وصل
> می‌شود یا اصلاً وجود ندارد.
### اطمینان از انتخاب دیتابیس درست
دستور از تنظیمات فعال Django (`DJANGO_SETTINGS_MODULE`) استفاده می‌کند و هیچ
مسیر SQLite ای هاردکد نشده است. پیش از هر کاری، alias + engine + مسیر دیتابیس
را چاپ می‌کند (بدون credential):
```
مقصد دیتابیس: alias=default engine=django.db.backends.sqlite3
NAME: /app/sqlite/db.sqlite3
توجه: ماژول تنظیمات production فعال است.
```
- روی سرور، `DJANGO_SETTINGS_MODULE=khatibi.production_settings` و
`NAME=/app/sqlite/db.sqlite3` (ولوم `khatibi-sqlite-db` در کانتینر) است.
- در توسعه، `khatibi.settings` و `data9/kt.sqlite3`.
- اگر مسیر چاپ‌شده همان چیزی نیست که انتظار داری، **همان‌جا `Ctrl+C` بزن**؛
هیچ داده‌ای تا آن لحظه نوشته نشده است.
- تشخیص production بر پایهٔ نام ماژول تنظیمات است، نه `DEBUG`. (در این پروژه
`production_settings.py` مقدار `DEBUG=True` دارد؛ پس اتکا به `DEBUG` غلط بود و
عمداً از آن استفاده نشده.)
## بکاپ پیش از اجرای واقعی
دستور آمادهٔ همین پروژه روی سرور (لینوکس/کانتینر): `sqlite_db_backup` — از متد
بومی SQLite (`Connection.backup`) با اتصال `mode=ro` استفاده می‌کند و بنابراین با
حالت WAL سازگار است. دو شرط دارد: فقط روی لینوکس اجرا می‌شود (`fcntl`) و
متغیرهای S3 را لازم دارد (`S3_ACCESS_KEY`, `S3_SECRET_KEY`, `S3_ENDPOINT`,
`S3_BUCKET`).
```bash
# داخل کانتینر (لینوکس) — نتیجه در S3 ذخیره و اعتبارسنجی می‌شود
docker compose exec web python manage.py sqlite_db_backup
```
اگر S3 در دسترس نیست یا روی ویندوز/WSL کار می‌کنی، همین بکاپ WAL-safe را
مستقیم بگیر (همه‌جا کار می‌کند و به env نیاز ندارد):
```bash
# WSL
.venv/Scripts/python.exe - <<'PY'
import sqlite3, pathlib, datetime
src = pathlib.Path('data9/kt.sqlite3')
dst = src.parent / f"db_backup_{datetime.datetime.now():%Y%m%d_%H%M%S}.sqlite3"
s = sqlite3.connect(f"file:{src}?mode=ro", uri=True, timeout=30)
d = sqlite3.connect(dst)
s.backup(d, pages=250, sleep=0.05) # کپی سطح C، سازگار با WAL
d.close(); s.close()
print("backup:", dst, dst.stat().st_size, "bytes")
PY
```
> **کپی سادهٔ فایل SQLite در حین اجرای برنامه بکاپ معتبر نیست.** دیتابیس در حالت
> `WAL` اجرا می‌شود (`entrypoint.sh`)؛ اگر فقط `db.sqlite3` را `cp` کنی،
> تراکنش‌های موجود در `db.sqlite3-wal` از دست می‌روند و ممکن است فایل خراب
> بازیابی شود. اگر دستی بکاپ می‌گیری، باید **هر سه فایل** (`db.sqlite3`،
> `-wal`، `-shm`) در لحظهٔ بدون نوشتن کپی شوند — و بهترین راه همان
> `sqlite3.Connection.backup` بالا است.
نکات مکمل:
- فضای دیسک: قبل از بکاپ حداقل ~۱.۵ برابر حجم دیتابیس خالی باشد
(دیتابیس فعلی ≈۷۹ مگابایت).
- وضعیت WAL: `PRAGMA journal_mode;` باید `wal` برگرداند.
- دسترسی فایل: کاربر اجراکنندهٔ کانتینر باید روی `/app/sqlite` و روی فایل JSON
دسترسی خواندن/نوشتن داشته باشد.
- فایل `iranianNamesDataset.json` **هرگز** تغییر داده، بازنویسی یا حذف نمی‌شود؛
دستور فقط آن را می‌خواند.
## ادامهٔ job پس از crash / قطع برق
هر batch شامل سه چیز است که **در یک تراکنش اتمیک** ثبت می‌شوند:
1. تغییرات `name_family` مشتریان واجد شرایط همان batch،
2. `last_processed_pk` (checkpoint)،
3. `heartbeat_at` و آمار تجمیعی.
پس یا کل batch ثبت شده یا هیچ‌کدام. دامنهٔ job در لحظهٔ آغاز با بزرگ‌ترین
primary key مشتریان قفل می‌شود (`initial_max_pk`)؛ مشتریان جدیدتر وارد دامنه
نمی‌شوند.
### گزینه‌های ادامه
| وضعیت | رفتار پیش‌فرض | راه‌حل |
|---|---|---|
| job ناتمام با همان فایل و همان نسخهٔ الگوریتم | **خودکار ادامه می‌یابد** | فقط همان دستور `--apply --confirm-production` را دوباره بزن |
| می‌خواهی صریحاً همان job را ادامه دهی | — | `--apply --confirm-production --resume <JOB_ID>` |
| job قبلی `completed` است | خطا؛ خودکار job جدید نمی‌سازد | `--apply --confirm-production --new-job` |
| فایل عوض شده (hash متفاوت) | **توقف، بدون هیچ تغییری** | `--new-job` با فایل جدید |
| نسخهٔ الگوریتم عوض شده | **توقف** | `--new-job` |
پیام خطاهای مربوطه:
```
CommandError: hash فایل ورودی با job#3 نمی‌خواند؛ ادامه رد شد و هیچ تغییری اعمال نمی‌شود.
CommandError: job#3 قبلاً تکمیل شده است؛ برای اجرای دوباره --new-job بده.
CommandError: job#3 همین حالا در حال اجراست (heartbeat تازه). اجرای هم‌زمان مجاز نیست.
```
### دستورهای دقیق ادامه / شروع مجدد
```bash
# ادامهٔ خودکار آخرین job ناتمامِ همین فایل (ساده‌ترین راه)
python manage.py fix_customer_names --apply --confirm-production
# ادامهٔ صریح یک job مشخص
python manage.py fix_customer_names --apply --confirm-production --resume 3
# شروع عمدی job جدید (پس از تکمیل job قبلی یا با فایل جدید)
python manage.py fix_customer_names --apply --confirm-production --new-job
# شروع job جدید با فایل دیگر و حجم batch کوچک‌تر (ساعات پرترافیک)
python manage.py fix_customer_names --apply --confirm-production --new-job \
--json-path /app/data/iranianNamesDataset_v2.json --batch-size 50
```
اجرای دوبارهٔ بی‌خطر: با `--new-job` روی دادهٔ اصلاح‌شده، `changed = 0` می‌شود،
چون نام‌های دارای پیشوند دیگر رد می‌شوند.
## قفل و اجرای هم‌زمان
- جلوگیری از اجرای هم‌زمان با **heartbeat** انجام می‌شود، نه `select_for_update()`.
(روی SQLite قفل ردیفی واقعی وجود ندارد؛ اتکا به `select_for_update` گمراه‌کننده بود.)
- هر batch مقدار `heartbeat_at` را به‌روز می‌کند. jobی که `status=running` دارد و
heartbeat آن تازه است (< `LOCK_TTL = 15 دقیقه`)، اجرای دوم را مسدود می‌کند.
- اگر سرور وسط کار خاموش شود، heartbeat کهنه می‌ماند و اجرای بعدی قفل را
**به‌صورت کنترل‌شده آزاد می‌کند** و به‌عنوان `failed` علامت می‌زند:
```
job#1 ناتمام رها شده بود و اکنون به‌عنوان failed آزاد شد.
```
پس از آن، همان دستور از `last_processed_pk` ادامه می‌دهد. قفل، دائمی نمی‌شود.
## SQLite، قفل دیتابیس و بار روی سایت
- batchهای کوچک (`--batch-size 200`) با تراکنش‌های کوتاه؛ هیچ تراکنش واحدی روی
۱۰٬۴۲۶ مشتری ساخته نمی‌شود.
- خطای `database is locked`: بازآزمایی حداکثر `4` بار با backoff نمایی
(۰.۵s، ۱s، ۲s) به‌همراه jitter. **retry نامحدود وجود ندارد.**
- خطاهای غیرقابل‌بازیابی فوراً بالا می‌آیند؛ batch جاری rollback می‌شود،
checkpoint جلو نمی‌رود و job با `failed` ثبت می‌شود.
- `PRAGMA busy_timeout=30000` موجود (در `admin_panel/signals.py`) دست‌نخورده است.
`journal_mode=WAL` و `synchronous=FULL` هم تغییر داده نشده‌اند.
- **محدودیت باقی‌مانده:** SQLite در هر لحظه فقط یک نویسنده دارد. بهتر است دستور
را در ساعات کم‌ترافیک اجرا کنی؛ اگر web/worker هم‌زمان بنویسند، ممکن است
چند batch با backoff کندتر شوند (نه خطا). سایت متوقف نمی‌شود.
## مدل وضعیت job
`CustomerNameFixJob` — **فقط** وضعیت و checkpoint. هیچ اطلاعاتی از جنسیت یا هویت
مشتری در آن ذخیره نمی‌شود.
| فیلد | معنا |
|---|---|
| `source_hash` | SHA-256 فایل ورودی؛ مبنای تشخیص «همان فایل» |
| `algorithm_version` | نسخهٔ الگوریتم تصمیم (`ALGORITHM_VERSION`) |
| `status` | `running` / `paused` / `completed` / `failed` |
| `batch_size` | اندازهٔ batch هنگام آغاز |
| `initial_max_pk` | سقف دامنه (بیشترین pk مشتریان در آغاز) |
| `last_processed_pk` | checkpoint؛ آخرین pk پردازش‌شده |
| `stats` | آمار تجمیعی (JSON) |
| `note` | توضیح وضعیت/خطا |
| `started_at` / `updated_at` / `finished_at` / `heartbeat_at` | زمان‌ها |
شرط خواندن هر batch: `last_processed_pk < pk <= initial_max_pk`، مرتب بر اساس
`pk`. هیچ‌وقت از offset یا شمارهٔ ردیف استفاده نمی‌شود (offset با افزودن/حذف
رکورد جابه‌جا می‌شود و باعث پرش/تکرار می‌شود).
## بکاپ/بازیابی خودکار نیست
دستور بکاپ نمی‌گیرد و تغییرات را «undo» نمی‌کند. برای برگشت، بکاپِ قبل از اجرا
را بازیابی کن:
```bash
# ۱) توقف سرویس‌هایی که می‌نویسند
docker compose stop web worker scheduler delivery
# ۲) جایگزینی فایل دیتابیس در ولوم، با پاک کردن WAL/SHM قدیمی
docker run --rm \
-v khatibi-sqlite-db:/data \
-v "$(pwd)":/backup \
alpine sh -c "cp /backup/db_backup_YYYYmmdd_HHMMSS.sqlite3 /data/db.sqlite3 \
&& rm -f /data/db.sqlite3-wal /data/db.sqlite3-shm"
# ۳) بالا آوردن دوباره (سرویس migrate اول اجرا می‌شود)
docker compose start migrate web worker scheduler delivery
```
اگر از `sqlite_db_backup` استفاده کرده‌ای، فایل بکاپ در S3 است؛ اول آن را با
`aws s3 cp`/کلاینت S3 دانلود کن و بعد مراحل بالا را اجرا کن.
## خطاهای رایج و اقدام درست
| خطا | معنا | اقدام |
|---|---|---|
| `فایل داده پیدا نشد: …` | مسیر `--json-path` غلط | مسیر را با `ls` تأیید کن |
| `JSON نامعتبر است: …` | فایل خراب است | هیچ تغییری اعمال نشد؛ فایل درست را بگذار |
| `کلید «RECORDS» در فایل JSON وجود ندارد` | ساختار فایل عوض شده | فایل را اصلاح کن — **هیچ نامی تغییر نمی‌کند** |
| `جدول … وجود ندارد` | migration اعمال نشده | `python manage.py migrate` |
| `hash فایل ورودی … نمی‌خواند` | فایل عوض شده | یا فایل قبلی را برگردان، یا `--new-job` |
| `همین حالا در حال اجراست` | یک اجرای دیگر فعال است | صبر کن یا `--resume` همان job را بده |
| `database is locked` (پس از ۴ تلاش) | فشار نوشتن هم‌زمان | دوباره اجرا کن؛ از checkpoint ادامه می‌دهد |
| `برای نوشتن واقعی، هم --apply و هم --confirm-production لازم است` | تأیید ناقص | هر دو گزینه را بده |
## بررسی صحت داده (SQL، پیش از/پس از اجرا)
```sql
-- وضعیت jobها
SELECT id, status, source_hash, last_processed_pk, initial_max_pk,
started_at, finished_at
FROM admin_panel_customernamefixjob ORDER BY id;
-- مشتریانی که پیشوند ندارند ولی نامشان چندکلمه‌ای است (کاندید بالقوه)
SELECT COUNT(*) FROM admin_panel_customer
WHERE TRIM(name_family) LIKE '% %'
AND name_family NOT LIKE 'آقا %'
AND name_family NOT LIKE 'آقای %'
AND name_family NOT LIKE 'خانم %';
-- تعدادی که پیشوند گرفته‌اند (نتیجهٔ اجرای واقعی)
SELECT COUNT(*) FROM admin_panel_customer WHERE name_family LIKE 'آقای %';
SELECT COUNT(*) FROM admin_panel_customer WHERE name_family LIKE 'خانم %';
```
## تست‌ها
```bash
.venv/Scripts/python.exe manage.py test tests.test_customer_name_fix # ۳۰ تست
.venv/Scripts/python.exe manage.py test tests # کل مجموعه
.venv/Scripts/python.exe manage.py makemigrations --check --dry-run # باید «No changes detected» بدهد
```
تست‌ها فقط روی دیتابیس تستی Django (SQLite درون‌حافظه) و با فایل JSON ساختگیِ
موقت اجرا می‌شوند؛ نه به `data9/kt.sqlite3` دست می‌زنند و نه به فایل دادهٔ واقعی.
## نکته‌ها و محدودیت‌ها
- **نام تک‌کلمه‌ای هیچ‌وقت تغییر نمی‌کند** — حتی اگر در فایل با جنسیت قطعی
باشد؛ چون ممکن است فقط فامیل باشد.
- **حرف اضافه/کم کردن ممنوع است:** نه fuzzy matching، نه حذف حروف، نه حدس از
فامیل، نه انتخاب تصادفی جنسیت.
- نام‌های دارای پیشوند **دوباره** پیشوند نمی‌گیرند (idempotent).
- دستور `save()` کامل صدا نمی‌زند؛ روی `Customer` سیگنال و منطق اجباری در
`save()` وجود ندارد، پس `bulk_update(['name_family'])` امن است و فقط همان
یک ستون را می‌نویسد (فیلدهای `auto_now_add` مثل `create_date` لمس نمی‌شوند).
- منطق روی `name_family` اجرا می‌شود، نه `name` — این نام واقعی فیلد در این
پروژه است.
- ۵ نام موجود در فایل جنسیت نامعتبر دارند (`D`/`FF`/`MF`) و عمداً کنار گذاشته
می‌شوند؛ مشتریانی با آن نام‌ها بدون پیشوند می‌مانند.
- نام‌هایی که در فایل نیستند (۱۴۵۷ مورد در دادهٔ فعلی) پیشوند نمی‌گیرند. اگر
بعداً فایل کامل‌تری آمد، با `--json-path` فایل جدید و `--new-job` می‌توان
دور تازه‌ای اجرا کرد.
- برای تغییر قواعد تصمیم یا نرمال‌سازی، `ALGORITHM_VERSION` در
`admin_panel/name_fix.py` را بالا ببر تا jobهای قدیمی ناخواسته ادامه داده
نشوند.
- کنسول ویندوز: متن فارسی در خروجی ممکن است `charmap` خطا بدهد؛ مثل بقیهٔ
سرویس‌های پروژه از `python -X utf8 manage.py …` استفاده کن.
## چک‌لیست سریع (کپی/پیست)
```bash
# ── توسعه (WSL) ──────────────────────────────────────────────
.venv/Scripts/python.exe manage.py test tests.test_customer_name_fix
.venv/Scripts/python.exe manage.py fix_customer_names --dry-run --samples 5
# ── Production ───────────────────────────────────────────────
docker compose run --rm migrate # ۱) مهاجرت
docker compose exec web python manage.py sqlite_db_backup # ۲) بکاپ
docker compose exec web python manage.py fix_customer_names --dry-run --samples 10
docker compose exec web python manage.py fix_customer_names --apply --confirm-production
docker compose exec web python manage.py fix_customer_names --apply --confirm-production --resume <JOB_ID>
```
گزارش نهایی یک اجرای واقعی:
```
گزارش اجرای واقعی job#1 (completed)
مشتریان بررسی‌شده: 10426
قابل اصلاح / اصلاح‌شده: 7303
بدون تغییر: 3123
تک‌کلمه‌ای: 1576 | دارای پیشوند: 89 | خالی/نامعتبر: 0
ناشناخته در JSON: 1457 | جنسیت مبهم/نامعتبر: 1
batchهای تکمیل‌شده: 53
شناسهٔ job: 1 | شروع: … | پایان: …
نمونهٔ تغییرات (قبل → بعد):
«مجتبی سالاری» → «آقای مجتبی سالاری»
```
### تعریف کلیدهای آماری
| کلید | معنا |
|---|---|
| `scanned` | کل مشتریان بررسی‌شده در دامنهٔ job |
| `changed` | نام‌هایی که پیشوند گرفتند (یا در dry-run، می‌گیرند) |
| `unchanged` | `scanned - changed` |
| `single_word` | تک‌کلمه‌ای ⇒ دست‌نخورده |
| `has_prefix` | از قبل `آقا`/`آقای`/`خانم` ⇒ دست‌نخورده |
| `empty_invalid` | خالی/فقط فاصله ⇒ دست‌نخورده |
| `unknown_name` | اولین کلمه در فایل نیست ⇒ دست‌نخورده |
| `ambiguous_gender` | جنسیت متناقض/نامعتبر ⇒ دست‌نخورده |
| `batches` | تعداد batchهای commit‌شده |
File diff suppressed because it is too large. Load diff
+223 -140
View File
@@ -1,142 +1,225 @@
{
"0": "views/store.py",
"1": "project_tree.py",
"2": "sqlite_db_backup.py",
"3": "django_db",
"4": "Customer ID Backup/New Factor Template",
"5": "views/customers.py",
"6": "cheque_inquiry.py",
"7": "admin_panel/templates/admin_panel/baseHesabdari.html",
"8": "django_db_models_deletion",
"9": "0051_auto_20260705_1356.py",
"10": "admin_panel/storeBK1.html",
"11": "ViewSmokeTests",
"12": "admin_panel/templates/admin_panel/customerAction.html",
"13": "User",
"14": "run_all",
"15": "admin_panel/admin.py",
"16": "stock_in",
"17": "admin_panel/templates/admin_panel/bedehi.html",
"18": "hesabdariCheckPassFail.html",
"19": "Reference guide",
"20": "normalize_mobile",
"21": "graphify",
"22": "hesabdariResidNashode.html",
"23": "0017_factoriteam_garantyesh.py",
"24": "scanner.py",
"25": "0002_auto_20220114_1616.py",
"26": "SMSResult",
"27": "Rip'n Fast. Fewer Tokens. Better Code.",
"28": "models/sms.py",
"29": "admin_panel/templates/admin_panel/baseStore.html",
"30": "views/finance.py",
"31": "Customer Modals UI",
"32": "views/factors.py",
"33": "0034_alter_article_sarresid.py",
"34": "views/sms.py",
"35": "0035_alter_article_sarresid.py",
"36": "django_db_models",
"37": "0010_auto_20220122_1546.py",
"38": "0040_customer_laghv_bazdid.py",
"39": "test_sms.py",
"40": "0048_alter_productinstore_options.py",
"41": "0032_article_paystatus.py",
"42": "0033_article_nahvepardakht.py",
"43": "make_customer",
"44": "sms0098.py",
"45": "0044_sarresid_desc.py",
"46": "models/__init__.py",
"47": "make_user",
"48": "GEMINI.md",
"49": "admin/migrations/__init__.py",
"50": "Customer Action Include",
"51": "New Customer Base Template",
"52": "Customer Feedback Partial",
"53": "Customer Factor Detail",
"54": "Customer Accounting Template",
"55": "Customer Factor List",
"56": "Customer Feedback Page",
"57": "commands/__init__.py",
"58": "management/__init__.py",
"59": "admin_panel/migrations/__init__.py",
"60": "Action List Template",
"61": "base.html",
"62": "Customer New Factor",
"63": "Customer New Factor V2",
"64": "Customer Satisfaction List",
"65": "Customer Satisfaction Partial",
"66": "Customer Check/Debt Management",
"67": "admin_panel/templates/admin_panel/customerBaseNew.html",
"68": "Customer List",
"69": "admin_panel/templates/admin_panel/entezarBK.html",
"70": "Financial Dashboard",
"71": "Accounting Main View",
"72": "admin_panel/templates/admin_panel/index.html",
"73": "New Inventory Operation",
"74": "Inventory Operations List",
"75": "Operations Backup Template",
"76": "Financial Report Template",
"77": "Debt Collection Dashboard",
"78": "Inventory Movement Report",
"79": "Customer Satisfaction Dashboard",
"80": "Check and Credit Report Template",
"81": "Satisfaction List Template",
"82": "Store Inventory Template",
"83": "Store Transfers Template",
"84": "Stores List Template",
"85": "toCurrency",
"86": "templatetags/__init__.py",
"87": "URL: newStore",
"88": "URL: process_transfer_action",
"89": "URL: rezayatEdit",
"90": "khatibi/__init__.py",
"91": "Extended Requirements File",
"92": "Requirements File",
"93": "django_shortcuts",
"94": "resolve_recipients",
"95": "factories.py",
"96": "write_tree",
"97": "TemplatesPageUITests",
"98": "reconciliation_tool.py",
"99": "ModelsPackageContractTests",
"100": "django_conf",
"101": "Command",
"102": "UrlContractTests",
"103": "customerIDFactorBackup.html",
"104": "system.py",
"105": "BehinSMSProvider",
"106": "test_customers.py",
"107": "tests/__init__.py",
"108": "Command",
"109": "Command",
"110": "0061_sms_timing_and_primary.py",
"111": "bale/providers.py",
"112": "os",
"113": "Command",
"114": "0058_seed_sms_templates.py",
"115": "test_factors.py",
"116": "Customer",
"117": "customerNewBackup.html",
"118": "0059_sms_flow_control.py",
"119": "0060_sms_permission_label.py",
"120": "datetime",
"121": "0008_storeroom_user.py",
"122": "0013_alter_factor_options.py",
"123": "0018_alter_factoriteam_product.py",
"124": "0020_auto_20220126_1532.py",
"125": "0022_article_typepy.py",
"126": "0025_action_actiontype.py",
"127": "0028_action_grade.py",
"128": "0030_auto_20220414_1047.py",
"129": "0036_sarresid.py",
"130": "0037_sarresid_sarresiddt.py",
"131": "0039_customer_last_bazdid_dt.py",
"132": "0041_auto_20240216_1607.py",
"133": "0047_alter_productinstore_movement_type.py",
"134": "0049_alter_productinstore_options.py",
"135": "0057_sms.py",
"136": "admin_panel/sms/__init__.py",
"137": "bale/__init__.py",
"138": "integrations/__init__.py",
"139": "integrations/sms/__init__.py"
"0": "views/sms.py",
"1": "AutoSendTests",
"2": "django_db",
"3": "views/store.py",
"4": "ModelsPackageContractTests",
"5": "PhoneCleanupTests",
"6": ".load",
"7": "models/sms.py",
"8": "django_db_models",
"9": "views/customers.py",
"10": "django_db_models_deletion",
"11": "PanelTestCase",
"12": "mark_primary",
"13": "EventTriggerTests",
"14": "views/finance.py",
"15": "django_conf",
"16": "sms0098ws.py",
"17": "Admin Panel Customization",
"18": "views/actions.py",
"19": "timing_for",
"20": "InactiveCustomerHiddenTests",
"21": "normalize_mobile",
"22": "Login Template Forms",
"23": "cheque_inquiry.py",
"24": "factories.py",
"25": "Rip'n Fast. Fewer Tokens. Better Code.",
"26": "views/factors.py",
"27": "SMSResult",
"28": "make_user",
"29": "QueueReviewTests",
"30": "NoticeMechanismTests",
"31": "name_fix.py",
"32": "scanner.py",
"33": "ZeroZeroNinetyEightWebServiceTests",
"34": "ScannerTests",
"35": "admin_panel/templates/admin_panel/baseHesabdari.html",
"36": "Reference guide",
"37": "Factor Creation UI",
"38": "hesabdariResidNashode.html",
"39": "requests",
"40": "CustomerSmsHistoryTests",
"41": "TemplatesPageUITests",
"42": "SMS Integration Docs",
"43": "enqueue.py",
"44": "django_shortcuts",
"45": "stock_in",
"46": "admin_panel/templates/admin_panel/customerAction.html",
"47": "SmsReportTests",
"48": "generate_snapshot",
"49": "CustomerInfoCardUITests",
"50": "enqueue_sms",
"51": "Phone Cleanup Guide",
"52": ".run_command",
"53": "project_tree.py",
"54": "Agent Operating Guidelines",
"55": "Command",
"56": "BehinSMSProvider",
"57": "run_all",
"58": "Financial Data Objects",
"59": "Hybrid Migration Command",
"60": "PhoneNumber",
"61": "Resource Cleanup Handler",
"62": "SMS Timing Migration",
"63": "admin_panel/templates/admin_panel/bedehi.html",
"64": "customerIDFactorBackup.html",
"65": "VisitHoldTests",
"66": "reconciliation_tool.py",
"67": "Graphify Tooling Docs",
"68": "Command",
"69": "ZeroZeroNinetyEightLinkTests",
"70": "SMS Template Seeding",
"71": "admin_panel/entezar.html",
"72": "customerNewBackup.html",
"73": "SMSProvider",
"74": "0070_sms_types_seven.py",
"75": "ViewSmokeTests",
"76": "Timezone Migration History",
"77": "Command",
"78": "TodayFollowupTests",
"79": "Brand Scrubbing Migration",
"80": "SMS Dedup Migration",
"81": "Installation Guide",
"82": "Project Honesty Contract",
"83": "Flow Control Migration",
"84": "Permission Label Migration",
"85": "visit_policy.py",
"86": "Output Format Specs",
"87": "Performance Benchmarks",
"88": "SMS Integration Overview",
"89": "CustomerNameFixJob",
"90": "Customer Modal UI",
"91": "decide_prefix",
"92": "Infrastructure Services",
"93": "Agent Setup Guide",
"94": "First Use Guide",
"95": "console.py",
"96": "test_sms.py",
"97": "تجمیع شماره‌های پیامک مشتریان",
"98": "Command",
"99": "Base Template",
"100": "test_customer_name_fix.py",
"101": "Customer",
"102": "WorkerTests",
"103": "manage.py",
"104": "افزودن پیشوند «آقای/خانم» به نام مشتریان",
"105": "Command",
"106": "make_customer",
"107": "admin_panel/apps.py",
"108": "SMS Domain Logic",
"109": "Customer Communication Partials",
"110": "SMS Template Management",
"111": "Documentation and Graphing",
"112": "Admin Migration Package",
"113": "resolve_recipients",
"114": "Customer Action Templates",
"115": "Customer Feedback Components",
"116": "Customer Invoice Details",
"117": "Accounting Document Templates",
"118": "Customer Invoice List",
"119": "Customer Feedback Interface",
"120": "Custom Management Commands",
"121": "Django Management Package",
"122": "Admin Panel Migrations",
"123": "Action List Interface",
"124": "Base HTML Layout",
"125": "New Invoice Creation",
"126": "Customer Satisfaction Records",
"127": "Satisfaction UI Components",
"128": "Debt and Credit Management",
"129": "Customer Base Layout",
"130": "Waiting List Template",
"131": "Financial Dashboard",
"132": "Accounting Main View",
"133": "Admin Dashboard Index",
"134": "Inventory Entry Form",
"135": "Inventory Operations History",
"136": "Operations Backup View",
"137": "Financial Reporting",
"138": "Debt Collection Interface",
"139": "Inventory Movement Analytics",
"140": "Satisfaction Analytics Dashboard",
"141": "Credit Status Reports",
"142": "Satisfaction List View",
"143": "SMS Queue Management",
"144": "Store Inventory View",
"145": "Store Transfer Interface",
"146": "Store Directory Template",
"147": "Currency Formatting Utility",
"148": "Django Template Tags",
"149": "Store Creation Endpoint",
"150": "Transfer Processing Endpoint",
"151": "Satisfaction Edit Endpoint",
"152": "Customer Deletion Endpoint",
"153": "HTTPSMSProvider",
"154": "Django Permissions System",
"155": "Static Asset Management",
"156": "Data Cleanup Documentation",
"157": "Bale Integration Package",
"158": "External Integrations",
"159": "SMS Integration Module",
"160": "Khatibi Custom Module",
"161": "Project Dependencies",
"162": "Test Suite Package",
"163": "Customer",
"164": "EntezarPageControlsTests",
"165": "0075_cheque_funding_before_due.py",
"166": "توقف و ادامه (Resume / Checkpoint)",
"167": "RecalcCommandTests",
"168": "0071_sms_settings_permission.py",
"169": "0056_auto_20260731_1824.py",
"170": "الگوریتم تصمیم (به همین ترتیب)",
"171": "سریع‌ترین مسیر روی Production (خلاصهٔ اجرایی)",
"172": "0073_alter_action_actiontype_choices.py",
"173": "stop.sh",
"174": "0074_alter_action_status_choices.py",
"175": "at",
"176": "اجرای محلی (توسعه)",
"177": "apply_timing",
"178": "اجرا روی سرور Production",
"179": "اجرای محلی (توسعه)",
"180": "ادامهٔ job پس از crash / قطع برق",
"181": "اجرا روی سرور Production",
"182": "os",
"183": "0005_auto_20220121_2054.py",
"184": "test_visit_policy.py",
"185": "0014_auto_20220123_1348.py",
"186": "ActionSoftDeleteTests",
"187": "last_visit_map",
"188": "CoordinationDoneConfirmTests",
"189": "BaseTemplateStructureTests",
"190": "0028_action_grade.py",
"191": "validate_action_payload",
"192": "NextAppointmentTests",
"193": "0034_alter_article_sarresid.py",
"194": "django_contrib_auth_models",
"195": "entezar",
"196": "0041_auto_20240216_1607.py",
"197": "Action",
"198": "بخش دوم — امکانات جدید رابط کاربری صفحهٔ انتظار",
"199": "بازمحاسبهٔ «آخرین بازدید» مشتریان",
"200": "0062_sms_link_provider.py",
"201": "TestCase",
"202": "newFactor",
"203": "0072_customernamefixjob.py",
"204": "0077_alter_smstemplate_text_balance_help.py",
"205": "«قرار بعدی» بازدید و صفحهٔ انتظار — توضیح کامل عملکرد",
"206": "SMSDeliveryCommandTests",
"207": "ActionModalTemplateTests",
"208": "customer_balance",
"209": "VisitDecisionTests",
"210": "EntezarScannerConsistencyTests",
"211": "EntezarLayoutTests",
"212": "signals.py",
"213": "۴. فرم ثبت اقدام (UI)",
"214": "۱.۱ نمای «نیازمند پیگیری امروز» (`?view=today`) — **پیش‌فرض صفحه**",
"215": "cleanup_visit_dedup.py",
"216": "۶.۱ حذف یک اقدام (soft-delete)",
"217": "active_deferral",
"218": "index",
"219": "0025_action_actiontype.py",
"220": "0027_alter_action_nazar.py",
"221": "0029_alter_article_options.py",
"222": "0030_auto_20220414_1047.py"
}
+1 -1
View File
@@ -1 +1 @@
{"0": "5ff8a72726a083db", "1": "219b01f43ec5f76d", "2": "edab4be6f8bf260c", "3": "70018840272ab80e", "4": "d36df3c85181f806", "5": "9eb1daeea9dda6c2", "6": "076144c85b2925b4", "7": "0928f3aa4e597117", "8": "0e080dc901d1f670", "9": "a00d0684d05c01a4", "10": "9701f1591d8fda6e", "11": "5290f7a7558a9c3e", "12": "e6a8282720eded0c", "13": "05119fe8608a0cbd", "14": "903ab35120e04b54", "15": "91b75fb079f9c02c", "16": "c12f70f2136b1a97", "17": "06959e26b0aedfb2", "18": "90146abe85d9419f", "19": "21f888d34b160f31", "20": "bc287e5355564fe6", "21": "0f632fc57e9feeb0", "22": "af89b22ae0662d6d", "23": "a800ecffc01fc9d5", "24": "955593b6e631a7a7", "25": "a19c211702401a5b", "26": "e72a0ec031902754", "27": "c9e7bf6ac46f263c", "28": "1a67e40fab1eeadd", "29": "3f3a4eb6e6b2f4d6", "30": "389c17cd386d28f2", "31": "03f8896e9b60ca96", "32": "40771cc7fa5ee930", "33": "c02bc9595eaedd36", "34": "d76e40111efda56a", "35": "7714d721fe893ef5", "36": "466b12915e08a4f0", "37": "2f1621907db6f86f", "38": "ef8221c5fdeee7f8", "39": "a890d0d5da72d758", "40": "bf60a8731033e467", "41": "d5c0f5f6714c9991", "42": "9948fb8b548535ed", "43": "61882165e32527ce", "44": "f1310e6117296d59", "45": "90e57f26f669372d", "46": "95f91e2eaf52002c", "47": "32e693b104a691c2", "48": "66ed76491a412a72", "49": "e67668b62ee6c62c", "50": "68aee39cd24db354", "51": "09b7297ea62919f2", "52": "054401d27ffaa4b2", "53": "dace81c1995fb321", "54": "19e301aeace95bb2", "55": "d6fd0cec4634a0b0", "56": "0230d355a6dabb54", "57": "5cebbb5528321795", "58": "536fe28d24c361f5", "59": "b08bdc2712cb0f12", "60": "6ce8444f504022cc", "61": "8021f52559633383", "62": "d8e34a3b3eb43ee0", "63": "056b8d6b5072289b", "64": "171c34c74a95481b", "65": "73e9eca6f2ca1c9b", "66": "dcc2230ae751c29a", "67": "2a617b932f5d92b2", "68": "2f5417a69eb1d15e", "69": "d55cb638532fdfeb", "70": "06cae4389208269f", "71": "e9c0a7be255e9b26", "72": "455b4ca39e55ecb0", "73": "8105c55538c34081", "74": "74304670b54c018f", "75": "a27f876eabb044b2", "76": "73f74dd7a40776d6", "77": "29d433d164b99f89", "78": "3f44aa48aa05d597", "79": "ca8a7efba0a3e579", "80": "5cc770af9d184d77", "81": "2d31fa723128b164", "82": "9d814c2520329846", "83": "f97d1a5c3a066598", "84": "14f84a6e4cd311d6", "85": "3a592d27b1f4ccc9", "86": "0bf6f9d0aeab4fd8", "87": "8b491bb3ff0649dd", "88": "638812cee15d1b9b", "89": "3dd16d68928a479c", "90": "72dad91d66d471ce", "91": "353a9d09eaae47ea", "92": "2d29260874184e4a", "93": "00d4d9fc79267971", "94": "8fedb8424b4f7d54", "95": "c7ce06d5e4e87224", "96": "9d46bbe4641a8543", "97": "68b25e60cbe5368c", "98": "8f5a6aa62c618b5f", "99": "33819123dbb4d454", "100": "e8d32595704b722a", "101": "e4fcae6cb365fba9", "102": "32ed40052fe2c3f8", "103": "8ff365aee1c1a767", "104": "c5743041b2101132", "105": "891ec2c014046f05", "106": "0c4707ef57c917a2", "107": "43bbf35b96423d46", "108": "88f880da5a61f9dc", "109": "dbfbf8557361f5ea", "110": "6e90b41fbd82c265", "111": "118bde95524551e0", "112": "b85898490162caed", "113": "d55977ec0e3ae213", "114": "df7ea8ce3fa52be3", "115": "460dadaff123e841", "116": "4faac8c35fa8b703", "117": "aea8fc3ff351253f", "118": "bda9be183e0f933e", "119": "63526d01888c4f22", "120": "329e844b7c9edf2d", "121": "37d2f4398ee065c5", "122": "49438bf9f08f11ff", "123": "b9687fc2d4953aed", "124": "6288b9f165b037f4", "125": "f97753a176d20dae", "126": "9cc7a507cfecd8fb", "127": "edb619bf5ac0fc49", "128": "8cb6b3db3aadb973", "129": "c9638aef2c5c82d8", "130": "c6b3f6e0a15a6a0b", "131": "52502a4c1ef75ce6", "132": "8d20e5c1bce8916d", "133": "b5ce3fce9192f8b8", "134": "6cef5bc37e710e62", "135": "0098e532f53735f2", "136": "b738c5aefe939cff", "137": "a9bf69b3d550abef", "138": "b039e1c69c8fb7b9", "139": "60029bf0948fc02a"}
{"0": "0b739897e89c7b41", "1": "c845994d0f12d034", "2": "8c7679f720857bf1", "3": "9653c364b823290d", "4": "ea39680823c06133", "5": "1c7a6b6536eca5f4", "6": "6b788d0721a913f7", "7": "97d81e46229f8a49", "8": "313943d53fc2bd9f", "9": "da38f92f51e93c79", "10": "0153b3a4e04dd75a", "11": "41d17fe9560c47f6", "12": "d6d2ce2d7d595ba2", "13": "e799ebae9c509cb3", "14": "48d0d033c0d2964f", "15": "58e9c0768a2c889d", "16": "e4b58f9f9e36d64a", "17": "9eec9953ee3ca67f", "18": "1b6aefd19ce25cbe", "19": "a7ba24b2eb2edbbe", "20": "a8997e767700eb26", "21": "0020ce7d1908ad7a", "22": "9701f1591d8fda6e", "23": "7cd46ce4c8fb3ca4", "24": "2ffddab549a70d4b", "25": "90da597ad2a7919f", "26": "c2574e654e1d0322", "27": "994c5e2378052e94", "28": "9a4550f6e7e78e08", "29": "ff4922906a507758", "30": "e4f88099ea3ccfa4", "31": "4d4f780fb4e7f8ea", "32": "293ee6609d9f939d", "33": "0564a8d4ebd069cc", "34": "d92b5a81599860af", "35": "0928f3aa4e597117", "36": "b584145a0a6af86a", "37": "d36df3c85181f806", "38": "bc695fcee2050806", "39": "b5fb0ddc2a912cb0", "40": "ef568e093f9cb1b3", "41": "18750a5fb3366fa5", "42": "bbd8a9066e48dada", "43": "0822c3c7bdd37717", "44": "159d7e82897e35fc", "45": "a7e9b25451da94c4", "46": "f38c1f1dc0ead50f", "47": "9004ecf9c7067aa0", "48": "67d2b4075e544a13", "49": "df2dbdd967da3eaf", "50": "8a2fd7414c9ee9e6", "51": "afc6d855b9fc1b76", "52": "5b43fbf8fcf8716d", "53": "e97ba10a1e6a2df3", "54": "34401beb9f60ebfd", "55": "ffa54e3d7035005e", "56": "330644cc56a0e06c", "57": "e2cb064067d950bd", "58": "90146abe85d9419f", "59": "88f880da5a61f9dc", "60": "306fc8a49c104841", "61": "dbfbf8557361f5ea", "62": "6e90b41fbd82c265", "63": "6af26e59b0e8c354", "64": "8ae1cb991df55ba5", "65": "870e90323abfd449", "66": "8f5a6aa62c618b5f", "67": "0f632fc57e9feeb0", "68": "92d7e4efe25770db", "69": "edda1f9fc3ddc6f9", "70": "df7ea8ce3fa52be3", "71": "fd47ef3914adf11e", "72": "9b3249f4a4e6fbfe", "73": "12a25396ede4f1e9", "74": "a534e43d03671a7c", "75": "0d14f943dc48c339", "76": "a19c211702401a5b", "77": "35aa0fc2a0626f70", "78": "fed2ae936b50d86d", "79": "da683f642f8c61ac", "80": "40313433c93b7054", "81": "81af0a28b68936d9", "82": "25287261c3d1c44b", "83": "bda9be183e0f933e", "84": "63526d01888c4f22", "85": "0bf99e0a63147db6", "86": "694a38d63caf7217", "87": "f220eaa4fac26e3e", "88": "d78c8e21a45613e9", "89": "e5ca736ea1d10113", "90": "03f8896e9b60ca96", "91": "4d4f5e897228ae79", "92": "4bfa64a1cd8c6a47", "93": "057eae5a523d2004", "94": "5de74655cbc56e06", "95": "b4f836f96422aa82", "96": "8d8fa0ac595a0ab7", "97": "19b821f40f591523", "98": "7508d3e84c588617", "99": "15f6a40009e539bb", "100": "634340879ffb956e", "101": "e752861d6bd6141e", "102": "9bb0051cf12f369d", "103": "85ecb40ed558ed43", "104": "756a405f723988ce", "105": "d55977ec0e3ae213", "106": "5970abbcf384c31d", "107": "06b5a3c2baa12fdb", "108": "b738c5aefe939cff", "109": "d2001d7d283134ac", "110": "6b8e6100893a6b6a", "111": "66ed76491a412a72", "112": "e67668b62ee6c62c", "113": "38b87928585aa997", "114": "68aee39cd24db354", "115": "054401d27ffaa4b2", "116": "dace81c1995fb321", "117": "19e301aeace95bb2", "118": "d6fd0cec4634a0b0", "119": "0230d355a6dabb54", "120": "5cebbb5528321795", "121": "536fe28d24c361f5", "122": "b08bdc2712cb0f12", "123": "6ce8444f504022cc", "124": "8021f52559633383", "125": "d8e34a3b3eb43ee0", "126": "171c34c74a95481b", "127": "73e9eca6f2ca1c9b", "128": "dcc2230ae751c29a", "129": "2a617b932f5d92b2", "130": "d55cb638532fdfeb", "131": "06cae4389208269f", "132": "e9c0a7be255e9b26", "133": "455b4ca39e55ecb0", "134": "8105c55538c34081", "135": "74304670b54c018f", "136": "a27f876eabb044b2", "137": "73f74dd7a40776d6", "138": "29d433d164b99f89", "139": "3f44aa48aa05d597", "140": "ca8a7efba0a3e579", "141": "5cc770af9d184d77", "142": "2d31fa723128b164", "143": "be720fc0071f0c3d", "144": "9d814c2520329846", "145": "f97d1a5c3a066598", "146": "14f84a6e4cd311d6", "147": "3a592d27b1f4ccc9", "148": "0bf6f9d0aeab4fd8", "149": "8b491bb3ff0649dd", "150": "638812cee15d1b9b", "151": "3dd16d68928a479c", "152": "03a0ee43e18f7934", "153": "1b4ee66550701d94", "154": "435331945d6aad17", "155": "968e1a135dc062b7", "156": "d1a987a548e55a76", "157": "a9bf69b3d550abef", "158": "b039e1c69c8fb7b9", "159": "60029bf0948fc02a", "160": "72dad91d66d471ce", "161": "353a9d09eaae47ea", "162": "43bbf35b96423d46", "163": "4faac8c35fa8b703", "164": "4af634c3c14ff03b", "165": "652eabd3db52041c", "166": "bca6f6760a942d10", "167": "29cb511ef6daa0c1", "168": "1abe2e7b0bcbeca9", "169": "cfbcf8cef78c5757", "170": "c9f25e20d3a7d5d8", "171": "7e818e8715c414bd", "172": "8d68a258e8ec738b", "173": "827420b645a55301", "174": "19e1beef5d40e7ac", "175": "43e1b3409f1becc6", "176": "adac855b05ea55ee", "177": "237c0746be1bce16", "178": "c67bd11d1973d6ac", "179": "63c999649e523e73", "180": "56f7f3573c34f651", "181": "f8f5346df7d0a239", "182": "43b977f2b2e6524e", "183": "6886ad7a5751faca", "184": "bfad11052c54a1cc", "185": "32f7ccd6bd4068c7", "186": "3f88bb4be9a0294a", "187": "f3756e86a6b2bee6", "188": "5bb9e4f75573b97c", "189"Line truncated
+1 -1
View File
@@ -1 +1 @@
{"output_tokens": 126792}
{"output_tokens": 201}
File diff suppressed because it is too large. Load diff
+5 -5
View File
@@ -63,12 +63,12 @@
</div>
<div id="legend"></div>
</div>
<div id="stats">1280 nodes &middot; 2237 edges &middot; 140 communities</div>
<div id="stats">2509 nodes &middot; 4876 edges &middot; 223 communities</div>
</div>
<script>
const RAW_NODES = [{"id": "admin_panel_models_store_storetransferrequest", "label": "StoreTransferRequest", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 13.8, "font": {"size": 0, "color": "#ffffff"}, "title": "StoreTransferRequest", "community": 0, "community_name": "views/store.py", "source_file": "admin_panel/models/store.py", "file_type": "code", "degree": 10}, {"id": "admin_panel_models_store_storetransferrequest_meta", "label": "Meta", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.4, "font": {"size": 0, "color": "#ffffff"}, "title": "Meta", "community": 0, "community_name": "views/store.py", "source_file": "admin_panel/models/store.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_models_store_storetransferrequest_status", "label": "Status", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.4, "font": {"size": 0, "color": "#ffffff"}, "title": "Status", "community": 0, "community_name": "views/store.py", "source_file": "admin_panel/models/store.py", "file_type": "code", "degree": 1}, {"id": "tests_test_inventory_productinstoremathtests", "label": "ProductInStoreMathTests", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 13.4, "font": {"size": 0, "color": "#ffffff"}, "title": "ProductInStoreMathTests", "community": 0, "community_name": "views/store.py", "source_file": "tests/test_inventory.py", "file_type": "code", "degree": 9}, {"id": "tests_test_inventory_transferworkflowtests", "label": "TransferWorkflowTests", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 14.9, "font": {"size": 12, "color": "#ffffff"}, "title": "TransferWorkflowTests", "community": 0, "community_name": "views/store.py", "source_file": "tests/test_inventory.py", "file_type": "code", "degree": 13}, {"id": "integrations_announcements_announcementrejected", "label": "AnnouncementRejected", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 11.5, "font": {"size": 0, "color": "#ffffff"}, "title": "AnnouncementRejected", "community": 100, "community_name": "django_conf", "source_file": "integrations/announcements.py", "file_type": "code", "degree": 4}, {"id": "integrations_voip_voipcallresult", "label": "VoipCallResult", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "VoipCallResult", "community": 100, "community_name": "django_conf", "source_file": "integrations/voip.py", "file_type": "code", "degree": 2}, {"id": "admin_panel_management_commands_sms_worker_command", "label": "Command", "color": {"background": "#F28E2B", "border": "#F28E2B", "highlight": {"background": "#ffffff", "border": "#F28E2B"}}, "size": 13.8, "font": {"size": 0, "color": "#ffffff"}, "title": "Command", "community": 101, "community_name": "Command", "source_file": "admin_panel/management/commands/sms_worker.py", "file_type": "code", "degree": 10}, {"id": "tests_test_urls_contract_urlcontracttests", "label": "UrlContractTests", "color": {"background": "#E15759", "border": "#E15759", "highlight": {"background": "#ffffff", "border": "#E15759"}}, "size": 12.3, "font": {"size": 0, "color": "#ffffff"}, "title": "UrlContractTests", "community": 102, "community_name": "UrlContractTests", "source_file": "tests/test_urls_contract.py", "file_type": "code", "degree": 6}, {"id": "admin_panel_models_system_cachetable", "label": "CacheTable", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "CacheTable", "community": 104, "community_name": "system.py", "source_file": "admin_panel/models/system.py", "file_type": "code", "degree": 2}, {"id": "integrations_sms_behin_behinsmsprovider", "label": "BehinSMSProvider", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 13.8, "font": {"size": 0, "color": "#ffffff"}, "title": "BehinSMSProvider", "community": 105, "community_name": "BehinSMSProvider", "source_file": "integrations/sms/behin.py", "file_type": "code", "degree": 10}, {"id": "tests_test_customers_customercrudtests", "label": "CustomerCrudTests", "color": {"background": "#B07AA1", "border": "#B07AA1", "highlight": {"background": "#ffffff", "border": "#B07AA1"}}, "size": 12.7, "font": {"size": 0, "color": "#ffffff"}, "title": "CustomerCrudTests", "community": 106, "community_name": "test_customers.py", "source_file": "tests/test_customers.py", "file_type": "code", "degreLine truncated
const RAW_EDGES = [{"from": "admin_panel_services_approve_transfer_request", "to": "admin_panel_models_store_storetransferrequest", "label": "references", "title": "references [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_services_cancel_transfer_request", "to": "admin_panel_models_store_storetransferrequest", "label": "references", "title": "references [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_services_create_transfer_request", "to": "admin_panel_models_store_storetransferrequest", "label": "references", "title": "references [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_services_reject_transfer_request", "to": "admin_panel_models_store_storetransferrequest", "label": "references", "title": "references [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_models_store", "to": "admin_panel_models_store_storetransferrequest", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_models_store_storetransferrequest", "to": "admin_panel_models_store_storetransferrequest_meta", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_models_store_storetransferrequest", "to": "admin_panel_models_store_storetransferrequest_status", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_models_store_storetransferrequest", "to": "admin_panel_models_store_storetransferrequest_str", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_models_store_storetransferrequest", "to": "admin_panel_models_store_storetransferrequest_clean", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_models_store_storetransferrequest", "to": "admin_models_user", "label": "uses", "title": "uses [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "tests_test_inventory", "to": "tests_test_inventory_productinstoremathtests", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_py_testcase", "label": "inherits", "title": "inherits [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_productinstoremathtests_setup", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_productinstoremathtests_test_initial_in_records_history_and_stock", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_productinstoremathtests_test_multiple_movements_accumulate_correctly", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_productinstoremathtests_test_editing_a_row_updates_stock_and_history", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_productinstoremathtests_test_deleting_a_row_creates_history_and_reduces_stock", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "tests_test_inventory_productinstoremathtests_test_garbage_numeric_values_are_coerced_to_zero", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_inventory_productinstoremathtests", "to": "admin_models_productinstore", "label": "uses", "title": "uses [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "tests_test_inventory", "to": "tests_test_inventory_transferworkflowtests", "label": "contains", "tLine truncated
const LEGEND = [{"cid": 0, "color": "#4E79A7", "label": "views/store.py", "count": 68}, {"cid": 1, "color": "#F28E2B", "label": "project_tree.py", "count": 14}, {"cid": 2, "color": "#E15759", "label": "sqlite_db_backup.py", "count": 11}, {"cid": 3, "color": "#76B7B2", "label": "django_db", "count": 29}, {"cid": 4, "color": "#59A14F", "label": "Customer ID Backup/New Factor Template", "count": 14}, {"cid": 5, "color": "#EDC948", "label": "views/customers.py", "count": 26}, {"cid": 6, "color": "#B07AA1", "label": "cheque_inquiry.py", "count": 21}, {"cid": 7, "color": "#FF9DA7", "label": "admin_panel/templates/admin_panel/baseHesabdari.html", "count": 15}, {"cid": 8, "color": "#9C755F", "label": "django_db_models_deletion", "count": 31}, {"cid": 9, "color": "#BAB0AC", "label": "0051_auto_20260705_1356.py", "count": 2}, {"cid": 10, "color": "#4E79A7", "label": "admin_panel/storeBK1.html", "count": 19}, {"cid": 11, "color": "#F28E2B", "label": "ViewSmokeTests", "count": 8}, {"cid": 12, "color": "#E15759", "label": "admin_panel/templates/admin_panel/customerAction.html", "count": 17}, {"cid": 13, "color": "#76B7B2", "label": "User", "count": 48}, {"cid": 14, "color": "#59A14F", "label": "run_all", "count": 64}, {"cid": 15, "color": "#EDC948", "label": "admin_panel/admin.py", "count": 28}, {"cid": 16, "color": "#B07AA1", "label": "stock_in", "count": 24}, {"cid": 17, "color": "#FF9DA7", "label": "admin_panel/templates/admin_panel/bedehi.html", "count": 20}, {"cid": 18, "color": "#9C755F", "label": "hesabdariCheckPassFail.html", "count": 10}, {"cid": 19, "color": "#BAB0AC", "label": "Reference guide", "count": 27}, {"cid": 20, "color": "#4E79A7", "label": "normalize_mobile", "count": 34}, {"cid": 21, "color": "#F28E2B", "label": "graphify", "count": 9}, {"cid": 22, "color": "#E15759", "label": "hesabdariResidNashode.html", "count": 6}, {"cid": 23, "color": "#76B7B2", "label": "0017_factoriteam_garantyesh.py", "count": 2}, {"cid": 24, "color": "#59A14F", "label": "scanner.py", "count": 32}, {"cid": 25, "color": "#EDC948", "label": "0002_auto_20220114_1616.py", "count": 7}, {"cid": 26, "color": "#B07AA1", "label": "SMSResult", "count": 30}, {"cid": 27, "color": "#FF9DA7", "label": "Rip&#x27;n Fast. Fewer Tokens. Better Code.", "count": 44}, {"cid": 28, "color": "#9C755F", "label": "models/sms.py", "count": 26}, {"cid": 29, "color": "#BAB0AC", "label": "admin_panel/templates/admin_panel/baseStore.html", "count": 15}, {"cid": 30, "color": "#4E79A7", "label": "views/finance.py", "count": 24}, {"cid": 31, "color": "#F28E2B", "label": "Customer Modals UI", "count": 3}, {"cid": 32, "color": "#E15759", "label": "views/factors.py", "count": 22}, {"cid": 33, "color": "#76B7B2", "label": "0034_alter_article_sarresid.py", "count": 2}, {"cid": 34, "color": "#59A14F", "label": "views/sms.py", "count": 22}, {"cid": 35, "color": "#EDC948", "label": "0035_alter_article_sarresid.py", "count": 2}, {"cid": 36, "color": "#B07AA1", "label": "django_db_models", "count": 20}, {"cid": 37, "color": "#FF9DA7", "label": "0010_auto_20220122_1546.py", "count": 2}, {"cid": 38, "color": "#9C755F", "label": "0040_customer_laghv_bazdid.py", "count": 2}, {"cid": 39, "color": "#BAB0AC", "label": "test_sms.py", "count": 20}, {"cid": 40, "color": "#4E79A7", "label": "0048_alter_productinstore_options.py", "count": 2}, {"cid": 41, "color": "#F28E2B", "label": "0032_article_paystatus.py", "count": 2}, {"cid": 42, "color": "#E15759", "label": "0033_article_nahvepardakht.py", "count": 2}, {"cid": 43, "color": "#76B7B2", "label": "make_customer", "count": 19}, {"cid": 44, "color": "#59A14F", "label": "sms0098.py", "count": 19}, {"cid": 45, "color": "#EDC948", "label": "0044_sarresid_desc.py", "count": 2}, {"cid": 46, "color": "#B07AA1", "label": "models/__init__.py", "count": 18}, {"cid": 47, "color": "#FF9DA7", "label": "make_user", "count": 17}, {"cid": 48, "color": "#9C755F", "label": "GEMINI.md", "count": 2}, {"cid": 49, "color": "#BAB0AC", "label": "admin/migrations/__init__.py", "count": 1}, {"cid": 50, "color": "#4E79A7", "label": "Customer Action Include", "count": 1}, {"cid": 51, "color": "#F28E2B", "label": "New Customer Base Template", "count": 1}, {"cid": 52, "color": "#E15759", "label": "Customer Feedback Partial", "count": 1}, {"cid": 53, "color": "#76B7B2", "label": "Customer Factor Detail", "count": 1}, {"cid": 54, "color": "#59A14F", "label": "Customer Accounting Template", "count": 1}, {"cid": 55, "color": "#EDC948", "label": "Customer Factor List", "count": 1}, {"cid": 56, "color": "#B07AA1", "label": "Customer Feedback Page", "count": 1}, {"cid": 57, "color": "#FF9DA7", "label": "commands/__init__.py", "count": 1}, {"cid": 58, "color": "#9C755F", "label": "management/__init__.py", "count": 1}, {"cid": 59, "color": "#BAB0AC", "label": "admin_panel/migrations/__init__.py", "count": 1}, {"cid": 60, "color": "#4E79A7", "label": "Action List Template", "count": 1}, {"cid": 61, "color": "#F28E2B", "label": "base.html", "count": 1}, {"cid": 62,Line truncated
const RAW_NODES = [{"id": "tests_test_sms_autosendtests", "label": "AutoSendTests", "color": {"background": "#F28E2B", "border": "#F28E2B", "highlight": {"background": "#ffffff", "border": "#F28E2B"}}, "size": 13.2, "font": {"size": 0, "color": "#ffffff"}, "title": "AutoSendTests", "community": 1, "community_name": "AutoSendTests", "source_file": "tests/test_sms.py", "file_type": "code", "degree": 12}, {"id": "admin_panel_migrations_0001_initial_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0001_initial.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0007_productinstore_factor_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0007_productinstore_factor.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0008_storeroom_user_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0008_storeroom_user.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0011_storeroom_user_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0011_storeroom_user.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0018_alter_factoriteam_product_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0018_alter_factoriteam_product.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0019_article_articletype_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0019_article_articletype.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0036_sarresid_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0036_sarresid.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0038_auto_20240213_1735_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0038_auto_20240213_1735.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0042_article_user_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0042_article_user.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0046_auto_20260624_1818_migration", "label": "Migration", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "Migration", "community": 10, "community_name": "django_db_models_deletion", "source_file": "admin_panel/migrations/0046_auto_20260624_1818.py", "file_type": "code", "degree": 1}, {"id": "admin_panel_migrations_0054_auto_20260715_2250_migration", "label": "Migration", "color": {"background": "#4E79A7", "borderLine truncated
const RAW_EDGES = [{"from": "tests_test_sms", "to": "tests_test_sms_autosendtests", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_paneltestcase", "label": "inherits", "title": "inherits [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_overdue_visit_customer", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_test_default_is_pending_so_manager_must_approve", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_test_auto_send_enqueues_approved_without_manager", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_test_auto_send_does_not_bypass_opt_out_or_disabled", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_test_welcome_auto_send_skips_approval_on_customer_creation", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_test_template_edit_persists_auto_send", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "tests_test_sms_autosendtests_test_templates_page_shows_auto_send_switch", "label": "method", "title": "method [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_rationale_1246", "to": "tests_test_sms_autosendtests", "label": "rationale_for", "title": "rationale_for [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "tests_test_sms_autosendtests", "to": "admin_models_phonenumber", "label": "uses", "title": "uses [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "tests_test_sms_autosendtests", "to": "admin_models_customer", "label": "uses", "title": "uses [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "admin_panel_migrations_0001_initial", "to": "admin_panel_migrations_0001_initial_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0007_productinstore_factor", "to": "admin_panel_migrations_0007_productinstore_factor_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0008_storeroom_user", "to": "admin_panel_migrations_0008_storeroom_user_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0011_storeroom_user", "to": "admin_panel_migrations_0011_storeroom_user_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0018_alter_factoriteam_product", "to": "admin_panel_migrations_0018_alter_factoriteam_product_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0019_article_articletype", "to": "admin_panel_migrations_0019_article_articletype_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0036_sarresid", "to": "admin_panel_migrations_0036_sarresid_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0038_auto_20240213_1735", "to": "admin_panel_migrations_0038_auto_20240213_1735_migration", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "admin_panel_migrations_0042_article_user", "to": Line truncated
const LEGEND = [{"cid": 0, "color": "#4E79A7", "label": "views/sms.py", "count": 37}, {"cid": 1, "color": "#F28E2B", "label": "AutoSendTests", "count": 9}, {"cid": 2, "color": "#E15759", "label": "django_db", "count": 57}, {"cid": 3, "color": "#76B7B2", "label": "views/store.py", "count": 72}, {"cid": 4, "color": "#59A14F", "label": "ModelsPackageContractTests", "count": 15}, {"cid": 5, "color": "#EDC948", "label": "PhoneCleanupTests", "count": 35}, {"cid": 6, "color": "#B07AA1", "label": ".load", "count": 12}, {"cid": 7, "color": "#FF9DA7", "label": "models/sms.py", "count": 32}, {"cid": 8, "color": "#9C755F", "label": "django_db_models", "count": 27}, {"cid": 9, "color": "#BAB0AC", "label": "views/customers.py", "count": 29}, {"cid": 10, "color": "#4E79A7", "label": "django_db_models_deletion", "count": 27}, {"cid": 11, "color": "#F28E2B", "label": "PanelTestCase", "count": 14}, {"cid": 12, "color": "#E15759", "label": "mark_primary", "count": 16}, {"cid": 13, "color": "#76B7B2", "label": "EventTriggerTests", "count": 21}, {"cid": 14, "color": "#59A14F", "label": "views/finance.py", "count": 27}, {"cid": 15, "color": "#EDC948", "label": "django_conf", "count": 28}, {"cid": 16, "color": "#B07AA1", "label": "sms0098ws.py", "count": 22}, {"cid": 17, "color": "#FF9DA7", "label": "Admin Panel Customization", "count": 22}, {"cid": 18, "color": "#9C755F", "label": "views/actions.py", "count": 39}, {"cid": 19, "color": "#BAB0AC", "label": "timing_for", "count": 20}, {"cid": 20, "color": "#4E79A7", "label": "InactiveCustomerHiddenTests", "count": 16}, {"cid": 21, "color": "#F28E2B", "label": "normalize_mobile", "count": 35}, {"cid": 22, "color": "#E15759", "label": "Login Template Forms", "count": 19}, {"cid": 23, "color": "#76B7B2", "label": "cheque_inquiry.py", "count": 19}, {"cid": 24, "color": "#59A14F", "label": "factories.py", "count": 19}, {"cid": 25, "color": "#EDC948", "label": "Rip&#x27;n Fast. Fewer Tokens. Better Code.", "count": 19}, {"cid": 26, "color": "#B07AA1", "label": "views/factors.py", "count": 21}, {"cid": 27, "color": "#FF9DA7", "label": "SMSResult", "count": 18}, {"cid": 28, "color": "#9C755F", "label": "make_user", "count": 23}, {"cid": 29, "color": "#BAB0AC", "label": "QueueReviewTests", "count": 9}, {"cid": 30, "color": "#4E79A7", "label": "NoticeMechanismTests", "count": 16}, {"cid": 31, "color": "#F28E2B", "label": "name_fix.py", "count": 27}, {"cid": 32, "color": "#E15759", "label": "scanner.py", "count": 28}, {"cid": 33, "color": "#76B7B2", "label": "ZeroZeroNinetyEightWebServiceTests", "count": 16}, {"cid": 34, "color": "#59A14F", "label": "ScannerTests", "count": 22}, {"cid": 35, "color": "#EDC948", "label": "admin_panel/templates/admin_panel/baseHesabdari.html", "count": 15}, {"cid": 36, "color": "#B07AA1", "label": "Reference guide", "count": 15}, {"cid": 37, "color": "#FF9DA7", "label": "Factor Creation UI", "count": 14}, {"cid": 38, "color": "#9C755F", "label": "hesabdariResidNashode.html", "count": 14}, {"cid": 39, "color": "#BAB0AC", "label": "requests", "count": 22}, {"cid": 40, "color": "#4E79A7", "label": "CustomerSmsHistoryTests", "count": 35}, {"cid": 41, "color": "#F28E2B", "label": "TemplatesPageUITests", "count": 14}, {"cid": 42, "color": "#E15759", "label": "SMS Integration Docs", "count": 13}, {"cid": 43, "color": "#76B7B2", "label": "enqueue.py", "count": 13}, {"cid": 44, "color": "#59A14F", "label": "django_shortcuts", "count": 12}, {"cid": 45, "color": "#EDC948", "label": "stock_in", "count": 27}, {"cid": 46, "color": "#B07AA1", "label": "admin_panel/templates/admin_panel/customerAction.html", "count": 13}, {"cid": 47, "color": "#FF9DA7", "label": "SmsReportTests", "count": 39}, {"cid": 48, "color": "#9C755F", "label": "generate_snapshot", "count": 8}, {"cid": 49, "color": "#BAB0AC", "label": "CustomerInfoCardUITests", "count": 13}, {"cid": 50, "color": "#4E79A7", "label": "enqueue_sms", "count": 12}, {"cid": 51, "color": "#F28E2B", "label": "Phone Cleanup Guide", "count": 12}, {"cid": 52, "color": "#E15759", "label": ".run_command", "count": 39}, {"cid": 53, "color": "#76B7B2", "label": "project_tree.py", "count": 13}, {"cid": 54, "color": "#59A14F", "label": "Agent Operating Guidelines", "count": 11}, {"cid": 55, "color": "#EDC948", "label": "Command", "count": 28}, {"cid": 56, "color": "#B07AA1", "label": "BehinSMSProvider", "count": 8}, {"cid": 57, "color": "#FF9DA7", "label": "run_all", "count": 16}, {"cid": 58, "color": "#9C755F", "label": "Financial Data Objects", "count": 10}, {"cid": 59, "color": "#BAB0AC", "label": "Hybrid Migration Command", "count": 10}, {"cid": 60, "color": "#4E79A7", "label": "PhoneNumber", "count": 34}, {"cid": 61, "color": "#F28E2B", "label": "Resource Cleanup Handler", "count": 10}, {"cid": 62, "color": "#E15759", "label": "SMS Timing Migration", "count": 10}, {"cid": 63, "color": "#76B7B2", "label": "admin_panel/templates/admin_panel/bedehi.html", "count": 10}, {"cid": 64, "color": "#59A14F", "label": "customerIDFactorBackup.htLine truncated
// HTML-escape helper — prevents XSS when injecting graph data into innerHTML
function esc(s) {
@@ -293,7 +293,7 @@ LEGEND.forEach(c => {
</script>
<script>
// Render hyperedges as shaded regions
const hyperedges = [{"id": "customer_retention_flow", "label": "Customer Satisfaction & Collection", "nodes": ["admin_panel_templates_admin_panel_report_rezayat", "admin_panel_templates_admin_panel_report_debtors_no_vosol", "admin_panel_customer_customernazarinc"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 0.9}, {"id": "customer_management_flow", "label": "Customer Management Flow", "nodes": ["admin_panel_customer_base_new", "admin_panel_customer_action_inc", "admin_panel_customer_id_factor", "admin_panel_customer_hesabdari"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "financial_management_flow", "label": "Financial & Debt Management", "nodes": ["admin_panel_templates_admin_panel_financial_dashboard", "admin_panel_templates_admin_panel_hesabdari"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "graphify_output_artifacts", "label": "Graphify Output Artifacts", "nodes": ["graphify-out_graph_json", "graphify-out_wiki_index_md", "graphify-out_graph_report_md"], "relation": "form", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": ".github/copilot-instructions.md"}, {"id": "graphify_subcommands", "label": "Graphify Subcommands", "nodes": ["graphify_query", "graphify_path", "graphify_explain"], "relation": "form", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": ".github/copilot-instructions.md"}, {"id": "inventory_management_flow", "label": "Inventory Management System", "nodes": ["admin_panel_templates_admin_panel_store", "admin_panel_templates_admin_panel_store_transfers", "admin_panel_templates_admin_panel_report_inventory_movements", "admin_panel_templates_admin_panel_operationsbk"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "bedehi_report_navigation", "label": "Bedehi Report Navigation", "nodes": ["django_urls_admin_panel_bedehi", "django_urls_admin_panel_bedehikhadamat", "django_urls_admin_panel_bedehinasb"], "relation": "participate_in", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/bedehi.html"}, {"id": "login_form", "label": "Login Form", "nodes": ["admin_panel_templates_admin_panel_login", "django_url_admin_panel_p_login", "django_csrf_token", "form_field_username", "form_field_password"], "relation": "form", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/login.html"}, {"id": "new_store_form", "label": "New Store Form", "nodes": ["admin_panel_templates_admin_panel_storebk1", "django_url_admin_panel_newstore", "django_csrf_token", "form_field_storename"], "relation": "form", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/storeBK1.html"}, {"id": "store_inventory_display", "label": "Store Inventory Display", "nodes": ["admin_panel_templates_admin_panel_storebk1", "template_variable_productsum", "product_property_product_name", "product_property_mojodi"], "relation": "participate_in", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/storeBK1.html"}, {"id": "customer_list_page", "label": "Customer List Page", "nodes": ["admin_panel_templates_admin_panel_entezar_html", "concept_customer_data", "concept_url_admin_panel_customers"], "relation": "form", "confidence": "INFERRED", "confidence_score": 0.8, "source_file": "admin_panel/templates/admin_panel/entezar.html"}, {"id": "customer_interaction_flow", "label": "Customer Lifecycle Management", "nodes": ["admin_panel_templates_admin_panel_customers"], "relation": "participate_in", "confidence": "INFERRED", "confidence_score": 0.85}, {"id": "customer_lifecycle_management", "label": "Customer Interaction Lifecycle", "nodes": ["admin_panel_templates_admin_panel_customers", "admin_panel_templates_admin_panel_customerNew", "admin_panel_templates_admin_panel_customerRezayat"], "relation": "form", "confidence": "INFERRED", "confidence_score": 0.85, "source_file": "admin_panel/templates/admin_panel/customers.html"}, {"id": "new_factor_creation_flow", "label": "New Factor Creation Flow", "nodes": ["admin_panel_templates_admin_panel_customernewbackup_html", "admin_panel_urls_newfactor", "concept_client_side_form_logic", "concept_customer", "concept_category"], "relation": "participate_in", "confidence": "INFERRED", "confidence_score": 0.85, "source_file": "admin_panel/templates/admin_panel/customerNewBackup.html"}, {"id": "customer_management_ui_flow", "label": "Customer Management UI Flow", "nodes": ["admin_panel_templates_admin_panel_customersbk_html", "admin_panel_templates_admin_panel_customersbk_html_createcs", "admin_panel_templates_admin_panel_customersbk_html_openrow", "concept_customer_modal_ui"], "relation": "participate_in", "confidence": "INFERRED", "confidence_score": 0.9, "source_file": "admin_panel/templates/admin_panel/customersBK.html"}, {"id": "financial_management_flow", "label": "Financial & Debt Management Flow", "nodes": ["adLine truncated
const hyperedges = [{"id": "customer_retention_flow", "label": "Customer Satisfaction & Collection", "nodes": ["admin_panel_templates_admin_panel_report_rezayat", "admin_panel_templates_admin_panel_report_debtors_no_vosol", "admin_panel_customer_customernazarinc"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 0.9}, {"id": "customer_management_flow", "label": "Customer Management Flow", "nodes": ["admin_panel_customer_action_inc", "admin_panel_customer_id_factor", "admin_panel_customer_hesabdari"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "financial_management_flow", "label": "Financial & Debt Management", "nodes": ["admin_panel_templates_admin_panel_financial_dashboard", "admin_panel_templates_admin_panel_hesabdari"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "graphify_output_artifacts", "label": "Graphify Output Artifacts", "nodes": ["graphify-out_graph_json", "graphify-out_wiki_index_md", "graphify-out_graph_report_md"], "relation": "form", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": ".github/copilot-instructions.md"}, {"id": "graphify_subcommands", "label": "Graphify Subcommands", "nodes": ["graphify_query", "graphify_path", "graphify_explain"], "relation": "form", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": ".github/copilot-instructions.md"}, {"id": "inventory_management_flow", "label": "Inventory Management System", "nodes": ["admin_panel_templates_admin_panel_store", "admin_panel_templates_admin_panel_store_transfers", "admin_panel_templates_admin_panel_report_inventory_movements", "admin_panel_templates_admin_panel_operationsbk"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "sms_management_system", "label": "SMS Management System", "nodes": ["admin_panel_templates_admin_panel_sms_settings_html", "admin_panel_templates_admin_panel_sms_templates_html", "admin_panel_templates_admin_panel_sms_queue_html", "sms_worker", "sms_delivery"], "relation": "participate_in", "confidence": "EXTRACTED", "confidence_score": 1.0}, {"id": "bedehi_report_navigation", "label": "Bedehi Report Navigation", "nodes": ["django_urls_admin_panel_bedehi", "django_urls_admin_panel_bedehikhadamat", "django_urls_admin_panel_bedehinasb"], "relation": "participate_in", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/bedehi.html"}, {"id": "login_form", "label": "Login Form", "nodes": ["admin_panel_templates_admin_panel_login", "django_url_admin_panel_p_login", "django_csrf_token", "form_field_username", "form_field_password"], "relation": "form", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/login.html"}, {"id": "new_store_form", "label": "New Store Form", "nodes": ["admin_panel_templates_admin_panel_storebk1", "django_url_admin_panel_newstore", "django_csrf_token", "form_field_storename"], "relation": "form", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/storeBK1.html"}, {"id": "store_inventory_display", "label": "Store Inventory Display", "nodes": ["admin_panel_templates_admin_panel_storebk1", "template_variable_productsum", "product_property_product_name", "product_property_mojodi"], "relation": "participate_in", "confidence": "EXTRACTED", "source_file": "admin_panel/templates/admin_panel/storeBK1.html"}, {"id": "customer_list_page", "label": "Customer List Page", "nodes": ["admin_panel_templates_admin_panel_entezar_html", "concept_customer_data", "concept_url_admin_panel_customers"], "relation": "form", "confidence": "INFERRED", "confidence_score": 0.8, "source_file": "admin_panel/templates/admin_panel/entezar.html"}, {"id": "customer_interaction_flow", "label": "Customer Lifecycle Management", "nodes": ["admin_panel_templates_admin_panel_customers"], "relation": "participate_in", "confidence": "INFERRED", "confidence_score": 0.85}, {"id": "new_factor_creation_flow", "label": "New Factor Creation Flow", "nodes": ["admin_panel_templates_admin_panel_customernewbackup_html", "admin_panel_urls_newfactor", "concept_client_side_form_logic", "concept_customer", "concept_category"], "relation": "participate_in", "confidence": "INFERRED", "confidence_score": 0.85, "source_file": "admin_panel/templates/admin_panel/customerNewBackup.html"}, {"id": "customer_management_ui_flow", "label": "Customer Management UI Flow", "nodes": ["admin_panel_templates_admin_panel_customersbk_html", "admin_panel_templates_admin_panel_customersbk_html_createcs", "admin_panel_templates_admin_panel_customersbk_html_openrow", "concept_customer_modal_ui"], "relation": "participate_in", "confidence": "INFERRED", "confidence_score": 0.9, "source_file": "admin_panel/templates/admin_panel/customersBK.html"}, {"id": "financial_management_flow", "label": "Financial & Debt Management Flow", "nodes": ["admin_panel_templates_admin_panel_customerSarresid", "admin_panelLine truncated
// afterDrawing passes ctx already transformed to network coordinate space.
// Draw node positions raw — no manual pan/zoom/DPR math needed.
+59440 -14484
View File
File diff suppressed because it is too large. Load diff
+496 -214
View File
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+2 -2
View File
@@ -78,11 +78,11 @@ WSGI_APPLICATION = 'khatibi.wsgi.application'
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'data9/kt.sqlite3',
'NAME': BASE_DIR / 'data9/khatibi92669266_backups_db_backup_20261021_223009.sqlite3',
}
}
#
# Password validation
# https://docs.djangoproject.com/en/3.2/ref/settings/#auth-password-validators
+611
View File
@@ -0,0 +1,611 @@
# تجمیع شماره‌های پیامک مشتریان
## چرا؟
شماره‌های هر مشتری در این پروژه به چند جا پراکنده‌اند: فیلدهای قدیمی
`Customer.phone1` / `phone2` / `phone3` و رکوردهای جدول `PhoneNumber`. بعضی
بدون صفر ابتدایی‌اند (`9133722815`)، بعضی ارقام فارسی/عربی دارند، بعضی با
فاصله/خط‌تیره نوشته شده‌اند و بعضی اصلاً موبایل نیستند (شمارهٔ ثابت، «0»، متن
آزاد).
این دستور همهٔ آن‌ها را می‌خواند، **موبایل‌های معتبر** را استخراج می‌کند و به
شکل یک رشتهٔ یکتا و مرتب در `Customer.sms_primary_phones` می‌ریزد.
> ⚠️ **قبل از `--apply` این بخش را بخوان:** «هشدار معنای داده» پایین.
> رفتار پیش‌فرض دستور **بدون نوشتن** است.
| جزء | مسیر |
|---|---|
| دستور | `admin_panel/management/commands/normalize_customer_sms_phones.py` |
| تست‌ها | `tests/test_sms_phone_normalize.py` |
| فایل وضعیت (checkpoint) | `.sms_normalization_checkpoint.json` در ریشهٔ پروژه |
| مسیر مصرف‌کنندهٔ فیلد | `admin_panel/sms/phones.py` → `admin_panel/sms/recipients.py` |
| قالب‌بندی شماره | `integrations/sms/normalize.py` |
**هیچ migration لازم نیست** — این دستور مدل را تغییر نمی‌دهد و فقط روی یک ستون
موجود می‌نویسد. هیچ پیش‌نیاز دیگری (جدول job، فایل داده، سرویس جانبی) ندارد.
---
## سریع‌ترین مسیر روی Production (اگر همین یک دستور را می‌خواهی)
دستور خودبسنده است: فقط `Customer` را وارد می‌کند و به هیچ migration یا مدل
جدیدی وابسته نیست. پس روی VPS، **تنها همین سه خط** کافی است:
```bash
cd /path/to/khatibi
# ۱) شبیه‌سازی (۳۰ ثانیه، صفر نوشتن) — اعداد را ببین
docker compose exec web python manage.py normalize_customer_sms_phones --dry-run --batch-size 50
# ۲) بکاپ قبل از نوشتن
docker compose exec web python -c "
import sqlite3, pathlib, datetime
src = pathlib.Path('/app/sqlite/db.sqlite3')
dst = src.parent / f'db_backup_{datetime.datetime.now():%Y%m%d_%H%M%S}.sqlite3'
s = sqlite3.connect(f'file:{src}?mode=ro', uri=True, timeout=30); d = sqlite3.connect(dst)
s.backup(d, pages=250, sleep=0.05); d.close(); s.close(); print('backup:', dst)"
# ۳) اجرای واقعی
docker compose exec web python manage.py normalize_customer_sms_phones --apply --batch-size 50
```
سه نکته:
1. **روی VPS `python` میزبان وجود ندارد؛ باید داخل کانتینر بزنی**
(`docker compose exec web …`). `docker compose run --rm web …` هم کار می‌کند
ولی یک کانتینر اضافه بالا می‌آورد.
2. **migrate لازم نیست.** (`migrate` فقط پیش‌نیاز دستور `fix_customer_names`
است، چون آن یکی جدول `CustomerNameFixJob` می‌خواهد.)
3. **`sqlite_db_backup` کار نمی‌کند** مگر `S3_ACCESS_KEY`، `S3_SECRET_KEY`،
`S3_ENDPOINT` و `S3_BUCKET` در محیط تنظیم شده باشند — `production.env` این
پروژه فقط `DJANGO_SETTINGS_MODULE` دارد. پس همان اسنیپت `sqlite3.backup`
بالا (که WAL-safe است) امن‌ترین راه بدون S3 است.
اگر وسط کار قطع شد:
```bash
docker compose exec web python manage.py normalize_customer_sms_phones --apply --resume
```
> تنها شرط تصمیم‌گیری: بخش **«هشدار معنای داده»** پایین. اگر اثر
> افزایشِ گیرندگان پیامک را نمی‌خواهی، مرحلهٔ ۳ را نزن.
---
## ⚠️ هشدار معنای داده (مهم‌ترین نکتهٔ این سند)
`Customer.sms_primary_phones` امروز معنایش «گیرندگان پیامک» است:
`admin_panel/sms/phones.py::primary_phones()` اگر این فیلد خالی باشد، فقط
**شمارهٔ اول** مشتری را برمی‌گرداند؛ و اگر پر باشد، **همهٔ** شماره‌های داخلش را
گیرندهٔ پیامک می‌داند.
وضعیت فعلی دیتابیس توسعه:
| سنجه | مقدار |
|---|---|
| کل مشتریان | 10,426 |
| مشتریانی که الان `sms_primary_phones` دارند | **6** |
| بیشترین طول فعلی مقدار | 27 کاراکتر |
پس اگر `--apply` بزنی، این ستون برای **~10,084 مشتری** پر می‌شود و از آن لحظه:
> **پیامک‌های آیندهٔ هر مشتری به همهٔ شماره‌های معتبرش می‌رود، نه فقط شمارهٔ اول.**
این یک خرابی نیست؛ اثر آگاهانهٔ همان کاری است که خواسته شده. ولی اگر
نمی‌خواهی تعداد ارسال/هزینه بالا برود، **قبل از `--apply` تصمیم بگیر**:
- اگر هدف فقط «یک‌جا کردن شماره‌ها برای بازبینی» است ⇒ همین دستور با `--dry-run`
کافی است و نیازی به `--apply` نیست.
- اگر می‌خواهی برای مشتریِ بدون انتخاب دستی فقط **شمارهٔ اول** ارسال شود، باید
منطق `primary_phones()` تغییر کند (کار جداگانه‌ای است، خارج از این دستور).
نکتهٔ تسکین‌دهنده: به‌محض اینکه اپراتور همان مشتری را از پنل ویرایش کند،
`customerEdit` مقدار را از تیک‌های فرم بازنویسی می‌کند؛ یعنی پنل همیشه منبع
حقیقت نهایی می‌ماند و اجرای دوبارهٔ این دستور آن را خراب نمی‌کند.
---
## چه چیزی تغییر می‌کند و چه چیزی نه
**تنها ستونی که نوشته می‌شود `Customer.sms_primary_phones` است.**
| مورد | وضعیت |
|---|---|
| `phone1`, `phone2`, `phone3` | فقط خوانده می‌شوند — **هرگز ویرایش/پاک نمی‌شوند** |
| ردیف‌های `PhoneNumber` | فقط خوانده می‌شوند — **هیچ رکوردی حذف/ویرایش نمی‌شود** |
| سایر فیلدهای مشتری (نام، آدرس، یادداشت، وضعیت) | دست‌نخورده |
| اسکیمای دیتابیس | دست‌نخورده (بدون migration) |
| مقدار موجودِ غیرخالی، وقتی شمارهٔ معتبری پیدا نشود | **محافظت می‌شود؛ خالی نمی‌شود** |
| مقدار خالی موجود وقتی شمارهٔ معتبر پیدا شود | فقط در این حالت پر می‌شود |
سایر فیلدها با یک تست اختصاصی
(`test_source_fields_and_phone_rows_are_untouched`) قفل شده‌اند.
---
## قواعد اعتبارسنجی و قالب شماره
اعتبارسنجی با تابع مشترک پروژه انجام می‌شود
(`integrations/sms/normalize.py::normalize_mobile`) — هیچ منطق موازی و دومی
نوشته نشده تا با بقیهٔ سیستم یکسان بماند.
| ورودی | معتبر؟ | توضیح |
|---|---|---|
| `09123456789` | ✅ | قالب استاندارد ۱۱رقمی |
| `9123456789` | ✅ | بدون صفر ابتدایی |
| `+989123456789` | ✅ | پیش‌شمارهٔ بین‌المللی |
| `00989123456789` | ✅ | پیش‌شمارهٔ `0098` |
| `989123456789` | ✅ | پیش‌شمارهٔ `98` |
| `۰۹۱۲۳۴۵۶۷۸۹` | ✅ | ارقام فارسی |
| `٠٩١٢٣٤٥٦٧٨٩` | ✅ | ارقام عربی |
| `0912-345-6789`, `(0912) 345 6789` | ✅ | جداکننده‌ها پاک می‌شوند |
| `02112345678`, `031-33445566` | ❌ | شمارهٔ ثابت با پیش‌شماره |
| `57387608` (۸رقمی) | ❌ | شمارهٔ ثابت محلی |
| `12345`, `0`, `اعظمی`, خالی | ❌ | ناقص / متن آزاد |
### قالبِ ذخیره‌شده: `+989xxxxxxxxx`
اینجا یک نکتهٔ ظریف و مهم است:
- **اعتبارسنجی** بر پایهٔ استاندارد ۱۱رقمی `09xxxxxxxxx` انجام می‌شود (همان
چیزی که در صورت مسئله آمده)،
- ولی **مقدار ذخیره‌شده** `+989xxxxxxxxx` است.
علت، کد موجود پروژه است: `admin_panel/sms/phones.py::stored_primary_normalized`
مقدار ذخیره‌شده را با `normalize_mobile()` (یعنی `+989…`) تطبیق می‌دهد. اگر
`09…` ذخیره شود:
1. ستارهٔ «★ اصلی» در صفحهٔ مشتری برای هیچ شماره‌ای روشن نمی‌شود
(`is_primary` همیشه False)،
2. `resolved_recipients()` بی‌اثر می‌شود و به شمارهٔ اول برمی‌گردد
(یعنی کل تجمیع می‌شود دادهٔ مرده)،
3. تست‌های موجود که روی `+989120009999` قفل‌اند می‌شکنند
(`tests/test_customers.py:143`، `tests/test_sms.py:1170`).
یک تست اختصاصی همین را قفل می‌کند:
`test_panel_resolution_reads_back_aggregated_numbers` بررسی می‌کند که خروجی
دستور با `resolve_recipients()` خوانده می‌شود.
---
## الگوریتم (برای هر مشتری)
**ترتیب اولویت منابع** (برای حذف تکراری‌ها؛ اولین‌بار که یک شماره دیده شود،
جایگاهش همان می‌ماند):
```
phone1 → phone2 → phone3 → رکوردهای PhoneNumber بر اساس id صعودی
```
**برای هر مقدار:**
1. مقدار خالی/`None` ⇒ نادیده (شمارش نمی‌شود).
2. تبدیل به موبایل معتبر (`normalize_mobile`) ؛ نامعتبر ⇒ کنار گذاشته و در
گزارش شمرده می‌شود (ثابت یا نامعتبر).
3. موبایل تکراری ⇒ حذف می‌شود (با حفظ جایگاه اولیه) و در گزارش شمرده می‌شود.
4. موبایل‌های یکتا با `,` و **بدون فاصله** به هم می‌چسبند:
`+989120000001,+989120000002`
5. اگر طول رشته > `max_length` (۱۰۰ کاراکتر، از خود مدل خوانده می‌شود) ⇒
**هیچ truncate‌ای انجام نمی‌شود**؛ رکورد دست‌نخورده می‌ماند و شناسه‌اش در
گزارش سرریز می‌آید.
6. اگر نتیجه خالی بود ولی مشتری از قبل مقداری داشت ⇒ مقدار قبلی **پاک نمی‌شود**
و در شمارندهٔ «محافظت شد» گزارش می‌شود.
7. اگر نتیجه با مقدار فعلی مو‌به‌مو برابر بود ⇒ **هیچ نوشتنی انجام نمی‌شود**.
### نمونه‌ها
| وضعیت مشتری | نتیجهٔ ذخیره‌شده |
|---|---|
| `phone1=09120000001`, `phone2=09120000002` | `+989120000001,+989120000002` |
| `phone1=09120000001`, `phone2=989120000001` | `+989120000001` (تکراری حذف) |
| `phone1=۰۹۱۲۰۰۰۰۰۰۱` | `+989120000001` |
| `phone1=09120000001`, `phone2=02112345678` | `+989120000001` (ثابت فیلتر شد) |
| `phone1=09120000001`, `PhoneNumber=09120000002` | `+989120000001,+989120000002` |
| ۱۰ شمارهٔ معتبر (۱۳۹ کاراکتر) | **دست‌نخورده** + ثبت در سرریز |
| ۷ شمارهٔ معتبر (۹۷ کاراکتر) | ذخیره می‌شود (زیر سقف) |
| `phone1=''` و `PhoneNumber` خالی، مقدار قبلی `+98912…` | دست‌نخورده (محافظت) |
---
## گزینه‌ها
| گزینه | پیش‌فرض | کار |
|---|---|---|
| `--batch-size` | `100` | تعداد مشتری در هر batch (تراکنش اتمیک) |
| `--dry-run` | خاموش (اما **رفتار پیش‌فرض همین است**) | گزارش بدون هیچ نوشتنی؛ همراه `--apply` خطا می‌دهد |
| `--apply` | خاموش | نوشتن واقعی در دیتابیس + نوشتن فایل وضعیت |
| `--resume` | خاموش | ادامه از `last_id` داخل فایل وضعیت |
| `--start-id N` | — | شروع دستی از مشتریان `id > N`؛ **بر `--resume` اولویت دارد** |
| `--reset-checkpoint` | خاموش | پاک‌کردن فایل وضعیت (در `--dry-run` نادیده گرفته می‌شود) |
| `--checkpoint PATH` | `.sms_normalization_checkpoint.json` در ریشهٔ پروژه | مسیر فایل وضعیت |
---
## اجرای محلی (توسعه)
### ۱) شبیه‌سازی — همیشه قدم اول
از WSL:
```bash
cd /mnt/d/projects/khatibi
.venv/Scripts/python.exe manage.py normalize_customer_sms_phones --dry-run
```
از Windows (PowerShell / CMD):
```bat
cd D:\projects\khatibi
.venv\Scripts\python.exe manage.py normalize_customer_sms_phones --dry-run
```
خروجی نمونهٔ واقعی روی دیتابیس توسعه (۱۰٬۴۲۶ مشتری، `--batch-size 100`):
```
حالت: شبیه‌سازی (dry-run) | batch=100 | فایل وضعیت: D:\Projects\khatibi\.sms_normalization_checkpoint.json
شروع از مشتریان با id > 0 (ابتدا)
batch 1: last_id=... | بررسی‌شده=100 | قابل‌به‌روزرسانی=... | سرریز=0
...
batch 105: last_id=11427 | بررسی‌شده=10426 | قابل‌به‌روزرسانی=10084 | سرریز=0
گزارش شبیه‌سازی (dry-run) — هیچ تغییری ذخیره نشد
مشتریان بررسی‌شده: 10426
مشتریان قابل‌به‌روزرسانی: 10084
بدون تغییر: 4
شماره‌های فیلترشده: ثابت=4864 | نامعتبر=0 | جمع=4864
شماره‌های تکراری حذف‌شده: 13
سرریز طول (>100 کاراکتر، دست‌نخورده): 0
batchهای تکمیل‌شده: 105
آخرین شناسهٔ پردازش‌شده: 11427
برای اجرای واقعی: --apply (و در صورت توقف قبلی: --apply --resume)
```
در `--dry-run`: نه دیتابیس نوشته می‌شود و نه فایل وضعیت ساخته می‌شود. (چک‌شده:
SHA-256 دیتابیس پیش و پس یکسان است و `.sms_normalization_checkpoint.json` وجود
ندارد.)
### ۲) تنظیم سرعت batch
```bash
# پیش‌فرض: ۱۰۰ مشتری در هر تراکنش
.venv/Scripts/python.exe manage.py normalize_customer_sms_phones --dry-run
# ساعات پرترافیک سرور: batch کوچک‌تر ⇒ تراکنش کوتاه‌تر
.venv/Scripts/python.exe manage.py normalize_customer_sms_phones --dry-run --batch-size 50
# اجرای سریع‌تر روی سرور خلوت
.venv/Scripts/python.exe manage.py normalize_customer_sms_phones --dry-run --batch-size 500
```
### ۳) اجرای واقعی
```bash
.venv/Scripts/python.exe manage.py normalize_customer_sms_phones --apply
```
قبلش یک‌بار دیگر «هشدار معنای داده» را بخوان.
---
## اجرا روی سرور Production
### ترتیب دقیق
```bash
# ۰) فایل‌ها روی سرور (بدون migration جدید — این دستور اسکیما را عوض نمی‌کند)
# فقط کد به‌روز شود؛ entrypoint/docker-compose خودشان migrate می‌کنند.
# ۱) بکاپ دیتابیس — بخش «بکاپ» در fix_customer_names.md
docker compose exec web python manage.py sqlite_db_backup
# یا اگر S3 در دسترس نیست، اسنیپت WAL-safe در همان سند آمده است.
# ۲) تأیید مقصد دیتابیس (بدون افشای credential)
docker compose exec web python -c "
import django, os; django.setup()
from django.conf import settings as s
print('settings:', os.environ.get('DJANGO_SETTINGS_MODULE'))
print('DB:', s.DATABASES['default']['ENGINE'], s.DATABASES['default']['NAME'])"
# ۳) شبیه‌سازی روی دیتابیس واقعی — هیچ نوشتنی ندارد
docker compose exec web python manage.py normalize_customer_sms_phones --dry-run --batch-size 50
# ۴) اگر اعداد منطقی بود (و اثر پیامکی را پذیرفتی): اجرای واقعی
docker compose exec web python manage.py normalize_customer_sms_phones --apply --batch-size 50
# ۵) بررسی خلاصه و صحت
docker compose exec web python -c "
import django; django.setup()
from admin_panel.models import Customer
print('دارای شماره:', Customer.objects.exclude(sms_primary_phones='').count())"
```
### نکته‌ها برای Production
- دستور از **تنظیمات فعال Django** می‌خواند (`DJANGO_SETTINGS_MODULE`)، نه از
مسیر هاردکدشده. روی سرور `khatibi.production_settings` و
`NAME=/app/sqlite/db.sqlite3` (ولوم `khatibi-sqlite-db`) است.
- در ساعات کم‌ترافیک اجرا کن. SQLite در هر لحظه یک نویسنده دارد؛ اگر web و
worker هم‌زمان بنویسند، `busy_timeout=30000` (در `admin_panel/signals.py`) و
اندازهٔ batch کوچک باعث می‌شود کند شود، ولی **سایت متوقف نمی‌شود**.
- هیچ migration جدیدی لازم نیست و دستور هیچ migration ای اجرا نمی‌کند.
---
## توقف و ادامه (Resume / Checkpoint)
### فایل وضعیت
پیش‌فرض: `.sms_normalization_checkpoint.json` در ریشهٔ پروژه، با این ساختار:
```json
{
"last_id": 11427,
"batch_size": 100,
"applied": true,
"scanned": 10426,
"updated": 10084,
"overflow": 0,
"batches": 105
}
```
- نام فایل با یک نقطه شروع می‌شود، پس در پوشهٔ پروژه پنهان است
(`ls -a` ببینش).
- اگر آن را در ریشه نمی‌خواهی (مثلاً ریشهٔ پروژه read-only است)، با
`--checkpoint` مسیر دلخواه بده — مثلاً کنار خود دیتابیس:
`--checkpoint /app/sqlite/.sms_norm.json`.
- **نوشتن فایل اتمیک است** (`tmp` + `os.replace`)؛ قطع برق وسط نوشتن، فایلِ
نیمه‌ساخته باقی نمی‌گذارد.
- در `--dry-run` این فایل **هرگز** ساخته یا تغییر داده نمی‌شود.
### اتمیک بودن
هر batch این‌ها را در یک تراکنش انجام می‌دهد: نوشتن `sms_primary_phones`
مشتریان همان batch. و فایل وضعیت **فقط پس از commit موفق** نوشته می‌شود.
نتیجهٔ قطعی وسط کار:
- batch در حال اجرا ⇒ rollback می‌شود و checkpoint همان batch **جلو نمی‌رود**.
- batchهای قبلی ⇒ commit شده و باقی می‌مانند.
- اجرای بعدی ⇒ از `last_id` ادامه می‌دهد، بدون جابه‌جایی رکورد و بدون پرش.
اگر قطعی در فاصلهٔ «commit» تا «نوشتن فایل وضعیت» رخ دهد، همان batch دوباره
پردازش می‌شود. این تراکنش **بی‌خطر است** (idempotent): مقدار یکسان ⇒ هیچ
نوشتنی. پس نه داده خراب می‌شود و نه رکوردی جا می‌ماند.
### گزینه‌های ادامه
```bash
# ادامهٔ خودکار از فایل وضعیت
python manage.py normalize_customer_sms_phones --apply --resume
# شروع دستی از یک شناسه (بر --resume اولویت دارد)
python manage.py normalize_customer_sms_phones --apply --start-id 5000
# شروع از صفر (پاک‌کردن فایل وضعیت)
python manage.py normalize_customer_sms_phones --apply --reset-checkpoint
```
### سلسله‌مراتب تصمیم نقطهٔ شروع
```
--start-id > --resume > 0 (از ابتدا)
```
بدون هیچ گزینه‌ای، اجرای جدید از ابتدای جدول شروع می‌شود ولی چون مقدارهای
قبلاً نوشته‌شده مو‌به‌مو برابرند، **دوباره نوشته نمی‌شوند** (idempotent).
یعنی اجرای دوبارهٔ ناخواسته خطرناک نیست، فقط بی‌دلیل جدول را می‌خواند.
---
## تعریف کلیدهای گزارش
| کلید | معنا |
|---|---|
| مشتریان بررسی‌شده | تعداد مشتریانی که در این اجرا از دیتابیس خوانده شدند |
| مشتریان به‌روزشده / قابل‌به‌روزرسانی | در `--apply` تعداد رکوردهایی که واقعاً نوشته شدند؛ در dry-run تعداد رکوردهایی که نوشته **می‌شدند** |
| بدون تغییر | مقدار محاسبه‌شده مو‌به‌مو با مقدار فعلی برابر بود ⇒ هیچ نوشتنی |
| شماره‌های فیلترشده: ثابت | شماره‌های ثابت (پیش‌شماره‌دار یا ۸رقمی مثل `57387608`) |
| شماره‌های فیلترشده: نامعتبر | ناقص، `0`، متن آزاد |
| شماره‌های تکراری حذف‌شده | موبایل‌های معتبری که قبلاً در همان مشتری دیده شده بودند |
| سرریز طول | مشتریانی که رشتهٔ نهایی‌شان > ۱۰۰ کاراکتر می‌شد ⇒ دست‌نخورده + شناسه‌ها چاپ می‌شود |
| مقدار موجودِ غیرخالی که محافظت شد | مشتریانی که شمارهٔ معتبر نداشتند ولی مقدار قبلی‌شان پاک **نشد** (فقط اگر > ۰ باشد چاپ می‌شود) |
| batchهای تکمیل‌شده | تعداد تراکنش‌های commit‌شده |
| آخرین شناسهٔ پردازش‌شده | `last_id` نهایی؛ در `--apply` همان مقدار داخل فایل وضعیت |
---
## عملکرد و بار روی دیتابیس
- **Keyset pagination**: `filter(id__gt=last_id).order_by('id')[:batch_size]` —
نه offset، نه شمارهٔ ردیف. پس افزودن/حذف مشتری وسط کار باعث پرش یا تکرار
نمی‌شود و ترتیب پردازش پایدار است.
- **جلوگیری از N+1**: `prefetch_related('phones')` ⇒ **۳ کوئری ثابت در هر
batch**، مستقل از تعداد مشتریان و تعداد شماره‌ها. یک تست با
`assertNumQueries(3)` این را قفل کرده است.
- **حداقل حافظه**: `only('id', 'phone1', 'phone2', 'phone3',
'sms_primary_phones')` — بقیهٔ ستون‌های سنگین (یادداشت، آدرس) خوانده نمی‌شوند
و batchها کوچک‌اند.
- **هیچ نوشتن غیرضروری**: `bulk_update([...], ['sms_primary_phones'])` فقط برای
رکوردهای تغییریافته و فقط همان یک ستون. `save()` کامل صدا زده نمی‌شود، پس
فیلدهای `auto_now_add` مثل `create_date` لمس نمی‌شوند.
زمانبندی تقریبی: ۱۰٬۴۲۶ مشتری با `--batch-size 100` = ۱۰۵ تراکنش کوچک؛ در
محیط توسعه چند ثانیه.
---
## خطاها و اقدام درست
| پیام | معنا | اقدام |
|---|---|---|
| `unsupported operand`/متن خطای غیرمنتظره | خطا وسط batch | batch جاری rollback شد؛ با `--apply --resume` ادامه بده |
| `--resume داده شد ولی فایل وضعیت وجود ندارد: …` | فایل پاک شده یا مسیر `--checkpoint` عوض شده | یا بدون `--resume` اجرا کن، یا مسیر درست را با `--checkpoint` بده |
| `فایل وضعیت معتبر نیست (last_id=…)` | فایل دست‌کاری/خراب شده | `--reset-checkpoint` یا فایل را پاک کن |
| `فایل وضعیت خوانده نشد (…): …` | JSON خراب یا دسترسی فایل | همان بالا |
| `فایل وضعیت پاک نشد (…)` | دسترسی نوشتن ندارد | مسیر `--checkpoint` را به جایی قابل‌نوشتن تغییر بده |
| `--dry-run و --apply با هم ناسازگارند.` | هر دو فلگ داده شده | فقط یکی را بده |
| `KeyboardInterrupt` / پیام «متوقف شد (Ctrl+C)» | توقف دستی | آخرین شناسهٔ معتبر چاپ می‌شود؛ `--apply --resume` |
هیچ‌کدام از این خطاها باعث truncate، پاک‌شدن مقدار قبلی یا نیمه‌کاره ماندن یک
batch نمی‌شود.
---
## بررسی صحت داده (SQL)
روی دیتابیس، بدون اجرای دستور (فقط برای سنجش). دیتابیس را با `mode=ro` باز کن
تا هیچ‌چیز تغییر نکند:
```bash
.venv/Scripts/python.exe - <<'PY'
import sqlite3
con = sqlite3.connect('file:data9/kt.sqlite3?mode=ro', uri=True)
q = lambda s: con.execute(s).fetchone()[0]
print('کل مشتریان:', q('select count(*) from admin_panel_customer'))
print('دارای مقدار:', q("select count(*) from admin_panel_customer where trim(coalesce(sms_primary_phones,''))<>''"))
print('چند شماره‌ای:', q("select count(*) from admin_panel_customer where sms_primary_phones like '%,%'"))
print('قالب محلی (09…):', q("select count(*) from admin_panel_customer where sms_primary_phones like '09%'"))
print('قالب متعارف (+98…):', q("select count(*) from admin_panel_customer where sms_primary_phones like '+98%'"))
print('بیشترین طول:', q("select max(length(sms_primary_phones)) from admin_panel_customer"))
con.close()
PY
```
`قالب محلی (09…)` باید همیشه `0` بماند — اگر عددی غیر از صفر دیدی، یعنی جایی
خارج از قواعد این دستور نوشته شده است.
بررسی پس از اجرای واقعی (برای دو نمونهٔ مشخص، پیش و پس):
```bash
docker compose exec web python -c "
import django; django.setup()
from admin_panel.models import Customer
for c in Customer.objects.exclude(sms_primary_phones='').order_by('-id')[:5]:
print(c.id, '|', c.phone1, c.phone2, c.phone3, '->', c.sms_primary_phones)"
```
---
## بازگردانی (اگر نتیجه را نخواستی)
دستور Undo ندارد. بازگردانی از بکاپ:
```bash
docker compose stop web worker scheduler delivery
docker run --rm -v khatibi-sqlite-db:/data -v "$(pwd)":/backup alpine sh -c \
"cp /backup/db_backup_YYYYmmdd_HHMMSS.sqlite3 /data/db.sqlite3 \
&& rm -f /data/db.sqlite3-wal /data/db.sqlite3-shm"
docker compose start migrate web worker scheduler delivery
```
اگر فقط می‌خواهی ستون برای همه خالی شود (بدون بازگردانی کل بکاپ) — **این کار
تعداد گیرندگان پیامک را به حالت قبل برمی‌گرداند (فقط شمارهٔ اول)** و انتخاب‌های
دستی اپراتور را هم پاک می‌کند. عمداً هیچ دستوری برای انجام خودکارش نوشته نشده؛
با آگاهی و دستی در `shell` انجام بده:
```bash
# ⚠️ تنها در صورت تصمیم آگاهانه
python manage.py shell -c "
from admin_panel.models import Customer
print(Customer.objects.exclude(sms_primary_phones='').update(sms_primary_phones=''))"
```
---
## تست‌ها
```bash
.venv/Scripts/python.exe manage.py test tests.test_sms_phone_normalize # ۲۷ تست
.venv/Scripts/python.exe manage.py test tests # کل مجموعه
```
پوشش تست‌ها:
- **قالب‌ها**: `+98`، `0098`، `98`، `9…`، `09…`، ارقام فارسی، ارقام عربی،
جداکننده‌ها.
- **اعتبارسنجی**: شمارهٔ ثابت پیش‌شماره‌دار، ثابت ۸رقمی، `0`، متن آزاد، خالی.
- **ترتیب و تکراری**: اولویت `phone1→phone2→phone3→PhoneNumber.id` و حذف
تکراری با حفظ جایگاه.
- **ایمنی داده**: فیلدهای مبدأ و ردیف‌های `PhoneNumber` و سایر فیلدهای مشتری
دست‌نخورده؛ رکورد بدون تغییر هیچ نوشتنی ندارد؛ مقدار موجودِ غیرخالی با
نتیجهٔ خالی پاک نمی‌شود.
- **سرریز**: ۱۳۹ کاراکتر ⇒ دست‌نخورده + شناسه در گزارش؛ ۹۷ کاراکتر ⇒ ذخیره.
- **batch و checkpoint**: پوشش کامل با batch کوچک، نوشتن فایل پس از هر batch،
`resume`، `--start-id`، `--reset-checkpoint`، `resume` بدون فایل ⇒ خطا، فایل
خراب ⇒ خطا.
- **اتمیک بودن واقعی**: batch دوم با خطا می‌شکند ⇒ batch اول commit می‌ماند،
batch دوم rollback می‌شود، checkpoint جلو نمی‌رود، و `--resume` بعدی کار را
تمام می‌کند.
- **کارایی**: `assertNumQueries(3)` برای هر batch.
- **سازگاری با پنل**: خروجی دستور با `resolve_recipients()` خوانده می‌شود.
تست‌ها روی دیتابیس تستی Django (SQLite درون‌حافظه) اجرا می‌شوند؛ نه به
`data9/kt.sqlite3` دست می‌زنند و نه فایل وضعیت ریشهٔ پروژه را می‌سازند.
---
## نکته‌ها و محدودیت‌ها
- **قفل اجرای هم‌زمان ندارد.** دو `--apply` موازی می‌توانند درهم بیامیزند
(فایل وضعیت: آخرین نویسنده برنده). برای دستور دستی اپراتور پذیرفتنی است؛ ولی
دو نسخه را هم‌زمان روی یک دیتابیس اجرا نکن. برای اطمینان:
```bash
# مطمئن شو نمونهٔ دیگری در حال اجرا نیست
ps aux | grep -c '[n]ormalize_customer_sms_phones'
```
- **اثر روی پیامک** — بند اول همین سند را ببین؛ مهم‌ترین نکتهٔ تصمیم‌گیری.
- **شماره‌های ثابت/نامعتبر از فیلدهای مبدأ حذف نمی‌شوند.** فقط از تجمیع بیرون
می‌مانند. تمیزکاری فیلدهای مبدأ کار دستور جداگانهٔ `fix_customer_phones` است.
- **`sms_primary_phones` یک `CharField(max_length=100)` است.** با ~۸ شمارهٔ
موبایل پر می‌شود. برای مشتریی با شماره‌های بیشتر، دستور عمداً هیچ‌کاری
نمی‌کند (سرریز) تا داده را نصفه نریزد. اگر مشتری زیاد سرریز داشت (در گزارش
می‌بینی)، افزایش `max_length` نیازمند migration جداگانه است.
- **معنای «اصلی» تغییر می‌کند.** اگر فرض قبلی سیستم این بود که این فیلد فقط
انتخاب دستیِ مدیر را نگه دارد، از این پس همهٔ شماره‌های معتبر را نگه می‌دارد.
- **`--reset-checkpoint` در `--dry-run` عمداً نادیده گرفته می‌شود** تا شبیه‌سازی
هیچ اثری روی وضعیت اجراهای واقعی نگذارد.
- **بازگشت‌پذیری**: با `--apply` آمار داخل فایل وضعیت ذخیره می‌شود، ولی تاریخچهٔ
per-customer نگه داشته نمی‌شود (ستون زمان/audit ندارد). برای برگشت، بکاپ لازم
است.
- کنسول ویندوز: متن فارسی در خروجی ممکن است `charmap` خطا بدهد؛ مثل بقیهٔ
سرویس‌های پروژه از `python -X utf8 manage.py …` استفاده کن.
- فایل‌های `-wal` و `-shm` دیتابیس جزء دیتابیس‌اند؛ در بکاپ دستی هر سه را در
لحظهٔ بدون نوشتن کپی کن (یا از `sqlite3.Connection.backup` استفاده کن).
---
## چک‌لیست سریع
```bash
# ── توسعه ────────────────────────────────────────────────────────────────
cd /mnt/d/projects/khatibi
.venv/Scripts/python.exe manage.py test tests.test_sms_phone_normalize
.venv/Scripts/python.exe manage.py normalize_customer_sms_phones --dry-run
# ── Production ───────────────────────────────────────────────────────────
docker compose exec web python manage.py sqlite_db_backup # ۱) بکاپ
docker compose exec web python manage.py normalize_customer_sms_phones --dry-run --batch-size 50
docker compose exec web python manage.py normalize_customer_sms_phones --apply --batch-size 50
# ── پس از توقف ناخواسته ─────────────────────────────────────────────────
docker compose exec web python manage.py normalize_customer_sms_phones --apply --resume
# ── شروع از صفر (با احتیاط) ─────────────────────────────────────────────
docker compose exec web python manage.py normalize_customer_sms_phones --apply --reset-checkpoint
```
سه تصمیم قبل از `--apply`:
1. اثر پیامکی (ارسال به همهٔ شماره‌ها به‌جای شمارهٔ اول) را می‌پذیری؟
2. بکاپ گرفته‌ای و از سالم بودنش مطمئنی؟
3. اعداد `--dry-run` را دیده‌ای (خصوصاً `سرریز طول` و `مقدار موجودِ محافظت‌شده`)؟
+138
View File
@@ -0,0 +1,138 @@
# بازمحاسبهٔ «آخرین بازدید» مشتریان
## چرا؟
فیلد `Customer.last_bazdid_dt` یعنی «آخرین بازدیدی که برای مشتری انجام شده» و صفحهٔ
`/panel/entezar/` بر پایهٔ آن مشتریانِ **معوق** (بیش از N ماه بازدید نشده) را لیست
می‌کند.
قاعدهٔ درست (منبع حقیقت): این مقدار باید برابر **بزرگ‌ترین `finishDateTime` میان
اقدام‌های `actionType='bazdid'` و `status='finish'` همان مشتری** باشد — دقیقاً همان
چیزی که ویوهای `customerNewAction` و `customerEditAction` می‌نویسند:
```python
if newAction.status == 'finish' and newAction.actionType == 'bazdid':
customer_obj.last_bazdid_dt = newAction.finishDateTime
customer_obj.save()
```
پس اگر رکوردی از راهی **غیر از این ویوها** وارد شود (اسکریپت، ایمپورت، ویرایش دستی
دیتابیس، اجرای دستی `gt_esh` و…)، این فیلد عقب می‌ماند و مشتریِ واقعاً
بازدیدشده، اشتباهاً «معوق» شمرده می‌شود. این دستور آن واگرایی (drift) را از روی
جدول `Action` ترمیم می‌کند.
> دستور **idempotent** است؛ اجرای دوباره‌اش هیچ تغییری ایجاد نمی‌کند.
## دستور
نام دستور منیج‌منت: `recalc_last_bazdid`
مسیر فایل: `admin_panel/management/commands/recalc_last_bazdid.py`
### ۱) اول «شبیه‌سازی» — بدون هیچ تغییری
فقط گزارش می‌دهد چه چیزی تغییر می‌کند. **قبل از هر اجرای واقعی این را بزنید.**
از WSL:
```bash
.venv/Scripts/python.exe manage.py recalc_last_bazdid --dry-run
```
از Windows:
```powershell
.venv\Scripts\python.exe manage.py recalc_last_bazdid --dry-run
```
### ۲) اجرای واقعی
```bash
.venv/Scripts/python.exe manage.py recalc_last_bazdid
```
## گزینه‌ها
| گزینه | پیش‌فرض | کار |
|---|---|---|
| `--dry-run` | خاموش | فقط گزارش؛ **هیچ رکوردی ذخیره نمی‌شود**. اول این را بزنید. |
| `--clear-orphans` | خاموش | مشتریانی که مقدار دارند ولی **هیچ اقدام بازدیدِ تمام‌شده‌ای** پشتشان نیست را هم `NULL` می‌کند. به‌طور پیش‌فرض دست‌نخورده می‌مانند. فقط اگر مطمئنید این ستون آلوده است. |
| `--batch-size` | `500` | اندازهٔ دستهٔ خواندن مشتریان در هر گام. |
## دقیقاً چه می‌کند؟
برای هر مشتری، `MAX(finishDateTime)` اقدام‌های بازدیدِ تمام‌شده محاسبه می‌شود، سپس:
| وضعیت مشتری | اقدام دستور |
|---|---|
| بازدید دارد و مقدار فعلی **برابر** MAX است | دست نمی‌زند (`از قبل درست`) |
| بازدید دارد و مقدار فعلی **کوچک‌تر یا NULL** است | به MAX **به‌روز** می‌کند — از لیست معوق‌ها خارج می‌شود (`جدیدتر شد`) |
| بازدید دارد و مقدار فعلی **بزرگ‌تر از MAX** است | به MAX **عقب** می‌برد (`عقب‌تر شد`) |
| بازدید ندارد و مقدار `NULL` است | کاری ندارد (طبیعی) |
| بازدید ندارد ولی مقداری دارد | **دست نمی‌زند** — مگر `--clear-orphans` بدهید (`خالی شد`) |
نوشتن با `Customer.objects.filter(pk=…).update(last_bazdid_dt=…)` داخل یک
`transaction.atomic()` انجام می‌شود؛ یعنی **فقط همین یک ستون** لمس می‌شود و هیچ
`save()` کاملی که فیلدهای دیگر (`auto_now` و…) را تغییر دهد اجرا نمی‌شود.
## نمونهٔ خروجی
```
بازمحاسبهٔ آخرین بازدید مشتریان آغاز شد.
گزارش بازمحاسبهٔ آخرین بازدید:
بررسی‌شده (کل مشتریان): 10,426
دارای بازدیدِ تمام‌شده: 9,151
از قبل درست: 9,084
نیازمند اصلاح: 67
→ جدیدتر شد (خروج از معوق): 67
→ عقب‌تر شد: 0
بدون اقدام ولی دارای مقدار (دست‌نخورده): 0
NULL و بدون اقدام (طبیعی): 1,275
انجام شد: 67 رکورد به‌روزرسانی شد.
```
## اجرا روی production
**اول از دیتابیس بکاپ بگیرید**، سپس:
```bash
python manage.py recalc_last_bazdid --dry-run
python manage.py recalc_last_bazdid
```
دستور تراکنشی است و در صورت خطا، هیچ تغییری کامیت نمی‌شود.
## بررسی صحت داده (SQL، پیش از اجرا)
اگر می‌خواهید بدون دستور، وضعیت را بسنجید:
```sql
-- مشتریانی که مقدارشان با آخرین بازدید واقعی اختلاف دارد (تعداد «نیازمند اصلاح»)
SELECT COUNT(*) FROM admin_panel_customer cu
JOIN (SELECT customer_id, MAX(finishDateTime) mx FROM admin_panel_action
WHERE actionType='bazdid' AND status='finish' GROUP BY customer_id) a
ON a.customer_id = cu.id
WHERE cu.last_bazdid_dt IS NULL OR cu.last_bazdid_dt <> a.mx;
-- مشتریانی که بازدید تمام‌شده دارند ولی مقدارشان NULL است (بدترین حالت)
SELECT COUNT(*) FROM admin_panel_customer cu
WHERE cu.last_bazdid_dt IS NULL
AND EXISTS (SELECT 1 FROM admin_panel_action a
WHERE a.customer_id=cu.id AND a.actionType='bazdid' AND a.status='finish');
-- تعداد سالم (مقدار دارد)
SELECT COUNT(*) FROM admin_panel_customer WHERE last_bazdid_dt IS NOT NULL;
```
## نکته‌های مهم
- مقادیر `NULL` مشتریانی که **هرگز** بازدید تمام‌شده نداشته‌اند، **طبیعی** است و
دستور آن‌ها را پر نمی‌کند (اگر پر کند، یعنی داده ساختن — که غلط است).
- دستور **هیچ فاکتور، سند، اقدام یا مشتری نمی‌سازد و حذف نمی‌کند**؛ فقط یک ستون را
هم‌راستا می‌کند.
- صفحهٔ `/panel/entezar/` یک کش در `CacheTable(key='9mahbazdid')` نگه می‌دارد؛ عددِ
روی صفحه ممکن است یک اجرا عقب باشد. هر بار باز شدن صفحه آن را به‌روز می‌کند.
- منبع حقیقت همیشه جدول `Action` است، نه این ستون. در صورت شک، همان کوئری‌های بخش
«بررسی صحت داده» ملاک هستند.
```
+225
View File
@@ -0,0 +1,225 @@
#!/usr/bin/env python
"""شبیه‌سازیِ «تعویقِ کوتاه‌تر از تاریخ انجامِ هماهنگی» روی دیتابیس واقعی (کپی).
سناریوی گزارش‌شده: در فرم «ایجاد وظیفه» نوع = هماهنگی،
«تاریخ و ساعتی که کار باید انجام شود» = ۱۴۰۵/۰۸/۰۵ و
«تا تاریخ پیگیری نشود» = ۱۴۰۵/۰۸/۰۳ (یعنی قرار **قبل‌تر** از تاریخ کار).
این اسکریپت روی یک **کپی موقت** از دیتابیس، یک مشتری آزمایشی می‌سازد و رفتار
سیستم را روز‌به‌روز چاپ می‌کند: منابع قرار، فهرست «نیازمند پیگیری»، «عقب‌افتاده»،
و اینکه اسکنر پیامک در هر روز چه می‌کند. دیتابیس اصلی دست‌نخورده می‌ماند.
اجرا::
.venv/Scripts/python.exe scripts/coordination_hold_order_probe.py
.venv/Scripts/python.exe scripts/coordination_hold_order_probe.py --customer 5124
"""
import argparse
import datetime
import os
import shutil
import sys
import tempfile
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if BASE_DIR not in sys.path:
sys.path.insert(0, BASE_DIR)
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'khatibi.settings')
def _copy_db(source_path, target_dir):
target = os.path.join(target_dir, 'probe.sqlite3')
shutil.copy2(source_path, target)
for suffix in ('-wal', '-shm'):
side = source_path + suffix
if os.path.exists(side):
shutil.copy2(side, target + suffix)
return target
def _day(offset):
return datetime.datetime.combine(
datetime.date.today() + datetime.timedelta(days=offset), datetime.time(12, 0),
)
def run_variant(label, *, done, hold_offset, action_offset):
"""یک سناریو را می‌سازد و رفتار روز‌به‌روز را چاپ می‌کند."""
from django.utils import timezone
from admin_panel.models import (Action, Customer, PhoneNumber, SMSProviderConfig,
SMSQueue)
from admin_panel.sms.scanner import scan_visit
from admin_panel.visit_policy import (appointment_sources_map, end_of_local_day,
followups_on_date, last_visit_map,
manual_holds_map, next_appointment_map,
overdue_followups, set_visit_hold)
tz = timezone.get_current_timezone()
now = timezone.now()
today = now.astimezone(tz).date()
customer = Customer.objects.create(
name_family='مشتری آزمایشی — %s' % label, address='آزمایش',
)
Customer.objects.filter(pk=customer.pk).update(
installDate=today - datetime.timedelta(days=400))
PhoneNumber.objects.create(customer=customer, phone_number='09120000777')
customer.refresh_from_db()
action_dt = timezone.make_aware(_day(action_offset))
hold_raw = timezone.make_aware(_day(hold_offset)) if hold_offset is not None else None
action = Action.objects.create(
customer=customer, actionType=Action.ActionType.HAMAHANGI,
status=Action.Status.FINISH if done else Action.Status.WAITE,
actionDateTime=action_dt,
finishDateTime=now if done else None,
desc='probe', result='probe' if done else None,
)
# همان مسیری که ویو طی می‌کند (شامل پیش‌فرض ۱۴ روز و «فقط رو به جلو»).
from admin_panel.views.actions import _apply_visit_hold
_apply_visit_hold(
customer,
{'actionType': 'hamahangi', 'holdRaw': hold_raw, 'status': action.status},
status=action.status, is_new=True,
)
customer.refresh_from_db()
config = SMSProviderConfig.load()
config.scan_since = now - datetime.timedelta(days=600)
config.allow_backlog = True
config.backlog_max = 50
config.max_per_run = 200
config.save()
print('\n' + '=' * 100)
print('سناریو %s' % label)
print(' تیک «انجام شد»: %s → status=%s' % ('خورده' if done else 'نخورده', action.status))
print(' تاریخ کار (actionDateTime): %s' % action.actionDateTime.astimezone(tz))
print(' تا تاریخ پیگیری نشود: %s' % (
customer.visit_hold_until.astimezone(tz) if customer.visit_hold_until
else 'خالی (هیچ تعویقی ثبت نشد)'))
# اثرهای جانبی «تیک انجام شد»: لیست وظایف، شمارندهٔ داشبورد، نظرسنجی.
print(' در «لیست وظایف باز» (ActionList/داشبورد): %s' % (
'بله' if action.status == Action.Status.WAITE else 'خیر'))
survey = (action.status == Action.Status.FINISH
and action.actionType != 'vosol'
and action.nazarDT is None
and action.createdDT >= now - datetime.timedelta(days=60)
and (action.finishDateTime is None
or action.finishDateTime >= now - datetime.timedelta(days=30)))
print(' در صف «نظرسنجی»: %s' % ('بله' if survey else 'خیر'))
# اسکن کامل دیتابیس گران است؛ تصمیمِ اسکنر برای همین مشتری بازسازی می‌شود:
# scanner.py:232 if customer.id in appointments: continue
# scanner.py:240 trigger = visit_latest_due(anchor, now=now)
from admin_panel.visit_policy import cycle_anchor_map, visit_latest_due
def scanner_decision(moment):
appointments = next_appointment_map(now=moment)
if customer.pk in appointments:
return 'رد (قرار بعدی دارد)'
anchors = cycle_anchor_map(now=moment)
anchor = anchors.get(customer.pk)
if anchor is None:
return 'رد (لنگر ندارد)'
trigger = visit_latest_due(anchor, now=moment)
if trigger is None or trigger.date() > moment.astimezone(tz).date():
return 'رد (موعد نرسیده)'
return 'ارسال یادآوری دوره‌ای'
for day_offset in range(0, action_offset + 3):
moment = timezone.make_aware(_day(day_offset))
sources = appointment_sources_map(now=moment)
nexts = next_appointment_map(now=moment)
holds = manual_holds_map(now=moment)
entries = dict(sources.get(customer.pk) or {})
day = moment.astimezone(tz).date()
follow = followups_on_date(day, now=moment)
overdue = overdue_followups(now=moment, target_date=day)
visited = last_visit_map(now=moment, customer_ids=[customer.pk])
badge_days = {value.astimezone(tz).date() for value in entries.values()}
scan_cell = scanner_decision(moment)
print(' %s | منابع=%-34s برچسب=%d قرار | قرار بعدی=%-11s | پیگیری=%s'
' | عقب‌افتاده=%s | قرار دستی=%s | %s' % (
day, '+'.join(sorted(entries)) or '—', len(badge_days),
(nexts.get(customer.pk).astimezone(tz).date()
if nexts.get(customer.pk) else '—'),
'بله' if customer.pk in follow else 'خیر',
'بله' if customer.pk in overdue else 'خیر',
'بله' if customer.pk in holds else 'خیر',
scan_cell,
))
_ = visited
SMSQueue.objects.filter(customer=customer).delete()
Action.objects.filter(customer=customer).delete()
def show_customer(customer_id):
"""وضعیت فعلی یک مشتری واقعی + خط زمانی اقدام‌هایش (فقط خواندن)."""
from django.utils import timezone
from admin_panel.models import Action, Customer
from admin_panel.visit_policy import (appointment_sources_map, last_visit_map,
manual_holds_map, next_appointment_map)
tz = timezone.get_current_timezone()
customer = Customer.objects.filter(pk=customer_id).first()
print('\n' + '=' * 100)
print('وضعیت مشتری #%s' % customer_id)
if customer is None:
print(' مشتری پیدا نشد.')
return
print(' نام: %s | فعال: %s | لغو بازدید: %s' % (
customer.name_family, customer.is_active, customer.laghv_bazdid))
print(' visit_hold_until: %s' % customer.visit_hold_until)
sources = appointment_sources_map()
print(' منابع قرار: %s' % {
k: str(v.astimezone(tz)) for k, v in (sources.get(customer.pk) or {}).items()})
print(' قرار بعدی: %s' % next_appointment_map().get(customer.pk))
print(' قرار دستی معتبر: %s' % (customer.pk in manual_holds_map()))
print(' آخرین بازدید: %s' % last_visit_map().get(customer.pk))
print(' اقدام‌ها (۱۰ مورد آخر):')
for act in Action.objects.filter(customer_id=customer_id).order_by('-createdDT')[:10]:
print(' #%-6s %-10s %-7s action=%-19s finish=%-19s created=%s' % (
act.pk, act.actionType, act.status,
act.actionDateTime, act.finishDateTime, act.createdDT))
def main():
parser = argparse.ArgumentParser(description='شبیه‌سازی تعویقِ قبل از تاریخ کار')
parser.add_argument('--customer', type=int, default=None, help='شناسهٔ مشتری واقعی')
parser.add_argument('--skip-variants', action='store_true')
args = parser.parse_args()
import django
django.setup()
from django.conf import settings
from django.db import connections
source_db = str(settings.DATABASES['default']['NAME'])
if not os.path.isabs(source_db):
source_db = os.path.join(BASE_DIR, source_db)
tmp_dir = tempfile.mkdtemp(prefix='hold_probe_')
settings.DATABASES['default']['NAME'] = _copy_db(source_db, tmp_dir)
connections.close_all()
print('دیتابیسِ کپیِ موقت: %s' % settings.DATABASES['default']['NAME'])
if not args.skip_variants:
run_variant('بدون تیک «انجام شد»', done=False, hold_offset=3, action_offset=5)
run_variant('با تیک «انجام شد»', done=True, hold_offset=3, action_offset=5)
run_variant('تعویق بعد از تاریخ کار (سالم)', done=True, hold_offset=10,
action_offset=5)
run_variant('تعویق خالی + تیک (پیش‌فرض ۱۴ روز)', done=True, hold_offset=None,
action_offset=5)
run_variant('تعویق خالی + بدون تیک', done=False, hold_offset=None,
action_offset=5)
if args.customer:
show_customer(args.customer)
shutil.rmtree(tmp_dir, ignore_errors=True)
if __name__ == '__main__':
main()
+370
View File
@@ -0,0 +1,370 @@
#!/usr/bin/env python
"""ممیزیِ فقط-خواندنیِ رفتار «قرار / پیگیری» روی دیتابیس واقعی.
این اسکریپت هیچ نوشتنی روی دیتابیسِ ورودی انجام نمی‌دهد: ابتدا یک **کپی موقت**
از فایل sqlite (به‌همراه ``-wal``/``-shm``) می‌سازد و همهٔ کوئری‌ها و توابع
``admin_panel.visit_policy`` را روی همان کپی اجرا می‌کند.
اجرا::
.venv/Scripts/python.exe scripts/entezar_action_audit.py
.venv/Scripts/python.exe scripts/entezar_action_audit.py --db data9/xxx.sqlite3
.venv/Scripts/python.exe scripts/entezar_action_audit.py --samples 10
"""
import argparse
import os
import shutil
import sys
import tempfile
from collections import Counter
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if BASE_DIR not in sys.path:
sys.path.insert(0, BASE_DIR)
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'khatibi.settings')
def _copy_db(source_path, target_dir):
"""کپی امنِ dbfile + فایل‌های WAL در پوشهٔ موقت؛ مسیر کپی برگردانده می‌شود."""
target = os.path.join(target_dir, 'audit_copy.sqlite3')
shutil.copy2(source_path, target)
for suffix in ('-wal', '-shm'):
side = source_path + suffix
if os.path.exists(side):
shutil.copy2(side, target + suffix)
return target
def _aware(value, tz):
from django.utils import timezone
if value is None:
return None
if timezone.is_naive(value):
return timezone.make_aware(value, tz)
return value
def _local_date(value, tz):
value = _aware(value, tz)
return None if value is None else value.astimezone(tz).date()
def _pct(part, whole):
return 0.0 if not whole else round(100.0 * part / whole, 1)
def main():
parser = argparse.ArgumentParser(description='ممیزی فقط-خواندنی صفحهٔ انتظار')
parser.add_argument('--db', default=None, help='مسیر دیتابیس (پیش‌فرض: settings)')
parser.add_argument('--samples', type=int, default=5, help='تعداد نمونه در خروجی')
parser.add_argument('--customer', type=int, default=None,
help='شناسهٔ مشتری برای نمایش خط زمانی کامل اقدام‌ها')
args = parser.parse_args()
import django
django.setup()
from django.conf import settings
from django.utils import timezone
from admin_panel.models import Action, Customer
from admin_panel.visit_policy import (SOURCE_COORDINATION, SOURCE_MANUAL,
appointment_sources_map,
followups_on_date, last_visit_map,
overdue_followups)
source_db = args.db or str(settings.DATABASES['default']['NAME'])
if not os.path.isabs(source_db):
source_db = os.path.join(BASE_DIR, source_db)
if not os.path.exists(source_db):
raise SystemExit('دیتابیس پیدا نشد: %s' % source_db)
tmp_dir = tempfile.mkdtemp(prefix='entezar_audit_')
settings.DATABASES['default']['NAME'] = _copy_db(source_db, tmp_dir)
from django.db import connections
connections.close_all()
print('دیتابیسِ کپیِ موقت: %s' % settings.DATABASES['default']['NAME'])
now = timezone.now()
tz = timezone.get_current_timezone()
today = now.astimezone(tz).date()
# ---------------- داده‌های پایه ----------------
customers = Customer.objects.all().values_list(
'id', 'name_family', 'is_active', 'laghv_bazdid', 'visit_hold_until', 'installDate',
)
customer_rows = {row[0]: row for row in customers}
coord_rows = list(
Action.objects.filter(
actionType=Action.ActionType.HAMAHANGI,
status__in=(Action.Status.WAITE, Action.Status.FINISH),
deleted_at__isnull=True,
).values_list('customer_id', 'id', 'actionDateTime', 'finishDateTime',
'createdDT', 'status')
)
visit_rows = list(
Action.objects.filter(
actionType=Action.ActionType.BAZDID,
status=Action.Status.FINISH,
).values_list('customer_id', 'id', 'actionDateTime', 'finishDateTime', 'createdDT')
)
pending_rows = list(
Action.objects.filter(
actionType=Action.ActionType.BAZDID,
status=Action.Status.WAITE,
).values_list('customer_id', 'id', 'actionDateTime', 'finishDateTime', 'createdDT')
)
print('مشتریان: %d | هماهنگی فعال: %d | بازدید انجام‌شده: %d | بازدید در انتظار: %d'
% (len(customer_rows), len(coord_rows), len(visit_rows), len(pending_rows)))
visits = last_visit_map(now=now)
sources = appointment_sources_map(now=now)
overdue = overdue_followups(now=now, target_date=today)
today_followups = followups_on_date(today, now=now)
last_coord = {}
for cid, aid, adt, fdt, created, status in coord_rows:
current = last_coord.get(cid)
created_aware = _aware(created, tz)
if current is None or created_aware > current['created']:
last_coord[cid] = {
'id': aid, 'actionDateTime': adt, 'finishDateTime': fdt,
'created': created_aware, 'status': status,
}
visits_by_customer = {}
for row in visit_rows:
visits_by_customer.setdefault(row[0], []).append(row)
def effective(dt, fdt):
"""قاعدهٔ ``effective_visit_dt``: actionDateTime اگر گذشته باشد، وگرنه finish."""
for value in (_aware(dt, tz), _aware(fdt, tz)):
if value is not None and value <= now:
return value
return None
def analyse(cid):
"""تشخیص علت حضور در «نیازمند پیگیری»."""
coord = last_coord.get(cid)
done = visits_by_customer.get(cid) or []
fact = {
'coord_day': _local_date(coord['actionDateTime'], tz) if coord else None,
'coord_created': coord['created'] if coord else None,
'coord_status': coord['status'] if coord else None,
'visits_total': len(done),
'visit_after_coord_created': False,
'visit_dt_after_coord_day': False,
'last_visit': visits.get(cid),
'last_visit_day': _local_date(visits.get(cid), tz),
}
if coord is not None:
for _cid, _aid, adt, fdt, created in done:
if _aware(created, tz) > coord['created']:
fact['visit_after_coord_created'] = True
eff = effective(adt, fdt)
if eff is not None and fact['coord_day'] is not None \
and eff.astimezone(tz).date() > fact['coord_day']:
fact['visit_dt_after_coord_day'] = True
return fact
# ---------------- ۱) نمای missed ----------------
print('\n=== ۱) ?view=today&missed=1 (پیگیری‌های عقب‌افتاده) ===')
missed_ids = [cid for cid in overdue if cid in customer_rows
and customer_rows[cid][2] and not customer_rows[cid][3]
and customer_rows[cid][1]]
print('تعداد ردیف: %d' % len(missed_ids))
reasons = Counter()
samples = []
facts = {}
for cid in missed_ids:
fact = facts[cid] = analyse(cid)
if fact['visits_total'] == 0:
reasons['بدون هیچ بازدید انجام‌شده'] += 1
elif fact['visit_after_coord_created']:
reasons['بازدید انجام‌شده پس از ثبت هماهنگی'] += 1
elif fact['visit_dt_after_coord_day']:
reasons['تاریخ بازدید بعد از موعد هماهنگی است'] += 1
else:
reasons['بازدید انجام‌شده اما قدیمی‌تر از هماهنگی'] += 1
if len(samples) < args.samples and fact['visits_total']:
samples.append((cid, customer_rows[cid][1], fact))
for label, count in reasons.most_common():
print(' - %-60s %6d (%s%%)' % (label, count, _pct(count, len(missed_ids))))
with_visit = sum(1 for f in facts.values() if f['visits_total'])
after_coord = sum(1 for f in facts.values() if f['visit_after_coord_created'])
last_visit_after = sum(
1 for f in facts.values()
if f['last_visit_day'] and f['coord_day'] and f['last_visit_day'] > f['coord_day']
)
print(' => دارای حداقل یک بازدید انجام‌شده: %d (%s%%)'
% (with_visit, _pct(with_visit, len(missed_ids))))
print(' => بازدید پس از ثبت هماهنگی: %d (%s%%)'
% (after_coord, _pct(after_coord, len(missed_ids))))
print(' => آخرین بازدید بعد از موعدِ هماهنگی: %d (%s%%)'
% (last_visit_after, _pct(last_visit_after, len(missed_ids))))
statuses = Counter(f['coord_status'] for f in facts.values())
print(' => وضعیت آخرین هماهنگی: %s' % dict(statuses))
finish_without_hold = sum(
1 for cid in missed_ids
if facts[cid]['coord_status'] == Action.Status.FINISH
and not (customer_rows[cid][4] and customer_rows[cid][4] > now)
)
print(' => هماهنگیِ finish بدون قرار دستیِ فعال: %d' % finish_without_hold)
pending_old = sum(1 for cid in missed_ids
if any(row[0] == cid for row in pending_rows))
print(' => دارای بازدید در انتظارِ قدیمی (قرار منقضی): %d' % pending_old)
holds_in_missed = sum(1 for cid in missed_ids
if customer_rows[cid][4] and customer_rows[cid][4] > now)
print(' => دارای «قرار دستی» آینده و باز هم در missed: %d' % holds_in_missed)
valid_holds_in_missed = sum(
1 for cid in missed_ids if SOURCE_MANUAL in (sources.get(cid) or {}))
print(' => دارای «قرار دستی» **معتبر** و باز هم در missed: %d'
% valid_holds_in_missed)
for cid, name, fact in samples:
print(' نمونه #%s %s | موعد هماهنگی: %s | وضعیت هماهنگی: %s | آخرین بازدید: %s'
% (cid, name, fact['coord_day'], fact['coord_status'], fact['last_visit_day']))
# ---------------- ۲) نمای today ----------------
print('\n=== ۲) ?view=today (نیازمند پیگیری امروز) ===')
eligible_today = [cid for cid in today_followups if cid in customer_rows
and customer_rows[cid][2] and not customer_rows[cid][3]
and customer_rows[cid][1]]
print('تعداد ردیف: %d' % len(eligible_today))
combo = Counter()
for cid in eligible_today:
entry = dict(sources.get(cid) or {})
entry.update(today_followups.get(cid) or {})
combo[tuple(sorted(entry))] += 1
print('ترکیب منابعِ «قرار» در این نما:')
for keys, count in combo.most_common():
print(' - %-45s %6d' % ('+'.join(keys) or 'بدون منبع', count))
today_facts = [analyse(cid) for cid in eligible_today]
done_today = sum(1 for f in today_facts if f['visits_total'])
done_after = sum(1 for f in today_facts if f['visit_after_coord_created'])
def followup_day(cid):
entry = today_followups.get(cid) or {}
return _local_date(min(entry.values()), tz) if entry else None
last_after = sum(
1 for cid, f in zip(eligible_today, today_facts)
if f['last_visit_day'] and followup_day(cid)
and f['last_visit_day'] >= followup_day(cid)
)
print(' => دارای بازدید انجام‌شده: %d (%s%%)'
% (done_today, _pct(done_today, len(eligible_today))))
print(' => بازدید پس از ثبت هماهنگی: %d (%s%%)'
% (done_after, _pct(done_after, len(eligible_today))))
print(' => آخرین بازدید در/بعد از همان روزِ موعد: %d' % last_after)
for cid, fact in list(zip(eligible_today, today_facts))[:args.samples or 0]:
print(' #%-6s %-28s موعد=%-12s آخرین بازدید=%-12s منابع=%s'
% (cid, customer_rows[cid][1], followup_day(cid),
fact['last_visit_day'], sorted(today_followups.get(cid) or {})))
# تفکیک موعدهای امروز: هماهنگیِ «انجام‌شده» (زمان تماس) یا قرار دستی؟
today_coord_status = Counter()
today_with_hold = 0
for cid in eligible_today:
if SOURCE_COORDINATION in (today_followups.get(cid) or {}):
coord = last_coord.get(cid)
today_coord_status[coord['status'] if coord else '?'] += 1
if SOURCE_MANUAL in (sources.get(cid) or {}):
today_with_hold += 1
print(' => وضعیت آخرین اقدام هماهنگی (ردیف‌های دارای منبع هماهنگی): %s'
% dict(today_coord_status))
print(' => از این ردیف‌ها، دارای قرار دستیِ آینده (یعنی بعداً هم می‌آید): %d'
% today_with_hold)
# ---------------- ۳) برچسب «N قرار» ----------------
print('\n=== ۳) برچسب وضعیت «N قرار» (source_count) ===')
source_count = Counter()
for cid, entry in sources.items():
if cid in customer_rows and customer_rows[cid][2]:
source_count[len(entry)] += 1
for n in sorted(source_count):
print(' %d منبع: %6d مشتری' % (n, source_count[n]))
pairs = Counter()
same_day = 0
different_day = 0
for cid, entry in sources.items():
if len(entry) > 1:
pairs['+'.join(sorted(entry))] += 1
if SOURCE_MANUAL in entry and SOURCE_COORDINATION in entry:
if _local_date(entry[SOURCE_MANUAL], tz) == _local_date(
entry[SOURCE_COORDINATION], tz):
same_day += 1
else:
different_day += 1
print(' از ترکیب manual+coordination: هم‌روز=%d | مختلف=%d'
% (same_day, different_day))
print(' ترکیب مشتریان با بیش از یک منبع:')
for keys, count in pairs.most_common():
print(' - %-45s %6d' % (keys, count))
for cid in [cid for cid, e in sources.items() if len(e) > 1][:args.samples or 0]:
print(' نمونه #%s %s: %s'
% (cid, customer_rows[cid][1],
{k: str(_local_date(v, tz)) for k, v in sources[cid].items()}))
# ---------------- ۴) ستون قرار دستی ----------------
print('\n=== ۴) ستون visit_hold_until («تا تاریخ پیگیری نشود») ===')
holds = [(cid, _aware(row[4], tz)) for cid, row in customer_rows.items() if row[4]]
future = [(cid, until) for cid, until in holds if until > now]
past = [(cid, until) for cid, until in holds if until <= now]
valid_future = sum(
1 for cid, _ in future
if SOURCE_MANUAL in (sources.get(cid) or {})
)
print('پرشده: %d | آینده: %d | گذشته (کهنه): %d | آینده و معتبر: %d'
% (len(holds), len(future), len(past), valid_future))
print(' => از %d قرارِ آینده، %d مورد بی‌اعتبار است (آخرین فعالیت هماهنگی نیست).'
% (len(future), len(future) - valid_future))
invalid_reason = Counter()
for cid, _until in future:
if cid not in last_coord:
invalid_reason['بدون اقدام هماهنگی فعال'] += 1
elif cid in visits_by_customer and any(
_aware(row[4], tz) > last_coord[cid]['created']
for row in visits_by_customer[cid]):
invalid_reason['بازدید ثبت‌شده بعد از هماهنگی'] += 1
elif SOURCE_MANUAL not in (sources.get(cid) or {}):
invalid_reason['سایر اقدام‌های بعد از هماهنگی'] += 1
print(' دلایل بی‌اعتباری: %s' % dict(invalid_reason))
# ---------------- ۵) هماهنگی ----------------
print('\n=== ۵) اقدام‌های هماهنگی ===')
print('وضعیت: %s' % dict(Counter(row[5] for row in coord_rows)))
with_hold_field = sum(1 for cid in last_coord
if customer_rows.get(cid) and customer_rows[cid][4])
print('مشتری با هماهنگی فعال و ستونِ قرار پرشده: %d' % with_hold_field)
# ---------------- ۶) خط زمانی یک مشتری ----------------
if args.customer:
cid = args.customer
row = customer_rows.get(cid)
print('\n=== ۶) خط زمانی مشتری #%s ===' % cid)
if row is None:
print(' مشتری پیدا نشد.')
else:
print(' نام: %s | فعال: %s | لغو بازدید: %s | قرار دستی: %s'
% (row[1], row[2], row[3], row[4]))
print(' در missed: %s | در today: %s | منابع: %s'
% (cid in overdue, cid in today_followups, sources.get(cid)))
for act in Action.objects.filter(customer_id=cid).order_by('createdDT'):
print(' #%-6s %-10s %-7s action=%-19s finish=%-19s created=%-19s deleted=%s'
% (act.pk, act.actionType, act.status,
_aware(act.actionDateTime, tz), _aware(act.finishDateTime, tz),
_aware(act.createdDT, tz), act.deleted_at is not None))
shutil.rmtree(tmp_dir, ignore_errors=True)
if __name__ == '__main__':
main()
+286
View File
@@ -0,0 +1,286 @@
#!/usr/bin/env python
"""صحت‌سنجیِ دو نقص گزارش‌شده دربارهٔ ``set_visit_hold`` (روی کپی دیتابیس).
سناریوها روی یک **کپی موقت** از دیتابیس اجرا می‌شوند؛ دیتابیس اصلی دست‌نخورده
می‌ماند و هیچ کد تولیدی‌ای تغییر نمی‌کند — این فقط ابزار اثبات/رد ادعاهاست.
اجرا::
.venv/Scripts/python.exe scripts/hold_write_verification.py
"""
import argparse
import datetime
import os
import shutil
import sys
import tempfile
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if BASE_DIR not in sys.path:
sys.path.insert(0, BASE_DIR)
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'khatibi.settings')
def _copy_db(source_path, target_dir):
target = os.path.join(target_dir, 'verify.sqlite3')
shutil.copy2(source_path, target)
for suffix in ('-wal', '-shm'):
side = source_path + suffix
if os.path.exists(side):
shutil.copy2(side, target + suffix)
return target
def _new_customer(name):
from django.utils import timezone
from admin_panel.models import Customer
today = timezone.localdate()
customer = Customer.objects.create(name_family=name, address='verify')
Customer.objects.filter(pk=customer.pk).update(
installDate=today - datetime.timedelta(days=400))
customer.refresh_from_db()
return customer
def _coordination(customer, *, days, status='finish'):
from django.utils import timezone
from admin_panel.models import Action
when = timezone.now() + datetime.timedelta(days=days)
return Action.objects.create(
customer=customer, actionType=Action.ActionType.HAMAHANGI, status=status,
actionDateTime=when,
finishDateTime=timezone.now() if status == 'finish' else None,
desc='verify',
)
def _show(label, customer):
from django.utils import timezone
from admin_panel.visit_policy import manual_holds_map, appointment_sources_map
tz = timezone.get_current_timezone()
print(' %-44s column=%-18s معتبر=%-5s منابع=%s' % (
label,
customer.visit_hold_until.astimezone(tz).strftime('%Y-%m-%d')
if customer.visit_hold_until else 'None',
'بله' if customer.pk in manual_holds_map() else 'خیر',
sorted((appointment_sources_map().get(customer.pk) or {}).keys()) or '—',
))
def claim_1_silent_failure():
"""نقص ۲ — آیا `_apply_visit_hold` نتیجه را نادیده می‌گیرد؟"""
from django.utils import timezone
from admin_panel.views.actions import _apply_visit_hold
from admin_panel.visit_policy import set_visit_hold
from admin_panel.models import Action
print('\n' + '=' * 92)
print('ادعای ۱ (نقص ۲): نتیجهٔ set_visit_hold در لایهٔ فراخوان دور ریخته می‌شود')
now = timezone.now()
customer = _new_customer('نقص۲')
set_visit_hold(customer, now + datetime.timedelta(days=20))
far = customer.visit_hold_until
_show('پس از ثبت قرار ۲۰ روزه', customer)
written = set_visit_hold(customer, now + datetime.timedelta(days=5))
print(' set_visit_hold(5 روز) ⇒ %s (مقدار بولی واقعی)' % written)
customer.refresh_from_db()
print(' ستون تغییر کرد؟ %s' % ('بله' if customer.visit_hold_until != far else 'خیر'))
result = _apply_visit_hold(
customer,
{'actionType': Action.ActionType.HAMAHANGI,
'holdRaw': now + datetime.timedelta(days=5),
'status': Action.Status.FINISH},
status=Action.Status.FINISH, is_new=False,
)
print(' _apply_visit_hold ⇒ %s' % result)
silent = result.get('reason') != 'forward_only'
print(' نتیجه: نقص ۲ %s' % ('**هنوز وجود دارد** (نتیجه گزارش نمی‌شود)'
if silent else '**رفع شد** (reason=forward_only گزارش می‌شود)'))
def claim_2_no_success_message():
"""آیا کاربر بازخورد می‌بیند؟ (پس از رفع: پیام هشدار با دلیل و تاریخ‌ها)"""
import inspect
from admin_panel.views import actions as views
print('\n' + '=' * 92)
print('بازخورد کاربر در مسیر ویرایش/ایجاد')
edit_src = inspect.getsource(views.customerEditAction)
create_src = inspect.getsource(views.customerNewAction)
helper_src = inspect.getsource(views._report_hold_result)
print(' customerEditAction نتیجهٔ قرار را گزارش می‌کند؟ %s'
% ('_report_hold_result' in edit_src))
print(' customerNewAction نتیجهٔ قرار را گزارش می‌کند؟ %s'
% ('_report_hold_result' in create_src))
print(' پیام هشدار شامل دلیل و تاریخ‌ها است؟ %s'
% ('ذخیره نشد' in helper_src))
print(' پیام موفقیتِ گمراه‌کننده وجود دارد؟ %s'
% ('messages.success' in edit_src or 'messages.success' in create_src))
def claim_3_stale_column_lock():
"""نقص ۳ — قفل شدن ستون بعد از حذف اقدام منبع."""
from django.utils import timezone
from admin_panel.visit_policy import (manual_holds_map, set_visit_hold,
soft_delete_action)
print('\n' + '=' * 92)
print('ادعای ۳ (نقص ۳): حذف اقدام منبع ستون را پاک نمی‌کند و نوشتن را قفل می‌کند')
now = timezone.now()
customer = _new_customer('نقص۳')
action = _coordination(customer, days=60)
set_visit_hold(customer, now + datetime.timedelta(days=60))
customer.refresh_from_db()
_show('قرار ۶۰ روزه ثبت شد', customer)
soft_delete_action(action)
action.refresh_from_db()
customer.refresh_from_db()
print(' اقدام منبع ⇒ status=%s deleted_at=%s' % (action.status, action.deleted_at))
_show('بعد از حذف (ستون کهنه ولی پر)', customer)
print(' در manual_holds_map هست؟ %s' % (customer.pk in manual_holds_map()))
ok = set_visit_hold(customer, now + datetime.timedelta(days=10))
customer.refresh_from_db()
print(' set_visit_hold(10 روز) ⇒ %s' % ok)
_show('پس از تلاش برای تاریخ نزدیک‌تر', customer)
print(' نتیجه: قفل %s' % ('تأیید می‌شود' if ok is False else 'رد می‌شود'))
def claim_4_escape_hatch():
"""آیا مسیر عادیِ رهاسازی وجود دارد؟ (ادعا: هیچ)"""
from django.utils import timezone
from admin_panel.models import Action
from admin_panel.views.actions import _apply_visit_hold
from admin_panel.visit_policy import set_visit_hold, soft_delete_action
print('\n' + '=' * 92)
print('ادعای ۴: «هیچ مسیر عادی‌ای برای رهاسازی وجود ندارد»')
now = timezone.now()
customer = _new_customer('رهاسازی')
action = _coordination(customer, days=60)
set_visit_hold(customer, now + datetime.timedelta(days=60))
soft_delete_action(action)
customer.refresh_from_db()
_show('قفل‌شده پس از حذف اقدام', customer)
# ثبت یک اقدام **غیرهماهنگی** جدید ⇒ is_new=True ⇒ clear_visit_hold
cleared = _apply_visit_hold(
customer,
{'actionType': Action.ActionType.OUT_CALL, 'holdRaw': None,
'status': Action.Status.WAITE},
status=Action.Status.WAITE, is_new=True,
)
customer.refresh_from_db()
print(' ثبت «تماس خروجی» جدید ⇒ clear_visit_hold: %s | ستون=%s'
% (cleared.get('reason') or cleared.get('ok'), customer.visit_hold_until))
ok = set_visit_hold(customer, now + datetime.timedelta(days=10))
customer.refresh_from_db()
_show('قرار ۱۰ روزه پس از رهاسازی', customer)
print(' ⇒ %s' % ('ادعا **رد** می‌شود: مسیر وجود دارد (ولی غیرشهودی و داده‌آلوده)'
if ok else 'ادعا تأیید می‌شود'))
def claim_5_edit_to_visit():
"""مسیری که در گزارش نیامده: ویرایش هماهنگی → «بازدید» ستون را پاک نمی‌کند."""
from django.utils import timezone
from admin_panel.models import Action
from admin_panel.views.actions import _apply_visit_hold
from admin_panel.visit_policy import set_visit_hold
print('\n' + '=' * 92)
print('یافتهٔ اضافی: ویرایش هماهنگی → «بازدید» ⇒ ستون می‌ماند ولی اعتبارش می‌رود')
now = timezone.now()
customer = _new_customer('ویرایش-به-بازدید')
action = _coordination(customer, days=60)
set_visit_hold(customer, now + datetime.timedelta(days=60))
customer.refresh_from_db()
action.actionType = Action.ActionType.BAZDID
action.status = Action.Status.FINISH
action.finishDateTime = now
action.save()
_apply_visit_hold(
customer,
{'actionType': Action.ActionType.BAZDID, 'holdRaw': None,
'status': Action.Status.FINISH},
status=Action.Status.FINISH, is_new=False,
)
customer.refresh_from_db()
_show('پس از ویرایش به بازدید', customer)
ok = set_visit_hold(customer, now + datetime.timedelta(days=7))
print(' set_visit_hold(7 روز) ⇒ %s' % ok)
print(' ⇒ %s' % ('قفل، حتی با ستونِ بی‌اعتبار — شدت نقص ۳ بیشتر از تخمین گزارش است'
if ok is False else 'قفل نشد'))
def real_db_stats():
"""آمار واقعی: چند مشتری ستون پرشدهٔ «بی‌اعتبار» دارند؟"""
from django.utils import timezone
from admin_panel.models import Action, Customer
from admin_panel.visit_policy import manual_holds_map
print('\n' + '=' * 92)
print('آمار دیتابیس واقعی (روی کپی)')
tz = timezone.get_current_timezone()
now = timezone.now()
future = list(Customer.objects.filter(visit_hold_until__gt=now))
valid = set(manual_holds_map())
dead = [c for c in future if c.pk not in valid]
print(' ستون پرشده و آینده: %d | معتبر: %d | بی‌اعتبار (قفل‌کننده): %d'
% (len(future), len(valid), len(dead)))
for c in dead[:10]:
last = Action.objects.filter(
customer=c, actionType=Action.ActionType.HAMAHANGI,
).order_by('-createdDT').first()
print(' id=%-6s idCode=%-10s hold=%-11s آخرین هماهنگی=%s (%s)' % (
c.id, c.idCode,
c.visit_hold_until.astimezone(tz).date(),
last.status if last else '—',
last.createdDT.date() if last else '—'))
print(' هماهنگی حذف/لغوشده با تاریخ آینده (کاندید قفل آینده): %d'
% Action.objects.filter(
actionType=Action.ActionType.HAMAHANGI, status=Action.Status.CANCELL,
actionDateTime__gt=now).count())
def main():
parser = argparse.ArgumentParser(description='صحت‌سنجی نقص‌های set_visit_hold')
parser.add_argument('--skip-stats', action='store_true')
args = parser.parse_args()
import django
django.setup()
from django.conf import settings
from django.db import connections
source_db = str(settings.DATABASES['default']['NAME'])
if not os.path.isabs(source_db):
source_db = os.path.join(BASE_DIR, source_db)
tmp_dir = tempfile.mkdtemp(prefix='hold_verify_')
settings.DATABASES['default']['NAME'] = _copy_db(source_db, tmp_dir)
connections.close_all()
print('دیتابیسِ کپیِ موقت: %s' % settings.DATABASES['default']['NAME'])
claim_1_silent_failure()
claim_2_no_success_message()
claim_3_stale_column_lock()
claim_4_escape_hatch()
claim_5_edit_to_visit()
if not args.skip_stats:
real_db_stats()
shutil.rmtree(tmp_dir, ignore_errors=True)
if __name__ == '__main__':
main()
+478
View File
@@ -0,0 +1,478 @@
"""تست‌های قابلیت «افزودن پیشوند آقای/خانم به نام مشتریان».
همهٔ تست‌ها روی دیتابیس تستی Django اجرا می‌شوند (SQLite در حافظه) و هیچ‌گاه به
``data9/kt.sqlite3`` (دیتابیس واقعی) دست نمی‌زنند. فایل دادهٔ واقعی هم دست‌نخورده
می‌ماند؛ هر تست روی یک فایل JSON ساختگیِ موقت کار می‌کند.
"""
import hashlib
import io
import itertools
import json
import shutil
import tempfile
from datetime import timedelta
from pathlib import Path
from unittest import mock
from django.core.management import call_command
from django.core.management.base import CommandError
from django.db import connections
from django.db.models.query import QuerySet
from django.db.utils import OperationalError
from django.test import SimpleTestCase, TestCase
from django.utils import timezone
from admin_panel.models import Customer, CustomerNameFixJob
from admin_panel.name_fix import (ALGORITHM_VERSION, DatasetError,
build_name_index, decide_prefix, load_name_index,
normalize_name_key)
from admin_panel.management.commands.fix_customer_names import (LOCK_TTL,
MAX_DB_RETRIES)
from .factories import make_customer
DATASET_RECORDS = [
{"Names": "محمد", "Gender": "M"},
{"Names": "مریم", "Gender": "F"},
{"Names": "علی", "Gender": "M"},
{"Names": "علي", "Gender": "M"}, # ي عربی؛ همان کلید نرمال‌شده
{"Names": "كاظم", "Gender": "M"}, # ك عربی
{"Names": "کاظم", "Gender": "M"}, # ک فارسی (همان کلید)
{"Names": "سارا", "Gender": "F"},
{"Names": "سارا", "Gender": "F"}, # تکراری هم‌جنسیت
{"Names": "آرش", "Gender": "M"},
{"Names": "آرش", "Gender": "F"}, # تکراری متناقض ⇒ مبهم
{"Names": "نازنین", "Gender": "D"}, # جنسیت نامعتبر
{"Names": 123, "Gender": "M"}, # رکورد malformed
{"Names": "", "Gender": "M"}, # نام خالی
{"Names": "بی‌جنس"}, # کلید Gender ندارد
]
def sha256_of(path):
return hashlib.sha256(Path(path).read_bytes()).hexdigest()
class DatasetFixtureMixin:
"""ساخت فایل JSON موقت و پاک‌سازی آن پس از تست."""
def setUp(self):
super().setUp()
self.tmpdir = tempfile.mkdtemp(prefix="namefix-")
self.addCleanup(shutil.rmtree, self.tmpdir, ignore_errors=True)
def write_dataset(self, records=DATASET_RECORDS, name="iranianNamesDataset.json"):
path = Path(self.tmpdir) / name
path.write_text(json.dumps({"RECORDS": records}, ensure_ascii=False),
encoding="utf-8")
return path
class NameIndexTests(DatasetFixtureMixin, SimpleTestCase):
"""اعتبارسنجی فایل، نرمال‌سازی و ساخت index."""
def test_load_builds_conservative_index_and_report(self):
path = self.write_dataset()
name_index = load_name_index(path)
self.assertEqual(name_index.sha256, sha256_of(path))
self.assertEqual(name_index.lookup("محمد"), "M")
self.assertEqual(name_index.lookup("مریم"), "F")
# ي/ی و ك/ک یکسان‌سازی می‌شوند.
self.assertEqual(name_index.lookup("علی"), "M")
self.assertEqual(name_index.lookup("کاظم"), "M")
# تکراری متناقض و جنسیت نامعتبر کنار گذاشته می‌شوند.
self.assertIsNone(name_index.lookup("آرش"))
self.assertIsNone(name_index.lookup("نازنین"))
rep = name_index.report
self.assertEqual(rep["records_total"], 14)
self.assertEqual(rep["rejected_malformed"], 2)
self.assertEqual(rep["rejected_empty_name"], 1)
self.assertEqual(rep["rejected_unknown_gender"], 1)
self.assertEqual(rep["usable_keys"], 5)
self.assertEqual(rep["unusable_keys"], 2)
self.assertEqual(rep["duplicate_keys"], 4)
self.assertEqual(rep["duplicate_same_gender"], 3)
self.assertEqual(rep["duplicate_conflict"], 1)
def test_normalization_unifies_arabic_and_persian_letters(self):
self.assertEqual(normalize_name_key(" علي "), "علی")
self.assertEqual(normalize_name_key("كاظم"), "کاظم")
self.assertEqual(normalize_name_key("محمد"), "محمد")
self.assertEqual(normalize_name_key(None), "")
def test_missing_records_key_is_rejected(self):
path = Path(self.tmpdir) / "bad.json"
path.write_text(json.dumps({"DATA": []}), encoding="utf-8")
with self.assertRaises(DatasetError):
load_name_index(path)
def test_records_must_be_a_list(self):
path = Path(self.tmpdir) / "bad.json"
path.write_text(json.dumps({"RECORDS": {"Names": "x"}}), encoding="utf-8")
with self.assertRaises(DatasetError):
load_name_index(path)
def test_invalid_json_is_rejected(self):
path = Path(self.tmpdir) / "bad.json"
path.write_text("{not json", encoding="utf-8")
with self.assertRaises(DatasetError):
load_name_index(path)
def test_normalization_collision_with_conflicting_gender_is_ambiguous(self):
name_index = build_name_index([
{"Names": "علي", "Gender": "M"},
{"Names": "علی", "Gender": "F"}, # پس از نرمال‌سازی همان کلید
])
self.assertIsNone(name_index.lookup("علی"))
self.assertIn("علی", name_index.ambiguous)
class DecidePrefixTests(DatasetFixtureMixin, SimpleTestCase):
"""الگوریتم تصمیم، مستقل از دیتابیس."""
def setUp(self):
super().setUp()
self.name_index = load_name_index(self.write_dataset())
def test_expected_behaviour_table(self):
cases = [
("محمد یاوری", "آقای محمد یاوری", "male"),
("مریم احمدی", "خانم مریم احمدی", "female"),
(" محمد یاوری ", "آقای محمد یاوری", "male"),
("\tمریم احمدی\n", "خانم مریم احمدی", "female"),
("یاوری", None, "single_word"),
("محمد", None, "single_word"),
("مریم", None, "single_word"),
("آقا محمد یاوری", None, "has_prefix"),
("آقای محمد یاوری", None, "has_prefix"),
("خانم مریم احمدی", None, "has_prefix"),
("نام ناشناخته احمدی", None, "unknown_name"),
("آرش محمدی", None, "ambiguous_gender"),
("نازنین کریمی", None, "ambiguous_gender"),
("علي رضایی", "آقای علي رضایی", "male"), # نام اصلی دست‌نخورده می‌ماند
("", None, "empty"),
(" ", None, "empty"),
]
for raw, expected_new, expected_reason in cases:
decision = decide_prefix(raw, self.name_index)
self.assertEqual(decision.new_name, expected_new, msg=repr(raw))
self.assertEqual(decision.reason, expected_reason, msg=repr(raw))
def test_none_value_is_handled(self):
decision = decide_prefix(None, self.name_index)
self.assertIsNone(decision.new_name)
self.assertEqual(decision.reason, "empty")
def test_internal_spaces_are_not_rewritten(self):
decision = decide_prefix("محمد یاوری", self.name_index)
self.assertEqual(decision.new_name, "آقای محمد یاوری")
# (نام اولیه، نتیجهٔ مورد انتظار) — ترتیب = ترتیب ساخت ⇒ ترتیب pk
CASES = [
("محمد یاوری", "آقای محمد یاوری"),
("مریم احمدی", "خانم مریم احمدی"),
(" محمد یاوری ", "آقای محمد یاوری"),
("یاوری", "یاوری"),
("محمد", "محمد"),
("مریم", "مریم"),
("آقا محمد یاوری", "آقا محمد یاوری"),
("آقای محمد یاوری", "آقای محمد یاوری"),
("خانم مریم احمدی", "خانم مریم احمدی"),
("نام ناشناخته احمدی", "نام ناشناخته احمدی"),
("آرش محمدی", "آرش محمدی"),
("نازنین کریمی", "نازنین کریمی"),
("علي رضایی", "آقای علي رضایی"),
(" نام ناشناخته احمدی ", " نام ناشناخته احمدی "),
]
EXPECTED_CHANGED = 4 # موارد ۱، ۲، ۳، ۱۳
EXPECTED_SINGLE_WORD = 3 # یاوری، محمد، مریم
EXPECTED_HAS_PREFIX = 3
EXPECTED_UNKNOWN = 2 # «نام ناشناخته …» دو مورد (با/بی فاصله)
EXPECTED_AMBIGUOUS = 2 # آرش، نازنین
class CommandTestMixin(DatasetFixtureMixin):
"""ساخت مشتریان نمونه + فایل دادهٔ موقت برای تست‌های فرمان."""
def setUp(self):
super().setUp()
self.json_path = self.write_dataset()
self.customers = [make_customer(name) for name, _ in CASES]
def run_command(self, **options):
options.setdefault("json_path", str(self.json_path))
options.setdefault("stdout", self._stdout())
return call_command("fix_customer_names", **options)
def _stdout(self):
return io.StringIO()
def names(self):
return list(Customer.objects.order_by("pk")
.values_list("name_family", flat=True))
def expected_names(self):
return [expected for _, expected in CASES]
def max_pk(self):
return max(c.pk for c in self.customers)
class DryRunTests(CommandTestMixin, TestCase):
"""پیش‌فرض فرمان نباید هیچ‌چیز بنویسد."""
def test_dry_run_changes_nothing(self):
out = self._stdout()
self.run_command(stdout=out)
self.assertEqual(self.names(), [name for name, _ in CASES])
self.assertEqual(CustomerNameFixJob.objects.count(), 0)
self.assertIn("dry-run", out.getvalue())
def test_dry_run_flag_conflicts_with_apply(self):
with self.assertRaises(CommandError):
self.run_command(dry_run=True, apply=True, confirm_production=True)
self.assertEqual(self.names(), [name for name, _ in CASES])
def test_dry_run_reports_expected_counts(self):
out = self._stdout()
self.run_command(stdout=out)
text = out.getvalue()
self.assertIn(f"مشتریان بررسی‌شده: {len(CASES)}", text)
self.assertIn(f"قابل اصلاح / اصلاح‌شده: {EXPECTED_CHANGED}", text)
self.assertIn(f"تک‌کلمه‌ای: {EXPECTED_SINGLE_WORD}", text)
self.assertIn(f"ناشناخته در JSON: {EXPECTED_UNKNOWN}", text)
self.assertIn(f"جنسیت مبهم/نامعتبر: {EXPECTED_AMBIGUOUS}", text)
# نمونهٔ قبل/بعد نمایش داده می‌شود.
self.assertIn("«محمد یاوری» → «آقای محمد یاوری»", text)
class ApplyTests(CommandTestMixin, TestCase):
"""اجرای واقعی: گارد تأیید، تغییر تنها مشتریان واجد شرایط، اتمیک بودن."""
APPLY = {"apply": True, "confirm_production": True}
def test_apply_without_confirm_production_is_refused(self):
with self.assertRaises(CommandError):
self.run_command(apply=True)
self.assertEqual(self.names(), [name for name, _ in CASES])
self.assertEqual(CustomerNameFixJob.objects.count(), 0)
def test_apply_changes_only_eligible_names(self):
self.run_command(batch_size=3, **self.APPLY)
self.assertEqual(self.names(), self.expected_names())
job = CustomerNameFixJob.objects.get()
self.assertEqual(job.status, CustomerNameFixJob.Status.COMPLETED)
self.assertEqual(job.algorithm_version, ALGORITHM_VERSION)
self.assertEqual(job.source_hash, sha256_of(self.json_path))
self.assertEqual(job.initial_max_pk, self.max_pk())
self.assertEqual(job.last_processed_pk, self.max_pk())
self.assertEqual(job.stats["scanned"], len(CASES))
self.assertEqual(job.stats["changed"], EXPECTED_CHANGED)
self.assertEqual(job.stats["single_word"], EXPECTED_SINGLE_WORD)
self.assertEqual(job.stats["has_prefix"], EXPECTED_HAS_PREFIX)
self.assertEqual(job.stats["unknown_name"], EXPECTED_UNKNOWN)
self.assertEqual(job.stats["ambiguous_gender"], EXPECTED_AMBIGUOUS)
self.assertEqual(job.stats["batches"], 5) # ۱۴ مشتری، batch=3
def test_other_customer_fields_and_json_file_remain_untouched(self):
target = self.customers[0]
Customer.objects.filter(pk=target.pk).update(
address="تهران، خیابان تست", phone1="09120000000",
notes="یادداشت مهم", is_active=False)
before_hash = sha256_of(self.json_path)
self.run_command(**self.APPLY)
target.refresh_from_db()
self.assertEqual(target.name_family, "آقای محمد یاوری")
self.assertEqual(target.address, "تهران، خیابان تست")
self.assertEqual(target.phone1, "09120000000")
self.assertEqual(target.notes, "یادداشت مهم")
self.assertFalse(target.is_active)
self.assertEqual(sha256_of(self.json_path), before_hash)
def test_customer_model_has_no_gender_field(self):
# فقط فیلدهای واقعی ستون‌دار مدل (بدون روابط معکوس).
field_names = {f.name for f in Customer._meta.concrete_fields}
self.assertEqual(field_names, {
"id", "name_family", "address", "notes", "phone1", "phone2",
"phone3", "idCode", "installDate", "create_date", "last_bazdid_dt",
"laghv_bazdid", "is_active", "sms_primary_phones",
# «قرار بعدی» (تعویق بازدید از فرم هماهنگی) + زمان ثبت برای حسابرسی.
"visit_hold_until", "visit_hold_set_at",
})
self.assertNotIn("gender", field_names)
def test_rerun_of_completed_job_requires_new_job(self):
self.run_command(**self.APPLY)
with self.assertRaises(CommandError):
self.run_command(**self.APPLY)
self.assertEqual(self.names(), self.expected_names())
self.assertEqual(CustomerNameFixJob.objects.count(), 1)
def test_new_job_rerun_is_idempotent(self):
self.run_command(**self.APPLY)
self.run_command(new_job=True, **self.APPLY)
# پیشوندهای موجود تکرار نشده‌اند.
self.assertEqual(self.names(), self.expected_names())
self.assertEqual(CustomerNameFixJob.objects.count(), 2)
self.assertEqual(CustomerNameFixJob.objects.latest("pk").stats["changed"], 0)
def test_missing_json_path_is_reported(self):
with self.assertRaises(CommandError):
self.run_command(json_path=str(Path(self.tmpdir) / "nope.json"),
apply=True, confirm_production=True)
self.assertEqual(self.names(), [name for name, _ in CASES])
def test_invalid_dataset_aborts_before_any_change(self):
bad = Path(self.tmpdir) / "bad.json"
bad.write_text("{oops", encoding="utf-8")
with self.assertRaises(CommandError):
self.run_command(json_path=str(bad), apply=True, confirm_production=True)
self.assertEqual(self.names(), [name for name, _ in CASES])
self.assertEqual(CustomerNameFixJob.objects.count(), 0)
def test_missing_job_table_is_reported(self):
with mock.patch.object(connections["default"].introspection,
"table_names", return_value=[]):
with self.assertRaises(CommandError):
self.run_command(**self.APPLY)
self.assertEqual(self.names(), [name for name, _ in CASES])
class ResilienceTests(CommandTestMixin, TestCase):
"""قفل، بازیابی پس از crash، hash، اتمیک بودن و retry قفل دیتابیس."""
APPLY = {"apply": True, "confirm_production": True}
def _job(self, **overrides):
values = {
"source_hash": sha256_of(self.json_path),
"algorithm_version": ALGORITHM_VERSION,
"status": CustomerNameFixJob.Status.PAUSED,
"batch_size": 3,
"initial_max_pk": self.max_pk(),
"last_processed_pk": 0,
"stats": {},
"heartbeat_at": timezone.now(),
}
values.update(overrides)
return CustomerNameFixJob.objects.create(**values)
def test_concurrent_run_is_blocked(self):
self._job(status=CustomerNameFixJob.Status.RUNNING,
heartbeat_at=timezone.now())
with self.assertRaises(CommandError):
self.run_command(**self.APPLY)
self.assertEqual(self.names(), [name for name, _ in CASES])
def test_stale_running_lock_is_recovered_and_resumed(self):
stale = self._job(status=CustomerNameFixJob.Status.RUNNING,
heartbeat_at=timezone.now() - LOCK_TTL - timedelta(minutes=1))
self.run_command(**self.APPLY)
stale.refresh_from_db()
self.assertEqual(stale.status, CustomerNameFixJob.Status.COMPLETED)
self.assertEqual(self.names(), self.expected_names())
def test_resume_continues_from_checkpoint(self):
first_pk = self.customers[0].pk
job = self._job(last_processed_pk=first_pk)
self.run_command(resume=job.pk, **self.APPLY)
names = self.names()
# مشتری قبل از checkpoint دست‌نخورده می‌ماند
self.assertEqual(names[0], "محمد یاوری")
self.assertEqual(names[1:], self.expected_names()[1:])
job.refresh_from_db()
self.assertEqual(job.status, CustomerNameFixJob.Status.COMPLETED)
self.assertEqual(job.last_processed_pk, self.max_pk())
self.assertEqual(job.stats["scanned"], len(CASES) - 1)
def test_resume_with_different_hash_is_refused(self):
job = self._job(source_hash="0" * 64)
with self.assertRaises(CommandError):
self.run_command(resume=job.pk, **self.APPLY)
self.assertEqual(self.names(), [name for name, _ in CASES])
job.refresh_from_db()
self.assertEqual(job.status, CustomerNameFixJob.Status.PAUSED)
def test_unknown_resume_id_is_refused(self):
with self.assertRaises(CommandError):
self.run_command(resume=999999, **self.APPLY)
self.assertEqual(self.names(), [name for name, _ in CASES])
def test_batch_failure_rolls_back_names_and_checkpoint_atomically(self):
original = QuerySet.bulk_update
calls = itertools.count(1)
def flaky(self, objs, fields, batch_size=None):
if next(calls) == 2:
raise RuntimeError("boom")
return original(self, objs, fields, batch_size)
with mock.patch.object(QuerySet, "bulk_update", flaky):
with self.assertRaises(CommandError):
self.run_command(batch_size=1, **self.APPLY)
names = self.names()
# batch اول (مشتری ۱) commit شده، batch دوم (مشتری ۲) rollback شده است.
self.assertEqual(names[0], "آقای محمد یاوری")
self.assertEqual(names[1], "مریم احمدی")
job = CustomerNameFixJob.objects.get()
self.assertEqual(job.status, CustomerNameFixJob.Status.FAILED)
# checkpoint دقیقاً روی پایان batch اول است ⇒ ادامه بدون تکرار/پرت شدن داده.
self.assertEqual(job.last_processed_pk, self.customers[0].pk)
def test_locked_database_is_retried_then_succeeds(self):
original = QuerySet.bulk_update
calls = itertools.count(1)
def flaky(self, objs, fields, batch_size=None):
if next(calls) == 1:
raise OperationalError("database is locked")
return original(self, objs, fields, batch_size)
with mock.patch.object(QuerySet, "bulk_update", flaky), \
mock.patch("admin_panel.management.commands.fix_customer_names.time.sleep"):
self.run_command(**self.APPLY)
self.assertEqual(self.names(), self.expected_names())
self.assertEqual(CustomerNameFixJob.objects.get().status,
CustomerNameFixJob.Status.COMPLETED)
def test_retry_is_bounded_and_surfaces_error(self):
calls = itertools.count(1)
attempts = []
def always_locked(self, objs, fields, batch_size=None):
attempts.append(next(calls))
raise OperationalError("database is locked")
with mock.patch.object(QuerySet, "bulk_update", always_locked), \
mock.patch("admin_panel.management.commands.fix_customer_names.time.sleep"):
with self.assertRaises(CommandError):
self.run_command(**self.APPLY)
self.assertEqual(len(attempts), MAX_DB_RETRIES) # retry نامحدود نیست
self.assertEqual(self.names(), [name for name, _ in CASES])
self.assertEqual(CustomerNameFixJob.objects.get().status,
CustomerNameFixJob.Status.FAILED)
def test_batches_cover_all_customers_across_sizes(self):
for batch_size in (1, 2, 5, 200):
with self.subTest(batch_size=batch_size):
CustomerNameFixJob.objects.all().delete()
for customer, (name, _) in zip(self.customers, CASES):
Customer.objects.filter(pk=customer.pk).update(name_family=name)
self.run_command(batch_size=batch_size, new_job=True, **self.APPLY)
self.assertEqual(self.names(), self.expected_names())
+89 -1
View File
@@ -4,7 +4,7 @@
from django.test import TestCase
from django.urls import reverse
from admin_panel.models import Article, Customer, PhoneNumber
from admin_panel.models import Article, Customer, Factor, PhoneNumber
from .factories import login_superuser, make_customer, make_user
@@ -55,6 +55,94 @@ class CustomerCrudTests(TestCase):
self.assertEqual(phones[0].phone_number, '09120009999')
class CustomerInfoCardUITests(TestCase):
"""کارت پروفایل مشتری (ستون راست): ساختار حرفه‌ای، ویرایش و تعیین شمارهٔ اصلی.
این تست‌ها قرارداد ویوها/قالب‌ها را قفل می‌کنند تا بازطراحی UI به ویرایش مشتری
یا تعیین «شمارهٔ اصلی پیامک» آسیب نزند.
"""
def setUp(self):
self.user = login_superuser(self.client, 'cardUser')
def _customer_page(self, customer):
return self.client.get(
reverse('admin_panel:customer', kwargs={'c_id': customer.id}),
).content.decode('utf-8')
def test_profile_card_structure_is_rendered(self):
customer = make_customer('مشتری کارت', phones=['09120000000'])
html = self._customer_page(customer)
for needle in ('has-background-white brad5', 'id="formcsEdit"',
'dynamic-phones-edit', 'شماره‌های تماس', 'لغو بازدید'):
self.assertIn(needle, html, msg=needle)
def test_template_comments_never_leak_into_the_page(self):
"""رگرسیون: کامنت چندخطی {# #} جنگو معتبر نیست و به‌صورت متن چاپ می‌شود.
قالب کارت پروفایل باید از ``{% comment %}`` استفاده کند؛ این تست تضمین می‌کند
هیچ متن کامنتی در HTML نهایی دیده نشود.
"""
customer = make_customer('مشتری کامنت', phones=['09120000000'])
html = self._customer_page(customer)
for leaked in ('تک‌منبع', 'DRY', 'شناسه‌های موردنیاز', 'کارت پروفایل مشتری —'):
self.assertNotIn(leaked, html, msg=f'متن کامنت در صفحه لو رفته: {leaked}')
def test_edit_controls_present_and_single_form(self):
customer = make_customer('مشتری ویرایش‌کارت', phones=['09120000000'])
html = self._customer_page(customer)
for needle in ('id="formcsEdit"', 'id="enEdit"', 'id="editCs"',
'id="cancelEdit"', 'id="showUserDT"'):
self.assertIn(needle, html, msg=needle)
# نباید فرم تودرتو ساخته شود؛ فقط یک فرم ویرایش در ستون وجود دارد.
self.assertEqual(html.count('id="formcsEdit"'), 1)
def test_primary_toggle_present_next_to_phone(self):
customer = make_customer('مشتری اصلی‌کارت')
PhoneNumber.objects.create(customer=customer, phone_number='09120000000')
html = self._customer_page(customer)
self.assertIn('sms-primary-toggle', html)
self.assertIn('data-phone="09120000000"', html)
self.assertIn(
'data-url="%s"' % reverse('admin_panel:sms_primary_toggle',
kwargs={'c_id': customer.id}),
html,
)
def test_card_also_renders_on_legacy_base_page(self):
"""صفحهٔ جزئیات فاکتور (customerFactor) از customerBase.html استفاده می‌کند."""
factor = Factor.objects.create(customer=make_customer('مشتری فاکتورکارت'),
amount=1000, pay_status='unpaid')
html = self.client.get(
reverse('admin_panel:customerFactor',
kwargs={'c_id': factor.customer_id, 'f_id': factor.id}),
).content.decode('utf-8')
self.assertIn('has-background-white brad5', html)
self.assertIn('id="formcsEdit"', html)
def test_edit_persists_phones_and_primary_selection(self):
"""ویرایش مشتری با markup جدید باید شماره‌ها و انتخاب «اصلی» را ذخیره کند."""
customer = make_customer('مشتری ویرایش‌نهایی', phones=['09120000001'])
url = reverse('admin_panel:customerEdit', kwargs={'c_id': customer.id})
response = self.client.post(url, {
'an_name': 'مشتری ویرایش‌نهایی', 'an_address': 'قم',
'installDate': '1401/02/03', 'idnCode': '555',
'laghv_bazdid': 'true', 'notes': 'یادداشت',
'phone_titles': ['موبایل'], 'phones': ['09120009999'],
'phone_primary': ['0'],
})
self.assertIn(response.status_code, (200, 302))
customer.refresh_from_db()
self.assertEqual(customer.name_family, 'مشتری ویرایش‌نهایی')
self.assertTrue(customer.laghv_bazdid)
self.assertEqual(customer.notes, 'یادداشت')
phones = list(PhoneNumber.objects.filter(customer=customer))
self.assertEqual(len(phones), 1)
self.assertEqual(phones[0].phone_number, '09120009999')
# شمارهٔ تیک‌خورده به‌عنوان «اصلی» ذخیره شده است.
self.assertEqual(customer.sms_primary_phones, '+989120009999')
class InactiveCustomerHiddenTests(TestCase):
"""مشتری غیرفعال (is_active=False) در فهرست و در جستجو دیده نمی‌شود."""
File diff suppressed because it is too large. Load diff
+1368 -137
View File
File diff suppressed because it is too large. Load diff
+383
View File
@@ -0,0 +1,383 @@
"""تست‌های دستور ``normalize_customer_sms_phones``.
همهٔ تست‌ها روی دیتابیس تستی Django اجرا می‌شوند؛ نه به ``data9/kt.sqlite3`` دست
می‌زنند و نه فایل وضعیت داخل ریشهٔ پروژه می‌نویسند (مسیر وضعیت موقت است).
"""
import io
import json
import shutil
import tempfile
from pathlib import Path
from unittest import mock
from django.core.management import call_command
from django.core.management.base import CommandError
from django.db.models.query import QuerySet
from django.test import TestCase
from admin_panel.models import Customer, PhoneNumber
from admin_panel.management.commands.normalize_customer_sms_phones import (
FIELD_MAX_LENGTH, digit_string, is_landline)
from admin_panel.sms.recipients import resolve_recipients
from .factories import make_customer
def make_phone(customer, number, title='تلفن'):
return PhoneNumber.objects.create(
customer=customer, title=title, phone_number=number)
class PureHelperTests(TestCase):
"""توابع کمکی اعتبارسنجی/تفکیک (بدون دیتابیس واقعی)."""
def test_digit_string_converts_persian_and_arabic_digits(self):
self.assertEqual(digit_string('۰۹۱۲-۳۴۵'), '0912345')
self.assertEqual(digit_string('٠٩١٢ ٣٤٥'), '0912345')
self.assertEqual(digit_string('(0912) 345'), '0912345')
self.assertEqual(digit_string(None), '')
self.assertEqual(digit_string(' '), '')
def test_landline_detection(self):
for raw in ('02112345678', '۰۲۱۱۲۳۴۵۶۷۸', '031-33445566', '05138490000',
'57387608', '57473005'): # ۸رقمی = ثابت محلی
self.assertTrue(is_landline(raw), msg=raw)
for raw in ('09123456789', '9123456789', '12345', '', None,
'+989123456789', '0012345678'):
self.assertFalse(is_landline(raw), msg=repr(raw))
class CommandTestCase(TestCase):
"""زیرساخت مشترک: دیتابیس تستی + فایل وضعیت موقت."""
def setUp(self):
super().setUp()
self.tmpdir = tempfile.mkdtemp(prefix='smsnorm-')
self.addCleanup(shutil.rmtree, self.tmpdir, ignore_errors=True)
self.checkpoint = Path(self.tmpdir) / '.sms_normalization_checkpoint.json'
def run_cmd(self, **options):
options.setdefault('checkpoint', str(self.checkpoint))
options.setdefault('stdout', io.StringIO())
call_command('normalize_customer_sms_phones', **options)
return options['stdout'].getvalue()
def stored(self):
return dict(Customer.objects.values_list('id', 'sms_primary_phones'))
class DryRunTests(CommandTestCase):
"""پیش‌فرض: هیچ دیتایی در دیتابیس یا فایل وضعیت نوشته نمی‌شود."""
def test_dry_run_writes_nothing(self):
customer = make_customer('خشکی')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', sms_primary_phones='+989120000009')
make_phone(customer, '09120000002')
out = self.run_cmd()
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones, '+989120000009')
self.assertFalse(self.checkpoint.exists())
self.assertIn('dry-run', out)
self.assertIn('قابل‌به‌روزرسانی', out)
def test_dry_run_reports_counts(self):
customer = make_customer('گزارش')
Customer.objects.filter(pk=customer.pk).update(phone1='09120000001')
PhoneNumber.objects.create(
customer=customer, title='t', phone_number='02112345678')
out = self.run_cmd()
self.assertIn('مشتریان بررسی‌شده: 1', out)
self.assertIn('شماره‌های فیلترشده: ثابت=1', out)
def test_dry_run_flag_conflicts_with_apply(self):
customer = make_customer('تناقض فلگ')
with self.assertRaises(CommandError):
self.run_cmd(dry_run=True, apply=True)
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones, '')
def test_dry_run_ignores_reset_checkpoint(self):
self.checkpoint.write_text(json.dumps({'last_id': 5}), encoding='utf-8')
self.run_cmd(reset_checkpoint=True)
self.assertTrue(self.checkpoint.exists())
class ApplyTests(CommandTestCase):
"""اجرای واقعی: تجمیع، حذف تکراری، فیلتر نامعتبر، ایمنی داده."""
def test_aggregates_all_sources_in_priority_order(self):
customer = make_customer('چند منبع')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', phone2='09120000002', phone3='09120000003')
PhoneNumber.objects.create(customer=customer, title='a', phone_number='09120000004')
PhoneNumber.objects.create(customer=customer, title='b', phone_number='09120000005')
self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(
customer.sms_primary_phones,
'+989120000001,+989120000002,+989120000003,+989120000004,+989120000005',
)
def test_dedupes_preserving_priority_order(self):
customer = make_customer('تکراری')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', phone2='989120000001') # همان شماره
PhoneNumber.objects.create(
customer=customer, title='a', phone_number='+98 912 000 0002')
PhoneNumber.objects.create(
customer=customer, title='b', phone_number='۰۹۱۲۰۰۰۰۰۰۲') # تکراری
out = self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones,
'+989120000001,+989120000002')
self.assertIn('شماره‌های تکراری حذف‌شده: 2', out)
def test_converts_international_and_local_variants(self):
customer = make_customer('قالب‌ها')
Customer.objects.filter(pk=customer.pk).update(phone1='+989120000001')
PhoneNumber.objects.create(customer=customer, title='a', phone_number='00989120000002')
PhoneNumber.objects.create(customer=customer, title='b', phone_number='989120000003')
PhoneNumber.objects.create(customer=customer, title='c', phone_number='9120000004')
PhoneNumber.objects.create(customer=customer, title='d', phone_number='0912-000-0005')
self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(
customer.sms_primary_phones,
'+989120000001,+989120000002,+989120000003,+989120000004,+989120000005',
)
def test_filters_landlines_and_invalid_values(self):
customer = make_customer('نامعتبر')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', phone2='02112345678', phone3='0')
PhoneNumber.objects.create(customer=customer, title='a', phone_number='57387608')
PhoneNumber.objects.create(customer=customer, title='b', phone_number='اعظمی')
PhoneNumber.objects.create(customer=customer, title='c', phone_number='')
out = self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones, '+989120000001')
self.assertIn('ثابت=2', out) # 02112345678 + 57387608
self.assertIn('نامعتبر=2', out) # '0' + 'اعظمی' (ردیف خالی شمرده نمی‌شود)
def test_source_fields_and_phone_rows_are_untouched(self):
customer = make_customer('ایزوله', address='تهران')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', phone2='02112345678')
row = make_phone(customer, '09120000002', title='موبایل')
self.run_cmd(apply=True)
customer.refresh_from_db()
row.refresh_from_db()
self.assertEqual(customer.phone1, '09120000001')
self.assertEqual(customer.phone2, '02112345678')
self.assertEqual(customer.name_family, 'ایزوله')
self.assertEqual(customer.address, 'تهران')
self.assertEqual(row.phone_number, '09120000002')
self.assertEqual(row.title, 'موبایل')
self.assertEqual(PhoneNumber.objects.filter(customer=customer).count(), 1)
def test_unchanged_rows_are_not_rewritten(self):
customer = make_customer('بدون تغییر')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', sms_primary_phones='+989120000001')
writes = []
original = QuerySet.bulk_update
def spy(self, objs, fields, batch_size=None):
writes.append(len(objs))
return original(self, objs, fields, batch_size)
with mock.patch.object(QuerySet, 'bulk_update', spy):
out = self.run_cmd(apply=True)
self.assertEqual(writes, []) # هیچ نوشتنی رخ نداد
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones, '+989120000001')
self.assertIn('بدون تغییر: 1', out)
def test_empty_result_never_erases_existing_value(self):
customer = make_customer('محافظت')
Customer.objects.filter(pk=customer.pk).update(
phone1='02112345678', sms_primary_phones='+989120000009')
out = self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones, '+989120000009')
self.assertIn('محافظت شد', out)
def test_idempotent_second_run_updates_nothing(self):
customer = make_customer('تکرار اجرا')
Customer.objects.filter(pk=customer.pk).update(phone1='09120000001')
self.run_cmd(apply=True)
first = self.stored()
out = self.run_cmd(apply=True, reset_checkpoint=True)
self.assertEqual(self.stored(), first)
self.assertIn('مشتریان به‌روزشده: 0', out)
class OverflowTests(CommandTestCase):
"""سرریز طول: truncate نمی‌شود، رکورد دست‌نخورده می‌ماند و در گزارش می‌آید."""
def test_overflow_leaves_customer_untouched(self):
numbers = ['09120000%03d' % i for i in range(1, 11)] # 10×13 = 139 > 100
customer = make_customer('سرریز')
Customer.objects.filter(pk=customer.pk).update(
phone1=numbers[0], phone2=numbers[1])
for number in numbers[2:]:
PhoneNumber.objects.create(customer=customer, title='t', phone_number=number)
out = self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(customer.sms_primary_phones, '')
self.assertIn(f'سرریز طول (>{FIELD_MAX_LENGTH} کاراکتر، دست‌نخورده): 1', out)
self.assertIn(f'شناسه‌های سرریز: {customer.id}', out)
def test_exactly_under_max_length_is_saved(self):
# 7 شماره × 13 کاراکتر + 6 کاما = 97 ≤ 100
numbers = ['09120000%03d' % i for i in range(1, 8)]
customer = make_customer('لبه طول')
Customer.objects.filter(pk=customer.pk).update(phone1=numbers[0])
for number in numbers[1:]:
PhoneNumber.objects.create(customer=customer, title='t', phone_number=number)
out = self.run_cmd(apply=True)
customer.refresh_from_db()
self.assertEqual(len(customer.sms_primary_phones), 97)
self.assertEqual(customer.sms_primary_phones.count(','), 6)
self.assertIn('سرریز طول', out)
class BatchAndCheckpointTests(CommandTestCase):
"""keyset pagination، batch اتمیک، و بازیابی از فایل وضعیت."""
def _customers_with_phone(self, count):
pks = []
for i in range(count):
customer = make_customer(f'مشتری {i}')
Customer.objects.filter(pk=customer.pk).update(phone1='09120%06d' % (i + 1))
pks.append(customer.pk)
return pks
def test_all_customers_covered_with_small_batches(self):
pks = self._customers_with_phone(7)
out = self.run_cmd(apply=True, batch_size=2)
self.assertEqual(
Customer.objects.filter(pk__in=pks).exclude(sms_primary_phones='').count(), 7)
self.assertIn('batchهای تکمیل‌شده: 4', out) # ۷ مشتری / ۲ = ۴ batch
def test_checkpoint_written_after_each_batch(self):
self._customers_with_phone(5)
self.run_cmd(apply=True, batch_size=2)
data = json.loads(self.checkpoint.read_text(encoding='utf-8'))
self.assertEqual(data['last_id'], Customer.objects.order_by('-id').first().pk)
self.assertEqual(data['batches'], 3)
self.assertTrue(data['applied'])
def test_resume_continues_from_checkpoint(self):
pks = self._customers_with_phone(4)
self.checkpoint.write_text(json.dumps({'last_id': pks[1]}), encoding='utf-8')
self.run_cmd(apply=True, resume=True)
self.assertEqual(Customer.objects.get(pk=pks[0]).sms_primary_phones, '')
self.assertEqual(
Customer.objects.filter(pk__in=pks[2:]).exclude(sms_primary_phones='').count(), 2)
def test_resume_without_checkpoint_fails(self):
with self.assertRaises(CommandError):
self.run_cmd(apply=True, resume=True)
def test_resume_with_invalid_checkpoint_fails(self):
self.checkpoint.write_text('{not json', encoding='utf-8')
with self.assertRaises(CommandError):
self.run_cmd(apply=True, resume=True)
def test_start_id_takes_precedence(self):
pks = self._customers_with_phone(4)
self.checkpoint.write_text(json.dumps({'last_id': 0}), encoding='utf-8')
self.run_cmd(apply=True, resume=True, start_id=pks[2])
self.assertEqual(Customer.objects.get(pk=pks[0]).sms_primary_phones, '')
self.assertEqual(Customer.objects.get(pk=pks[3]).sms_primary_phones,
'+989120000004')
def test_reset_checkpoint_restarts_from_beginning(self):
self._customers_with_phone(3)
self.run_cmd(apply=True, batch_size=1)
self.checkpoint.write_text(json.dumps({'last_id': 10**9}), encoding='utf-8')
self.run_cmd(apply=True, reset_checkpoint=True, batch_size=1)
data = json.loads(self.checkpoint.read_text(encoding='utf-8'))
self.assertEqual(data['batches'], 3) # از ابتدا شروع شد
def test_batch_failure_keeps_previous_batches_and_checkpoint(self):
pks = self._customers_with_phone(3)
original = QuerySet.bulk_update
calls = iter([1, 2])
def flaky(self, objs, fields, batch_size=None):
if next(calls, 2) == 2:
raise RuntimeError('boom')
return original(self, objs, fields, batch_size)
with mock.patch.object(QuerySet, 'bulk_update', flaky):
with self.assertRaises(CommandError):
self.run_cmd(apply=True, batch_size=1)
# batch اول commit شده، batch دوم rollback شده، مشتری سوم دست‌نخورده
self.assertEqual(Customer.objects.get(pk=pks[0]).sms_primary_phones,
'+989120000001')
self.assertEqual(Customer.objects.get(pk=pks[1]).sms_primary_phones, '')
self.assertEqual(Customer.objects.get(pk=pks[2]).sms_primary_phones, '')
data = json.loads(self.checkpoint.read_text(encoding='utf-8'))
self.assertEqual(data['last_id'], pks[0])
def test_resume_after_failure_completes_remaining(self):
pks = self._customers_with_phone(3)
original = QuerySet.bulk_update
calls = iter([1, 2])
def flaky(self, objs, fields, batch_size=None):
if next(calls, 2) == 2:
raise RuntimeError('boom')
return original(self, objs, fields, batch_size)
with mock.patch.object(QuerySet, 'bulk_update', flaky):
with self.assertRaises(CommandError):
self.run_cmd(apply=True, batch_size=1)
self.run_cmd(apply=True, resume=True, batch_size=1)
for pk in pks:
self.assertNotEqual(Customer.objects.get(pk=pk).sms_primary_phones, '')
class IntegrationAndEfficiencyTests(CommandTestCase):
"""سازگاری با مسیر پیامک موجود + جلوگیری از N+1."""
def test_panel_resolution_reads_back_aggregated_numbers(self):
customer = make_customer('گیرنده')
Customer.objects.filter(pk=customer.pk).update(
phone1='09120000001', phone2='09120000002')
self.run_cmd(apply=True)
customer.refresh_from_db()
# قالب ذخیره‌شده باید همان چیزی باشد که مسیر پیامک انتظار دارد.
self.assertEqual(resolve_recipients(customer),
['+989120000001', '+989120000002'])
def test_query_count_is_constant_per_batch(self):
for i in range(3):
customer = make_customer(f'کوئری {i}')
Customer.objects.filter(pk=customer.pk).update(phone1='09120%06d' % (i + 1))
for j in range(5):
PhoneNumber.objects.create(
customer=customer, title='t',
phone_number='09130%06d' % (i * 10 + j))
with self.assertNumQueries(3): # ۱ کوئری سقف دامنه + ۱ مشتریان + ۱ prefetch
self.run_cmd()
+6 -1
View File
@@ -7,7 +7,7 @@
from django.test import SimpleTestCase
from django.urls import reverse
# snapshot قطعی نام‌های مسیرهای اپ admin_panel (۷۲ مسیر)
# snapshot قطعی نام‌های مسیرهای اپ admin_panel (۷۷ مسیر)
EXPECTED_URL_NAMES = {
'index',
'p_login',
@@ -36,6 +36,7 @@ EXPECTED_URL_NAMES = {
'customerNazar',
'customerNewAction',
'customerEditAction',
'customerActionDelete',
'customerDel',
'customerFactors',
'customerFactor',
@@ -76,10 +77,12 @@ EXPECTED_URL_NAMES = {
'sms_settings',
'sms_templates',
'sms_template_edit',
'customerSmsHistory',
'sms_customer_toggle',
'sms_primary_toggle',
'sms_send_custom',
'sms_queue',
'sms_report',
'sms_queue_retry',
'sms_queue_approve',
'sms_queue_delete',
@@ -97,6 +100,7 @@ PARAMETERIZED = {
'customerNazar': {'c_id': 1},
'customerNewAction': {'c_id': 1},
'customerEditAction': {'c_id': 1, 'action_id': 1},
'customerActionDelete': {'c_id': 1, 'action_id': 1},
'customerDel': {'c_id': 1},
'customerFactors': {'c_id': 1},
'customerFactor': {'c_id': 1, 'f_id': 1},
@@ -124,6 +128,7 @@ PARAMETERIZED = {
'addSarresid': {'cs_id': 1},
'pardakhtNesiye': {'cs_id': 1},
'sms_template_edit': {'t_id': 1},
'customerSmsHistory': {'c_id': 1},
'sms_customer_toggle': {'c_id': 1},
'sms_primary_toggle': {'c_id': 1},
'sms_send_custom': {'c_id': 1},
+115
View File
@@ -9,6 +9,8 @@
هیچ پاسخی نباید کد ۵۰۰ داشته باشد.
"""
import json
import re
from html.parser import HTMLParser
from django.test import TestCase
from django.urls import reverse
@@ -224,7 +226,9 @@ class ViewSmokeTests(TestCase):
'phone': '09120000000', 'is_primary': 'true',
}),
('sms_send_custom', {'c_id': c.id}, POST, {'text': 'پیامک دودی'}),
('customerSmsHistory', {'c_id': c.id}, GET, None),
('sms_queue', {}, GET, None),
('sms_report', {}, GET, None),
('sms_queue_retry', {'q_id': self.sms_queue.id}, POST, None),
# در انتهای لیست: خروج از حساب، چون بعد از آن تمام درخواست‌ها بی‌اعتبار می‌شوند
('p_logout', {}, GET, None),
@@ -255,3 +259,114 @@ class ViewSmokeTests(TestCase):
f"داده‌اند: {failures}"
),
)
class _DivBalanceParser(HTMLParser):
"""شمارندهٔ عمق <div> با احترام به محتوای <script>/<style>.
نکته: HTMLParser محتوای script/style را متن خام می‌داند، پس `<div>` داخل
رشتهٔ جاوااسکریپت به‌اشتباه شمرده نمی‌شود — همان چیزی که شمارش متنی ساده
اشتباه می‌کند.
"""
def __init__(self):
super().__init__(convert_charrefs=True)
self.depth = 0
self.min_depth = 0
self.depth_at_body = None
def handle_starttag(self, tag, attrs):
if tag == 'div':
self.depth += 1
def handle_endtag(self, tag):
if tag == 'div':
self.depth -= 1
self.min_depth = min(self.min_depth, self.depth)
elif tag == 'body':
self.depth_at_body = self.depth
class BaseTemplateStructureTests(TestCase):
"""ساختار HTML قالب پایه.
چرا؟ قالب `base.html` یک `<div class="">` باز می‌کرد که هرگز بسته نمی‌شد.
مرورگر آن را در EOF خودکار می‌بست، پس هیچ خطایی دیده نمی‌شد؛ ولی همهٔ
صفحات HTML نامعتبر تولید می‌کردند و بازسازی DOM توسط جاوااسکریپت و
پارسرهای سخت‌گیر می‌توانست بشکند.
"""
URLS = ['/panel/', '/panel/customers/', '/panel/entezar/', '/panel/rezayat/',
'/panel/hesabdari/', '/panel/report/']
def setUp(self):
self.user = make_user('structureAdmin', superuser=True)
self.client.force_login(self.user)
def _parsed_pages(self):
"""صفحاتی که در محیط تست کد ۲۰۰ می‌دهند را پارس می‌کند.
برخی صفحات روی دیتابیس خالی خطای داخلی می‌دهند (باگ مستقل، پوشش‌داده‌شده
در تست دودی)؛ آن‌ها اینجا کنار گذاشته می‌شوند. برای اینکه تست بی‌اثر
نشود، تعداد صفحات بررسی‌شده assert می‌شود.
"""
parsed = []
for url in self.URLS:
response = self.client.get(url)
if response.status_code != 200:
continue
parser = _DivBalanceParser()
parser.feed(response.content.decode('utf-8', 'replace'))
parsed.append((url, parser))
return parsed
def test_every_page_has_balanced_divs(self):
"""در پایان سند، هیچ <div> بازی نباید باقی بماند."""
parsed = self._parsed_pages()
self.assertGreaterEqual(len(parsed), 5,
msg='صفحات کافی برای بررسی ساختار رندر نشدند')
for url, parser in parsed:
with self.subTest(url=url):
self.assertEqual(
parser.depth_at_body, 0,
msg='در %s هنگام </body> تعداد %d تگ <div> بسته‌نشده ماند'
% (url, parser.depth_at_body),
)
def test_no_stray_closing_div(self):
"""عمق هرگز نباید منفی شود؛ یعنی </div> اضافی هم وجود ندارد."""
parsed = self._parsed_pages()
self.assertGreaterEqual(len(parsed), 5)
for url, parser in parsed:
with self.subTest(url=url):
self.assertGreaterEqual(parser.min_depth, 0,
msg='در %s تگ </div> اضافی وجود دارد' % url)
def test_base_template_comments_are_single_line(self):
"""کامنت‌های {# ... #} باید تک‌خطی باشند.
موتور قالب جنگو (۳.۲) الگوی کامنت را بدون re.DOTALL می‌شناسد؛ کامنت
چندخطی حذف نمی‌شود و عیناً در HTML چاپ می‌شود — در همین اصلاح، یک
`<div class="">` داخل کامنت چندخطی، به‌عنوان تگ واقعی به خروجی اضافه
شده بود و تگ بستن را می‌بلعید.
"""
import io
import os
templates_root = os.path.join('admin_panel', 'templates')
offenders = []
for base, _dirs, files in os.walk(templates_root):
for name in files:
if not name.endswith('.html'):
continue
path = os.path.join(base, name)
text = io.open(path, encoding='utf-8', errors='replace').read()
for match in re.finditer(r'\{#', text):
tail = text[match.start():match.start() + 500]
line_end = tail.find('\n')
end = line_end if line_end > -1 else len(tail)
if tail.find('#}', 0, end) == -1:
offenders.append('%s:%d' % (
path, text[:match.start()].count('\n') + 1))
self.assertEqual(offenders, [],
msg='کامنت چندخطی در این قالب‌ها حذف نمی‌شود: %s' % offenders)
File diff suppressed because it is too large. Load diff