Compare commits
18
Commits
5c6069c3ef
..
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2e5d0bcdd3 | ||
|
|
fa73a734a0 | ||
|
|
99c25a8216 | ||
|
|
825f2a5973 | ||
|
|
8fd881e0ea | ||
|
|
f86d060e4d | ||
|
|
f8d768a724 | ||
|
|
534a84f977 | ||
|
|
2aee85593f | ||
|
|
1fd27d0445 | ||
|
|
7e5c83bea2 | ||
|
|
e3a6d1f9d4 | ||
|
|
1dea3509a7 | ||
|
|
69de29a8fa | ||
|
|
e9ffc11e44 | ||
|
|
b82a2f61a8 | ||
|
|
0fcb7632cb | ||
|
|
f273c83a5e |
No files matched your search
+66
@@ -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.
|
||||||
@@ -56,6 +56,12 @@ RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
|
|||||||
# کپی کردن و واگذاری مالکیت محیط مجازی به کاربر django
|
# کپی کردن و واگذاری مالکیت محیط مجازی به کاربر django
|
||||||
COPY --from=builder --chown=django:django /opt/venv /opt/venv
|
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 . .
|
COPY --chown=django:django . .
|
||||||
|
|
||||||
|
|||||||
+302
-25
@@ -1,11 +1,11 @@
|
|||||||
Project Root: khatibi
|
Project Root: khatibi
|
||||||
Generated At: 2026-10-10T06:32:47+00:00
|
Generated At: 2026-10-27T07:48:20+00:00
|
||||||
Python Files: 153
|
Python Files: 194
|
||||||
Django Files: 12
|
Django Files: 12
|
||||||
JavaScript/TypeScript Files: 14
|
JavaScript/TypeScript Files: 14
|
||||||
HTML Files: 54
|
HTML Files: 59
|
||||||
Total Files: 523
|
Total Files: 794
|
||||||
Total Directories: 74
|
Total Directories: 81
|
||||||
|
|
||||||
khatibi
|
khatibi
|
||||||
├── .cursor
|
├── .cursor
|
||||||
@@ -20,6 +20,10 @@ khatibi
|
|||||||
│ │ └── graphify.js
|
│ │ └── graphify.js
|
||||||
│ └── opencode.json
|
│ └── opencode.json
|
||||||
├── .run
|
├── .run
|
||||||
|
│ ├── delivery.pid
|
||||||
|
│ ├── scanner.pid
|
||||||
|
│ ├── web.pid
|
||||||
|
│ └── worker.pid
|
||||||
├── admin
|
├── admin
|
||||||
│ ├── migrations
|
│ ├── migrations
|
||||||
│ │ └── __init__.py
|
│ │ └── __init__.py
|
||||||
@@ -34,8 +38,14 @@ khatibi
|
|||||||
│ ├── management
|
│ ├── management
|
||||||
│ │ ├── commands
|
│ │ ├── commands
|
||||||
│ │ │ ├── __init__.py
|
│ │ │ ├── __init__.py
|
||||||
|
│ │ │ ├── cleanup_visit_dedup.py
|
||||||
|
│ │ │ ├── fix_customer_names.py
|
||||||
|
│ │ │ ├── fix_customer_phones.py
|
||||||
│ │ │ ├── gt_esh.py
|
│ │ │ ├── gt_esh.py
|
||||||
|
│ │ │ ├── normalize_customer_sms_phones.py
|
||||||
|
│ │ │ ├── recalc_last_bazdid.py
|
||||||
│ │ │ ├── send_daily_report.py
|
│ │ │ ├── send_daily_report.py
|
||||||
|
│ │ │ ├── sms_delivery.py
|
||||||
│ │ │ ├── sms_scan.py
|
│ │ │ ├── sms_scan.py
|
||||||
│ │ │ ├── sms_worker.py
|
│ │ │ ├── sms_worker.py
|
||||||
│ │ │ └── sqlite_db_backup.py
|
│ │ │ └── sqlite_db_backup.py
|
||||||
@@ -103,6 +113,25 @@ khatibi
|
|||||||
│ │ ├── 0060_sms_permission_label.py
|
│ │ ├── 0060_sms_permission_label.py
|
||||||
│ │ ├── 0061_sms_timing_and_primary.py
|
│ │ ├── 0061_sms_timing_and_primary.py
|
||||||
│ │ ├── 0062_sms_link_provider.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
|
│ │ └── __init__.py
|
||||||
│ ├── models
|
│ ├── models
|
||||||
│ │ ├── __init__.py
|
│ │ ├── __init__.py
|
||||||
@@ -117,13 +146,18 @@ khatibi
|
|||||||
│ │ └── users.py
|
│ │ └── users.py
|
||||||
│ ├── sms
|
│ ├── sms
|
||||||
│ │ ├── __init__.py
|
│ │ ├── __init__.py
|
||||||
|
│ │ ├── balance.py
|
||||||
│ │ ├── enqueue.py
|
│ │ ├── enqueue.py
|
||||||
|
│ │ ├── notices.py
|
||||||
|
│ │ ├── parts.py
|
||||||
|
│ │ ├── phone_cleanup.py
|
||||||
│ │ ├── phones.py
|
│ │ ├── phones.py
|
||||||
│ │ ├── recipients.py
|
│ │ ├── recipients.py
|
||||||
│ │ ├── render.py
|
│ │ ├── render.py
|
||||||
│ │ ├── rules.py
|
│ │ ├── rules.py
|
||||||
│ │ ├── scanner.py
|
│ │ ├── scanner.py
|
||||||
│ │ └── timing.py
|
│ │ ├── timing.py
|
||||||
|
│ │ └── triggers.py
|
||||||
│ ├── static
|
│ ├── static
|
||||||
│ │ └── admin_panel
|
│ │ └── admin_panel
|
||||||
│ │ ├── DataTables
|
│ │ ├── DataTables
|
||||||
@@ -208,7 +242,8 @@ khatibi
|
|||||||
│ │ ├── customer
|
│ │ ├── customer
|
||||||
│ │ │ ├── customerNazarInc.html
|
│ │ │ ├── customerNazarInc.html
|
||||||
│ │ │ └── nazar.html
|
│ │ │ └── nazar.html
|
||||||
│ │ ├── _customer_sms.html
|
│ │ ├── _customer_info.html
|
||||||
|
│ │ ├── _customer_phones.html
|
||||||
│ │ ├── ActionList.html
|
│ │ ├── ActionList.html
|
||||||
│ │ ├── base.html
|
│ │ ├── base.html
|
||||||
│ │ ├── baseHesabdari.html
|
│ │ ├── baseHesabdari.html
|
||||||
@@ -234,6 +269,7 @@ khatibi
|
|||||||
│ │ ├── customers.html
|
│ │ ├── customers.html
|
||||||
│ │ ├── customerSarresid.html
|
│ │ ├── customerSarresid.html
|
||||||
│ │ ├── customersBK.html
|
│ │ ├── customersBK.html
|
||||||
|
│ │ ├── customerSmsHistory.html
|
||||||
│ │ ├── entezar.html
|
│ │ ├── entezar.html
|
||||||
│ │ ├── entezarBK.html
|
│ │ ├── entezarBK.html
|
||||||
│ │ ├── financial_dashboard.html
|
│ │ ├── financial_dashboard.html
|
||||||
@@ -253,6 +289,7 @@ khatibi
|
|||||||
│ │ ├── reportCheckNesiye.html
|
│ │ ├── reportCheckNesiye.html
|
||||||
│ │ ├── rezayat.html
|
│ │ ├── rezayat.html
|
||||||
│ │ ├── sms_queue.html
|
│ │ ├── sms_queue.html
|
||||||
|
│ │ ├── sms_report.html
|
||||||
│ │ ├── sms_settings.html
|
│ │ ├── sms_settings.html
|
||||||
│ │ ├── sms_templates.html
|
│ │ ├── sms_templates.html
|
||||||
│ │ ├── store.html
|
│ │ ├── store.html
|
||||||
@@ -278,19 +315,33 @@ khatibi
|
|||||||
│ ├── admin.py
|
│ ├── admin.py
|
||||||
│ ├── apps.py
|
│ ├── apps.py
|
||||||
│ ├── context_processor.py
|
│ ├── context_processor.py
|
||||||
|
│ ├── name_fix.py
|
||||||
│ ├── services.py
|
│ ├── services.py
|
||||||
│ ├── signals.py
|
│ ├── signals.py
|
||||||
│ ├── tests.py
|
│ ├── tests.py
|
||||||
│ ├── urls.py
|
│ ├── urls.py
|
||||||
│ ├── views - Copy.py
|
│ ├── views - Copy.py
|
||||||
│ └── viewsBK.py
|
│ ├── viewsBK.py
|
||||||
|
│ └── visit_policy.py
|
||||||
├── data9
|
├── data9
|
||||||
|
│ ├── backup-20261020-180934.sqlite3
|
||||||
|
│ ├── backup-20261020-213406.sqlite3
|
||||||
|
│ ├── backup-20261020-213406.sqlite3-shm
|
||||||
|
│ ├── backup-20261020-213406.sqlite3-wal
|
||||||
│ ├── db2 (2).sqlite32
|
│ ├── db2 (2).sqlite32
|
||||||
│ ├── db2.sqlite32
|
│ ├── db2.sqlite32
|
||||||
│ ├── db222.sqlite3
|
│ ├── db222.sqlite3
|
||||||
│ ├── kt.sqlite3
|
│ ├── khatibi92669266_backups_db_backup_20261020_223011.sqlite3
|
||||||
│ ├── kt.sqlite3-shm
|
│ ├── khatibi92669266_backups_db_backup_20261020_223011.sqlite3-shm
|
||||||
│ └── kt.sqlite3-wal
|
│ ├── 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
|
├── graphify-out
|
||||||
│ ├── 2026-10-09
|
│ ├── 2026-10-09
|
||||||
│ │ ├── .graphify_analysis.json
|
│ │ ├── .graphify_analysis.json
|
||||||
@@ -299,67 +350,184 @@ khatibi
|
|||||||
│ │ ├── graph.json
|
│ │ ├── graph.json
|
||||||
│ │ ├── GRAPH_REPORT.md
|
│ │ ├── GRAPH_REPORT.md
|
||||||
│ │ └── manifest.json
|
│ │ └── 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
|
│ ├── cache
|
||||||
│ │ ├── ast
|
│ │ ├── ast
|
||||||
│ │ │ └── v0.9.82-s7
|
│ │ │ └── v0.9.82-s7
|
||||||
│ │ │ ├── 0075bdcd95747f7c750eba8757614aab71d4d8c77bd6764e4c5a98fe18dc8997.json
|
│ │ │ ├── 0075bdcd95747f7c750eba8757614aab71d4d8c77bd6764e4c5a98fe18dc8997.json
|
||||||
|
│ │ │ ├── 0175e34128b5ac5119a5da4cc53d889dce334d8f20357631d54627c53cae9b8e.json
|
||||||
|
│ │ │ ├── 01850b7fad89dcb9e521fceed2c41e64e9909a0f4c4a54d818d346ccf63bbc5d.json
|
||||||
|
│ │ │ ├── 01b87542be8c5f2850a08a631287f94a89184e186d5cfca4d585800f41ee0f5d.json
|
||||||
|
│ │ │ ├── 0317da4b3f4f0b0b5f6cf487567ec7e1b6f3bed2c6ad5cb19bd526a020521c10.json
|
||||||
|
│ │ │ ├── 0348dd4662ebd96572421864ce77a266334a327f8bcbdc237d54c313d116bafb.json
|
||||||
│ │ │ ├── 03c6fb41770a9293658a5db5af36f7e4afe64ae04b3ce8cc6c5874320706fd22.json
|
│ │ │ ├── 03c6fb41770a9293658a5db5af36f7e4afe64ae04b3ce8cc6c5874320706fd22.json
|
||||||
|
│ │ │ ├── 0400cc0eadd706ff70ef627ffe39f401fc72a591dcbcd5463fca07fc271f080d.json
|
||||||
│ │ │ ├── 0442dd7e8445ba796e02aaefde16760c8ed37f63359d4319498be512f60266bd.json
|
│ │ │ ├── 0442dd7e8445ba796e02aaefde16760c8ed37f63359d4319498be512f60266bd.json
|
||||||
│ │ │ ├── 056f0cb55bfd5a1ddf744c7c824c342048c1db47f3bb350030a1533ab56bf8d7.json
|
│ │ │ ├── 056f0cb55bfd5a1ddf744c7c824c342048c1db47f3bb350030a1533ab56bf8d7.json
|
||||||
|
│ │ │ ├── 05b753e15288fbd02b721b00cfd03c3a523e9e234420330b980a462a1de2dad6.json
|
||||||
|
│ │ │ ├── 07eb6ef411f8e9b78d19cfd5f262bfc9fc482701f0834c8936cbb5ba2b14efab.json
|
||||||
|
│ │ │ ├── 0b48631fc75356bef276f694d7db5b457bd2315410fd4538680612fe10b95eb2.json
|
||||||
│ │ │ ├── 0b8f8e3b6e4d84256e784dabb96f5646fa6e7295adbd20648c235e7821b4ca1d.json
|
│ │ │ ├── 0b8f8e3b6e4d84256e784dabb96f5646fa6e7295adbd20648c235e7821b4ca1d.json
|
||||||
│ │ │ ├── 0e6bfa570caca1f79f549f5cdc37f8bdf9c9b43a023ca28a8fcb83351389b399.json
|
│ │ │ ├── 0e6bfa570caca1f79f549f5cdc37f8bdf9c9b43a023ca28a8fcb83351389b399.json
|
||||||
│ │ │ ├── 100f37182d082767395fcd09f1ec937fd74e57ed039885843bf81d349c3fc1f5.json
|
│ │ │ ├── 100f37182d082767395fcd09f1ec937fd74e57ed039885843bf81d349c3fc1f5.json
|
||||||
|
│ │ │ ├── 10615f5a999e04257afc03cdc52e1b9e4e11ae7818d7c64ae13b976e3974feb4.json
|
||||||
|
│ │ │ ├── 11042a6b38137d4e725c18d536cde9c98652782cb58390aa6216dacad2d18cf5.json
|
||||||
|
│ │ │ ├── 1219157d5f2c0a61d4069d2e7067d2eaf1c6403fcd5965743d9a196fe4564184.json
|
||||||
|
│ │ │ ├── 1285cdf9b89689e3ac99cea19470a3c14fdbf3a9d1bb2cd8da2cfdbd42ca940f.json
|
||||||
│ │ │ ├── 128b2b616c097fbfbcbc3fddafc224df0919ba261bb5ded7bcafa8b445fe118b.json
|
│ │ │ ├── 128b2b616c097fbfbcbc3fddafc224df0919ba261bb5ded7bcafa8b445fe118b.json
|
||||||
│ │ │ ├── 12d922593c75865b8068057f9244ad61a5ee573b7f3f38a16c31fa83abb9d668.json
|
│ │ │ ├── 12d922593c75865b8068057f9244ad61a5ee573b7f3f38a16c31fa83abb9d668.json
|
||||||
|
│ │ │ ├── 13a39530fbb076496d510363b40bf16093d8d117751e7240bcc09a447bdace35.json
|
||||||
│ │ │ ├── 13ca1f37c3eea3c07228d2d98d47f7db6a9c1d8468b259651f3fea5419651569.json
|
│ │ │ ├── 13ca1f37c3eea3c07228d2d98d47f7db6a9c1d8468b259651f3fea5419651569.json
|
||||||
|
│ │ │ ├── 143902d3d7280d781e9f6a8e366068809dec67bd385462175012f9b5c072e470.json
|
||||||
|
│ │ │ ├── 14f64f9b156b6b520e7af189b303a2844728f3ab8bbe1e65fed49160b1431cb2.json
|
||||||
│ │ │ ├── 15be5091a5bfbf8f48c3f3ae344a980be5452eab00f054c001958aae96557514.json
|
│ │ │ ├── 15be5091a5bfbf8f48c3f3ae344a980be5452eab00f054c001958aae96557514.json
|
||||||
│ │ │ ├── 174e406c2649f2384921581cbf912945a95d54aab73707b9aa45752aaa7c54d7.json
|
│ │ │ ├── 174e406c2649f2384921581cbf912945a95d54aab73707b9aa45752aaa7c54d7.json
|
||||||
|
│ │ │ ├── 17850e40dfa0d02ec3b0d4b2e1f9b931fe6a3a90c6cd874dabeb9466bed5f1d1.json
|
||||||
│ │ │ ├── 183467d5c1ee7daac78dfb428bd335c17e17272bd4510358f38fc5924140c816.json
|
│ │ │ ├── 183467d5c1ee7daac78dfb428bd335c17e17272bd4510358f38fc5924140c816.json
|
||||||
│ │ │ ├── 1893253c5245ae073f9de9168d537384ab764b79d7b1631c785cd7335aab791b.json
|
│ │ │ ├── 1893253c5245ae073f9de9168d537384ab764b79d7b1631c785cd7335aab791b.json
|
||||||
|
│ │ │ ├── 1b244c373e08c304261f7f760687c7ebe0ba9c79e7ab7ea16c3fa4768da959f5.json
|
||||||
|
│ │ │ ├── 1ceebfc94adbc38aa951c83044b67943bc4032309ba3a61d9335dd833d49bbef.json
|
||||||
│ │ │ ├── 1d5a29a9dabb365c079039c788988636b66c3a4bd2dbe66b249df001c2b5396f.json
|
│ │ │ ├── 1d5a29a9dabb365c079039c788988636b66c3a4bd2dbe66b249df001c2b5396f.json
|
||||||
|
│ │ │ ├── 1d7a28f73bb52bbc018674a0c01405b7f395bcc5f340ecabe332e2fe440bcae8.json
|
||||||
│ │ │ ├── 1d9f15f04104af07c60349f21bcd9f6f2c0e65c915e3e9c69040a10197b0fa6f.json
|
│ │ │ ├── 1d9f15f04104af07c60349f21bcd9f6f2c0e65c915e3e9c69040a10197b0fa6f.json
|
||||||
│ │ │ ├── 1dd0c6958a307a1e4e59c24f20225292277585dd8652b35537ede94fc04807ee.json
|
│ │ │ ├── 1dd0c6958a307a1e4e59c24f20225292277585dd8652b35537ede94fc04807ee.json
|
||||||
|
│ │ │ ├── 1f7001563689c4ba77d24f98418fd10725419d45385094fd18d89f20573d6453.json
|
||||||
|
│ │ │ ├── 20652a8d348bf514ac266f30a6400f923674dae819d18046d008066943377804.json
|
||||||
│ │ │ ├── 21af53aa7322868a25b47458e59f339a8f6e58b7914fbe8e3389ab86e0b0b643.json
|
│ │ │ ├── 21af53aa7322868a25b47458e59f339a8f6e58b7914fbe8e3389ab86e0b0b643.json
|
||||||
│ │ │ ├── 22310d4d49f2beee611c83915933ea06e80ec562fd92c170345c556cd3772561.json
|
│ │ │ ├── 22310d4d49f2beee611c83915933ea06e80ec562fd92c170345c556cd3772561.json
|
||||||
│ │ │ ├── 2356cb9f067d43739312459bad2cb6d9ecbacac703e7e40a282d5b89d64332b3.json
|
│ │ │ ├── 2356cb9f067d43739312459bad2cb6d9ecbacac703e7e40a282d5b89d64332b3.json
|
||||||
|
│ │ │ ├── 23c92d4714bc2e410ae9267e6ea7c139d5b16215da917f9a89c44a29724c69d7.json
|
||||||
|
│ │ │ ├── 23da13b308596ede7678e92e57041bcecdd8e9baff04b759ddf9a69803dd790a.json
|
||||||
│ │ │ ├── 23f4e3a62e03a38743659d94dd1350d17775da8be9175846e4ff3f38fa87c515.json
|
│ │ │ ├── 23f4e3a62e03a38743659d94dd1350d17775da8be9175846e4ff3f38fa87c515.json
|
||||||
|
│ │ │ ├── 24508e7a9b6fa93cdd28b9436bdb55fa24ad8f324baa95adb3afd37e301af9ac.json
|
||||||
│ │ │ ├── 2501a9885d6fa5292276ee8cc7db63a9a3c08605f38d199d425d33f650dac35e.json
|
│ │ │ ├── 2501a9885d6fa5292276ee8cc7db63a9a3c08605f38d199d425d33f650dac35e.json
|
||||||
│ │ │ ├── 25dbf169bbd8ae50f7cc568b4dbb7d259eb993ccddc9dbb20db96018ed093f5a.json
|
│ │ │ ├── 25dbf169bbd8ae50f7cc568b4dbb7d259eb993ccddc9dbb20db96018ed093f5a.json
|
||||||
|
│ │ │ ├── 28b192ecdcd9b33d8e4980d5043b6b2bc59095df392e22bf44d2166f7fa6d5ba.json
|
||||||
│ │ │ ├── 28df8bbd275806fd77c086629211231bd1329fe8156f521b19b5c5979f0d3b51.json
|
│ │ │ ├── 28df8bbd275806fd77c086629211231bd1329fe8156f521b19b5c5979f0d3b51.json
|
||||||
│ │ │ ├── 294e2d390f56acc0445564d428d90c641d76496cbc457bcfb09876382e9d87ab.json
|
│ │ │ ├── 294e2d390f56acc0445564d428d90c641d76496cbc457bcfb09876382e9d87ab.json
|
||||||
|
│ │ │ ├── 2976c530804df2075019fedaf2b908eeeff37b2703310c7e031b653d1fec71e5.json
|
||||||
|
│ │ │ ├── 2c587e304ae13b0717d72f5099508220c82234a8a293219c2ed2c97df9152404.json
|
||||||
│ │ │ ├── 2f36d1565911fdcb414da716162085b0fdc4b92d9d2d3fbb9fecc403b1916766.json
|
│ │ │ ├── 2f36d1565911fdcb414da716162085b0fdc4b92d9d2d3fbb9fecc403b1916766.json
|
||||||
|
│ │ │ ├── 3089c169c5eb18e61b13a19751166813d18c7bbe35b938b2b149406ff349feda.json
|
||||||
|
│ │ │ ├── 3258762ed4d4077750967504aecb42df00c35a69571f5d4839d4cfebd9b1c838.json
|
||||||
|
│ │ │ ├── 3330ae8555dab8f7ff4e014183f014681feb3f40a0d8969f30a4b2e9658e27f8.json
|
||||||
│ │ │ ├── 338e7d5d2e7d3a7260ab74d9b7b19bbab6b9ce84e7036623060190d9e0cc4bcd.json
|
│ │ │ ├── 338e7d5d2e7d3a7260ab74d9b7b19bbab6b9ce84e7036623060190d9e0cc4bcd.json
|
||||||
|
│ │ │ ├── 33b32e27be802f61375110f7f4ac9419fd4eb633523e01e31774b874448849c1.json
|
||||||
│ │ │ ├── 3614ae46baf3e1b6efa17011c37407a5d2931aba1886d8f8bdf8e4e154ab6c3f.json
|
│ │ │ ├── 3614ae46baf3e1b6efa17011c37407a5d2931aba1886d8f8bdf8e4e154ab6c3f.json
|
||||||
|
│ │ │ ├── 370c10e9d6f01aa67799b1f2191d5749a69ce4541aa55cbf4a28d45732bd641b.json
|
||||||
|
│ │ │ ├── 373e16b6c6996757d88a6ac751cd44028efa64701d746f8536819889417125ff.json
|
||||||
|
│ │ │ ├── 38980449465279974120694e1c667f229049f75d656fe518196d9cadc2429155.json
|
||||||
|
│ │ │ ├── 3a341a98aef632503bf2dc67ad87833e604c9aabe7ff69f5bcff7b54d6fe6407.json
|
||||||
|
│ │ │ ├── 3ba0d4c75ab8bfa5bc2a60dccb74197cb94bd161e526e54770a9b0a2aa757806.json
|
||||||
|
│ │ │ ├── 3c9f8987dc7426b442fe2a90c7de5d909fc85988e172e7722c11f24a2c331481.json
|
||||||
|
│ │ │ ├── 3d94db4e528b0e06bb975a12c71733767fe57307bb6e3de7c6ce65721e097541.json
|
||||||
│ │ │ ├── 3ff644065147b53af40ea703202c0fd832114936fe67e6c9a30d15e3da915455.json
|
│ │ │ ├── 3ff644065147b53af40ea703202c0fd832114936fe67e6c9a30d15e3da915455.json
|
||||||
│ │ │ ├── 40e7fbe5e765171201ab8016acce76a28304e1339d9aeb5a9cc18da87c5604d2.json
|
│ │ │ ├── 40e7fbe5e765171201ab8016acce76a28304e1339d9aeb5a9cc18da87c5604d2.json
|
||||||
|
│ │ │ ├── 4162977f2c2251e7a8b331d7229bd43dff56df31356191b19886b5bf5d56377d.json
|
||||||
│ │ │ ├── 41952e7c846da15fe658603ff001dafdb0e12d3372a7f0306adfa3a71de8bee7.json
|
│ │ │ ├── 41952e7c846da15fe658603ff001dafdb0e12d3372a7f0306adfa3a71de8bee7.json
|
||||||
|
│ │ │ ├── 4204828f3cbb3465c469e28345e0fc4d7ff9a84e30e3dd9f00ab4dbe27014e0d.json
|
||||||
|
│ │ │ ├── 435b8e433cd2f09f7b81717214592f9bfadd8edd8177adcabd4338ce803855d2.json
|
||||||
|
│ │ │ ├── 44fd8135217bc689f0886e5bd75458999e67ea57252445884c2822fff306312e.json
|
||||||
│ │ │ ├── 458c1b9a3ce257e789f75305939ab2e79029c557657102eebf2082e50a47a0e5.json
|
│ │ │ ├── 458c1b9a3ce257e789f75305939ab2e79029c557657102eebf2082e50a47a0e5.json
|
||||||
│ │ │ ├── 45f7e59ef3f291171180b6763e8da408d8b7579bb7cb96dd4ca859e48aa5ce14.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
|
│ │ │ ├── 52608b276c6f0a2f190186e5bac578715ad888ff5ba3c10ff30879c3baf9d9ce.json
|
||||||
|
│ │ │ ├── 527de91bd8bbc5a7ab79951457a9f192909faa9bbf02aaec72bb3d26e2298b57.json
|
||||||
│ │ │ ├── 5316515ee7fc3e1038e676b361d9028edc735993c3d34791a77a14503deb064d.json
|
│ │ │ ├── 5316515ee7fc3e1038e676b361d9028edc735993c3d34791a77a14503deb064d.json
|
||||||
|
│ │ │ ├── 53bcc38a002a291b8a370a1c24dde42e704cbda5d409d77b8405599e45844cae.json
|
||||||
|
│ │ │ ├── 559fbbe72061ed129b192884f1f2b9c58d23f2af199cd408aa95d7c5af2753ef.json
|
||||||
│ │ │ ├── 5730d72cc177474584197921cce656696e3177780028c4629950f5514b530c6d.json
|
│ │ │ ├── 5730d72cc177474584197921cce656696e3177780028c4629950f5514b530c6d.json
|
||||||
│ │ │ ├── 57a18b5350b4a567305ca01b2951efee6eeb3b289b5ffbbf390c3962ff29d61c.json
|
│ │ │ ├── 57a18b5350b4a567305ca01b2951efee6eeb3b289b5ffbbf390c3962ff29d61c.json
|
||||||
│ │ │ ├── 58ad02e0930221b4f44603dbcf01d3b5d07d9da2772edafe48a94a9894ea148a.json
|
│ │ │ ├── 58ad02e0930221b4f44603dbcf01d3b5d07d9da2772edafe48a94a9894ea148a.json
|
||||||
│ │ │ ├── 58bfae9cf8467d2bb9363884d517e98cae38a934f4c474e9e02aed520fdaab95.json
|
│ │ │ ├── 58bfae9cf8467d2bb9363884d517e98cae38a934f4c474e9e02aed520fdaab95.json
|
||||||
│ │ │ ├── 58f2e3419fb2de4a3bdc4a9c0bf48e50f2cc225506096109dbf2b9bfe4778bb5.json
|
│ │ │ ├── 58f2e3419fb2de4a3bdc4a9c0bf48e50f2cc225506096109dbf2b9bfe4778bb5.json
|
||||||
│ │ │ ├── 5901400fc36893a9ad85acd97eb73b691cb4b8d1440047c5f85c1534a2c7e492.json
|
│ │ │ ├── 5901400fc36893a9ad85acd97eb73b691cb4b8d1440047c5f85c1534a2c7e492.json
|
||||||
|
│ │ │ ├── 59dd2e5089bebfb0397e9c492c890c619fcaa4d73b9d035e533320f276e1ebf9.json
|
||||||
|
│ │ │ ├── 5a15a341e370fb512c0b3f5ae1c30ec0d8a6729a690f286369015d107210124e.json
|
||||||
|
│ │ │ ├── 5b59421d9713dc21f9f77603d9708edd8c3eb8ba198636f80f1cedcc79ffcaca.json
|
||||||
│ │ │ ├── 5b63b5d7fc7a09b2dbf5e2f7db6fe00ccab773762b3291bd666c8e29d32100d3.json
|
│ │ │ ├── 5b63b5d7fc7a09b2dbf5e2f7db6fe00ccab773762b3291bd666c8e29d32100d3.json
|
||||||
|
│ │ │ ├── 5c8593cf08ce32f0c569aacfaf83b8baeb352934f6f8749aa4f652d5ce2acff1.json
|
||||||
|
│ │ │ ├── 5c922734de6f6345b5230507bee5c43dc284c308901e84846666b939493e6258.json
|
||||||
│ │ │ ├── 5ce9ee869c507986bf00ae6929f3aae3ab7aa58b5c2bded4965374fcf7f5654b.json
|
│ │ │ ├── 5ce9ee869c507986bf00ae6929f3aae3ab7aa58b5c2bded4965374fcf7f5654b.json
|
||||||
│ │ │ ├── 5d5b6249e3cfa0aeee94ba2053fc73b4b7b5b8fa1d21df09d40bda7c90ef273d.json
|
│ │ │ ├── 5d5b6249e3cfa0aeee94ba2053fc73b4b7b5b8fa1d21df09d40bda7c90ef273d.json
|
||||||
|
│ │ │ ├── 5d994876cad71133f4bf804932fb2604ffdc8bb8cc434ca1434667ef789144e7.json
|
||||||
|
│ │ │ ├── 5e19aa3aba5509cd48a9a93b39db071cfc2c2728ccae46b34caa0e214cc6be01.json
|
||||||
|
│ │ │ ├── 5f050da3769e151e52138ee1ea5dcbcb6160cb57952c75665e607628d0e08d67.json
|
||||||
|
│ │ │ ├── 5f858ab6d9f90e0f41617273b6f132af3f76f520deafb8d612adce373875e768.json
|
||||||
|
│ │ │ ├── 5fe315e6417b8eb8b26079139d8bbe46ddaaf7cd67b078d927ea79d3815be453.json
|
||||||
│ │ │ ├── 60002a01d6fc22147e2994d1a1a447d5e577c02aed2443789af20571ec2d2a19.json
|
│ │ │ ├── 60002a01d6fc22147e2994d1a1a447d5e577c02aed2443789af20571ec2d2a19.json
|
||||||
│ │ │ ├── 60e00560038df059b1696e54dcf055cd658677d6e1201570a8500531addc0ac6.json
|
│ │ │ ├── 60e00560038df059b1696e54dcf055cd658677d6e1201570a8500531addc0ac6.json
|
||||||
|
│ │ │ ├── 611c158815bdf3dbec9f5a5c01bce751fcd07db536e9bbaba2b2d232f82f5ae6.json
|
||||||
|
│ │ │ ├── 62d88411a61ee9d3b60dda6c4febf33539b8b9e8226b5d2b9205f8e2b0c4478a.json
|
||||||
│ │ │ ├── 63c38f2a8abe98c0d1e9cb5b7d9fd0451e1e46c2bcbf1d2c3b241b263ac0a9cd.json
|
│ │ │ ├── 63c38f2a8abe98c0d1e9cb5b7d9fd0451e1e46c2bcbf1d2c3b241b263ac0a9cd.json
|
||||||
│ │ │ ├── 6448d65fdcfe330b5d4278c8d1540e7b075238672b8101f9d2e1c4052f7c9c49.json
|
│ │ │ ├── 6448d65fdcfe330b5d4278c8d1540e7b075238672b8101f9d2e1c4052f7c9c49.json
|
||||||
│ │ │ ├── 64fc04d8c553b2121a71955d48257160a40f6dd34258e3287945873f02d897dc.json
|
│ │ │ ├── 64fc04d8c553b2121a71955d48257160a40f6dd34258e3287945873f02d897dc.json
|
||||||
│ │ │ ├── 65d5139792e0ee840c5b1710d7659ecfb5dbdcadbd02d205f7517a6a3a374211.json
|
│ │ │ ├── 65d5139792e0ee840c5b1710d7659ecfb5dbdcadbd02d205f7517a6a3a374211.json
|
||||||
|
│ │ │ ├── 6603c5eb7403f7426c429341d43018fdffcb3430f22972c426ac43956d229b33.json
|
||||||
|
│ │ │ ├── 6648bc2b25d0bd25846d48f406d3e9a6f89677542600e9f3f57533747ed9b08c.json
|
||||||
|
│ │ │ ├── 6691dea01045e5561ac1c72f902f96ba84564c221498829443f793fee8784021.json
|
||||||
|
│ │ │ ├── 67b4e119f02b3ed94553e526bbd33cddff90053edb27438e472409b2ca5ad9a0.json
|
||||||
|
│ │ │ ├── 6805914035b171d32a1b80948179da15f78c5741e5a80b216d51a6586185c0c3.json
|
||||||
│ │ │ ├── 6876f75a9cb4a5f5857c47e3b0d6b38e51941aff76bc6d92cb1b4eef1c51071e.json
|
│ │ │ ├── 6876f75a9cb4a5f5857c47e3b0d6b38e51941aff76bc6d92cb1b4eef1c51071e.json
|
||||||
│ │ │ ├── 6a88f82e5b9f9da12b50f8531eac30c10e1c2a0cf39601d275fd90ee3e28da55.json
|
│ │ │ ├── 6a88f82e5b9f9da12b50f8531eac30c10e1c2a0cf39601d275fd90ee3e28da55.json
|
||||||
│ │ │ ├── 6aca679f90689aa4c275389c8b4e2462a9456775e8b124071070af2c988ca0fc.json
|
│ │ │ ├── 6aca679f90689aa4c275389c8b4e2462a9456775e8b124071070af2c988ca0fc.json
|
||||||
|
│ │ │ ├── 6afa6136d9df8317bdd8d49f4109412776deb21ba123fdd2a97331b400a0230d.json
|
||||||
|
│ │ │ ├── 6bfbb9eed6842bf331dec78724d7e740919c76345b54be844964f44640482a87.json
|
||||||
|
│ │ │ ├── 6d026e901d3b2ff0cb9550c750966905afbbc681ba68db88e1de608fb2964495.json
|
||||||
│ │ │ ├── 6d4d7d7f829f13e46e4898aceb760d66d2255dc838eab0933f9a92d720f420a7.json
|
│ │ │ ├── 6d4d7d7f829f13e46e4898aceb760d66d2255dc838eab0933f9a92d720f420a7.json
|
||||||
|
│ │ │ ├── 6d556671b5632e29972dc09e345d68d522a5b3bcd2852b803d56668890fa46d7.json
|
||||||
|
│ │ │ ├── 6dcafcac3a0b169a08580cc4cb9196423dacfa51329841311665c363a97bc29e.json
|
||||||
│ │ │ ├── 6df9c1e88224e95c55dee4238fa91358360231ee47362294e884bc6e24d73612.json
|
│ │ │ ├── 6df9c1e88224e95c55dee4238fa91358360231ee47362294e884bc6e24d73612.json
|
||||||
│ │ │ ├── 6e262456570c174e207055c7c964fe85431addb0f59298b1e4d912500dfb23a3.json
|
│ │ │ ├── 6e262456570c174e207055c7c964fe85431addb0f59298b1e4d912500dfb23a3.json
|
||||||
│ │ │ ├── 6e2ed39911a83c75e432ffd0dab22fd095ce8c5bb186d6ab22d594375f3b32bc.json
|
│ │ │ ├── 6e2ed39911a83c75e432ffd0dab22fd095ce8c5bb186d6ab22d594375f3b32bc.json
|
||||||
|
│ │ │ ├── 6ed362dbf43e46eeb440246d52fdc4e0783c895114249ea33f3de7ddf6898a3a.json
|
||||||
|
│ │ │ ├── 6ee8ac22fd8b7d0152fe85c630c98fd9c7f1f74312b5f923dbebb3ff5367a71e.json
|
||||||
│ │ │ ├── 71a07328d56403d55714d76cefc05db3e68c6498719e629e4e76889a1940efc2.json
|
│ │ │ ├── 71a07328d56403d55714d76cefc05db3e68c6498719e629e4e76889a1940efc2.json
|
||||||
|
│ │ │ ├── 72577fde1eae8cf079aff518cecce910ac310cefcc038fbbcb0a5d11f20fa20d.json
|
||||||
│ │ │ ├── 73a129efd08cc38274f3c56503c234eef17f58faf74dadbdbbe475efcbfc2777.json
|
│ │ │ ├── 73a129efd08cc38274f3c56503c234eef17f58faf74dadbdbbe475efcbfc2777.json
|
||||||
│ │ │ ├── 7483cdf00a2d7de8809278d9dcdf2f2330354b02117952da4b9452d4bbd6b81e.json
|
│ │ │ ├── 7483cdf00a2d7de8809278d9dcdf2f2330354b02117952da4b9452d4bbd6b81e.json
|
||||||
│ │ │ ├── 74efb913c62b374d818cfc5af6d7ee9bb46966eb2bce0e26e0bba461683b98a7.json
|
│ │ │ ├── 74efb913c62b374d818cfc5af6d7ee9bb46966eb2bce0e26e0bba461683b98a7.json
|
||||||
@@ -369,107 +537,198 @@ khatibi
|
|||||||
│ │ │ ├── 767dd58146a5d4a713611561a9e5c1b706e5f509a5621891c9b2e195f3b8ee0a.json
|
│ │ │ ├── 767dd58146a5d4a713611561a9e5c1b706e5f509a5621891c9b2e195f3b8ee0a.json
|
||||||
│ │ │ ├── 77a1520156879de714ee872c29b1387967bcc5ce470b47d37087ea2a110f3875.json
|
│ │ │ ├── 77a1520156879de714ee872c29b1387967bcc5ce470b47d37087ea2a110f3875.json
|
||||||
│ │ │ ├── 780977bca042ffdde1cca2811a3a46c36bd3fcff2723c94ac527428113131c64.json
|
│ │ │ ├── 780977bca042ffdde1cca2811a3a46c36bd3fcff2723c94ac527428113131c64.json
|
||||||
|
│ │ │ ├── 784dd791c21e8837a3e925331cf234b2138ded3d2012968739604d5535a18e09.json
|
||||||
|
│ │ │ ├── 78d30d0a40b28969d64653d2508fd53e53709b95a45f3e380ebd6c7aff04ace9.json
|
||||||
|
│ │ │ ├── 79ffc45a7139464dd6c7b1fc6f1f0f9c44347fbd7dcee92c6d4b63525424c442.json
|
||||||
│ │ │ ├── 7be7f428e6acfe4c99370707cc7de9253f801feff1564088f2584d5dc8c42a89.json
|
│ │ │ ├── 7be7f428e6acfe4c99370707cc7de9253f801feff1564088f2584d5dc8c42a89.json
|
||||||
|
│ │ │ ├── 7bf404104bb32fc04568c2d287891fa69955ac3f46718c99dcca64a4bfff6fe3.json
|
||||||
│ │ │ ├── 7c4fc90402a7836b364425c33cc2ffc98e7634391ebe78143df03c88945d8988.json
|
│ │ │ ├── 7c4fc90402a7836b364425c33cc2ffc98e7634391ebe78143df03c88945d8988.json
|
||||||
|
│ │ │ ├── 7d106c54b917d9e26357fa71aa871e94cb99c940b6c48808e93cd57415da91e3.json
|
||||||
|
│ │ │ ├── 7d59da18a8b644e48a164eb8a764efc9f4c3538b99d41c8e93ce38cc5556ba05.json
|
||||||
│ │ │ ├── 7e9bad82d0eb642b739dcf11e86c2fcf2005dfb12c94478af143deb9a8129bfa.json
|
│ │ │ ├── 7e9bad82d0eb642b739dcf11e86c2fcf2005dfb12c94478af143deb9a8129bfa.json
|
||||||
│ │ │ ├── 8055bf9fe36a9fa183d0c5dc152684e65410d58c5634e544e8f38f6c9216f6ad.json
|
│ │ │ ├── 8055bf9fe36a9fa183d0c5dc152684e65410d58c5634e544e8f38f6c9216f6ad.json
|
||||||
|
│ │ │ ├── 81d6d00c4c975b3289ac212d355856c3d6e60bccde0780fe2e3fc8cac31f3c19.json
|
||||||
│ │ │ ├── 82833f6235cb6559bad38e93372d42284eb4e9097e90519337266113da2495bf.json
|
│ │ │ ├── 82833f6235cb6559bad38e93372d42284eb4e9097e90519337266113da2495bf.json
|
||||||
│ │ │ ├── 828dacee98d6f71fcf53c8a051b3bf1bfc9d94c272a79ed8539801e3fb90b3df.json
|
│ │ │ ├── 828dacee98d6f71fcf53c8a051b3bf1bfc9d94c272a79ed8539801e3fb90b3df.json
|
||||||
|
│ │ │ ├── 82916053b0e3cfa286347ea0a7101f2d06678bd28b8b8d8fe955d11bcb7a43aa.json
|
||||||
|
│ │ │ ├── 837801d7d0e218e49de562a7e03711e75941d42ce5cc2f77552bc6293a45a4e8.json
|
||||||
│ │ │ ├── 84281ba94e70a71d52b5179cf2e933f8412da3a9eaf5e7177b815f8fadd0afc5.json
|
│ │ │ ├── 84281ba94e70a71d52b5179cf2e933f8412da3a9eaf5e7177b815f8fadd0afc5.json
|
||||||
│ │ │ ├── 846ba1087a1ee6b5cda2ebdf22d0bc61ad9175b21aba29783429277288dbfaaf.json
|
│ │ │ ├── 846ba1087a1ee6b5cda2ebdf22d0bc61ad9175b21aba29783429277288dbfaaf.json
|
||||||
|
│ │ │ ├── 84cef5656079ececae35930e1b26620186b50f25fd977c569537daad2d59db86.json
|
||||||
│ │ │ ├── 86e57806cd08cf765ce1f56f0638dd321e93c653bb6613aa35d7ad375808433c.json
|
│ │ │ ├── 86e57806cd08cf765ce1f56f0638dd321e93c653bb6613aa35d7ad375808433c.json
|
||||||
|
│ │ │ ├── 881adf7185e68d203906537117de576a11fba814941cf9eeedd0dfac2d65e536.json
|
||||||
│ │ │ ├── 88e349e879d601e1f5c75f3b019ffb4958e90639317ba893c54f82b0cc9066c2.json
|
│ │ │ ├── 88e349e879d601e1f5c75f3b019ffb4958e90639317ba893c54f82b0cc9066c2.json
|
||||||
|
│ │ │ ├── 8a70e1324d7f834d2c41a7c3b4cbb3b8ccad92d413970316bc95e13f5132ff76.json
|
||||||
|
│ │ │ ├── 8d658a3a8b1ae03cbc881e3c47cf2cfe111f9be2b564fb3739cf3d9367845a8b.json
|
||||||
│ │ │ ├── 8ffb83ce6f13d2f97d0197c7381748e9b66956c13f0158bc519350b7dd1b9ad0.json
|
│ │ │ ├── 8ffb83ce6f13d2f97d0197c7381748e9b66956c13f0158bc519350b7dd1b9ad0.json
|
||||||
│ │ │ ├── 908e0129cefe129d0b562243460fe20793c84876244cef2e99ca1becf8cf6a1f.json
|
│ │ │ ├── 908e0129cefe129d0b562243460fe20793c84876244cef2e99ca1becf8cf6a1f.json
|
||||||
|
│ │ │ ├── 909129924b48dede801eb946cf98bb93003ab8116be2b6acbd2f7fe8dc166358.json
|
||||||
|
│ │ │ ├── 92ecdeb228d91f4adb6c1e9bfd1b3f0eea65faec8dbcb27fca3211d1d264cb46.json
|
||||||
│ │ │ ├── 940d0349821b0fb7f2c3effcb81fd13bb1c046daa6f6c5f2cd1b157058c55877.json
|
│ │ │ ├── 940d0349821b0fb7f2c3effcb81fd13bb1c046daa6f6c5f2cd1b157058c55877.json
|
||||||
│ │ │ ├── 957f37be1d5d6a5207f90ad07704f8423c915c5bcdfcd130acc85a388fc89d19.json
|
│ │ │ ├── 957f37be1d5d6a5207f90ad07704f8423c915c5bcdfcd130acc85a388fc89d19.json
|
||||||
|
│ │ │ ├── 95e88ece49092778e7709f6b87db4c05dd055b838cfdf20d7d4705b6373739ba.json
|
||||||
│ │ │ ├── 96c3ba545db191ae5811d5dfdde74e7c6396a932b759513c94160cb7b7c81fc8.json
|
│ │ │ ├── 96c3ba545db191ae5811d5dfdde74e7c6396a932b759513c94160cb7b7c81fc8.json
|
||||||
|
│ │ │ ├── 96f5469edd566b92d9d38423a27779142fbe2b77cfc9d85005d43ffc99ce3de1.json
|
||||||
│ │ │ ├── 9766508e5a013c3d3cbb2602719391199e90af5720c9782a77ca71565aa346b1.json
|
│ │ │ ├── 9766508e5a013c3d3cbb2602719391199e90af5720c9782a77ca71565aa346b1.json
|
||||||
│ │ │ ├── 9880af8b991c19abe5ed019ad7b7291b8b281ed9dcb894a00c3fd8259a59b4a4.json
|
│ │ │ ├── 9880af8b991c19abe5ed019ad7b7291b8b281ed9dcb894a00c3fd8259a59b4a4.json
|
||||||
│ │ │ ├── 996411678d23c3cf8a0e6c1c5076701e8bf5f3dad21ca907ec4116d15366a668.json
|
│ │ │ ├── 996411678d23c3cf8a0e6c1c5076701e8bf5f3dad21ca907ec4116d15366a668.json
|
||||||
|
│ │ │ ├── 9b2fd03f2769231e4c207b2f0ee915e3b5eb050232f2fe6c59ddb01904976650.json
|
||||||
|
│ │ │ ├── 9c2c2f6f8d4d4c3a9a60da3ed38a26dc789e8cfaff5d46d140d2f208e5fef3c3.json
|
||||||
│ │ │ ├── 9cfb6e4f7b08a863675af032e7823c0523170f5201e686c5ef72b39c04b07a12.json
|
│ │ │ ├── 9cfb6e4f7b08a863675af032e7823c0523170f5201e686c5ef72b39c04b07a12.json
|
||||||
│ │ │ ├── 9eabdb0cacba38c8fb6b3e777932e06bd82172cdc0bcccf2fc0bfc23b5bd4974.json
|
│ │ │ ├── 9eabdb0cacba38c8fb6b3e777932e06bd82172cdc0bcccf2fc0bfc23b5bd4974.json
|
||||||
|
│ │ │ ├── 9ef7cb42412a83490d3e54c81d4e7fa58db25253eb50a41d97d5d4064df0dfe2.json
|
||||||
|
│ │ │ ├── a186e74ebd87e23212ffe7fd72c40e9383c0624a3efdb2fe1e3271d9ea96d9b9.json
|
||||||
│ │ │ ├── a31ab0e36b30049a602cc060d77c0715187f7c3838db91b8c20bfaa802f49899.json
|
│ │ │ ├── a31ab0e36b30049a602cc060d77c0715187f7c3838db91b8c20bfaa802f49899.json
|
||||||
|
│ │ │ ├── a43d68ff03b49e9153a73777c0bde346a6b1969f640d67eae500d60d410a02c0.json
|
||||||
|
│ │ │ ├── a7c605f57dd37c8725a92f08d4fe18701628701fa986cbb98d3a4aeb3a74abbe.json
|
||||||
│ │ │ ├── a823c9c28027c8d525714e6571bc3f3ca38f3bd0420aaf4f4921067cf0672475.json
|
│ │ │ ├── a823c9c28027c8d525714e6571bc3f3ca38f3bd0420aaf4f4921067cf0672475.json
|
||||||
│ │ │ ├── a8311f6e51027ea4606e35bf14d50edc1795e71b2d63cddeae8c7bb7ece215b8.json
|
│ │ │ ├── a8311f6e51027ea4606e35bf14d50edc1795e71b2d63cddeae8c7bb7ece215b8.json
|
||||||
|
│ │ │ ├── aabf6dbb2202699bb1b06fd582c88465b9cf2b8cc060bda2e2bc0c67fc493bed.json
|
||||||
|
│ │ │ ├── ab5d0682afc0714c24b9ac5fda36b243c638d272ea973f46a5c18e783132c861.json
|
||||||
│ │ │ ├── add004e78a62164d7565c102eb825debea20811f7fe76afa0567a1b6b289f264.json
|
│ │ │ ├── add004e78a62164d7565c102eb825debea20811f7fe76afa0567a1b6b289f264.json
|
||||||
|
│ │ │ ├── adda28366431a09f735c806811acad036f33199438c7679d275e3c80714b9a80.json
|
||||||
│ │ │ ├── aeaae7b60339b1283cab517b4ab42806c64933c272d007a68431988ba8e0edb5.json
|
│ │ │ ├── aeaae7b60339b1283cab517b4ab42806c64933c272d007a68431988ba8e0edb5.json
|
||||||
|
│ │ │ ├── af128ca7fc8d02ae40fff36925a5b96034862ce0d581e22a8a0c88f41040e526.json
|
||||||
|
│ │ │ ├── b24556e20d540fd63de3dc04501ffd021836b930c4ebc3ff309f7950ef17a335.json
|
||||||
│ │ │ ├── b26c22033963df1727407c1fa6c79d8241bfc16056e7a8d3c4383fb2d050d3cd.json
|
│ │ │ ├── b26c22033963df1727407c1fa6c79d8241bfc16056e7a8d3c4383fb2d050d3cd.json
|
||||||
│ │ │ ├── b26e251bde84a040dbb2d1a4f700ebcd761f51a124a98a104704e82537e320eb.json
|
│ │ │ ├── b26e251bde84a040dbb2d1a4f700ebcd761f51a124a98a104704e82537e320eb.json
|
||||||
│ │ │ ├── b34cb0a1a28e753a900b3d23f01d3810f9c06635b0650d34be4ec9d98daa8fbb.json
|
│ │ │ ├── b34cb0a1a28e753a900b3d23f01d3810f9c06635b0650d34be4ec9d98daa8fbb.json
|
||||||
│ │ │ ├── b543952627caaf0a5c52bec09b33fae93443fca7234365680bbe75acc260dd1c.json
|
│ │ │ ├── b543952627caaf0a5c52bec09b33fae93443fca7234365680bbe75acc260dd1c.json
|
||||||
│ │ │ ├── b59999c2fd322c241c7bd37e6ed0a95c9124cbb79f8424f1fa7cb2e92fe63817.json
|
│ │ │ ├── b59999c2fd322c241c7bd37e6ed0a95c9124cbb79f8424f1fa7cb2e92fe63817.json
|
||||||
│ │ │ ├── b82d5f6840b4930eb62fdb1c7b3a58124fff805e529ede7684516a65322fcae0.json
|
│ │ │ ├── b82d5f6840b4930eb62fdb1c7b3a58124fff805e529ede7684516a65322fcae0.json
|
||||||
|
│ │ │ ├── b87a932e418a18531d61dc15776db652401e7cf1682dead02abdf50e2cd00530.json
|
||||||
|
│ │ │ ├── b9b878bef7c0ae7d407a42c797a4697990237971be65a5d01a6c7b9b444a2a9a.json
|
||||||
|
│ │ │ ├── b9f8ea31056fe0c0fc40a84640c58f29895312c65bf694567487204d8f1170e9.json
|
||||||
│ │ │ ├── bb140cfe12cfb3e32dc9815393035fc33c7649c2faeeccb82cdee56a930ea635.json
|
│ │ │ ├── bb140cfe12cfb3e32dc9815393035fc33c7649c2faeeccb82cdee56a930ea635.json
|
||||||
|
│ │ │ ├── bb74cda4073a6da7a4b60fecfb3bb40796a51ceafcbdd128d60e5ce23fa4f319.json
|
||||||
|
│ │ │ ├── bc24ddb05a8aa685edc1376cbd110423adf05bcc488fb97a30fe286e7e74c2da.json
|
||||||
|
│ │ │ ├── bc6f93c7938b3565d50cdfc4abe4fd62f0739fd6299f35d7c50075cd860cab58.json
|
||||||
│ │ │ ├── bcea7c584e5031a9c5734144f8169d016ef1ed316e6f4827609509ba2a79d3eb.json
|
│ │ │ ├── bcea7c584e5031a9c5734144f8169d016ef1ed316e6f4827609509ba2a79d3eb.json
|
||||||
|
│ │ │ ├── bd00f0b0db2eb10f7e889df5a0f08994e8c1eaa0eb69be8398e45e0e634724fd.json
|
||||||
│ │ │ ├── bd6e156d8e427b14676b4707710f2b340026e679cb7bd29b22b247a4b637e7bd.json
|
│ │ │ ├── bd6e156d8e427b14676b4707710f2b340026e679cb7bd29b22b247a4b637e7bd.json
|
||||||
│ │ │ ├── be1200d7c9b2881ba54c7fa95daf5f3e2ce993619b974c7760a9d44a416e00c0.json
|
│ │ │ ├── be1200d7c9b2881ba54c7fa95daf5f3e2ce993619b974c7760a9d44a416e00c0.json
|
||||||
|
│ │ │ ├── be72e639c12e860a2120c3ecf96b94c86e5c69b2f1f0715cd2804d0475409cd6.json
|
||||||
|
│ │ │ ├── c12baf851ec40542280cb62d2f878d5e7383357365281938cfb55a64c08a9a10.json
|
||||||
|
│ │ │ ├── c36b696b57c1deb51e47a057b32d1dd75e3f1560e83931aab1f8ba86abcc1543.json
|
||||||
|
│ │ │ ├── c3c6651e6b7dd802c31efb56ac20c1f1ba3c4c0108599f1480c6a143b2e688ef.json
|
||||||
│ │ │ ├── c46ad3fc8fd3db1315ab2e40add760b44e8f98c24c79e334c342c6a411fc671c.json
|
│ │ │ ├── c46ad3fc8fd3db1315ab2e40add760b44e8f98c24c79e334c342c6a411fc671c.json
|
||||||
│ │ │ ├── c52300dce4cf464158f8db56df5030359a501a81bbe4a5f36e50c8c38a5ac48c.json
|
│ │ │ ├── c52300dce4cf464158f8db56df5030359a501a81bbe4a5f36e50c8c38a5ac48c.json
|
||||||
|
│ │ │ ├── c535c8a7523b768d28903b84f4cfbce7d62181a2a05f3db08ec3a7c8cbf86ce8.json
|
||||||
|
│ │ │ ├── c56beb43cf063fd1cc92950ca14695b543b3971bf7e7dbd4a676242057258533.json
|
||||||
│ │ │ ├── c5c93ccc7715c31fc7538bcd9327c8fb7c1e495bd17d6444b384ec426b7a231f.json
|
│ │ │ ├── c5c93ccc7715c31fc7538bcd9327c8fb7c1e495bd17d6444b384ec426b7a231f.json
|
||||||
|
│ │ │ ├── c718a8f0cdfb66217ab4484dca103c7029d43976f7f0889bfb11f6cab3bb2510.json
|
||||||
│ │ │ ├── c72226544540cc75217ba02f1d09d989eb810d879409ac086c76245f27220cfa.json
|
│ │ │ ├── c72226544540cc75217ba02f1d09d989eb810d879409ac086c76245f27220cfa.json
|
||||||
│ │ │ ├── c795f43bd1f10cf666ff987d18af538b2164c1683629ac689f0a54cb875118be.json
|
│ │ │ ├── c795f43bd1f10cf666ff987d18af538b2164c1683629ac689f0a54cb875118be.json
|
||||||
│ │ │ ├── c7eb97fa16701c6d9ee531fa032479a7c771292f3e9d8921d3ea12a4897fd43a.json
|
│ │ │ ├── c7eb97fa16701c6d9ee531fa032479a7c771292f3e9d8921d3ea12a4897fd43a.json
|
||||||
│ │ │ ├── c846b5de286163b5eed16ff6d6e00f2038f30bf7edd2ab3f8d831369e190ae18.json
|
│ │ │ ├── c846b5de286163b5eed16ff6d6e00f2038f30bf7edd2ab3f8d831369e190ae18.json
|
||||||
|
│ │ │ ├── c850d65440fa6ea38db7300c89c5052b3db430ea2c7d20d35cf38c6b41807d0d.json
|
||||||
|
│ │ │ ├── c8719ca6bbbd7a4815ce5f982745c94d54d2f753312c08b96964ab7ead661291.json
|
||||||
|
│ │ │ ├── ca0c19553fc1b40bdec0973b3e0c5363d6bbbf69d9961567483ba1c1cb9023eb.json
|
||||||
|
│ │ │ ├── cb3b2a1c1afd8d0837cc29b5040ec984dc0c0070af2135d0b0e5cb5ff726f2a7.json
|
||||||
│ │ │ ├── cdc5059cf09416d24d03fe57a48af5219727866c84b8109d986456fbaa789dc4.json
|
│ │ │ ├── cdc5059cf09416d24d03fe57a48af5219727866c84b8109d986456fbaa789dc4.json
|
||||||
|
│ │ │ ├── cf17cbc72af5f2b56eff6cc03157817d7552c6c5e4565e97278e02ae69a362f3.json
|
||||||
│ │ │ ├── cf6668c54cd4f65d268a17df44f100e1cb77f91eae90dd2dc052564731b2f195.json
|
│ │ │ ├── cf6668c54cd4f65d268a17df44f100e1cb77f91eae90dd2dc052564731b2f195.json
|
||||||
│ │ │ ├── d1289d5406d360e3ff617e213db4e262cd43a32711a61aba97bdcd0a906cbcb5.json
|
│ │ │ ├── d1289d5406d360e3ff617e213db4e262cd43a32711a61aba97bdcd0a906cbcb5.json
|
||||||
|
│ │ │ ├── d12cd2b31145213be1b4d89e7be64f3aecc122841cdeac7660eceae3dd871f01.json
|
||||||
|
│ │ │ ├── d12dccf07d58d7c0a2b5ea5b6aa821aa419fdc8b34a48939ebf9c565bc439551.json
|
||||||
|
│ │ │ ├── d1392fc7270aa978a815d8dbe99ea56de021ee699664635d53b8df5b2988c835.json
|
||||||
|
│ │ │ ├── d1f2090208e1aab3b0e377278b02e9fc1007e5e1724c9000fb69d050365c8660.json
|
||||||
│ │ │ ├── d3456cd690135f9630e6b0bb79fef5d205804c7acabffc61cbd5ac4032b17bc7.json
|
│ │ │ ├── d3456cd690135f9630e6b0bb79fef5d205804c7acabffc61cbd5ac4032b17bc7.json
|
||||||
|
│ │ │ ├── d51b2eb414ee4ea432987cd45d6b623013e994a6080c89cde57b69004b576e9d.json
|
||||||
|
│ │ │ ├── d5676c133bc21ec531e7c17c5e9416781e3459852a4e6e1fac9c77ecdb5c05a2.json
|
||||||
|
│ │ │ ├── d606b856d99eb59fe3e5378e597bbeff679c812e9f1b173ecced4639ede8ad11.json
|
||||||
│ │ │ ├── d88e1e365cafd5d26ce47c2a0fe1f067dc3bfe5ceed1f75a21393fae950be939.json
|
│ │ │ ├── d88e1e365cafd5d26ce47c2a0fe1f067dc3bfe5ceed1f75a21393fae950be939.json
|
||||||
|
│ │ │ ├── d899e8cc575f125b908d78f0c8d34408a4af1972ee0544d0517f8d1933239214.json
|
||||||
│ │ │ ├── d94bebfe941bb0acc30b633423eaee11690652709e5f8f28d157473d31a07ee3.json
|
│ │ │ ├── d94bebfe941bb0acc30b633423eaee11690652709e5f8f28d157473d31a07ee3.json
|
||||||
|
│ │ │ ├── d9590fb13a20db20da78d33674f56397a18e3356d08dab6f7c0739130caee096.json
|
||||||
│ │ │ ├── db68b8db5217e2295eb1195760d7352960627da044a4c4f8f6b89c67ad2f8f57.json
|
│ │ │ ├── db68b8db5217e2295eb1195760d7352960627da044a4c4f8f6b89c67ad2f8f57.json
|
||||||
|
│ │ │ ├── db794bbcafe219af962673ef26efb1ee1eacf3923e13113352f3eedfd3192d23.json
|
||||||
|
│ │ │ ├── db81ec42bfd68175829c568dac66c2844afba128b94afa2accdf24ed67aeccaf.json
|
||||||
│ │ │ ├── dbbdad9d992922aff62ad3262a531716cfc32e2f15f600773b9a0cf10545058d.json
|
│ │ │ ├── dbbdad9d992922aff62ad3262a531716cfc32e2f15f600773b9a0cf10545058d.json
|
||||||
│ │ │ ├── dc0344515d1b3ffe8643560516b88418be0b306fba56101b8a630ed73d48db46.json
|
│ │ │ ├── dc0344515d1b3ffe8643560516b88418be0b306fba56101b8a630ed73d48db46.json
|
||||||
|
│ │ │ ├── dcad55d51bb4494a642af555d5bfe78c5b8ee3d11de1b3d8f4286d608980854b.json
|
||||||
|
│ │ │ ├── ddd79719e349936349e9ec7684d3eec146d3b73f95a419ad142ae603ab199acd.json
|
||||||
|
│ │ │ ├── e08c4784f0f82403ff24a1676e3d75e11a208aadf8fe94a723461c9658afd1e0.json
|
||||||
|
│ │ │ ├── e0eb3c543474df255f97ae0679df48999b86b75dc42943b9d67f4cfcf1acae34.json
|
||||||
│ │ │ ├── e16f78807ff202fa2c81867b321acfacede2d24cc785856eef0633d8d352796b.json
|
│ │ │ ├── e16f78807ff202fa2c81867b321acfacede2d24cc785856eef0633d8d352796b.json
|
||||||
│ │ │ ├── e1a7be59904a3dc503c5b12bddc7604c6783b02462c8ec76834c65c5610c3bda.json
|
│ │ │ ├── e1a7be59904a3dc503c5b12bddc7604c6783b02462c8ec76834c65c5610c3bda.json
|
||||||
|
│ │ │ ├── e2967fb2aed9420b2cdf823d95f971b7038323c97a6ed139ce63b7a1912381d1.json
|
||||||
|
│ │ │ ├── e2c62f6012dcae176d19340f6db8db3e94547ebbc4a21577b63caf35cc72ecfb.json
|
||||||
│ │ │ ├── e3ee8d9942c74a74be83ca00d5438e4a1e1cb5b23f55d95d308a42954e4757f0.json
|
│ │ │ ├── e3ee8d9942c74a74be83ca00d5438e4a1e1cb5b23f55d95d308a42954e4757f0.json
|
||||||
|
│ │ │ ├── e86dc6bb7703d4329623bd33ccbc5e5e6c6daebf8d36d84fd415d6f868c779b0.json
|
||||||
|
│ │ │ ├── e8738fdd0a67e92abd0ce636990ee001a2fc7586e9eda224915f33cb80d3b2c6.json
|
||||||
|
│ │ │ ├── e8e380264b41f789dddd25b7af5d0e3c517b957a14fe8ba2ce7bb8a529e005cf.json
|
||||||
│ │ │ ├── e9589ded446a5befb285a0a2e93a182ca9431c76661e68c9210ed252580dd7f0.json
|
│ │ │ ├── e9589ded446a5befb285a0a2e93a182ca9431c76661e68c9210ed252580dd7f0.json
|
||||||
│ │ │ ├── e9e14d581ed59799b2d83c67402e8555b5b59e7d49425950ec490422bd0307d9.json
|
│ │ │ ├── e9e14d581ed59799b2d83c67402e8555b5b59e7d49425950ec490422bd0307d9.json
|
||||||
|
│ │ │ ├── eaceb29a907e3e67bed5255cc1f8b8b3eab9d9946f4d4df2cc99070151285029.json
|
||||||
│ │ │ ├── ec07e022005d3513838eee7e6618ff060e25d914cab7745aa6172f22d4089497.json
|
│ │ │ ├── ec07e022005d3513838eee7e6618ff060e25d914cab7745aa6172f22d4089497.json
|
||||||
|
│ │ │ ├── ec3570ad9673cc5dfc9a0d12f208b7f4d897d28d1ae2974d6a3fa63ad27598d3.json
|
||||||
|
│ │ │ ├── eccad1f007b52643ce8d81576efb7d1969ecbff2e9db288989fd9a9c21fd7288.json
|
||||||
│ │ │ ├── ecd9c1dbfa0a72e253adb680ae7088eff24c26360e53a65862b274ea1281ceae.json
|
│ │ │ ├── ecd9c1dbfa0a72e253adb680ae7088eff24c26360e53a65862b274ea1281ceae.json
|
||||||
│ │ │ ├── ee450e6251e62d8972efb53bc35145c4a65050a7b6db2954b84bda42fca7b704.json
|
│ │ │ ├── ee450e6251e62d8972efb53bc35145c4a65050a7b6db2954b84bda42fca7b704.json
|
||||||
│ │ │ ├── ee557c6ed214858651cd3ebceb5e0fd00999354a4c54bb379f26c64b48b509ab.json
|
│ │ │ ├── ee557c6ed214858651cd3ebceb5e0fd00999354a4c54bb379f26c64b48b509ab.json
|
||||||
│ │ │ ├── efd113025c3fb3c0becaecd8090e8494b13d92ff3c49220d54665b3a8af586af.json
|
│ │ │ ├── efd113025c3fb3c0becaecd8090e8494b13d92ff3c49220d54665b3a8af586af.json
|
||||||
|
│ │ │ ├── f081ba494afddbf02c2599aedee9fc9d38ccdb159ade7f07ce3bdad3323a001e.json
|
||||||
│ │ │ ├── f1af209a02f2ec5c5a344e3fa7dd8ad7d443e0479e55f5465449c0a2eed314a1.json
|
│ │ │ ├── f1af209a02f2ec5c5a344e3fa7dd8ad7d443e0479e55f5465449c0a2eed314a1.json
|
||||||
|
│ │ │ ├── f2eacc54ffb4b9802045711c0fb0ac7210c95f21ed6ae78011fe0496951aa086.json
|
||||||
│ │ │ ├── f3a6285dcf9eb39df500bc0b76b03b5941103e8b90c06ffaeab1b3129f18fedc.json
|
│ │ │ ├── f3a6285dcf9eb39df500bc0b76b03b5941103e8b90c06ffaeab1b3129f18fedc.json
|
||||||
|
│ │ │ ├── f3fe81220df98d0410b1505fa995df65427035dd552c85f1d80e35bb75a9aba1.json
|
||||||
|
│ │ │ ├── f48decaf1220666fbda1a5328b963dbd999caab9ebbb1d84459d4c556a6e6ba7.json
|
||||||
│ │ │ ├── f537b36e2ee33d1303c10e950a6910cc7fd954c7fce3220be2c95d75d70dfd40.json
|
│ │ │ ├── f537b36e2ee33d1303c10e950a6910cc7fd954c7fce3220be2c95d75d70dfd40.json
|
||||||
|
│ │ │ ├── f72f6f3fe9d226e4717e158dedd318fff0a1d52ece54f965311c2b4f862dcfee.json
|
||||||
│ │ │ ├── f76726d2898f2a3ba7168d3fb77c21087432eb9c200631b664ecb3b1837aaf17.json
|
│ │ │ ├── f76726d2898f2a3ba7168d3fb77c21087432eb9c200631b664ecb3b1837aaf17.json
|
||||||
|
│ │ │ ├── f92b94479afedf47039d8821a77facb55d9a862338e85876b80cac3b41c844f6.json
|
||||||
|
│ │ │ ├── fa4a8a35e96c919372da27c7af11abea0c89fff941c0b20dbc4e48c15f32597c.json
|
||||||
|
│ │ │ ├── fb6825c4e9ffba13d17a2da18a1e07aef792089a7cd24b31e7f4f32ee39287e8.json
|
||||||
|
│ │ │ ├── fbfc351c35c5272de5612b4740e380b06a24c37f8074b977e35f62ad85a6dcc0.json
|
||||||
│ │ │ ├── fc6ae63ae2639372c4ae4fbe9718feca814261dda099ba58bb780d14c69086cd.json
|
│ │ │ ├── fc6ae63ae2639372c4ae4fbe9718feca814261dda099ba58bb780d14c69086cd.json
|
||||||
│ │ │ ├── fd714e03c631694d30457ac529d05d8d131c183665e086246da607f752dea5eb.json
|
│ │ │ ├── fd714e03c631694d30457ac529d05d8d131c183665e086246da607f752dea5eb.json
|
||||||
|
│ │ │ ├── fe7f3f3c4b234398f7c0fb728456ac41c92c6e939634e147d2fdda12067df842.json
|
||||||
|
│ │ │ ├── fe8b7b639a9f98fd1b883b7dccf8490ee905a2a21df5671ca1838a173fa0f921.json
|
||||||
│ │ │ └── ff862e0ffad7bba911716072ae82f268240d82105ffefe78c7714a160c4c31ba.json
|
│ │ │ └── ff862e0ffad7bba911716072ae82f268240d82105ffefe78c7714a160c4c31ba.json
|
||||||
│ │ ├── semantic
|
│ │ ├── semantic
|
||||||
│ │ │ └── p5e80268fecd6
|
│ │ │ └── p5e80268fecd6
|
||||||
|
│ │ │ ├── 0be9cb2f924f20c8cd09e0361a90c8f0b4c8859120101bbe21eee930294ebdfd.json
|
||||||
│ │ │ ├── 0c4f87b180cd5b0576b197ff5cb0e9cc5dfd8d82d97d618036df00c7955fdbac.json
|
│ │ │ ├── 0c4f87b180cd5b0576b197ff5cb0e9cc5dfd8d82d97d618036df00c7955fdbac.json
|
||||||
|
│ │ │ ├── 14328edb08c286b631c2ef0ead8ac33b522157be84855de346e8c0688e30c965.json
|
||||||
│ │ │ ├── 14e03f8f9b4ebd7cf018188e2351ca859aa4e27d02d5dbfc7b1f8b932d282d16.json
|
│ │ │ ├── 14e03f8f9b4ebd7cf018188e2351ca859aa4e27d02d5dbfc7b1f8b932d282d16.json
|
||||||
|
│ │ │ ├── 212a2dc6dcc30c1b45f6cf5bfa9bf16386fa138bf382bbde438f8d6883769b29.json
|
||||||
│ │ │ ├── 2679b1fb1647af24f007334e6560733c957ca3cf3831eb02a9c8fb7a7ae44d62.json
|
│ │ │ ├── 2679b1fb1647af24f007334e6560733c957ca3cf3831eb02a9c8fb7a7ae44d62.json
|
||||||
│ │ │ ├── 296d532aced4658e74a296977efe4fd8a2ec3cf02a997ce3837f59ce36e61343.json
|
│ │ │ ├── 296d532aced4658e74a296977efe4fd8a2ec3cf02a997ce3837f59ce36e61343.json
|
||||||
│ │ │ ├── 2a13d2bb6f18a81d9511481df0edcdb1a8779e1ec03e919991693cae7e84c8e0.json
|
│ │ │ ├── 2a13d2bb6f18a81d9511481df0edcdb1a8779e1ec03e919991693cae7e84c8e0.json
|
||||||
|
│ │ │ ├── 2ac09852870126bb1792a5e9242b34d3f55365bfa6e3b09aa432461a6c72045e.json
|
||||||
│ │ │ ├── 2d3b8c0bb7eea6a50a24093abfc3457c0938079b0771b2568498060f6f3a4a74.json
|
│ │ │ ├── 2d3b8c0bb7eea6a50a24093abfc3457c0938079b0771b2568498060f6f3a4a74.json
|
||||||
│ │ │ ├── 40373bd2bcd76ed8ed27031299e541005d4c8c0c7df312a9312f390b173d7248.json
|
|
||||||
│ │ │ ├── 42a95a4a8f651dbebe297ce92beca376cb19eab99d6ef6b5d10a16d79d1842e4.json
|
│ │ │ ├── 42a95a4a8f651dbebe297ce92beca376cb19eab99d6ef6b5d10a16d79d1842e4.json
|
||||||
│ │ │ ├── 4f53e6b5fc48381f8afe6052371989c4df69347c84c2ec65a46b73cd1c464b5f.json
|
|
||||||
│ │ │ ├── 538cdc2fb71798c581f20d37d52a1484c2ef21691d2e01ee79edcf253ba06394.json
|
│ │ │ ├── 538cdc2fb71798c581f20d37d52a1484c2ef21691d2e01ee79edcf253ba06394.json
|
||||||
│ │ │ ├── 569db52f8b9229dc3cd5cbde156a4ac012ab711d32bdeb4175b60ba863ac8cd0.json
|
│ │ │ ├── 569db52f8b9229dc3cd5cbde156a4ac012ab711d32bdeb4175b60ba863ac8cd0.json
|
||||||
│ │ │ ├── 57dba5c2a37beb12ccc107807b7544f687d6d8ba6394c8977c3c59b433d2dab4.json
|
│ │ │ ├── 57dba5c2a37beb12ccc107807b7544f687d6d8ba6394c8977c3c59b433d2dab4.json
|
||||||
│ │ │ ├── 5ad5f87fc2eb132405e3aab9ef8a84e41f76c958fbcb188873c86abd4fbc12fd.json
|
│ │ │ ├── 5ad5f87fc2eb132405e3aab9ef8a84e41f76c958fbcb188873c86abd4fbc12fd.json
|
||||||
|
│ │ │ ├── 5c0f2ea11f5bdcc5272d6344c9015c20bf79f315d74a910d56bf7a2922c92315.json
|
||||||
|
│ │ │ ├── 5dbe87f1a5fa172581ed5abebee35b5d08ff488e798a334992a2756bff277cdc.json
|
||||||
│ │ │ ├── 6aaa93a769a41eb1d37a91608cd6f98b9252c2a5598bd859a130986429d1d53f.json
|
│ │ │ ├── 6aaa93a769a41eb1d37a91608cd6f98b9252c2a5598bd859a130986429d1d53f.json
|
||||||
│ │ │ ├── 7b504b4173cb8d683a7021270372c5c65f078ac3e3e1351601bedfec9c585632.json
|
|
||||||
│ │ │ ├── 7edbffbd4455d071df034927a69faaf76f8e8bbf6495921ce2b70eea1abe8e4f.json
|
│ │ │ ├── 7edbffbd4455d071df034927a69faaf76f8e8bbf6495921ce2b70eea1abe8e4f.json
|
||||||
|
│ │ │ ├── 82db37687728a8df60ccf231c06838b4a0074d22ad93e89d3f5e93d4de48132f.json
|
||||||
│ │ │ ├── 8a79c80fca0ed04957e7b4df749ab80b5d0f4ce3d0ae032a47d51d4a2fbfcd82.json
|
│ │ │ ├── 8a79c80fca0ed04957e7b4df749ab80b5d0f4ce3d0ae032a47d51d4a2fbfcd82.json
|
||||||
│ │ │ ├── 8f60bda631cbe7457886d1d574b2e3d2850034f469592a3e8c333f0623a2d3c6.json
|
│ │ │ ├── 8b6c538ab1a901fb71decc7f7f511c8c67a76d72f05f02b1bddc10f5026f9e4e.json
|
||||||
|
│ │ │ ├── 96f5469edd566b92d9d38423a27779142fbe2b77cfc9d85005d43ffc99ce3de1.json
|
||||||
│ │ │ ├── 9897fa1997a41e155ed8de922722238e1f684f5c77a7f56405c8ac7cd1aa376f.json
|
│ │ │ ├── 9897fa1997a41e155ed8de922722238e1f684f5c77a7f56405c8ac7cd1aa376f.json
|
||||||
│ │ │ ├── 9b674bec71dfe6e133af9fb4e35a421fa56cecd230544008ed83a44e6eaae3bf.json
|
│ │ │ ├── a3f3d3cf99dd02b4d8c41297d4634e120953f1650257c0c6a1888481aa4c5745.json
|
||||||
│ │ │ ├── aa41b77ce8563f4b4bee015be5ffa598f1c98d4f2854ec9a465f271e8c3f974b.json
|
│ │ │ ├── aa41b77ce8563f4b4bee015be5ffa598f1c98d4f2854ec9a465f271e8c3f974b.json
|
||||||
│ │ │ ├── b5f6ef338a857f51d581abe7c50f57f41757aa6900bf94f6ed8fc2ad442f6019.json
|
│ │ │ ├── b5f6ef338a857f51d581abe7c50f57f41757aa6900bf94f6ed8fc2ad442f6019.json
|
||||||
│ │ │ ├── be1200d7c9b2881ba54c7fa95daf5f3e2ce993619b974c7760a9d44a416e00c0.json
|
│ │ │ ├── be1200d7c9b2881ba54c7fa95daf5f3e2ce993619b974c7760a9d44a416e00c0.json
|
||||||
|
│ │ │ ├── c109dbf29a8233cec6f0e4e3c1256a94ecee99887756af2060e620aaa5979e4b.json
|
||||||
│ │ │ ├── c1d9e0aa5d7450242681eebd003d4f502744a3624112b10ab091011a50820ce3.json
|
│ │ │ ├── c1d9e0aa5d7450242681eebd003d4f502744a3624112b10ab091011a50820ce3.json
|
||||||
|
│ │ │ ├── c89f13bada10536a104ce57788562563a61c2682430e4273ca3195890d45c68c.json
|
||||||
│ │ │ ├── c97d49fed39b9aca8dea35a49c3e031a641420e4452e61d1ea2a912e899f6dd9.json
|
│ │ │ ├── c97d49fed39b9aca8dea35a49c3e031a641420e4452e61d1ea2a912e899f6dd9.json
|
||||||
│ │ │ ├── cacf6773249daafca21d21004106209d86aa215140de071c64363aff4d9e5431.json
|
│ │ │ ├── cacf6773249daafca21d21004106209d86aa215140de071c64363aff4d9e5431.json
|
||||||
│ │ │ ├── cfb57017bc764ee7e9011b52f1e44ad2f41b2670778af73232ecfc309b406a0d.json
|
│ │ │ ├── cfb57017bc764ee7e9011b52f1e44ad2f41b2670778af73232ecfc309b406a0d.json
|
||||||
│ │ │ ├── dc89fcddf8c6f20bc9f52ae15e5cc8b226320d2776dc8f27be16894e53165013.json
|
│ │ │ ├── dc89fcddf8c6f20bc9f52ae15e5cc8b226320d2776dc8f27be16894e53165013.json
|
||||||
│ │ │ ├── dd78862d0f7862653c702e86f7acfabfe33ec5d85d40ba764138c0d1784f7b06.json
|
│ │ │ ├── dd78862d0f7862653c702e86f7acfabfe33ec5d85d40ba764138c0d1784f7b06.json
|
||||||
│ │ │ ├── de67f63e3f49d4ee32811dd67676da33a1e584f671d396fca130f3681d54bd76.json
|
│ │ │ ├── de67f63e3f49d4ee32811dd67676da33a1e584f671d396fca130f3681d54bd76.json
|
||||||
│ │ │ ├── e0a52ba8204140f195e8d30847dda00d3de5439cf903c576b77fac1ec852b5fb.json
|
│ │ │ ├── e86dc6bb7703d4329623bd33ccbc5e5e6c6daebf8d36d84fd415d6f868c779b0.json
|
||||||
|
│ │ │ ├── e9ca16b55daa5d6bdf6b0257a4e08c35caeae32eaaeb5c0be11532b77ab658ea.json
|
||||||
|
│ │ │ ├── ea11661eb53bce4c7a43acb2d636de01d960acdad246c1f1372df351e25bac25.json
|
||||||
|
│ │ │ ├── eaceb29a907e3e67bed5255cc1f8b8b3eab9d9946f4d4df2cc99070151285029.json
|
||||||
│ │ │ ├── f71a50c524a31da468cf7c0c08d929d4d31bf17e77473db59b5830f4c583ce25.json
|
│ │ │ ├── f71a50c524a31da468cf7c0c08d929d4d31bf17e77473db59b5830f4c583ce25.json
|
||||||
│ │ │ ├── f7fdf480e35ed096b57529bfcafd8695aff9a98851050be1f00e4a736ad79719.json
|
│ │ │ ├── f7fdf480e35ed096b57529bfcafd8695aff9a98851050be1f00e4a736ad79719.json
|
||||||
│ │ │ └── fb1977d392a5009580c7a608fd403ac2ae96c72f6f2835ba6e49cf662dd0bf6d.json
|
│ │ │ └── fb1977d392a5009580c7a608fd403ac2ae96c72f6f2835ba6e49cf662dd0bf6d.json
|
||||||
@@ -484,12 +743,10 @@ khatibi
|
|||||||
│ │ │ ├── 2a13d2bb6f18a81d9511481df0edcdb1a8779e1ec03e919991693cae7e84c8e0.json
|
│ │ │ ├── 2a13d2bb6f18a81d9511481df0edcdb1a8779e1ec03e919991693cae7e84c8e0.json
|
||||||
│ │ │ ├── 2d3b8c0bb7eea6a50a24093abfc3457c0938079b0771b2568498060f6f3a4a74.json
|
│ │ │ ├── 2d3b8c0bb7eea6a50a24093abfc3457c0938079b0771b2568498060f6f3a4a74.json
|
||||||
│ │ │ ├── 32267f72ce9ef01cd2e804d43c6828549af8eb6f868c76e7d1619502a953f14d.json
|
│ │ │ ├── 32267f72ce9ef01cd2e804d43c6828549af8eb6f868c76e7d1619502a953f14d.json
|
||||||
│ │ │ ├── 40373bd2bcd76ed8ed27031299e541005d4c8c0c7df312a9312f390b173d7248.json
|
|
||||||
│ │ │ ├── 40a84c5465882009ab69d2874adbb9aaed373cd706d70c92e9e1f4c35640472e.json
|
│ │ │ ├── 40a84c5465882009ab69d2874adbb9aaed373cd706d70c92e9e1f4c35640472e.json
|
||||||
│ │ │ ├── 4280dd1094314da773fe73ba1ffb91f58f22eea26281bd5cb51f5e9a201c95f6.json
|
│ │ │ ├── 4280dd1094314da773fe73ba1ffb91f58f22eea26281bd5cb51f5e9a201c95f6.json
|
||||||
│ │ │ ├── 42a95a4a8f651dbebe297ce92beca376cb19eab99d6ef6b5d10a16d79d1842e4.json
|
│ │ │ ├── 42a95a4a8f651dbebe297ce92beca376cb19eab99d6ef6b5d10a16d79d1842e4.json
|
||||||
│ │ │ ├── 4b8f3b6c0ccb3b5494fb2af8c0f9892b6b198a8d503f53498bd1fe2548ef112a.json
|
│ │ │ ├── 4b8f3b6c0ccb3b5494fb2af8c0f9892b6b198a8d503f53498bd1fe2548ef112a.json
|
||||||
│ │ │ ├── 4f53e6b5fc48381f8afe6052371989c4df69347c84c2ec65a46b73cd1c464b5f.json
|
|
||||||
│ │ │ ├── 538cdc2fb71798c581f20d37d52a1484c2ef21691d2e01ee79edcf253ba06394.json
|
│ │ │ ├── 538cdc2fb71798c581f20d37d52a1484c2ef21691d2e01ee79edcf253ba06394.json
|
||||||
│ │ │ ├── 569db52f8b9229dc3cd5cbde156a4ac012ab711d32bdeb4175b60ba863ac8cd0.json
|
│ │ │ ├── 569db52f8b9229dc3cd5cbde156a4ac012ab711d32bdeb4175b60ba863ac8cd0.json
|
||||||
│ │ │ ├── 57dba5c2a37beb12ccc107807b7544f687d6d8ba6394c8977c3c59b433d2dab4.json
|
│ │ │ ├── 57dba5c2a37beb12ccc107807b7544f687d6d8ba6394c8977c3c59b433d2dab4.json
|
||||||
@@ -497,15 +754,12 @@ khatibi
|
|||||||
│ │ │ ├── 60002a01d6fc22147e2994d1a1a447d5e577c02aed2443789af20571ec2d2a19.json
|
│ │ │ ├── 60002a01d6fc22147e2994d1a1a447d5e577c02aed2443789af20571ec2d2a19.json
|
||||||
│ │ │ ├── 6aaa93a769a41eb1d37a91608cd6f98b9252c2a5598bd859a130986429d1d53f.json
|
│ │ │ ├── 6aaa93a769a41eb1d37a91608cd6f98b9252c2a5598bd859a130986429d1d53f.json
|
||||||
│ │ │ ├── 7101777f271bbc6bce9a2a4fd3bcf487bb62a846a2436bc8c70008bfb23ce33b.json
|
│ │ │ ├── 7101777f271bbc6bce9a2a4fd3bcf487bb62a846a2436bc8c70008bfb23ce33b.json
|
||||||
│ │ │ ├── 7b504b4173cb8d683a7021270372c5c65f078ac3e3e1351601bedfec9c585632.json
|
|
||||||
│ │ │ ├── 7db83b9e384d80a1584b152f9fbc781e0ae5a7524dac0a57ce98bb4d3432bfae.json
|
│ │ │ ├── 7db83b9e384d80a1584b152f9fbc781e0ae5a7524dac0a57ce98bb4d3432bfae.json
|
||||||
│ │ │ ├── 7edbffbd4455d071df034927a69faaf76f8e8bbf6495921ce2b70eea1abe8e4f.json
|
│ │ │ ├── 7edbffbd4455d071df034927a69faaf76f8e8bbf6495921ce2b70eea1abe8e4f.json
|
||||||
│ │ │ ├── 8a79c80fca0ed04957e7b4df749ab80b5d0f4ce3d0ae032a47d51d4a2fbfcd82.json
|
│ │ │ ├── 8a79c80fca0ed04957e7b4df749ab80b5d0f4ce3d0ae032a47d51d4a2fbfcd82.json
|
||||||
│ │ │ ├── 8f60bda631cbe7457886d1d574b2e3d2850034f469592a3e8c333f0623a2d3c6.json
|
|
||||||
│ │ │ ├── 908e0129cefe129d0b562243460fe20793c84876244cef2e99ca1becf8cf6a1f.json
|
│ │ │ ├── 908e0129cefe129d0b562243460fe20793c84876244cef2e99ca1becf8cf6a1f.json
|
||||||
│ │ │ ├── 92e1d82ed4571249c09163413ceae360dd4d7d03c162c554f3b5a47e94474cf1.json
|
│ │ │ ├── 92e1d82ed4571249c09163413ceae360dd4d7d03c162c554f3b5a47e94474cf1.json
|
||||||
│ │ │ ├── 9897fa1997a41e155ed8de922722238e1f684f5c77a7f56405c8ac7cd1aa376f.json
|
│ │ │ ├── 9897fa1997a41e155ed8de922722238e1f684f5c77a7f56405c8ac7cd1aa376f.json
|
||||||
│ │ │ ├── 9b674bec71dfe6e133af9fb4e35a421fa56cecd230544008ed83a44e6eaae3bf.json
|
|
||||||
│ │ │ ├── a3f1dac3e797de04ab83d263a12eda947904d8e5015b77363db2d29aba8b4928.json
|
│ │ │ ├── a3f1dac3e797de04ab83d263a12eda947904d8e5015b77363db2d29aba8b4928.json
|
||||||
│ │ │ ├── aa41b77ce8563f4b4bee015be5ffa598f1c98d4f2854ec9a465f271e8c3f974b.json
|
│ │ │ ├── aa41b77ce8563f4b4bee015be5ffa598f1c98d4f2854ec9a465f271e8c3f974b.json
|
||||||
│ │ │ ├── b205a6dda565ed51a38a6b75c509f41589425f0c2006aad838978f5dc6810b91.json
|
│ │ │ ├── b205a6dda565ed51a38a6b75c509f41589425f0c2006aad838978f5dc6810b91.json
|
||||||
@@ -522,7 +776,6 @@ khatibi
|
|||||||
│ │ │ ├── dc89fcddf8c6f20bc9f52ae15e5cc8b226320d2776dc8f27be16894e53165013.json
|
│ │ │ ├── dc89fcddf8c6f20bc9f52ae15e5cc8b226320d2776dc8f27be16894e53165013.json
|
||||||
│ │ │ ├── dd78862d0f7862653c702e86f7acfabfe33ec5d85d40ba764138c0d1784f7b06.json
|
│ │ │ ├── dd78862d0f7862653c702e86f7acfabfe33ec5d85d40ba764138c0d1784f7b06.json
|
||||||
│ │ │ ├── de67f63e3f49d4ee32811dd67676da33a1e584f671d396fca130f3681d54bd76.json
|
│ │ │ ├── de67f63e3f49d4ee32811dd67676da33a1e584f671d396fca130f3681d54bd76.json
|
||||||
│ │ │ ├── e0a52ba8204140f195e8d30847dda00d3de5439cf903c576b77fac1ec852b5fb.json
|
|
||||||
│ │ │ ├── e13320e9716b0be66b7cc677a64b44cf3127f7317f35cfa3b849dfbaa9c1f367.json
|
│ │ │ ├── e13320e9716b0be66b7cc677a64b44cf3127f7317f35cfa3b849dfbaa9c1f367.json
|
||||||
│ │ │ ├── e1c07127e4cef79fe0bfc63a0ab904e5d1b0d9c4be5278b553b6e48d39753b4d.json
|
│ │ │ ├── e1c07127e4cef79fe0bfc63a0ab904e5d1b0d9c4be5278b553b6e48d39753b4d.json
|
||||||
│ │ │ ├── f0478454ef37ecdc5128db97c18d0ffd92005c1d1db586b6750d985e30a25d76.json
|
│ │ │ ├── f0478454ef37ecdc5128db97c18d0ffd92005c1d1db586b6750d985e30a25d76.json
|
||||||
@@ -558,7 +811,9 @@ khatibi
|
|||||||
│ │ ├── http.py
|
│ │ ├── http.py
|
||||||
│ │ ├── normalize.py
|
│ │ ├── normalize.py
|
||||||
│ │ ├── providers.py
|
│ │ ├── providers.py
|
||||||
│ │ └── sms0098.py
|
│ │ ├── sms0098.py
|
||||||
|
│ │ ├── sms0098_codes.py
|
||||||
|
│ │ └── sms0098ws.py
|
||||||
│ ├── __init__.py
|
│ ├── __init__.py
|
||||||
│ ├── announcements.py
|
│ ├── announcements.py
|
||||||
│ └── voip.py
|
│ └── voip.py
|
||||||
@@ -569,35 +824,57 @@ khatibi
|
|||||||
│ ├── settings.py
|
│ ├── settings.py
|
||||||
│ ├── urls.py
|
│ ├── urls.py
|
||||||
│ └── wsgi.py
|
│ └── wsgi.py
|
||||||
|
├── scripts
|
||||||
|
│ ├── coordination_hold_order_probe.py
|
||||||
|
│ ├── entezar_action_audit.py
|
||||||
|
│ └── hold_write_verification.py
|
||||||
├── static
|
├── static
|
||||||
│ └── .gitkeep
|
│ └── .gitkeep
|
||||||
├── tests
|
├── tests
|
||||||
│ ├── __init__.py
|
│ ├── __init__.py
|
||||||
│ ├── factories.py
|
│ ├── factories.py
|
||||||
|
│ ├── test_customer_name_fix.py
|
||||||
│ ├── test_customers.py
|
│ ├── test_customers.py
|
||||||
|
│ ├── test_entezar_action_simulation.py
|
||||||
│ ├── test_factors.py
|
│ ├── test_factors.py
|
||||||
│ ├── test_inventory.py
|
│ ├── test_inventory.py
|
||||||
│ ├── test_models_contract.py
|
│ ├── test_models_contract.py
|
||||||
│ ├── test_sms.py
|
│ ├── test_sms.py
|
||||||
|
│ ├── test_sms_phone_normalize.py
|
||||||
│ ├── test_urls_contract.py
|
│ ├── test_urls_contract.py
|
||||||
│ └── test_view_smoke.py
|
│ ├── test_view_smoke.py
|
||||||
|
│ └── test_visit_policy.py
|
||||||
|
├── .clinerules
|
||||||
├── .dockerignore
|
├── .dockerignore
|
||||||
├── .gitignore
|
├── .gitignore
|
||||||
├── .graphifyignore
|
├── .graphifyignore
|
||||||
|
├── 0098sms.md
|
||||||
├── AGENTS.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
|
├── check_finance.py
|
||||||
|
├── CLAUDE.md
|
||||||
├── db.json
|
├── db.json
|
||||||
├── docker-compose.yml
|
├── docker-compose.yml
|
||||||
├── Dockerfile
|
├── Dockerfile
|
||||||
├── entrypoint.sh
|
├── entrypoint.sh
|
||||||
├── financial_audit_20260816_151225.csv
|
├── financial_audit_20260816_151225.csv
|
||||||
|
├── fix_customer_names.md
|
||||||
|
├── fix_customer_phones.md
|
||||||
├── GEMINI.md
|
├── GEMINI.md
|
||||||
├── ghost_hunter.py
|
├── ghost_hunter.py
|
||||||
|
├── iranianNamesDataset.json
|
||||||
├── khatibi.zip
|
├── khatibi.zip
|
||||||
├── local.env
|
├── local.env
|
||||||
├── manage.py
|
├── manage.py
|
||||||
|
├── normalize_customer_sms_phones.md
|
||||||
├── production.env
|
├── production.env
|
||||||
├── project_tree.py
|
├── project_tree.py
|
||||||
|
├── recalc_last_bazdid.md
|
||||||
├── reconciliation_tool.py
|
├── reconciliation_tool.py
|
||||||
├── requirements.txt
|
├── requirements.txt
|
||||||
├── requirements2.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(
|
nazar_stats = Action.objects.filter(
|
||||||
nazarDT__range=(today_start, today_end),
|
nazarDT__range=(today_start, today_end),
|
||||||
grade__gt=0
|
grade__gt=0,
|
||||||
|
deleted_at__isnull=True,
|
||||||
).aggregate(
|
).aggregate(
|
||||||
avg_grade=Avg('grade'),
|
avg_grade=Avg('grade'),
|
||||||
total_count=Count('id')
|
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),
|
||||||
|
]
|
||||||
@@ -22,7 +22,35 @@ class VisitQueue(models.Model):
|
|||||||
|
|
||||||
|
|
||||||
class Action(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)
|
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)
|
customer = models.ForeignKey('Customer', related_name='actionrlt', on_delete=models.CASCADE, null=True, blank=True)
|
||||||
createdDT = models.DateTimeField(auto_now_add=True)
|
createdDT = models.DateTimeField(auto_now_add=True)
|
||||||
@@ -31,8 +59,45 @@ class Action(models.Model):
|
|||||||
finishDateTime = models.DateTimeField(null=True, blank=True)
|
finishDateTime = models.DateTimeField(null=True, blank=True)
|
||||||
desc = models.CharField(max_length=500, null=True, blank=True)
|
desc = models.CharField(max_length=500, null=True, blank=True)
|
||||||
result = 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)
|
nazar = models.CharField(max_length=50, null=True, blank=True, default=None)
|
||||||
nextNazarDT = models.DateTimeField(null=True, blank=True, default=None)
|
nextNazarDT = models.DateTimeField(null=True, blank=True, default=None)
|
||||||
nazarDT = 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)
|
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',
|
||||||
|
),
|
||||||
|
]
|
||||||
@@ -39,6 +39,25 @@ class Customer(models.Model):
|
|||||||
help_text="شمارههای نرمالشده (+98…) جداشده با کاما؛ خالی = شمارهٔ اول مشتری.",
|
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):
|
def __str__(self):
|
||||||
return self.name_family
|
return self.name_family
|
||||||
|
|
||||||
|
|||||||
@@ -11,16 +11,21 @@ from django.db import models
|
|||||||
|
|
||||||
|
|
||||||
class SMSType(models.TextChoices):
|
class SMSType(models.TextChoices):
|
||||||
"""انواع پیامکهای سیستم."""
|
"""انواع پیامکهای سیستم (دقیقاً ۸ نوع، به ترتیب چرخهٔ کاری).
|
||||||
|
|
||||||
|
ترتیب تعریف = ترتیب نمایش در پنل. هر نوع یا از یک رویداد (view) یا از یک
|
||||||
|
اسکنر دورهای در صف قرار میگیرد؛ نگاشت آن در ``admin_panel/sms/triggers.py``
|
||||||
|
و ``admin_panel/sms/scanner.py`` است.
|
||||||
|
"""
|
||||||
|
|
||||||
WELCOME = "welcome", "خوشآمدگویی (ایجاد مشتری)"
|
WELCOME = "welcome", "خوشآمدگویی (ایجاد مشتری)"
|
||||||
CHEQUE_DUE = "cheque_due", "یادآوری سررسید چک"
|
SURVEY = "survey", "نظرسنجی پس از ثبت فاکتور"
|
||||||
NESIYE_DUE = "nesiye_due", "یادآوری سررسید نسیه"
|
|
||||||
CHEQUE_REGISTRATION = "cheque_registration", "یادآوری تأمین موجودی چک"
|
CHEQUE_REGISTRATION = "cheque_registration", "یادآوری تأمین موجودی چک"
|
||||||
DEBT_DUE = "debt_due", "یادآوری بدهی (سررسید وصول مطالبات)"
|
VISIT = "visit", "یادآوری بازدید خدمات دستگاه"
|
||||||
VISIT = "visit", "یادآوری بازدید خدمات"
|
VISIT_CREATED = "visit_created", "ثبت بازدید (اقدام از نوع بازدید)"
|
||||||
SURVEY = "survey", "نظرسنجی پس از فاکتور"
|
INSTALL_CREATED = "install_created", "ثبت نصب (اقدام از نوع نصب)"
|
||||||
CUSTOM = "custom", "پیام سفارشی"
|
PAYMENT_THANKS = "payment_thanks", "تشکر از پرداخت"
|
||||||
|
NESIYE_DUE = "nesiye_due", "یادآوری سررسید نسیه"
|
||||||
|
|
||||||
|
|
||||||
class SMSProviderConfig(models.Model):
|
class SMSProviderConfig(models.Model):
|
||||||
@@ -33,6 +38,9 @@ class SMSProviderConfig(models.Model):
|
|||||||
# نام نمایشی مطابق قرارداد سایر پرمیشنهای پروژه (ViewStore/AddCustomer/...)
|
# نام نمایشی مطابق قرارداد سایر پرمیشنهای پروژه (ViewStore/AddCustomer/...)
|
||||||
# تا در فهرست پرمیشنهای Django Admin بهسادگی پیدا شود.
|
# تا در فهرست پرمیشنهای Django Admin بهسادگی پیدا شود.
|
||||||
("ManageSMS", "ManageSMS"),
|
("ManageSMS", "ManageSMS"),
|
||||||
|
# سطح دسترسی جداگانه برای صفحات «تنظیمات» و «قالبها»: مدیر میتواند فقط
|
||||||
|
# به کاربران مشخصی اجازهٔ دیدن/ویرایش اینها را بدهد (نه هر کاربر پیامک).
|
||||||
|
("ManageSMSSettings", "ManageSMSSettings"),
|
||||||
]
|
]
|
||||||
|
|
||||||
ProviderChoices = [
|
ProviderChoices = [
|
||||||
@@ -147,7 +155,11 @@ class SMSTemplate(models.Model):
|
|||||||
verbose_name="متن پیامک",
|
verbose_name="متن پیامک",
|
||||||
help_text="متغیرهای قابل استفاده: {name} نام مشتری، {amount} مبلغ، "
|
help_text="متغیرهای قابل استفاده: {name} نام مشتری، {amount} مبلغ، "
|
||||||
"{amount_sep} مبلغ با جداکننده، {date} تاریخ جلالی، {days} تعداد روز، "
|
"{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="فعال")
|
is_enabled = models.BooleanField(default=True, verbose_name="فعال")
|
||||||
auto_send = models.BooleanField(
|
auto_send = models.BooleanField(
|
||||||
|
|||||||
@@ -1,6 +1,48 @@
|
|||||||
from django.db import models
|
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):
|
class CacheTable(models.Model):
|
||||||
key = models.CharField(max_length=50, unique=True)
|
key = models.CharField(max_length=50, unique=True)
|
||||||
value = models.CharField(max_length=400)
|
value = models.CharField(max_length=400)
|
||||||
|
|||||||
@@ -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")
|
||||||
|
|
||||||
@@ -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
|
||||||
@@ -5,6 +5,7 @@ from uuid import uuid4
|
|||||||
from django.db import IntegrityError
|
from django.db import IntegrityError
|
||||||
|
|
||||||
from ..models import SMSDedup, SMSQueue, SMSTemplate, SMSType
|
from ..models import SMSDedup, SMSQueue, SMSTemplate, SMSType
|
||||||
|
from .balance import customer_balance
|
||||||
from .recipients import resolve_recipients
|
from .recipients import resolve_recipients
|
||||||
from .render import render_template
|
from .render import render_template
|
||||||
from .rules import is_sms_enabled
|
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`` که مدیر در صفحهٔ قالبها برای هر نوع
|
یا آزمایشی)، و ``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()
|
template = SMSTemplate.objects.filter(sms_type=sms_type, is_enabled=True).first()
|
||||||
if template is None:
|
if template is None:
|
||||||
return 0
|
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
|
approved = approved or template.auto_send
|
||||||
|
|
||||||
|
|||||||
@@ -30,6 +30,10 @@ NOTICES = {
|
|||||||
"approved": ("success", "پیامک تأیید شد و برای ارسال در صف قرار گرفت."),
|
"approved": ("success", "پیامک تأیید شد و برای ارسال در صف قرار گرفت."),
|
||||||
"not_pending": ("warning", "این پیامک در وضعیت «در انتظار تأیید» نیست."),
|
"not_pending": ("warning", "این پیامک در وضعیت «در انتظار تأیید» نیست."),
|
||||||
"deleted": ("success", "پیامک از صف حذف شد."),
|
"deleted": ("success", "پیامک از صف حذف شد."),
|
||||||
|
"delete_done_blocked": (
|
||||||
|
"warning",
|
||||||
|
"این پیامک ارسال شده است و از صف حذف نمیشود؛ سابقهٔ آن در «گزارش ارسال» میماند.",
|
||||||
|
),
|
||||||
"bulk_approved_all": ("success", "{count} پیامک تأیید شد و برای ارسال در صف قرار گرفت."),
|
"bulk_approved_all": ("success", "{count} پیامک تأیید شد و برای ارسال در صف قرار گرفت."),
|
||||||
"bulk_approved": ("success", "{count} پیامک تأیید شد."),
|
"bulk_approved": ("success", "{count} پیامک تأیید شد."),
|
||||||
"bulk_deleted": ("success", "{count} پیامک از صف حذف شد."),
|
"bulk_deleted": ("success", "{count} پیامک از صف حذف شد."),
|
||||||
|
|||||||
@@ -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),
|
||||||
|
}
|
||||||
@@ -3,11 +3,21 @@ from persiantools.jdatetime import JalaliDate, JalaliDateTime
|
|||||||
|
|
||||||
|
|
||||||
class _SafeDict(dict):
|
class _SafeDict(dict):
|
||||||
"""دیکشنری که برای کلیدهای ناشناخته رشته خالی برمیگرداند (بدون خطا)."""
|
"""دیکشنری امن برای ``str.format_map``.
|
||||||
|
|
||||||
|
* کلیدِ ناشناخته ⇒ رشتهٔ خالی (بدون ``KeyError``).
|
||||||
|
* کلیدِ شناختهشده با مقدار ``None`` ⇒ رشتهٔ خالی. فیلدهای اختیاری مدل
|
||||||
|
(مثل ``Sarresid.check_sayyad_id`` یا ``check_row_number``) ممکن است ``NULL``
|
||||||
|
باشند؛ بدون این تبدیل، ``None`` عیناً در متن پیامک چاپ میشد.
|
||||||
|
"""
|
||||||
|
|
||||||
def __missing__(self, key):
|
def __missing__(self, key):
|
||||||
return ""
|
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):
|
def format_amount(value):
|
||||||
try:
|
try:
|
||||||
@@ -35,6 +45,10 @@ def render_template(text, context=None):
|
|||||||
ctx = dict(context or {})
|
ctx = dict(context or {})
|
||||||
if "amount" in ctx:
|
if "amount" in ctx:
|
||||||
ctx.setdefault("amount_sep", format_amount(ctx["amount"]))
|
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:
|
if "date" in ctx:
|
||||||
ctx.setdefault("date_raw", ctx["date"])
|
ctx.setdefault("date_raw", ctx["date"])
|
||||||
ctx["date"] = format_jalali(ctx["date"])
|
ctx["date"] = format_jalali(ctx["date"])
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ from ..models import CustomerSMSSetting, SMSType
|
|||||||
|
|
||||||
def is_sms_enabled(customer, sms_type):
|
def is_sms_enabled(customer, sms_type):
|
||||||
"""اگر رکوردی با is_enabled=False وجود داشته باشد غیرفعال است؛ در غیر اینصورت فعال."""
|
"""اگر رکوردی با is_enabled=False وجود داشته باشد غیرفعال است؛ در غیر اینصورت فعال."""
|
||||||
if customer is None or sms_type == SMSType.CUSTOM:
|
if customer is None:
|
||||||
return True
|
return True
|
||||||
setting = CustomerSMSSetting.objects.filter(customer=customer, sms_type=sms_type).first()
|
setting = CustomerSMSSetting.objects.filter(customer=customer, sms_type=sms_type).first()
|
||||||
if setting is None:
|
if setting is None:
|
||||||
@@ -21,5 +21,4 @@ def customer_toggle_map(customer):
|
|||||||
return [
|
return [
|
||||||
{"code": code, "label": label, "enabled": overrides.get(code, True)}
|
{"code": code, "label": label, "enabled": overrides.get(code, True)}
|
||||||
for code, label in SMSType.choices
|
for code, label in SMSType.choices
|
||||||
if code != SMSType.CUSTOM
|
|
||||||
]
|
]
|
||||||
+117
-169
@@ -9,55 +9,68 @@
|
|||||||
در هر اجرا حداکثر ``backlog_max`` مورد قدیمی هم صف میشود.
|
در هر اجرا حداکثر ``backlog_max`` مورد قدیمی هم صف میشود.
|
||||||
* **سقف هر اجرا (``max_per_run``)**: سقف کل صفکردن هر اسکنر در یک اجرا.
|
* **سقف هر اجرا (``max_per_run``)**: سقف کل صفکردن هر اسکنر در یک اجرا.
|
||||||
|
|
||||||
|
اسکنرها فقط انواع «دورهای» را پوشش میدهند (تأمین موجودی چک، سررسید نسیه، بازدید
|
||||||
|
دورهای). انواع «رویدادی» (خوشآمدگویی، نظرسنجی، ثبت بازدید، تشکر از پرداخت) هنگام
|
||||||
|
وقوع رخداد توسط ویوها و از طریق ``admin_panel/sms/triggers.py`` صف میشوند.
|
||||||
|
|
||||||
هر اسکنر مستقل و مقاوم به خطاست؛ یک خطا بقیه را متوقف نمیکند. ``dedup_key`` از
|
هر اسکنر مستقل و مقاوم به خطاست؛ یک خطا بقیه را متوقف نمیکند. ``dedup_key`` از
|
||||||
ارسال تکراری جلوگیری میکند و تضمین میکند اجرای دوبارهٔ اسکنر رکورد جدیدی نسازد.
|
ارسال تکراری جلوگیری میکند و تضمین میکند اجرای دوبارهٔ اسکنر رکورد جدیدی نسازد.
|
||||||
|
|
||||||
یادآوریهای **دورهای** (بازدید و ثبت چک) کلیدشان شامل شمارهٔ دوره است. یعنی اگر
|
یادآوریهای **دورهای** (بازدید) کلیدشان شامل شمارهٔ دوره است. یعنی اگر مدیر یک مورد
|
||||||
مدیر یک مورد را از صف حذف کند، فقط همان دوره کنسل میشود و در دورهٔ بعد دوباره
|
را از صف حذف کند، فقط همان دوره کنسل میشود و در دورهٔ بعد دوباره ساخته میشود؛ برای
|
||||||
ساخته میشود؛ برای همیشه خاموش نمیماند.
|
همیشه خاموش نمیماند.
|
||||||
"""
|
"""
|
||||||
import logging
|
import logging
|
||||||
import os
|
|
||||||
from datetime import datetime, time, timedelta
|
from datetime import datetime, time, timedelta
|
||||||
|
|
||||||
from django.db.models import Q, Sum
|
|
||||||
from django.utils import timezone
|
from django.utils import timezone
|
||||||
|
|
||||||
from ..models import (Article, Customer, Factor, Sarresid, SMSProviderConfig,
|
from ..models import Customer, Sarresid, SMSProviderConfig, SMSTemplate, SMSType
|
||||||
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 .enqueue import enqueue_sms
|
||||||
from .timing import DEFAULT_VISIT_MONTHS
|
|
||||||
|
|
||||||
logger = logging.getLogger(__name__)
|
logger = logging.getLogger(__name__)
|
||||||
|
|
||||||
# پیشفرض فاصلهٔ تکرار «یادآوری ثبت چک» (روز) وقتی قالبی تنظیم نشده باشد.
|
|
||||||
CHEQUE_REG_INTERVAL_DEFAULT = 3
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
def _template(sms_type):
|
def _template(sms_type):
|
||||||
return SMSTemplate.objects.filter(sms_type=sms_type, is_enabled=True).first()
|
return SMSTemplate.objects.filter(sms_type=sms_type, is_enabled=True).first()
|
||||||
|
|
||||||
|
|
||||||
def _aware(value):
|
def _aware(value):
|
||||||
"""تبدیل تاریخ/ساعت naive به aware (کد قدیمی پروژه جاهایی مقدار naive ذخیره میکند)."""
|
"""تبدیل تاریخ/ساعت naive به aware (کد قدیمی پروژه جاهایی مقدار naive ذخیره میکند).
|
||||||
|
|
||||||
|
در روزهای تغییر ساعت، نیمهشب ممکن است وجود نداشته باشد؛ آن حالت هم پوشش داده
|
||||||
|
میشود تا یک ``installDate`` روی مرز DST اجرای کل اسکن را نشکند.
|
||||||
|
"""
|
||||||
if value is None:
|
if value is None:
|
||||||
return None
|
return None
|
||||||
if isinstance(value, datetime):
|
if isinstance(value, datetime):
|
||||||
if timezone.is_naive(value):
|
if timezone.is_naive(value):
|
||||||
return timezone.make_aware(value, timezone.get_current_timezone())
|
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
|
return value
|
||||||
# date → آغاز همان روز
|
# date → آغاز همان روز
|
||||||
return timezone.make_aware(
|
moment = datetime.combine(value, time.min)
|
||||||
datetime.combine(value, time.min), timezone.get_current_timezone(),
|
try:
|
||||||
)
|
return timezone.make_aware(moment, timezone.get_current_timezone())
|
||||||
|
except Exception:
|
||||||
|
return timezone.make_aware(
|
||||||
|
moment, timezone.get_current_timezone(), is_dst=False,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
class _Budget:
|
class _Budget:
|
||||||
"""ظرفیت صفکردن یک اسکنر در یک اجرا (خط شروع + سقف قدیمی + سقف کل)."""
|
"""ظرفیت صفکردن یک اسکنر در یک اجرا (خط شروع + سقف قدیمی + سقف کل)."""
|
||||||
|
|
||||||
def __init__(self, config):
|
def __init__(self, config, now=None):
|
||||||
self.since = config.scan_since
|
self.since = config.scan_since
|
||||||
|
# مرجع زمانی «خط شروع»؛ برای اسکن با زمان تزریقی (تست/بازپخش) همزمان میشود.
|
||||||
|
self.now = now
|
||||||
self.allow_backlog = bool(config.allow_backlog)
|
self.allow_backlog = bool(config.allow_backlog)
|
||||||
self.backlog_max = config.backlog_max or 0
|
self.backlog_max = config.backlog_max or 0
|
||||||
self.max_per_run = config.max_per_run or 0
|
self.max_per_run = config.max_per_run or 0
|
||||||
@@ -65,8 +78,21 @@ class _Budget:
|
|||||||
self.backlog_count = 0
|
self.backlog_count = 0
|
||||||
|
|
||||||
def is_backlog(self, trigger):
|
def is_backlog(self, trigger):
|
||||||
|
"""آیا این مورد پیش از «خط شروع» واجد شرط شده است؟
|
||||||
|
|
||||||
|
مرجع زمانی، «اکنونِ همین اجرا» است (``self.now``)؛ برای اسکن عادی همان
|
||||||
|
``timezone.now()`` و برای اسکن با زمان تزریقی همان لحظهٔ تزریقشده.
|
||||||
|
"""
|
||||||
trigger = _aware(trigger)
|
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):
|
def can_send(self, trigger):
|
||||||
if self.max_per_run and (self.new_count + self.backlog_count) >= self.max_per_run:
|
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
|
self.new_count += 1
|
||||||
|
|
||||||
|
|
||||||
def scan_cheque_due(today):
|
def scan_cheque_funding(today):
|
||||||
template = _template(SMSType.CHEQUE_DUE)
|
"""یادآوری «تأمین موجودی چک» چند روز **پیش از** سررسید چکِ پرداختنشده.
|
||||||
|
|
||||||
|
تعداد روزِ *قبل* از سررسید از قالب همین نوع (``offset_days`` در دیتابیس،
|
||||||
|
قابل ویرایش از پنل) خوانده میشود؛ مثلاً ``offset_days = 1`` یعنی یک روز پیش
|
||||||
|
از سررسید پیامک میرود تا مشتری فرصت تأمین موجودی داشته باشد.
|
||||||
|
|
||||||
|
پنجرهٔ یادآوری از «سررسید − offset روز» باز میشود و تا خودِ سررسید ادامه
|
||||||
|
دارد؛ پس اگر اسکنر چند روز از دست برود، یادآوری از دست نمیرود (چکهایی که
|
||||||
|
سررسیدشان رسیده هم واجد شرط میمانند). اگر چک پرداخت شود
|
||||||
|
(``payStatus=true``) دیگر یادآوری نمیگیرد؛ ``dedup_key`` نیز مانع ارسال
|
||||||
|
تکراری در اجراهای بعدی میشود.
|
||||||
|
"""
|
||||||
|
template = _template(SMSType.CHEQUE_REGISTRATION)
|
||||||
if template is None:
|
if template is None:
|
||||||
return 0
|
return 0
|
||||||
budget = _Budget(SMSProviderConfig.load())
|
budget = _Budget(SMSProviderConfig.load())
|
||||||
offset = template.offset_days or 0
|
offset = template.offset_days or 0
|
||||||
|
# پنجرهٔ یادآوری: از «سررسید − offset» تا «سررسید». یعنی فقط سررسیدهای
|
||||||
|
# امروز تا offset روز آینده واجد شرطاند و مقادیر دورتر هنوز پیامکی نمیگیرند.
|
||||||
|
# (سررسیدهای گذشته هم داخل شرط میمانند تا یک یادآوری از دست نرود.)
|
||||||
|
window_end = today + timedelta(days=max(offset, 0))
|
||||||
qs = Sarresid.objects.filter(
|
qs = Sarresid.objects.filter(
|
||||||
type="check", payStatus="false",
|
type="check", payStatus="false", sarresidDT__date__lte=window_end,
|
||||||
sarresidDT__date__gte=today,
|
|
||||||
sarresidDT__date__lte=today + timedelta(days=offset),
|
|
||||||
).select_related("customer").order_by("sarresidDT")
|
).select_related("customer").order_by("sarresidDT")
|
||||||
count = 0
|
count = 0
|
||||||
for s in qs:
|
for s in qs:
|
||||||
if not s.customer or not s.sarresidDT:
|
if not s.customer or not s.sarresidDT:
|
||||||
continue
|
continue
|
||||||
# پنجرهٔ یادآوری از «سررسید منهای offset» باز میشود.
|
due = s.sarresidDT.date()
|
||||||
|
# لحظهٔ باز شدن پنجرهٔ یادآوری = سررسید − offset روز.
|
||||||
trigger = _aware(s.sarresidDT) - timedelta(days=offset)
|
trigger = _aware(s.sarresidDT) - timedelta(days=offset)
|
||||||
if not budget.can_send(trigger):
|
if not budget.can_send(trigger):
|
||||||
continue
|
continue
|
||||||
days = (s.sarresidDT.date() - today).days
|
# روزهای باقیمانده تا سررسید؛ اگر سررسید دورتر از پنجره باشد پیامک نمیرود.
|
||||||
|
days = (due - today).days
|
||||||
|
if days > offset:
|
||||||
|
continue
|
||||||
made = enqueue_sms(
|
made = enqueue_sms(
|
||||||
customer=s.customer, sms_type=SMSType.CHEQUE_DUE,
|
customer=s.customer, sms_type=SMSType.CHEQUE_REGISTRATION,
|
||||||
context={
|
context={
|
||||||
"name": s.customer.name_family, "amount": s.price,
|
"name": s.customer.name_family, "amount": s.price,
|
||||||
"date": s.sarresidDT, "days": days, "check_row": s.check_row_number,
|
"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:
|
if made:
|
||||||
budget.record(trigger)
|
budget.record(trigger)
|
||||||
@@ -149,163 +194,66 @@ def scan_nesiye_due(today):
|
|||||||
return count
|
return count
|
||||||
|
|
||||||
|
|
||||||
def scan_cheque_registration(today):
|
def scan_visit(today, *, now=None):
|
||||||
"""یادآوری «ثبت اطلاعات چک» برای چکهای پرداختنشدهٔ ثبتنشده.
|
|
||||||
|
|
||||||
هر ``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):
|
|
||||||
"""یادآوری بازدید برای مشتریان عقبافتاده از بازدید (منطق صفحهٔ «انتظار»).
|
"""یادآوری بازدید برای مشتریان عقبافتاده از بازدید (منطق صفحهٔ «انتظار»).
|
||||||
|
|
||||||
لحظهٔ واجدشرطشدن هر مشتری = «آخرین بازدید + دورهٔ مجاز» (یا تاریخ نصب برای
|
لحظهٔ واجدشرطشدن هر مشتری = «آخرین بازدید معتبر + دورهٔ مجاز» (یا تاریخ نصب
|
||||||
مشتریانی که هرگز بازدید نشدهاند). اگر این لحظه پیش از خط شروع باشد، مورد قدیمی
|
برای مشتریانی که هرگز بازدید نشدهاند). مبنای «آخرین بازدید» و دوره، هر دو از
|
||||||
تلقی میشود و فقط با اجازهٔ صریح مدیر (و در سقف تعیینشده) ارسال میگردد.
|
``admin_panel.visit_policy`` میآیند تا این اسکنر و صفحهٔ ``entezar`` هرگز
|
||||||
|
دو جواب متفاوت ندهند. مشتری دارای «تعویق فعال» (هماهنگی در انتظار) یادآوری
|
||||||
|
نمیگیرد، چون قرار بعدی از قبل با او گذاشته شده است.
|
||||||
|
|
||||||
|
``now`` برای تست/بازپخش قابل تزریق است؛ پیشفرض «همین حالا» است.
|
||||||
|
|
||||||
|
اگر لحظهٔ واجدشرطشدن پیش از خط شروع باشد، مورد قدیمی تلقی میشود و فقط با
|
||||||
|
اجازهٔ صریح مدیر (و در سقف تعیینشده) ارسال میگردد.
|
||||||
"""
|
"""
|
||||||
template = _template(SMSType.VISIT)
|
template = _template(SMSType.VISIT)
|
||||||
if template is None:
|
if template is None:
|
||||||
return 0
|
return 0
|
||||||
budget = _Budget(SMSProviderConfig.load())
|
period = visit_period()
|
||||||
# دورهٔ بازدید: اول از قالب (قابل تنظیم از پنل)، وگرنه متغیر محیطی legacy، وگرنه پیشفرض.
|
now = timezone.now() if now is None else as_aware(now)
|
||||||
months = template.repeat_interval_months
|
budget = _Budget(SMSProviderConfig.load(), now=now)
|
||||||
if not months:
|
# لنگر چرخه: آخرین «بازدید» یا «نصب» (تصمیم محصولی). تماس تلفنی چرخه را ریست نمیکند.
|
||||||
try:
|
anchors = cycle_anchor_map(now=now)
|
||||||
months = int(os.environ.get("bazdid", DEFAULT_VISIT_MONTHS))
|
# قرار بعدی (هماهنگی توافقشده یا بازدید برنامهریزیشده) ⇒ یادآوری لازم نیست.
|
||||||
except (TypeError, ValueError):
|
appointments = next_appointment_map(now=now)
|
||||||
months = DEFAULT_VISIT_MONTHS
|
# مرز تاریخها باید به وقت **محلی** گرفته شود؛ `.date()` روی دیتاتایم aware،
|
||||||
period = timedelta(weeks=int(months * 4.3))
|
# تاریخ UTC میدهد که در ساعتهای اول شب تهران یک روز عقبتر است و باعث میشد
|
||||||
period_days = max(period.days, 1)
|
# مشتریِ دقیقاً روی مرز، از اسکن جا بیفتد.
|
||||||
now = timezone.now()
|
cutoff_date = (now - period).astimezone(timezone.get_current_timezone()).date()
|
||||||
qs = Customer.objects.filter(
|
qs = Customer.objects.filter(
|
||||||
laghv_bazdid=False,
|
laghv_bazdid=False,
|
||||||
is_active=True,
|
is_active=True,
|
||||||
installDate__lte=(now - period).date(),
|
installDate__lte=cutoff_date,
|
||||||
).order_by("id")
|
).order_by("id")
|
||||||
count = 0
|
count = 0
|
||||||
for customer in qs:
|
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:
|
if anchor is None:
|
||||||
continue
|
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 # هنوز عقبافتاده نیست
|
continue # هنوز عقبافتاده نیست
|
||||||
if not budget.can_send(trigger):
|
if not budget.can_send(trigger):
|
||||||
continue
|
continue
|
||||||
# چرخه = شمارهٔ دورهٔ کاملِ سپریشده از لنگر. کلید به چرخه گره میخورد تا
|
# کلید یکتاسازی = «موعد تقویمیِ» همان دوره، نه شمارش روز.
|
||||||
# حذفِ یادآوری توسط مدیر فقط همان «دوره» را کنسل کند و در دورههای بعدی
|
# با این قاعده هر دوره دقیقاً یک کلید دارد: ۹ ماه، ۱۸ ماه، ۲۷ ماه… .
|
||||||
# دوباره ساخته شود (نه اینکه برای همیشه خاموش بماند).
|
# (قاعدهٔ قبلی — days // 274 — با موعد تقویمی همتراز نبود و باعث
|
||||||
cycle = max((today - anchor.date()).days // period_days, 0)
|
# گمشدنِ یک دوره و تکرار/پرش شمارهٔ چرخه میشد.)
|
||||||
|
due_month = trigger.strftime("%Y-%m")
|
||||||
made = enqueue_sms(
|
made = enqueue_sms(
|
||||||
customer=customer, sms_type=SMSType.VISIT,
|
customer=customer, sms_type=SMSType.VISIT,
|
||||||
context={"name": customer.name_family},
|
context={"name": customer.name_family},
|
||||||
dedup_key=f"visit:{customer.id}:{cycle}",
|
dedup_key=f"visit:{customer.id}:{due_month}",
|
||||||
)
|
)
|
||||||
if made:
|
if made:
|
||||||
budget.record(trigger)
|
budget.record(trigger)
|
||||||
@@ -313,12 +261,12 @@ def scan_visit(today):
|
|||||||
return count
|
return count
|
||||||
|
|
||||||
|
|
||||||
|
# فقط انواعی که «موعد» دارند و دورهای اسکن میشوند؛ انواع رویدادی (خوشآمدگویی،
|
||||||
|
# نظرسنجی، ثبت بازدید، ثبت نصب، تشکر از پرداخت) در ``admin_panel/sms/triggers.py``
|
||||||
|
# توسط ویوها صف میشوند، نه اینجا.
|
||||||
SCANNERS = [
|
SCANNERS = [
|
||||||
("cheque_due", scan_cheque_due),
|
("cheque_registration", scan_cheque_funding),
|
||||||
("nesiye_due", scan_nesiye_due),
|
("nesiye_due", scan_nesiye_due),
|
||||||
("cheque_registration", scan_cheque_registration),
|
|
||||||
("debt_due", scan_debt_due),
|
|
||||||
("survey", scan_survey),
|
|
||||||
("visit", scan_visit),
|
("visit", scan_visit),
|
||||||
]
|
]
|
||||||
|
|
||||||
|
|||||||
+29
-34
@@ -9,8 +9,7 @@ from ..models import SMSType
|
|||||||
|
|
||||||
NONE = "none"
|
NONE = "none"
|
||||||
BEFORE_DUE = "before_due"
|
BEFORE_DUE = "before_due"
|
||||||
AFTER_CREATION = "after_creation"
|
AFTER_DUE = "after_due"
|
||||||
RECURRING = "recurring"
|
|
||||||
PERIOD_MONTHS = "period_months"
|
PERIOD_MONTHS = "period_months"
|
||||||
|
|
||||||
# پیشفرض دورهٔ بازدید (ماه) وقتی مدیر مقداری در قالب نگذاشته باشد.
|
# پیشفرض دورهٔ بازدید (ماه) وقتی مدیر مقداری در قالب نگذاشته باشد.
|
||||||
@@ -22,39 +21,18 @@ TIMING = {
|
|||||||
"field": None,
|
"field": None,
|
||||||
"note": "بهمحض ثبت مشتری و بدون تأخیر ارسال میشود؛ تنظیم زمانی ندارد.",
|
"note": "بهمحض ثبت مشتری و بدون تأخیر ارسال میشود؛ تنظیم زمانی ندارد.",
|
||||||
},
|
},
|
||||||
SMSType.CHEQUE_DUE: {
|
SMSType.SURVEY: {
|
||||||
|
"kind": NONE,
|
||||||
|
"field": None,
|
||||||
|
"note": "بیدرنگ پس از ثبت فاکتور ارسال میشود؛ تنظیم زمانی ندارد.",
|
||||||
|
},
|
||||||
|
SMSType.CHEQUE_REGISTRATION: {
|
||||||
"kind": BEFORE_DUE,
|
"kind": BEFORE_DUE,
|
||||||
"field": "offset_days",
|
"field": "offset_days",
|
||||||
"label": "چند روز قبل از سررسید چک",
|
"label": "چند روز قبل از سررسید چک",
|
||||||
"default": 2,
|
"default": 1,
|
||||||
"note": "پنجرهٔ یادآوری از «سررسید − این تعداد روز» باز میشود و تا سررسید ادامه دارد.",
|
"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": "روی سررسیدِ وصول مطالبات و فقط برای مشتریانی که مانده بدهکارند ارسال میشود.",
|
|
||||||
},
|
},
|
||||||
SMSType.VISIT: {
|
SMSType.VISIT: {
|
||||||
"kind": PERIOD_MONTHS,
|
"kind": PERIOD_MONTHS,
|
||||||
@@ -63,10 +41,27 @@ TIMING = {
|
|||||||
"default": DEFAULT_VISIT_MONTHS,
|
"default": DEFAULT_VISIT_MONTHS,
|
||||||
"note": "برای مشتریانی که از این مدت بازدید نشدهاند ارسال میشود.",
|
"note": "برای مشتریانی که از این مدت بازدید نشدهاند ارسال میشود.",
|
||||||
},
|
},
|
||||||
SMSType.CUSTOM: {
|
SMSType.VISIT_CREATED: {
|
||||||
"kind": NONE,
|
"kind": NONE,
|
||||||
"field": 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": "پنجرهٔ یادآوری از «سررسید − این تعداد روز» باز میشود و تا سررسید ادامه دارد.",
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -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,
|
||||||
|
)
|
||||||
@@ -129,4 +129,5 @@ input[disabled]{
|
|||||||
border-right: 1px solid #b7b7b7;
|
border-right: 1px solid #b7b7b7;
|
||||||
text-align: center;
|
text-align: center;
|
||||||
border-left: 1px solid #b7b7b7;
|
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 %}
|
|
||||||
@@ -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">
|
<div class="navbar-item has-dropdown is-hoverable">
|
||||||
<a class="navbar-link">پیامک</a>
|
<a class="navbar-link">پیامک</a>
|
||||||
<div class="navbar-dropdown">
|
<div class="navbar-dropdown">
|
||||||
|
{% if perms.admin_panel.ManageSMSSettings %}
|
||||||
<a href="{% url 'admin_panel:sms_settings' %}" style="padding-right: 10px;" class="navbar-item">
|
<a href="{% url 'admin_panel:sms_settings' %}" style="padding-right: 10px;" class="navbar-item">
|
||||||
تنظیمات سامانه
|
تنظیمات سامانه
|
||||||
</a>
|
</a>
|
||||||
<a href="{% url 'admin_panel:sms_templates' %}" style="padding-right: 10px;" class="navbar-item">
|
<a href="{% url 'admin_panel:sms_templates' %}" style="padding-right: 10px;" class="navbar-item">
|
||||||
قالبها
|
قالبها
|
||||||
</a>
|
</a>
|
||||||
|
{% endif %}
|
||||||
|
{% if perms.admin_panel.ManageSMS %}
|
||||||
<a href="{% url 'admin_panel:sms_queue' %}" style="padding-right: 10px;" class="navbar-item">
|
<a href="{% url 'admin_panel:sms_queue' %}" style="padding-right: 10px;" class="navbar-item">
|
||||||
صف ارسال
|
صف ارسال
|
||||||
</a>
|
</a>
|
||||||
|
<a href="{% url 'admin_panel:sms_report' %}" style="padding-right: 10px;" class="navbar-item">
|
||||||
|
گزارش ارسال
|
||||||
|
</a>
|
||||||
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
@@ -232,6 +239,8 @@
|
|||||||
|
|
||||||
{% block bodyPage %}
|
{% block bodyPage %}
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
|
{# بستن <div class=""> که بالاتر باز شده بود؛ پیشتر بسته نمیشد و HTML نامعتبر میشد. #}
|
||||||
|
</div>
|
||||||
|
|
||||||
</body>
|
</body>
|
||||||
<script>
|
<script>
|
||||||
|
|||||||
@@ -164,6 +164,8 @@
|
|||||||
|
|
||||||
{% block bodyPage %}
|
{% block bodyPage %}
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
|
{# بستن <div class=""> که بالاتر باز شده بود (همان باگ base.html). #}
|
||||||
|
</div>
|
||||||
|
|
||||||
</body>
|
</body>
|
||||||
<script>
|
<script>
|
||||||
|
|||||||
@@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
{% block BodyCustomer1 %}
|
{% 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 ">
|
<div id="action" class="column is-12-mobile is-12-desktop ">
|
||||||
|
|||||||
@@ -62,9 +62,12 @@
|
|||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% for action in actions %}
|
{% 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="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' %}
|
{% ifequal action.status 'finish' %}
|
||||||
<img class="" style="width: 20px; height: 20px;" src="{% static 'admin_panel/icons/check.png' %}">
|
<img class="" style="width: 20px; height: 20px;" src="{% static 'admin_panel/icons/check.png' %}">
|
||||||
{% endifequal %}
|
{% 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="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 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>
|
</div>
|
||||||
<div class="column is-12-mobile is-12-desktop actionBoxOpenB">
|
<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>
|
<p style="text-align: center; margin-bottom: 20px; color: #d90000; font-size: 18px;"> کارهای مانده از روزهای قبل</p>
|
||||||
|
|
||||||
{% for action in actionPr %}
|
{% 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="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">
|
||||||
{% ifequal action.status 'finish' %}
|
{% ifequal action.status 'finish' %}
|
||||||
@@ -161,27 +187,222 @@
|
|||||||
|
|
||||||
</div>
|
</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 %}
|
{% 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 %}
|
{% else %}
|
||||||
<form id="ActionBox" class="modal" method="post" action="">
|
<form id="ActionBox" class="modal" method="post" action="">
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% csrf_token %}
|
{% csrf_token %}
|
||||||
|
{# تأیید صریح کاربر برای عقببردن تاریخ قرار؛ فقط با زدن دکمهٔ تأیید پر میشود. #}
|
||||||
|
<input type="hidden" name="force_hold" id="forceHold" value="">
|
||||||
<div class="modal-background closeActionBox"></div>
|
<div class="modal-background closeActionBox"></div>
|
||||||
<div class="modal-card">
|
<div class="modal-card ax-card">
|
||||||
<header class="modal-card-head">
|
<header class="modal-card-head ax-head">
|
||||||
<p class="modal-card-title is-hidden">ایجاد وظیفه</p>
|
<div>
|
||||||
<button type="button" class="delete closeActionBox" aria-label="close"></button>
|
<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>
|
</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">
|
<div class="ax-section">
|
||||||
<label class="label">نوع اقدام</label>
|
<p class="ax-legend"><span class="ax-step">۱</span> نوع اقدام و مسئول</p>
|
||||||
<div class="control">
|
<div class="ax-grid">
|
||||||
<div class="select" style="width: 100%;">
|
<div class="ax-field">
|
||||||
<select id="actionType" required name="actionType" style="width: 100%;">
|
<label class="label ax-label" for="actionType">نوع اقدام</label>
|
||||||
|
<div class="select">
|
||||||
|
<select id="actionType" required name="actionType">
|
||||||
<option value="">انتخاب کنید</option>
|
<option value="">انتخاب کنید</option>
|
||||||
<option value="bazdid">بازدید</option>
|
<option value="bazdid">بازدید</option>
|
||||||
<option value="nasb">نصب</option>
|
<option value="nasb">نصب</option>
|
||||||
@@ -192,29 +413,11 @@
|
|||||||
</select>
|
</select>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
|
||||||
|
<div class="ax-field">
|
||||||
<div class="field column is-6-desktop is-12-mobile m-0">
|
<label class="label ax-label" for="userID">توسط</label>
|
||||||
<label class="label">تاریخ و ساعتی که کار باید انجام شود</label>
|
<div class="select">
|
||||||
<div class="control">
|
<select id="userID" required name="userID">
|
||||||
<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%;">
|
|
||||||
<option value="">انتخاب کنید</option>
|
<option value="">انتخاب کنید</option>
|
||||||
{% if perms.admin_panel.ViewStore %}
|
{% if perms.admin_panel.ViewStore %}
|
||||||
{% for auser in allUsers %}
|
{% for auser in allUsers %}
|
||||||
@@ -228,47 +431,199 @@
|
|||||||
</div>
|
</div>
|
||||||
</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">
|
|
||||||
این کار انجام شده
|
|
||||||
</label>
|
|
||||||
</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">
|
|
||||||
<input name="FinishDateTime" type="text" class="input dateTimePickerFinish-alt is-hidden">
|
|
||||||
</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>
|
</div>
|
||||||
|
|
||||||
|
{# ---------- گام ۲: زمانبندی ---------- #}
|
||||||
|
<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="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>
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
<footer class="modal-card-foot">
|
<footer class="modal-card-foot ax-foot">
|
||||||
<button type="button" class="button closeActionBox">لغو</button>
|
<button type="button" class="button closeActionBox">انصراف</button>
|
||||||
<input id="sabtBtn05" type="submit" class="button is-success" value="ثبت"/>
|
<input id="sabtBtn05" type="submit" class="button is-success" value="ثبت"/>
|
||||||
</footer>
|
</footer>
|
||||||
</div>
|
</div>
|
||||||
</form>
|
</form>
|
||||||
|
|
||||||
<script>
|
<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(){
|
$(".closeActionBox").click(function(){
|
||||||
$("#ActionBox").removeClass("is-active");
|
$("#ActionBox").removeClass("is-active");
|
||||||
});
|
});
|
||||||
|
|
||||||
$("#showActionBox").click(function(){
|
$("#showActionBox").click(function(){
|
||||||
|
isEditMode = false;
|
||||||
|
holdAutoChecked = false;
|
||||||
|
holdConfirmed = false;
|
||||||
|
$("#holdDoneWarning").addClass("is-hidden").removeClass("is-confirming");
|
||||||
$("#ActionBox").addClass("is-active");
|
$("#ActionBox").addClass("is-active");
|
||||||
{% if customer %}
|
{% if customer %}
|
||||||
var NewActionUrl = "{% url 'admin_panel:customerNewAction' customer.id %}";
|
var NewActionUrl = "{% url 'admin_panel:customerNewAction' customer.id %}";
|
||||||
@@ -282,22 +637,190 @@
|
|||||||
$("#actionResult").val('');
|
$("#actionResult").val('');
|
||||||
dateTimePickerAnjam.setDate();
|
dateTimePickerAnjam.setDate();
|
||||||
dateTimePickerFinish.setDate();
|
dateTimePickerFinish.setDate();
|
||||||
|
resetHoldPicker();
|
||||||
|
syncHoldBackward();
|
||||||
|
$(".showWhenCoordination").addClass("is-hidden");
|
||||||
|
closeHoldHelp();
|
||||||
$("#sabtBtn05").val("ثبت");
|
$("#sabtBtn05").val("ثبت");
|
||||||
});
|
});
|
||||||
|
|
||||||
$("#checkIsDone").change(function() {
|
// نمایش/پنهانکردن فیلدهای «انجام شده».
|
||||||
if(this.checked) {
|
function syncDoneFields() {
|
||||||
$(".showWhenDone").removeClass("is-hidden");
|
$(".showWhenDone").toggleClass("is-hidden", !$("#checkIsDone").prop("checked"));
|
||||||
} else {
|
}
|
||||||
$(".showWhenDone").addClass("is-hidden");
|
|
||||||
|
// هشدار «آیا هماهنگی را انجام دادی؟» فقط برای هماهنگیِ تیکخورده نمایش داده میشود.
|
||||||
|
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("ویرایش");
|
$("#sabtBtn05").val("ویرایش");
|
||||||
var actionEditUrl = "{% url 'admin_panel:customerEditAction' 1111 2222 %}";
|
var actionEditUrl = "{% url 'admin_panel:customerEditAction' 1111 2222 %}";
|
||||||
var action_id = $(this).parent().attr("action_id");
|
var row = $(this).parent();
|
||||||
var customer_id = $(this).parent().attr("customer_id");
|
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('1111', customer_id);
|
||||||
actionEditUrl = actionEditUrl.replace('2222', action_id);
|
actionEditUrl = actionEditUrl.replace('2222', action_id);
|
||||||
$("#ActionBox").prop("action", actionEditUrl);
|
$("#ActionBox").prop("action", actionEditUrl);
|
||||||
@@ -316,6 +839,16 @@
|
|||||||
}
|
}
|
||||||
$("#ActionBox").addClass("is-active");
|
$("#ActionBox").addClass("is-active");
|
||||||
$("#actionType").val(ActionParseData[0]['fields']['actionType']);
|
$("#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']);
|
$("#desc").val(ActionParseData[0]['fields']['desc']);
|
||||||
$("#userID").val(ActionParseData[0]['fields']['forUser']);
|
$("#userID").val(ActionParseData[0]['fields']['forUser']);
|
||||||
if(ActionParseData[0]['fields']['status'] == 'finish'){
|
if(ActionParseData[0]['fields']['status'] == 'finish'){
|
||||||
@@ -326,6 +859,8 @@
|
|||||||
$(".showWhenDone").addClass("is-hidden");
|
$(".showWhenDone").addClass("is-hidden");
|
||||||
}
|
}
|
||||||
$("#actionResult").val(ActionParseData[0]['fields']['result']);
|
$("#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({
|
var dateTimePickerAnjam = $(".dateTimePickerAnjam").pDatepicker({
|
||||||
altField: '.dateTimePickerAnjam-alt',
|
altField: '.dateTimePickerAnjam-alt',
|
||||||
initialValue: true,
|
initialValue: true,
|
||||||
|
|||||||
@@ -6,74 +6,7 @@
|
|||||||
<div class="">
|
<div class="">
|
||||||
<div class="columns m-0">
|
<div class="columns m-0">
|
||||||
<div class="column is-12-mobile is-4-desktop">
|
<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">
|
{% include "./_customer_info.html" %}
|
||||||
{% 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>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="column is-12-mobile is-8-desktop">
|
<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(){
|
$(".closeNewIteam").click(function(){
|
||||||
$("#addNewIteam").removeClass("is-active");
|
$("#addNewIteam").removeClass("is-active");
|
||||||
@@ -337,22 +265,6 @@ $(document).ready(function() {
|
|||||||
|
|
||||||
var test = 0
|
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(){
|
$(".closeSearch").click(function(){
|
||||||
$(".SearchBox").removeClass("is-active")
|
$(".SearchBox").removeClass("is-active")
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -7,7 +7,7 @@
|
|||||||
<div class="columns m-0">
|
<div class="columns m-0">
|
||||||
<div class="column is-12 px-2 pt-3 pb-0">
|
<div class="column is-12 px-2 pt-3 pb-0">
|
||||||
{% for message in messages %}
|
{% 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>
|
<button class="delete close-notification" type="button"></button>
|
||||||
<strong>{{ message }}</strong>
|
<strong>{{ message }}</strong>
|
||||||
</div>
|
</div>
|
||||||
@@ -18,108 +18,7 @@
|
|||||||
<div class="">
|
<div class="">
|
||||||
<div class="columns m-0">
|
<div class="columns m-0">
|
||||||
<div class="column is-12-mobile is-4-desktop">
|
<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">
|
{% include "./_customer_info.html" %}
|
||||||
{% 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>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="column is-12-mobile is-8-desktop">
|
<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="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 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>
|
<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 %}
|
{% endwith %}
|
||||||
|
|
||||||
@@ -505,11 +405,6 @@
|
|||||||
|
|
||||||
});
|
});
|
||||||
|
|
||||||
$("#del_customer").click(function(){
|
|
||||||
if(confirm("با حذف مشتری، تمام سوابق، فاکتورها و اطلاعات از سیستم حذف میشود، مطمئن هستید؟")){
|
|
||||||
window.location.href = "/panel/customer/{{ customer.id }}/del";
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
$(".closeNewIteam").click(function(){
|
$(".closeNewIteam").click(function(){
|
||||||
$("#addNewIteam").removeClass("is-active");
|
$("#addNewIteam").removeClass("is-active");
|
||||||
@@ -635,50 +530,6 @@ $(document).ready(function() {
|
|||||||
|
|
||||||
var test = 0;
|
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(){
|
$(".closeSearch").click(function(){
|
||||||
$(".SearchBox").removeClass("is-active")
|
$(".SearchBox").removeClass("is-active")
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -180,9 +180,12 @@
|
|||||||
</form>
|
</form>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
{% include "./_customer_sms.html" %}
|
|
||||||
</div>
|
</div>
|
||||||
|
{% comment %}
|
||||||
|
باکس «پیامک» از این صفحه حذف شد: تنظیمات پیامک به تب «سوابق پیامک» مشتری
|
||||||
|
(/panel/customer/<id>/sms/) منتقل شده تا فرم فاکتور تمامعرض بماند و سوابق و
|
||||||
|
تنظیمات هر دو در یک صفحهٔ اختصاصی دیده شوند.
|
||||||
|
{% endcomment %}
|
||||||
{% endblock %}
|
{% 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 %}
|
||||||
|
|
||||||
@@ -2,219 +2,642 @@
|
|||||||
{% load custom_tags %}
|
{% load custom_tags %}
|
||||||
{% block bodyPage %}
|
{% block bodyPage %}
|
||||||
|
|
||||||
<div class="">
|
<style>
|
||||||
<div class="columns m-0">
|
/* ===================================================================
|
||||||
|
صفحهٔ انتظار بازدید — 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">
|
.ez-stats-head { margin: 0 0 .55rem; }
|
||||||
<a href="#" id="openSearchBox" class="button is-info is-outlined is-rounded mr-0">جستجو</a>
|
.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>
|
||||||
|
|
||||||
|
<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">
|
<div class="table-container">
|
||||||
<table class="table has-text-centered is-bordered is-striped is-narrow is-hoverable is-fullwidth">
|
<table class="table ez-table">
|
||||||
<!-- Your table content -->
|
<colgroup>
|
||||||
|
{% for col in table_columns %}
|
||||||
|
<col style="width: {{ col.width }}%">
|
||||||
|
{% endfor %}
|
||||||
|
</colgroup>
|
||||||
<thead>
|
<thead>
|
||||||
<tr style="
|
<tr>
|
||||||
background: #33b5d3;
|
{% for col in sort_header %}
|
||||||
">
|
<th class="ez-th {% if col.active %}is-sorted{% endif %}">
|
||||||
<th >ردیف</th>
|
<a href="{{ col.link }}" title="مرتبسازی بر اساس {{ col.label }}">
|
||||||
<th style="min-width: 200px;">نام و نام خانودگی</th>
|
{{ col.label }}<span class="ez-arrow">{% if col.active %}{% if col.dir == 'asc' %}▲{% else %}▼{% endif %}{% else %}⇅{% endif %}</span>
|
||||||
<th >آخرین بازدید</th>
|
</a>
|
||||||
<th >تلفن</th>
|
</th>
|
||||||
<th style="min-width: 400px;">آدرس</th>
|
{% endfor %}
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{% for customer in customers %}
|
{% for customer in customers %}
|
||||||
<tr>
|
<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">
|
<input class="is-hidden fid fidv-20" value="20">
|
||||||
<a target="_blank" href="{% url 'admin_panel:customerAction' customer.id %}" class="tdvl name">
|
<span class="ez-idx">{{ forloop.counter0|add:customers.start_index }}</span>
|
||||||
{% if customer.name_family|length >= 2 %} {{ customer.name_family }} {% else %} نامعلوم {% endif %}
|
<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>
|
</a>
|
||||||
|
{% if customer.idCode %}<div class="ez-sub">کد: {{ customer.idCode }}</div>{% endif %}
|
||||||
</td>
|
</td>
|
||||||
<td>
|
{% with appt=appointment_rows|row_for:customer.id %}
|
||||||
<div class="tdvl lastView">
|
<td data-label="وضعیت" class="ez-nolabel">
|
||||||
{{ customer.last_bazdid_dt | toJalali }}
|
{% if appt.source_count > 1 %}
|
||||||
</div>
|
<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>
|
||||||
|
<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>
|
<td data-label="تلفن" class="ez-nowrap">
|
||||||
<div class="tdvl mobile_1">
|
<span class="tdvl mobile_1 ez-phone">
|
||||||
{{ customer.phone1 }}
|
{% if customer.phone1 %}{{ customer.phone1 }}{% else %}<span class="ez-muted">—</span>{% endif %}
|
||||||
</div>
|
</span>
|
||||||
<div class="tdvl is-hidden mobile_2">
|
<span class="tdvl is-hidden mobile_2">{{ customer.phone2 }}</span>
|
||||||
09384999655
|
<span class="tdvl is-hidden mobile_3">{{ customer.phone3 }}</span>
|
||||||
</div>
|
{# دکمههای اقدام سریع — فقط موبایل #}
|
||||||
<div class="tdvl is-hidden mobile_3">
|
<div class="ez-actions">
|
||||||
{{ customer.phone2 }}
|
{% if customer.phone1 %}
|
||||||
</div>
|
<a href="tel:{{ customer.phone1 }}" class="button is-success is-small">تماس</a>
|
||||||
</td>
|
{% endif %}
|
||||||
<td>
|
<a target="_blank" href="{% url 'admin_panel:customerAction' customer.id %}" class="button is-info is-small">ثبت اقدام</a>
|
||||||
<div class="tdvl address">
|
|
||||||
{{ customer.address }}
|
|
||||||
</div>
|
</div>
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
<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 %}
|
{% endfor %}
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
<div class="">
|
|
||||||
{% if customers.has_previous %}
|
|
||||||
<a class="button is-danger" href="?{% if searchVal %}searchVal={{ searchVal }}&searchOn={{ searchOn }}{% endif %}&page={{ customers.previous_page_number }}">صفحه قبل</a>
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
{% if customers.has_next %}
|
{# ===== صفحهبندی ===== #}
|
||||||
<a class="button is-danger" href="?{% if searchVal %}searchVal={{ searchVal }}&searchOn={{ searchOn }}{% endif %}&page={{ customers.next_page_number }}">صفحه بعد</a>
|
<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 is-small" href="{{ page_prev }}">صفحه قبل</a>
|
||||||
|
{% else %}<span></span>{% endif %}
|
||||||
|
|
||||||
{% endif %}
|
<span class="is-size-7 has-text-grey">
|
||||||
|
صفحهٔ {{ customers.number }} از {{ customers.paginator.num_pages }} ·
|
||||||
|
{{ customers.paginator.count }} مورد
|
||||||
|
</span>
|
||||||
|
|
||||||
</div>
|
{% if customers.has_next %}
|
||||||
|
<a class="button is-danger is-small" href="{{ page_next }}">صفحه بعد</a>
|
||||||
|
{% else %}<span></span>{% endif %}
|
||||||
|
</div>
|
||||||
</div>
|
</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 %}
|
{% endblock %}
|
||||||
{% block jsEnd %}
|
{% block jsEnd %}
|
||||||
<script>
|
<script>
|
||||||
$(document).ready(function() {
|
$(document).ready(function() {
|
||||||
|
// تغییر هر دراپداون ⇒ ارسال خودکار فرم فیلترها.
|
||||||
|
$(".ez-auto-submit").on('change', function () {
|
||||||
|
$(this).closest('form').trigger('submit');
|
||||||
|
});
|
||||||
|
|
||||||
kamaDatepicker('persianDateP', { buttonsColor: "red", forceFarsiDigits: true });
|
// مقدار «مرتبسازی» با علامتِ جهت ترکیب میشود (مثلاً 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('');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
$(".closeBazdidF").click(function(){
|
// تقویم شمسی برای ناوبری روزهای نمای «نیازمند پیگیری».
|
||||||
$(".BazdidF").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');
|
||||||
|
}
|
||||||
});
|
});
|
||||||
|
}
|
||||||
$("#openSearchBox").click(function(){
|
{% endif %}
|
||||||
$(".SearchBox").addClass("is-active")
|
});
|
||||||
});
|
|
||||||
|
|
||||||
$(".closeSearch").click(function(){
|
|
||||||
$(".SearchBox").removeClass("is-active")
|
|
||||||
});
|
|
||||||
|
|
||||||
$(".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")
|
|
||||||
});
|
|
||||||
} );
|
|
||||||
</script>
|
</script>
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
@@ -12,6 +12,9 @@
|
|||||||
حذف یک مورد، فقط همان نوبت را کنسل میکند. یادآوریهای دورهای (بازدید و ثبت
|
حذف یک مورد، فقط همان نوبت را کنسل میکند. یادآوریهای دورهای (بازدید و ثبت
|
||||||
اطلاعات چک) در <strong>دورهٔ بعدی</strong> دوباره ساخته میشوند؛ پس با حذف یک
|
اطلاعات چک) در <strong>دورهٔ بعدی</strong> دوباره ساخته میشوند؛ پس با حذف یک
|
||||||
مورد، پیامک برای آن مشتری برای همیشه قطع نمیشود.
|
مورد، پیامک برای آن مشتری برای همیشه قطع نمیشود.
|
||||||
|
<br>
|
||||||
|
پیامکهای <strong>ارسالشده</strong> از این صف بیرون میروند؛ فهرست و سابقهٔ
|
||||||
|
کاملشان در <a href="{% url 'admin_panel:sms_report' %}">گزارش ارسال</a> است.
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="columns is-multiline mb-2" dir="rtl">
|
<div class="columns is-multiline mb-2" dir="rtl">
|
||||||
@@ -21,6 +24,13 @@
|
|||||||
<p class="title is-5 mb-0">{{ total_count }}</p>
|
<p class="title is-5 mb-0">{{ total_count }}</p>
|
||||||
</div>
|
</div>
|
||||||
</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 %}
|
{% for code, label, count in status_stats %}
|
||||||
<div class="column is-narrow">
|
<div class="column is-narrow">
|
||||||
<a href="?status={{ code }}" class="box py-3 px-4 has-text-centered"
|
<a href="?status={{ code }}" class="box py-3 px-4 has-text-centered"
|
||||||
@@ -71,11 +81,12 @@
|
|||||||
</form>
|
</form>
|
||||||
|
|
||||||
<div class="notification is-danger is-light is-flex is-align-items-center is-justify-content-space-between mb-3">
|
<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' %}"
|
<form method="post" action="{% url 'admin_panel:sms_queue_empty' %}"
|
||||||
onsubmit="return confirm('کل صف پیامک خالی شود؟ این پیامکها دیگر هرگز ارسال یا بازسازی نمیشوند.');">
|
onsubmit="return confirm('صف پیامک خالی شود؟ این پیامکها دیگر هرگز ارسال یا بازسازی نمیشوند.');">
|
||||||
{% csrf_token %}
|
{% csrf_token %}
|
||||||
<button class="button is-danger" type="submit">خالی کردن کل صف</button>
|
<button class="button is-danger" type="submit">خالی کردن صف</button>
|
||||||
</form>
|
</form>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -119,11 +130,17 @@
|
|||||||
<button class="button is-small is-warning" type="submit">ارسال مجدد</button>
|
<button class="button is-small is-warning" type="submit">ارسال مجدد</button>
|
||||||
</form>
|
</form>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
{% if item.status != 'sent' %}
|
||||||
<form method="post" action="{% url 'admin_panel:sms_queue_delete' item.id %}"
|
<form method="post" action="{% url 'admin_panel:sms_queue_delete' item.id %}"
|
||||||
onclick="return confirm('این پیامک از صف حذف شود؟');">
|
onclick="return confirm('این پیامک از صف حذف شود؟');">
|
||||||
{% csrf_token %}
|
{% csrf_token %}
|
||||||
<button class="button is-small is-danger" type="submit">حذف</button>
|
<button class="button is-small is-danger" type="submit">حذف</button>
|
||||||
</form>
|
</form>
|
||||||
|
{% else %}
|
||||||
|
<a class="button is-small is-light"
|
||||||
|
href="{% url 'admin_panel:sms_report' %}?q={{ item.phone_number }}"
|
||||||
|
title="این پیامک ارسال شده است؛ سابقهٔ آن در گزارش ارسال است">در گزارش</a>
|
||||||
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</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">
|
<div class="box">
|
||||||
<form method="post" action="{% url 'admin_panel:sms_settings' %}">
|
<form method="post" action="{% url 'admin_panel:sms_settings' %}">
|
||||||
{% csrf_token %}
|
{% csrf_token %}
|
||||||
|
<h2 class="title is-5">اتصال به سامانه پیامک</h2>
|
||||||
|
<p class="help mb-3">
|
||||||
|
این بخش مشخص میکند پیامکها <strong>از چه مسیری و با چه حساب کاربری</strong> به
|
||||||
|
اپراتور سپرده میشوند. تا وقتی «وضعیت ارسال» روشن نباشد، هیچکدام از سرویسهای
|
||||||
|
پسزمینه (worker) پیامکی نمیفرستند.
|
||||||
|
</p>
|
||||||
|
|
||||||
<div class="columns is-multiline">
|
<div class="columns is-multiline">
|
||||||
<div class="field column is-4-desktop is-12-mobile">
|
<div class="field column is-4-desktop is-12-mobile">
|
||||||
<label class="label">سرویسدهنده</label>
|
<label class="label">سرویسدهنده</label>
|
||||||
@@ -19,6 +26,19 @@
|
|||||||
</select>
|
</select>
|
||||||
</div>
|
</div>
|
||||||
</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>
|
||||||
|
|
||||||
<div class="field column is-4-desktop is-12-mobile">
|
<div class="field column is-4-desktop is-12-mobile">
|
||||||
@@ -29,6 +49,11 @@
|
|||||||
فعال باشد
|
فعال باشد
|
||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>کلید اصلی خاموش/روشن ارسال.</strong> اگر تیک نخورد، سرویس worker هیچ
|
||||||
|
پیامکی نمیفرستد (ردیفها در صف میمانند). اسکنر و صفکردن مستقل از این است،
|
||||||
|
پس میتوانید پیامکها را از قبل در صف بچینید و بعد ارسال را روشن کنید.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-4-desktop is-12-mobile">
|
<div class="field column is-4-desktop is-12-mobile">
|
||||||
@@ -36,6 +61,13 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="number" name="timeout_seconds" value="{{ config.timeout_seconds }}">
|
<input class="input" type="number" name="timeout_seconds" value="{{ config.timeout_seconds }}">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>حداکثر زمان انتظار worker برای پاسخ سرویسدهنده</strong> در هر تلاش.
|
||||||
|
اگر پاسخ دیرتر بیاید، آن تلاش «ناموفق» ثبت میشود و بر اساس سیاست تلاش مجدد
|
||||||
|
دوباره در نوبت قرار میگیرد. مقدار کم (مثل ۵) ممکن است در سرویس کند، ارسالهای
|
||||||
|
سالم را هم ناموفق کند؛ مقدار زیاد (مثل ۱۲۰) در قطعی سرویس، worker را بیکار
|
||||||
|
نگه میدارد. پیشفرض ۳۰ ثانیه متعادل است.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-12-mobile">
|
<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">
|
<input class="input" type="text" name="api_url" value="{{ config.api_url }}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
<p class="help">
|
<p class="help">
|
||||||
برای 0098SMS همین آدرس لینکی ارسال است
|
<strong>آدرس درخواست ارسال برای providerهای «لینکی HTTP» و «HTTP عمومی».</strong>
|
||||||
|
<br>• برای 0098SMS لینکی همین آدرس است
|
||||||
(<span dir="ltr">http://www.0098sms.com/sendsmslink.aspx</span>)؛ این سرویس
|
(<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>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -56,8 +93,9 @@
|
|||||||
<input class="input" type="text" name="webservice_url" value="{{ config.webservice_url }}" dir="ltr">
|
<input class="input" type="text" name="webservice_url" value="{{ config.webservice_url }}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
<p class="help">
|
<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>
|
<span dir="ltr">https://webservice.0098sms.com/service.asmx</span>
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
@@ -67,7 +105,11 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="text" name="panel_no" value="{{ config.panel_no }}" dir="ltr">
|
<input class="input" type="text" name="panel_no" value="{{ config.panel_no }}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
<p class="help">اگر خالی بماند از «شماره خط فرستنده» استفاده میشود.</p>
|
<p class="help">
|
||||||
|
<strong>شمارهٔ اختصاصی حساب شما در وبسرویس</strong> (فقط provider وبسرویس).
|
||||||
|
اگر خالی بماند، سیستم از «شماره خط فرستنده» استفاده میکند. مقدار اشتباه باعث
|
||||||
|
رد شدن ارسال با خطای احراز هویت میشود.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-4-desktop is-12-mobile">
|
<div class="field column is-4-desktop is-12-mobile">
|
||||||
@@ -75,6 +117,10 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="text" name="username" value="{{ config.username }}" dir="ltr">
|
<input class="input" type="text" name="username" value="{{ config.username }}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>نام کاربری حساب سامانهٔ پیامک</strong> (در همهٔ providerها بهجز Console
|
||||||
|
لازم است). اگر اشتباه باشد، ارسالها رد میشوند و در «خطا» صف ثبت میگردد.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-4-desktop is-12-mobile">
|
<div class="field column is-4-desktop is-12-mobile">
|
||||||
@@ -82,6 +128,11 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="password" name="password" placeholder="{% if config.password %}(بدون تغییر){% endif %}" dir="ltr">
|
<input class="input" type="password" name="password" placeholder="{% if config.password %}(بدون تغییر){% endif %}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>رمز حساب سامانهٔ پیامک.</strong> برای امنیت، مقدار ذخیرهشده بازخوانی
|
||||||
|
نمیشود؛ این کادر را <strong>خالی بگذارید</strong> تا رمز قبلی بماند و فقط وقتی
|
||||||
|
رمز عوض شده، مقدار جدید را وارد کنید.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-4-desktop is-12-mobile">
|
<div class="field column is-4-desktop is-12-mobile">
|
||||||
@@ -89,6 +140,12 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="text" name="sender" value="{{ config.sender }}" dir="ltr">
|
<input class="input" type="text" name="sender" value="{{ config.sender }}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>شماره یا عنوان خطی که پیامک با آن به دست مشتری میرسد.</strong> باید
|
||||||
|
جزو خطوط مجاز حساب شما باشد؛ در غیر این صورت اپراتور ارسال را رد میکند.
|
||||||
|
همچنین در provider وبسرویس، اگر «شمارهٔ پنل» خالی باشد همین مقدار جای آن
|
||||||
|
استفاده میشود.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-12-mobile">
|
<div class="field column is-12-mobile">
|
||||||
@@ -96,15 +153,23 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="password" name="api_token" placeholder="{% if config.api_token %}(بدون تغییر){% endif %}" dir="ltr">
|
<input class="input" type="password" name="api_token" placeholder="{% if config.api_token %}(بدون تغییر){% endif %}" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>کلید/توکن احراز هویت providerهای «HTTP عمومی».</strong> برای 0098SMS
|
||||||
|
لازم نیست. مثل رمز، خالی گذاشتن آن یعنی «بدون تغییر».
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<hr>
|
<hr>
|
||||||
<h2 class="title is-5">کنترل جریان ارسال</h2>
|
<h2 class="title is-5">کنترل جریان ارسال</h2>
|
||||||
<p class="help mb-3">
|
<p class="help mb-3">
|
||||||
برای جلوگیری از سیل پیامک: تنها مواردی ارسال میشوند که پنجرهٔ یادآوریشان از
|
این بخش تعیین میکند اسکنر دورهای <strong>چه چیزی و چقدر</strong> در هر اجرا در صف
|
||||||
«خط شروع» به بعد باز شود. موارد قدیمیتر تنها با روشنکردن «اجازهٔ موارد قدیمی»
|
بگذارد. اسکنر هر چند دقیقه یکبار اجرا میشود و بر اساس «سررسیدها» تصمیم میگیرد
|
||||||
و در سقف تعیینشده ارسال میشوند. بین هر پیامک هم فاصلهٔ زمانی رعایت میشود.
|
کدام مشتری باید یادآوری بگیرد. منطق بودجه به این شکل است:
|
||||||
|
<strong>سقف هر اجرا</strong> ← تعیین میکند کلاً چند مورد صف شود؛
|
||||||
|
<strong>خط شروع</strong> ← موارد قدیمیتر از آن را کنار میگذارد؛
|
||||||
|
<strong>اجازهٔ موارد قدیمی + سقف آن</strong> ← تصمیم میگیرد از آن موارد کنارگذاشتهشده
|
||||||
|
چند تا (اگر لازم بود) ارسال شود.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<div class="columns is-multiline">
|
<div class="columns is-multiline">
|
||||||
@@ -116,9 +181,15 @@
|
|||||||
placeholder="مثلاً 1403/07/18 — خالی = همین حالا" dir="ltr">
|
placeholder="مثلاً 1403/07/18 — خالی = همین حالا" dir="ltr">
|
||||||
</div>
|
</div>
|
||||||
<p class="help">
|
<p class="help">
|
||||||
فقط یادآوریهایی صف میشوند که «پنجرهٔ» آنها از این تاریخ به بعد باز شده باشد.
|
<strong>خط جداکنندهٔ «موارد جدید» از «موارد قدیمی».</strong>
|
||||||
مشتریان قدیمیتری که پنجرهشان پیش از این تاریخ باز شده، وارد صف نمیشوند.
|
هر مورد (چک، نسیه، بازدید) یک «لحظهٔ باز شدن پنجرهٔ یادآوری» دارد. اگر این
|
||||||
قالب: <span dir="ltr">YYYY/MM/DD</span> (شمسی) — خالی = همین حالا.
|
لحظه <strong>از این تاریخ به بعد</strong> باشد، مورد «جدید» است و آزادانه صف
|
||||||
|
میشود؛ اگر <strong>قبل از</strong> آن باشد، «قدیمی» (backlog) حساب میشود.
|
||||||
|
<br>• هدف اصلی: در نخستین راهاندازی، هزاران مشتری قدیمیِ واجد شرط یکباره پیامک
|
||||||
|
نگیرند.
|
||||||
|
<br>• قالب: <span dir="ltr">YYYY/MM/DD</span> شمسی — خالی = همین حالا.
|
||||||
|
<br>• عوضکردن آن به گذشته، مشتریان قدیمیتر را «جدید» میکند و ممکن است سیل پیامک
|
||||||
|
بسازد؛ با احتیاط تغییر دهید.
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -127,6 +198,19 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="number" min="0" name="max_per_run" value="{{ config.max_per_run }}">
|
<input class="input" type="number" min="0" name="max_per_run" value="{{ config.max_per_run }}">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>سقف کل صفکردن در یک اجرا — بهازای هر اسکنر جداگانه.</strong>
|
||||||
|
<br>• «هر اسکنر» یعنی این عدد برای هر نوع یادآوری مستقل اعمال میشود
|
||||||
|
(تأمین موجودی چک، سررسید نسیه، بازدید دورهای)؛ پس اگر ۱۰۰ باشد و هر سه اسکنر
|
||||||
|
واجد شرط باشند، در یک اجرا حداکثر ۱۰۰ + ۱۰۰ + ۱۰۰ = ۳۰۰ ردیف صف میشود.
|
||||||
|
<br>• شمارش از مجموع «جدیدها + موارد قدیمی» است، نه فقط جدیدها.
|
||||||
|
<br>• <strong>۰ = بینهایت</strong> (هیچ سقفی اعمال نمیشود).
|
||||||
|
<br>• چون اسکنر دورهای اجرا میشود، سقف باعث «دستهدسته» شدن ارسالهای انبوه
|
||||||
|
میشود (بقیه در اجراهای بعدی میآیند) و از ریختن یکبارهٔ صدها پیامک روی ارسال
|
||||||
|
جلوگیری میکند.
|
||||||
|
<br>• نکته: این سقفها روی «صفکردن» اثر دارند، نه سرعت ارسال واقعی؛ سرعت ارسال
|
||||||
|
به «فاصلهٔ بین هر پیامک» بستگی دارد.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-3-desktop is-6-mobile">
|
<div class="field column is-3-desktop is-6-mobile">
|
||||||
@@ -134,6 +218,11 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="number" min="0" name="send_interval_seconds" value="{{ config.send_interval_seconds }}">
|
<input class="input" type="number" min="0" name="send_interval_seconds" value="{{ config.send_interval_seconds }}">
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>مکث سرویس worker پس از هر ارسال</strong> تا اپراتور زیر بار زیاد نرود.
|
||||||
|
مثال: با مقدار ۳، ارسال ۱۰۰ پیامک حدود ۵ دقیقه طول میکشد. مقدار ۰ یعنی بدون
|
||||||
|
مکث (سریع ولی پرخطر — ممکن است سرویسدهنده محدودتان کند).
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-3-desktop is-6-mobile">
|
<div class="field column is-3-desktop is-6-mobile">
|
||||||
@@ -144,6 +233,12 @@
|
|||||||
فعال باشد
|
فعال باشد
|
||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
|
<p class="help">
|
||||||
|
<strong>دربِ موارد «قدیمیتر از تاریخ شروع دوره».</strong> بهصورت پیشفرض بسته
|
||||||
|
است. تا وقتی بسته باشد، موارد قدیمی <strong>هرگز</strong> صف نمیشوند (حتی اگر
|
||||||
|
سقف باقی باشد). اگر لازم بود این موارد هم پردازش شوند، آن را روشن کنید و مقدار
|
||||||
|
«حداکثر موارد قدیمی در هر اجرا» را تعیین کنید.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="field column is-3-desktop is-6-mobile">
|
<div class="field column is-3-desktop is-6-mobile">
|
||||||
@@ -151,7 +246,15 @@
|
|||||||
<div class="control">
|
<div class="control">
|
||||||
<input class="input" type="number" min="0" name="backlog_max" value="{{ config.backlog_max }}">
|
<input class="input" type="number" min="0" name="backlog_max" value="{{ config.backlog_max }}">
|
||||||
</div>
|
</div>
|
||||||
<p class="help">صفر = هیچ مورد قدیمی ارسال نمیشود.</p>
|
<p class="help">
|
||||||
|
<strong>سقف ارسال موارد قدیمی در هر اجرا، بهازای هر اسکنر.</strong>
|
||||||
|
<br>• فقط وقتی «اجازهٔ ارسال موارد قدیمی» روشن باشد اثر دارد.
|
||||||
|
<br>• صفر = هیچ مورد قدیمی ارسال نمیشود (حتی با روشنبودن کلید).
|
||||||
|
<br>• این سقف <strong>در کنار</strong> «حداکثر پیامک هر اسکنر» اعمال میشود؛ پس
|
||||||
|
ممکن است ابتدا سقف کل (max_per_run) پر شود.
|
||||||
|
<br>• برای پاککردن تدریجی انبار قدیمی، عدد کوچکی مثل ۵۰ بگذارید تا در هر اجرا
|
||||||
|
دستهای ارسال شود.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@@ -20,6 +20,34 @@ def toJalaliDT(value):
|
|||||||
def has_group(user, group_name):
|
def has_group(user, group_name):
|
||||||
return user.groups.filter(name=group_name).exists()
|
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('has_group', has_group)
|
||||||
register.filter('toJalali', toJalali)
|
register.filter('toJalali', toJalali)
|
||||||
register.filter('toJalaliDT', toJalaliDT)
|
register.filter('toJalaliDT', toJalaliDT)
|
||||||
|
register.filter('row_for', row_for)
|
||||||
@@ -37,6 +37,7 @@ urlpatterns = [
|
|||||||
path('customer/<int:c_id>/nazar/', views.customerNazar, name='customerNazar'),
|
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/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>/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>/del', views.customerDel, name='customerDel'),
|
||||||
path('customer/<int:c_id>/factors/', views.customerFactors, name='customerFactors'),
|
path('customer/<int:c_id>/factors/', views.customerFactors, name='customerFactors'),
|
||||||
path('customer/<int:c_id>/factor/<int:f_id>', views.customerFactor, name='customerFactor'),
|
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('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/settings', views.sms_settings, name='sms_settings'),
|
||||||
path('sms/templates', views.sms_templates, name='sms_templates'),
|
path('sms/templates', views.sms_templates, name='sms_templates'),
|
||||||
path('sms/template/<int:t_id>/edit', views.sms_template_edit, name='sms_template_edit'),
|
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>/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/customer/<int:c_id>/send', views.sms_send_custom, name='sms_send_custom'),
|
||||||
path('sms/queue', views.sms_queue, name='sms_queue'),
|
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/bulk', views.sms_queue_bulk, name='sms_queue_bulk'),
|
||||||
path('sms/queue/empty', views.sms_queue_empty, name='sms_queue_empty'),
|
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'),
|
path('sms/queue/<int:q_id>/approve', views.sms_queue_approve, name='sms_queue_approve'),
|
||||||
|
|||||||
+331
-78
@@ -1,12 +1,24 @@
|
|||||||
import datetime
|
import datetime
|
||||||
|
|
||||||
|
from django.core.exceptions import ValidationError
|
||||||
from django.db.models import Q
|
from django.db.models import Q
|
||||||
from django.shortcuts import render, redirect, get_object_or_404
|
from django.shortcuts import render, redirect, get_object_or_404
|
||||||
from django.http import HttpResponse
|
from django.http import HttpResponse
|
||||||
|
from django.contrib import messages
|
||||||
from django.contrib.auth.models import User
|
from django.contrib.auth.models import User
|
||||||
from django.contrib.auth.decorators import login_required
|
from django.contrib.auth.decorators import login_required
|
||||||
|
from django.utils import timezone
|
||||||
|
from persiantools.jdatetime import JalaliDate
|
||||||
|
|
||||||
from ..models import Action, Customer
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@@ -18,8 +30,12 @@ def customerAction(request, c_id):
|
|||||||
filter_type = request.GET.get('actionType', 'all')
|
filter_type = request.GET.get('actionType', 'all')
|
||||||
filter_status = request.GET.get('status', 'all')
|
filter_status = request.GET.get('status', 'all')
|
||||||
|
|
||||||
# کوئری پایه برای اقدامات این مشتری
|
# کوئری پایه برای اقدامات این مشتری.
|
||||||
|
# اقدامهای حذفشده (soft-delete) بهطور پیشفرض نمایش داده نمیشوند؛ با
|
||||||
|
# فیلتر صریح `status=cancell` میتوان آنها را دید (برای حسابرسی).
|
||||||
actions = Action.objects.filter(customer=customer)
|
actions = Action.objects.filter(customer=customer)
|
||||||
|
if filter_status != 'cancell':
|
||||||
|
actions = actions.filter(deleted_at__isnull=True)
|
||||||
|
|
||||||
# اعمال فیلتر بر اساس نوع اقدام (بازدید، نصب و ...)
|
# اعمال فیلتر بر اساس نوع اقدام (بازدید، نصب و ...)
|
||||||
if filter_type != 'all':
|
if filter_type != 'all':
|
||||||
@@ -48,48 +64,216 @@ def customerAction(request, c_id):
|
|||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def customerNazar(request ,c_id):
|
def customerNazar(request ,c_id):
|
||||||
customer = Customer.objects.get(id=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')
|
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
|
||||||
data = {'customer': customer, 'actions': actions, 'allUsers': allUsers}
|
data = {'customer': customer, 'actions': actions, 'allUsers': allUsers}
|
||||||
return render(request, 'admin_panel/customer/nazar.html', data)
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def customerNewAction(request ,c_id):
|
def customerNewAction(request ,c_id):
|
||||||
actionType = request.POST.get('actionType', None)
|
payload = _action_payload_from_request(request)
|
||||||
dateTimeAnjam = request.POST.get('dateTimeAnjam', None)
|
|
||||||
#return HttpResponse(float(dateTimeAnjam+".0"))
|
|
||||||
try:
|
try:
|
||||||
dateTimeAnjam = datetime.datetime.fromtimestamp(int(dateTimeAnjam)/1e3)
|
validate_action_payload(payload)
|
||||||
except:
|
# اعتبارسنجی «قرار بعدی» پیش از هر نوشتنی (سقف ۶ ماه و تاریخ گذشته).
|
||||||
pass
|
if payload['actionType'] == Action.ActionType.HAMAHANGI and payload['holdRaw']:
|
||||||
desc = request.POST.get('desc', None)
|
normalize_hold_until(payload['holdRaw'])
|
||||||
userID = request.POST.get('userID', None)
|
except ValidationError as error:
|
||||||
is_done = request.POST.get('is_done', None)
|
return _reject(request, error, '/panel/customer/' + str(c_id) + '/action')
|
||||||
result = request.POST.get('result', None)
|
|
||||||
FinishDateTime = request.POST.get('FinishDateTime', None)
|
|
||||||
try:
|
|
||||||
FinishDateTime = datetime.datetime.fromtimestamp(int(FinishDateTime)/1e3)
|
|
||||||
except:
|
|
||||||
pass
|
|
||||||
|
|
||||||
customer_obj = Customer.objects.get(id=int(c_id))
|
customer_obj = Customer.objects.get(id=int(c_id))
|
||||||
newAction = Action()
|
newAction = Action()
|
||||||
newAction.actionType = actionType
|
newAction.actionType = payload['actionType']
|
||||||
newAction.actionDateTime = dateTimeAnjam
|
newAction.actionDateTime = payload['actionDateTime']
|
||||||
newAction.desc = desc
|
newAction.desc = payload['desc']
|
||||||
newAction.forUser = User.objects.get(id=int(userID))
|
newAction.forUser = User.objects.get(id=int(payload['userID']))
|
||||||
newAction.customer = customer_obj
|
newAction.customer = customer_obj
|
||||||
if is_done:
|
if payload['is_done']:
|
||||||
newAction.status = 'finish'
|
newAction.status = Action.Status.FINISH
|
||||||
newAction.finishDateTime = FinishDateTime
|
# تاریخ اتمام خالی نباید None ذخیره شود (سابقه را پاک میکرد).
|
||||||
newAction.result = result
|
newAction.finishDateTime = normalize_finish_datetime(payload['finishDateTime'])
|
||||||
|
newAction.result = payload['result']
|
||||||
else:
|
else:
|
||||||
newAction.status = 'waite'
|
newAction.status = Action.Status.WAITE
|
||||||
newAction.save()
|
newAction.save()
|
||||||
|
|
||||||
if newAction.status == 'finish' and newAction.actionType == 'bazdid':
|
# last_bazdid_dt فقط از تابع واحد بازمحاسبه میشود؛ نه از finishDateTime.
|
||||||
customer_obj.last_bazdid_dt = newAction.finishDateTime
|
refresh_last_bazdid(customer_obj, reason=REASON_CREATE, user=request.user)
|
||||||
customer_obj.save()
|
# «قرار بعدی» فقط برای هماهنگی.
|
||||||
|
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')
|
return redirect('/panel/customer/'+str(c_id)+'/action')
|
||||||
|
|
||||||
@@ -111,61 +295,133 @@ def ActionListUser(request, u_id):
|
|||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def customerEditAction(request ,c_id, action_id):
|
def customerEditAction(request ,c_id, action_id):
|
||||||
|
|
||||||
actionType = request.POST.get('actionType', None)
|
payload = _action_payload_from_request(request)
|
||||||
dateTimeAnjam = request.POST.get('dateTimeAnjam', None)
|
|
||||||
print("ok")
|
|
||||||
#return HttpResponse(float(dateTimeAnjam+".0"))
|
|
||||||
try:
|
try:
|
||||||
dateTimeAnjam = datetime.datetime.fromtimestamp(int(dateTimeAnjam)/1e3)
|
validate_action_payload(payload)
|
||||||
except:
|
if payload['actionType'] == Action.ActionType.HAMAHANGI and payload['holdRaw']:
|
||||||
pass
|
normalize_hold_until(payload['holdRaw'])
|
||||||
desc = request.POST.get('desc', None)
|
except ValidationError as error:
|
||||||
userID = request.POST.get('userID', None)
|
return _reject(
|
||||||
is_done = request.POST.get('is_done', None)
|
request, error,
|
||||||
result = request.POST.get('result', None)
|
request.META.get('HTTP_REFERER', '/panel/customer/' + str(c_id) + '/action'),
|
||||||
FinishDateTime = request.POST.get('FinishDateTime', None)
|
)
|
||||||
try:
|
|
||||||
FinishDateTime = datetime.datetime.fromtimestamp(int(FinishDateTime)/1e3)
|
|
||||||
except:
|
|
||||||
pass
|
|
||||||
|
|
||||||
customer_obj = Customer.objects.get(id=int(c_id))
|
customer_obj = Customer.objects.get(id=int(c_id))
|
||||||
newAction = Action.objects.get(id=action_id)
|
newAction = Action.objects.get(id=action_id)
|
||||||
newAction.actionType = actionType
|
was_done = newAction.status == Action.Status.FINISH
|
||||||
newAction.actionDateTime = dateTimeAnjam
|
# نوع **قبلی** رکورد (پیش از بازنویسی) — برای تشخیص گذار «غیربازدید → بازدید»
|
||||||
newAction.desc = desc
|
# و برعکس. اگر بعد از ``save()`` خوانده شود، همیشه مقدار جدید است.
|
||||||
newAction.forUser = User.objects.get(id=int(userID))
|
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
|
newAction.customer = customer_obj
|
||||||
if is_done:
|
if payload['is_done']:
|
||||||
newAction.status = 'finish'
|
newAction.status = Action.Status.FINISH
|
||||||
newAction.finishDateTime = FinishDateTime
|
newAction.finishDateTime = normalize_finish_datetime(payload['finishDateTime'])
|
||||||
newAction.result = result
|
newAction.result = payload['result']
|
||||||
else:
|
else:
|
||||||
newAction.status = 'waite'
|
newAction.status = Action.Status.WAITE
|
||||||
newAction.save()
|
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('/panel/customer/'+str(c_id)+'/action')
|
||||||
return redirect(request.META.get('HTTP_REFERER', 'redirect_if_referer_not_found'))
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def ActionListAll(request):
|
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')
|
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
|
||||||
data = {'actions': actions, 'allUsers': allUsers}
|
data = {'actions': actions, 'allUsers': allUsers}
|
||||||
return render(request, 'admin_panel/ActionList.html', data)
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def ActionListToday(request):
|
def ActionListToday(request):
|
||||||
startTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 00:00:00')
|
startTodayDT, endTodayDT = _local_day_range()
|
||||||
endTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 23:59:59')
|
actions = Action.objects.filter(
|
||||||
#startTodayDT = datetime.datetime.strptime(startTodayDT, '%Y-%m-%d-00:00:00')
|
actionDateTime__range=(startTodayDT, endTodayDT),
|
||||||
#endTodayDT = datetime.datetime.strptime(endTodayDT, '%Y-%m-%d-23:59:59')
|
forUser__id=request.user.id, status='waite',
|
||||||
#return HttpResponse(todayDT)
|
).order_by("-actionDateTime")[:50]
|
||||||
actions = Action.objects.filter(actionDateTime__gte=startTodayDT,actionDateTime__lte=endTodayDT, forUser__id=request.user.id, status='waite').order_by("-actionDateTime")[:50]
|
|
||||||
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
|
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
|
||||||
data = {'actions': actions, 'allUsers': allUsers}
|
data = {'actions': actions, 'allUsers': allUsers}
|
||||||
return render(request, 'admin_panel/ActionList.html', data)
|
return render(request, 'admin_panel/ActionList.html', data)
|
||||||
@@ -176,22 +432,19 @@ def ActionListUserToday(request, u_id):
|
|||||||
status = request.GET.get('status', None)
|
status = request.GET.get('status', None)
|
||||||
unixADT = dateTimeAction
|
unixADT = dateTimeAction
|
||||||
if dateTimeAction:
|
if dateTimeAction:
|
||||||
dateTimeAction = datetime.datetime.fromtimestamp(int(dateTimeAction)/1e3)
|
# timestamp میلیثانیهای GET → تاریخ محلی (نه naive UTC).
|
||||||
startTodayDT = dateTimeAction.strftime('%Y-%m-%d 00:00:00')
|
moment = as_aware(datetime.datetime.fromtimestamp(int(dateTimeAction) / 1e3))
|
||||||
endTodayDT= dateTimeAction.strftime('%Y-%m-%d 23:59:59')
|
day = moment.astimezone(timezone.get_current_timezone()).date()
|
||||||
else:
|
else:
|
||||||
startTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 00:00:00')
|
day = timezone.localdate()
|
||||||
endTodayDT= datetime.datetime.today().strftime('%Y-%m-%d 23:59:59')
|
startTodayDT, endTodayDT = _local_day_range(day)
|
||||||
#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)
|
|
||||||
if status == 'waite' or status == None or status == '' or status == ' ':
|
if status == 'waite' or status == None or status == '' or status == ' ':
|
||||||
status = 'waite'
|
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]
|
actionPr = Action.objects.filter(actionDateTime__lt=startTodayDT, forUser__id=u_id, status=status).order_by("-actionDateTime")[:200]
|
||||||
elif status == 'finish':
|
elif status == 'finish':
|
||||||
actionPr = None
|
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')
|
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}
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def rezayat(request):
|
def rezayat(request):
|
||||||
statusRezayat = request.GET.get('status', 'waite')
|
statusRezayat = request.GET.get('status', 'waite')
|
||||||
now = datetime.datetime.now()
|
now = timezone.now()
|
||||||
|
|
||||||
# محاسبه بازههای زمانی ۳۰ روز و ۶۰ روز قبل
|
# محاسبه بازههای زمانی ۳۰ روز و ۶۰ روز قبل
|
||||||
dt_30_days_ago = now - datetime.timedelta(days=30)
|
dt_30_days_ago = now - datetime.timedelta(days=30)
|
||||||
@@ -241,20 +494,20 @@ def rezayatEdit(request, ac_id):
|
|||||||
# عدم موفقیت: تنظیم nextNazarDT برای ۳ روز بعد (nazarDT پر نمیشود تا نهایی نشود)
|
# عدم موفقیت: تنظیم nextNazarDT برای ۳ روز بعد (nazarDT پر نمیشود تا نهایی نشود)
|
||||||
action.nazar = csDesc
|
action.nazar = csDesc
|
||||||
action.grade = int(csGrade)
|
action.grade = int(csGrade)
|
||||||
action.nextNazarDT = datetime.datetime.now() + datetime.timedelta(days=3)
|
action.nextNazarDT = timezone.now() + datetime.timedelta(days=3)
|
||||||
|
|
||||||
elif csGrade == '-2':
|
elif csGrade == '-2':
|
||||||
# کنسل کردن: پر کردن nazarDT برای خروج کامل از لیست کارهای در انتظار
|
# کنسل کردن: پر کردن nazarDT برای خروج کامل از لیست کارهای در انتظار
|
||||||
action.nazar = csDesc
|
action.nazar = csDesc
|
||||||
action.grade = int(csGrade)
|
action.grade = int(csGrade)
|
||||||
action.nazarDT = datetime.datetime.now()
|
action.nazarDT = timezone.now()
|
||||||
action.nextNazarDT = None
|
action.nextNazarDT = None
|
||||||
|
|
||||||
else:
|
else:
|
||||||
# ثبت امتیاز عادی
|
# ثبت امتیاز عادی
|
||||||
action.nazar = csDesc
|
action.nazar = csDesc
|
||||||
action.grade = int(csGrade)
|
action.grade = int(csGrade)
|
||||||
action.nazarDT = datetime.datetime.now()
|
action.nazarDT = timezone.now()
|
||||||
action.nextNazarDT = None
|
action.nextNazarDT = None
|
||||||
|
|
||||||
action.save()
|
action.save()
|
||||||
|
|||||||
+528
-61
@@ -2,21 +2,63 @@ import datetime
|
|||||||
import os
|
import os
|
||||||
|
|
||||||
from django.db import models
|
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.shortcuts import redirect, render, get_object_or_404
|
||||||
from django.core.paginator import Paginator
|
from django.core.paginator import Paginator
|
||||||
|
from django.utils import timezone
|
||||||
from django.views.decorators.csrf import csrf_exempt
|
from django.views.decorators.csrf import csrf_exempt
|
||||||
from django.contrib import messages
|
from django.contrib import messages
|
||||||
from django.contrib.auth.decorators import login_required, permission_required
|
from django.contrib.auth.decorators import login_required, permission_required
|
||||||
from persiantools.jdatetime import JalaliDate
|
from persiantools.jdatetime import JalaliDate
|
||||||
|
|
||||||
from ..models import (Customer, PhoneNumber, ProductCategory, Product, Factor,
|
from ..models import (Customer, PhoneNumber, ProductCategory, Product, Factor,
|
||||||
FactorIteam, Article, Sarresid, Action, CacheTable, SMSType)
|
FactorIteam, Article, Sarresid, Action, CacheTable)
|
||||||
from ..sms.enqueue import enqueue_sms
|
from ..sms.balance import customer_balance
|
||||||
from ..sms.phones import (customer_phone_entries, normalize_primary_values,
|
from ..sms.phones import (normalize_primary_values,
|
||||||
save_primary_normalized)
|
save_primary_normalized)
|
||||||
from ..sms.recipients import resolve_recipients
|
from ..sms.triggers import notify_payment_thanks, notify_welcome
|
||||||
from ..sms.rules import customer_toggle_map
|
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
|
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)
|
#all_prd = serializers.serialize("json", all_prda)
|
||||||
#return JsonResponse(all_prd,safe = False)
|
#return JsonResponse(all_prd,safe = False)
|
||||||
dateNow = datetime.datetime.now().date
|
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 = {
|
data = {
|
||||||
'customer': customer, 'categorys': categorys, 'dateNow': dateNow,
|
'customer': customer, 'categorys': categorys, 'dateNow': dateNow,
|
||||||
'factorha': factorha, 'mandehesabCs': mandehesabCs,
|
'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)
|
return render(request, 'admin_panel/customerNew2.html', data)
|
||||||
|
|
||||||
@@ -271,12 +306,7 @@ def customersAdd(request):
|
|||||||
)
|
)
|
||||||
|
|
||||||
# پیامک خوشآمدگویی (در صورت فعال بودن قالب و تنظیم مشتری)
|
# پیامک خوشآمدگویی (در صورت فعال بودن قالب و تنظیم مشتری)
|
||||||
enqueue_sms(
|
notify_welcome(newCs, created_by=request.user)
|
||||||
customer=newCs, sms_type=SMSType.WELCOME,
|
|
||||||
context={'name': newCs.name_family},
|
|
||||||
dedup_key=f'welcome:{newCs.id}',
|
|
||||||
created_by=request.user,
|
|
||||||
)
|
|
||||||
|
|
||||||
return redirect('/panel/customers/')
|
return redirect('/panel/customers/')
|
||||||
|
|
||||||
@@ -337,63 +367,496 @@ def customerEdit(request, c_id):
|
|||||||
|
|
||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def entezar(request):
|
def entezar(request):
|
||||||
a = datetime.datetime.now()
|
"""فهرست «منتظر بازدید» + تفکیک بر اساس **نوع قرار**.
|
||||||
|
|
||||||
|
منبع حقیقت تاریخ بازدید ``visit_policy.last_visit_map`` است و منبع قرارها
|
||||||
|
``appointment_sources_map`` که سه منبع مستقل دارد:
|
||||||
|
|
||||||
|
* ``manual`` — قرار دستی روی مشتری (تعویق از فرم هماهنگی)
|
||||||
|
* ``scheduled`` — اقدام «بازدید» با تاریخ آینده
|
||||||
|
* ``coordination`` — اقدام «هماهنگی» با تاریخ پیگیری در آینده
|
||||||
|
|
||||||
|
هر فیلتر فقط منبع خودش را نشان میدهد (یک مشتری میتواند چند منبع داشته
|
||||||
|
باشد و در چند فیلتر دیده شود). فیلتر با ``?view=`` و قابل ترکیب با جستوجو.
|
||||||
|
"""
|
||||||
searchVal = request.GET.get('searchVal', '')
|
searchVal = request.GET.get('searchVal', '')
|
||||||
searchOn = request.GET.get('searchOn', '')
|
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
|
searchStatus = True
|
||||||
full_path = request.get_full_path()
|
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 )
|
visits = last_visit_map(now=now)
|
||||||
|
sources = appointment_sources_map(now=now)
|
||||||
|
|
||||||
dateTime6MonthAgo = a - datetime.timedelta(weeks=bazdid)
|
# جستوجو: نام، آدرس، تلفن (همه شمارهها) و کد شناسایی.
|
||||||
''' customers = Customer.objects.filter(name_family__isnull=False)
|
def _apply_search(queryset):
|
||||||
m6mbazdid = []
|
"""فیلتر جستوجو؛ فیلد نامعتبر ⇒ بدون فیلتر (سازگاری با رفتار قبلی)."""
|
||||||
for customerObj in customers:
|
if not searchVal:
|
||||||
try:
|
return queryset
|
||||||
actionAa = Action.objects.filter(customer=customerObj, actionType='bazdid', status='finish').last()
|
if searchOn == 'address':
|
||||||
if actionAa.status == 'finish':
|
return queryset.filter(address__contains=searchVal)
|
||||||
customerObj.last_bazdid_dt = actionAa.actionDateTime
|
if searchOn == 'name':
|
||||||
customerObj.save()
|
return queryset.filter(name_family__contains=searchVal)
|
||||||
if actionAa.actionDateTime.date() < dateTime6MonthAgo.date():
|
if searchOn == 'phone':
|
||||||
m6mbazdid.append(actionAa)
|
return queryset.filter(
|
||||||
except:
|
Q(phone1__contains=searchVal) | Q(phone2__contains=searchVal)
|
||||||
pass '''
|
| Q(phone3__contains=searchVal)
|
||||||
|
)
|
||||||
|
if searchOn == 'code':
|
||||||
|
return queryset.filter(idCode__contains=searchVal)
|
||||||
|
return queryset
|
||||||
|
|
||||||
if searchOn == 'address':
|
searchStatus = bool(searchVal) and searchOn in (
|
||||||
print("addressaddressaddressaddressaddress")
|
'address', 'name', 'phone', 'code')
|
||||||
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')
|
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:
|
else:
|
||||||
searchStatus = False
|
followups = {}
|
||||||
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')
|
|
||||||
|
|
||||||
#customers_objj = Customer.objects.filter(name_family__isnull=False, last_bazdid_dt__lte=dateTime6MonthAgo)
|
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:
|
try:
|
||||||
entezar_bazdid = CacheTable.objects.get(key='9mahbazdid')
|
entezar_bazdid = CacheTable.objects.get(key='9mahbazdid')
|
||||||
|
# کارت داشبورد = «کارِ فوری» = تعیین تکلیف نشده.
|
||||||
entezar_bazdid.value = Customer.objects.filter(
|
# فقط در صورت تغییر مینویسیم تا یک GET ساده بیدلیل دیتابیس را تغییر ندهد.
|
||||||
Q(last_bazdid_dt__lte=dateTime6MonthAgo) | Q(last_bazdid_dt__isnull=True),
|
if str(entezar_bazdid.value) != str(counts['uncoordinated']):
|
||||||
installDate__lte=dateTime6MonthAgo,
|
entezar_bazdid.value = str(counts['uncoordinated'])
|
||||||
laghv_bazdid=False, name_family__isnull=False).count()
|
entezar_bazdid.save(update_fields=['value'])
|
||||||
|
except CacheTable.DoesNotExist:
|
||||||
entezar_bazdid.save()
|
|
||||||
except:
|
|
||||||
pass
|
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)
|
page_number = request.GET.get('page', None)
|
||||||
customerHa = paginator.get_page(page_number)
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@@ -448,14 +911,13 @@ def customerDel(request, c_id):
|
|||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
def customerHesabdari(request ,c_id):
|
def customerHesabdari(request ,c_id):
|
||||||
customer = Customer.objects.get(id=c_id)
|
customer = Customer.objects.get(id=c_id)
|
||||||
|
# مانده حساب از همان تابع مشترکی میآید که قالبهای پیامک استفاده میکنند تا
|
||||||
|
# عددِ این صفحه و پیامک هرگز واگرا نشوند (منبع حقیقت: sms/balance.py).
|
||||||
|
mandehesabCs = customer_balance(customer)
|
||||||
try:
|
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')
|
articls = Article.objects.filter(customer=customer).order_by('-createdDT')
|
||||||
except:
|
except:
|
||||||
articls =None
|
articls = None
|
||||||
mandehesabCs = 0
|
|
||||||
|
|
||||||
dateNow = datetime.datetime.now().date
|
dateNow = datetime.datetime.now().date
|
||||||
data = {'customer': customer, 'mandehesabCs': mandehesabCs, 'articls': articls}
|
data = {'customer': customer, 'mandehesabCs': mandehesabCs, 'articls': articls}
|
||||||
@@ -494,4 +956,9 @@ def customerHesabdariAdd(request ,c_id):
|
|||||||
newArticl.user = user_op
|
newArticl.user = user_op
|
||||||
newArticl.nahvePardakht = nahvePardakhat
|
newArticl.nahvePardakht = nahvePardakhat
|
||||||
newArticl.save()
|
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')
|
return redirect('/panel/customer/'+str(c_id)+'/hesabdari')
|
||||||
@@ -12,6 +12,7 @@ from persiantools import digits
|
|||||||
|
|
||||||
from ..models import (Customer, StoreRoom, Factor, FactorIteam, Product,
|
from ..models import (Customer, StoreRoom, Factor, FactorIteam, Product,
|
||||||
ProductInStore, Article, Sarresid)
|
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
|
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()
|
if not str(item.get('garanty_Esh', '')).strip()
|
||||||
)
|
)
|
||||||
|
|
||||||
|
new_factor = None
|
||||||
|
payment_articles = []
|
||||||
try:
|
try:
|
||||||
with transaction.atomic():
|
with transaction.atomic():
|
||||||
|
|
||||||
@@ -231,7 +234,7 @@ def newFactor2(request, c_id):
|
|||||||
|
|
||||||
if key in payment_map:
|
if key in payment_map:
|
||||||
nahve_pardakht = payment_map[key]
|
nahve_pardakht = payment_map[key]
|
||||||
Article.objects.create(
|
payment_articles.append((Article.objects.create(
|
||||||
debit=0,
|
debit=0,
|
||||||
credit=amount,
|
credit=amount,
|
||||||
customer=customer_obj,
|
customer=customer_obj,
|
||||||
@@ -240,7 +243,7 @@ def newFactor2(request, c_id):
|
|||||||
nahvePardakht=nahve_pardakht,
|
nahvePardakht=nahve_pardakht,
|
||||||
payStatus="true",
|
payStatus="true",
|
||||||
user=user_op
|
user=user_op
|
||||||
)
|
), nahve_pardakht))
|
||||||
|
|
||||||
elif key in ['l_nesiye', 'l_checkPrice']:
|
elif key in ['l_nesiye', 'l_checkPrice']:
|
||||||
is_nesiye = (key == 'l_nesiye')
|
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)
|
logger.error(f"Error creating factor for customer {c_id}: {str(e)}", exc_info=True)
|
||||||
return HttpResponse("خطایی غیرمنتظره در سرور رخ داد. اطلاعات ذخیره نشد.", status=500)
|
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/')
|
return redirect(f'/panel/customer/{c_id}/factors/')
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -16,6 +16,7 @@ from persiantools.jdatetime import JalaliDate
|
|||||||
|
|
||||||
from ..models import (Article, Sarresid, Customer, Factor, ProductInStore,
|
from ..models import (Article, Sarresid, Customer, Factor, ProductInStore,
|
||||||
StoreRoom, Action)
|
StoreRoom, Action)
|
||||||
|
from ..sms.triggers import notify_payment_thanks
|
||||||
from ._helpers import logger, _safe_int
|
from ._helpers import logger, _safe_int
|
||||||
|
|
||||||
|
|
||||||
@@ -155,9 +156,10 @@ def report_debtors_no_vosol(request):
|
|||||||
).values('customer').annotate(c=Count('id')).values('c')
|
).values('customer').annotate(c=Count('id')).values('c')
|
||||||
|
|
||||||
# استخراج آخرین سابقه اکشن وصول
|
# استخراج آخرین سابقه اکشن وصول
|
||||||
|
# نکته: اقدام حذفشده/لغوشده نباید «آخرین اقدام وصول» بهحساب بیاید.
|
||||||
latest_vosol_qs = Action.objects.filter(
|
latest_vosol_qs = Action.objects.filter(
|
||||||
customer=OuterRef('pk'), actionType='vosol'
|
customer=OuterRef('pk'), actionType='vosol',
|
||||||
).order_by('-createdDT')
|
).exclude(status='cancell').order_by('-createdDT')
|
||||||
|
|
||||||
# --- ۳. ساخت کوئری پایه (فقط مشتریان فعال و دارای معوقه) ---
|
# --- ۳. ساخت کوئری پایه (فقط مشتریان فعال و دارای معوقه) ---
|
||||||
base_qs = Customer.objects.filter(is_active=True).annotate(
|
base_qs = Customer.objects.filter(is_active=True).annotate(
|
||||||
@@ -713,6 +715,11 @@ def passCheck(request, articl_id):
|
|||||||
sarresidINC.desc = desc
|
sarresidINC.desc = desc
|
||||||
sarresidINC.save()
|
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 HttpResponse("ok")
|
||||||
#return redirect(request.META.get('HTTP_REFERER'))
|
#return redirect(request.META.get('HTTP_REFERER'))
|
||||||
|
|
||||||
@@ -916,6 +923,11 @@ def pardakhtNesiye(request, cs_id):
|
|||||||
articleHesabDariObj.user = user_op
|
articleHesabDariObj.user = user_op
|
||||||
articleHesabDariObj.save()
|
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'))
|
return redirect(request.META.get('HTTP_REFERER'))
|
||||||
|
|
||||||
except:
|
except:
|
||||||
@@ -928,7 +940,8 @@ def rezayat_dashboard(request):
|
|||||||
# دریافت تمامی نظرسنجیهای ثبت شده معتبر (که تاریخ نظرسنجی دارند)
|
# دریافت تمامی نظرسنجیهای ثبت شده معتبر (که تاریخ نظرسنجی دارند)
|
||||||
valid_surveys = Action.objects.filter(
|
valid_surveys = Action.objects.filter(
|
||||||
nazarDT__isnull=False,
|
nazarDT__isnull=False,
|
||||||
grade__in=[5, 10, 15, 20]
|
grade__in=[5, 10, 15, 20],
|
||||||
|
deleted_at__isnull=True,
|
||||||
)
|
)
|
||||||
|
|
||||||
# ۱. محاسبات شاخصهای کلیدی (KPIs)
|
# ۱. محاسبات شاخصهای کلیدی (KPIs)
|
||||||
@@ -954,7 +967,8 @@ def rezayat_dashboard(request):
|
|||||||
# ۴. واکشی لیست مشتریان نیازمند پیگیری (شامل متوسط ۱۵، ضعیف ۱۰ و بد ۵)
|
# ۴. واکشی لیست مشتریان نیازمند پیگیری (شامل متوسط ۱۵، ضعیف ۱۰ و بد ۵)
|
||||||
low_score_actions = Action.objects.filter(
|
low_score_actions = Action.objects.filter(
|
||||||
nazarDT__isnull=False,
|
nazarDT__isnull=False,
|
||||||
grade__in=[5, 10, 15] # <-- امتیاز ۱۵ (متوسط) نیز اضافه شد
|
grade__in=[5, 10, 15], # <-- امتیاز ۱۵ (متوسط) نیز اضافه شد
|
||||||
|
deleted_at__isnull=True,
|
||||||
).order_by('-nazarDT')
|
).order_by('-nazarDT')
|
||||||
|
|
||||||
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
|
allUsers = User.objects.filter().exclude(username='admin').exclude(username='fesahat')
|
||||||
|
|||||||
+318
-42
@@ -1,11 +1,11 @@
|
|||||||
"""ویوهای مدیریت پیامک در پنل (نیازمند پرمیشن ``admin_panel.ManageSMS``)."""
|
"""ویوهای مدیریت پیامک در پنل (نیازمند پرمیشن ``admin_panel.ManageSMS``)."""
|
||||||
import re
|
import re
|
||||||
from datetime import datetime, time
|
from datetime import datetime, time, timedelta
|
||||||
from urllib.parse import urlencode
|
from urllib.parse import urlencode
|
||||||
|
|
||||||
from django.contrib.auth.decorators import login_required, permission_required
|
from django.contrib.auth.decorators import login_required, permission_required
|
||||||
from django.core.paginator import Paginator
|
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.shortcuts import get_object_or_404, redirect, render
|
||||||
from django.urls import reverse
|
from django.urls import reverse
|
||||||
from django.utils import timezone
|
from django.utils import timezone
|
||||||
@@ -13,12 +13,37 @@ from django.utils import timezone
|
|||||||
from ..models import (Customer, SMSDedup, SMSProviderConfig, SMSQueue,
|
from ..models import (Customer, SMSDedup, SMSProviderConfig, SMSQueue,
|
||||||
SMSTemplate, SMSType)
|
SMSTemplate, SMSType)
|
||||||
from ..sms.enqueue import enqueue_sms
|
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,
|
from ..sms.phones import (customer_phone_entries, save_primary_normalized,
|
||||||
stored_primary_normalized)
|
stored_primary_normalized)
|
||||||
from ..sms.render import format_jalali, render_template
|
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
|
from ..sms.timing import apply_timing, current_timing_value, timing_for
|
||||||
|
|
||||||
_manage_required = permission_required("admin_panel.ManageSMS", raise_exception=True)
|
_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):
|
def _notice(url, code, **extra):
|
||||||
@@ -34,6 +59,16 @@ def _notice(url, code, **extra):
|
|||||||
def _customer_url(c_id):
|
def _customer_url(c_id):
|
||||||
return reverse("admin_panel:customer", kwargs={"c_id": 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 = [
|
TEMPLATE_VARIABLES = [
|
||||||
("{name}", "نام مشتری"),
|
("{name}", "نام مشتری"),
|
||||||
@@ -42,19 +77,22 @@ TEMPLATE_VARIABLES = [
|
|||||||
("{date}", "تاریخ جلالی"),
|
("{date}", "تاریخ جلالی"),
|
||||||
("{days}", "تعداد روز"),
|
("{days}", "تعداد روز"),
|
||||||
("{check_row}", "شمارهٔ ردیف چک"),
|
("{check_row}", "شمارهٔ ردیف چک"),
|
||||||
|
("{sayyad_id}", "شناسهٔ چک صیاد (۱۶ رقم)"),
|
||||||
("{owner_name}", "نام مالک چک"),
|
("{owner_name}", "نام مالک چک"),
|
||||||
|
("{balance}", "مانده حساب مشتری (بدهکار − بستانکار)"),
|
||||||
|
("{balance_sep}", "مانده حساب با جداکنندهٔ هزارگان"),
|
||||||
]
|
]
|
||||||
|
|
||||||
# فقط برای نمایش: آیکن و توضیح کوتاه «چه زمانی ارسال میشود» هر نوع (لایهٔ UI، نه دامنه).
|
# فقط برای نمایش: آیکن و توضیح کوتاه «چه زمانی ارسال میشود» هر نوع (لایهٔ UI، نه دامنه).
|
||||||
SMS_TYPE_UI = {
|
SMS_TYPE_UI = {
|
||||||
SMSType.WELCOME: {"icon": "👋", "when": "بیدرنگ پس از ثبت مشتری"},
|
SMSType.WELCOME: {"icon": "👋", "when": "بیدرنگ پس از ثبت مشتری"},
|
||||||
SMSType.CHEQUE_DUE: {"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.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, # در زمان ساخت ویو با تاریخ امروز پر میشود
|
"date": None, # در زمان ساخت ویو با تاریخ امروز پر میشود
|
||||||
"days": 2,
|
"days": 2,
|
||||||
"check_row": "1234",
|
"check_row": "1234",
|
||||||
|
"sayyad_id": "1234567890123456",
|
||||||
"owner_name": "نام مالک",
|
"owner_name": "نام مالک",
|
||||||
|
"balance": 3500000,
|
||||||
|
"balance_sep": "3,500,000",
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@_manage_required
|
@_settings_required
|
||||||
def sms_settings(request):
|
def sms_settings(request):
|
||||||
config = SMSProviderConfig.load()
|
config = SMSProviderConfig.load()
|
||||||
if request.method == "POST":
|
if request.method == "POST":
|
||||||
@@ -82,7 +123,7 @@ def sms_settings(request):
|
|||||||
config.test_message = test_text
|
config.test_message = test_text
|
||||||
config.save(update_fields=["test_message"])
|
config.save(update_fields=["test_message"])
|
||||||
enqueue_sms(
|
enqueue_sms(
|
||||||
customer=None, sms_type=SMSType.CUSTOM,
|
customer=None, sms_type="",
|
||||||
message=test_text or config.test_message,
|
message=test_text or config.test_message,
|
||||||
recipients=resolve_recipients_test(phone), created_by=request.user,
|
recipients=resolve_recipients_test(phone), created_by=request.user,
|
||||||
approved=True, # ارسال دستیِ مدیر؛ نیاز به بازبینی صف ندارد.
|
approved=True, # ارسال دستیِ مدیر؛ نیاز به بازبینی صف ندارد.
|
||||||
@@ -192,7 +233,7 @@ def _sample_context():
|
|||||||
|
|
||||||
|
|
||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@_manage_required
|
@_settings_required
|
||||||
def sms_templates(request):
|
def sms_templates(request):
|
||||||
raw_sample, text_sample = _sample_context()
|
raw_sample, text_sample = _sample_context()
|
||||||
rows = []
|
rows = []
|
||||||
@@ -236,7 +277,7 @@ def _templates_redirect(anchor="", notice="", **extra):
|
|||||||
|
|
||||||
|
|
||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@_manage_required
|
@_settings_required
|
||||||
def sms_template_edit(request, t_id):
|
def sms_template_edit(request, t_id):
|
||||||
"""ویرایش یک قالب. فیلد زمانی بر اساس نوع پیامک انتخاب و اعتبارسنجی میشود.
|
"""ویرایش یک قالب. فیلد زمانی بر اساس نوع پیامک انتخاب و اعتبارسنجی میشود.
|
||||||
|
|
||||||
@@ -284,8 +325,12 @@ def sms_customer_toggle(request, c_id):
|
|||||||
)
|
)
|
||||||
setting.is_enabled = enabled
|
setting.is_enabled = enabled
|
||||||
setting.save()
|
setting.save()
|
||||||
return _notice(_customer_url(c_id), "customer_sms_saved")
|
# ``open=settings`` ⇒ صفحه با همان مودال تنظیمات باز میشود تا کاربر
|
||||||
return redirect("admin_panel:customer", c_id=c_id)
|
# چند نوع را پشتسرهم روشن/خاموش کند و هر بار مودال را باز نکند.
|
||||||
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@@ -307,13 +352,13 @@ def sms_primary_toggle(request, c_id):
|
|||||||
"",
|
"",
|
||||||
)
|
)
|
||||||
if not normalized:
|
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]
|
current = [n for n in stored_primary_normalized(customer) if n != normalized]
|
||||||
if enabled:
|
if enabled:
|
||||||
current.append(normalized)
|
current.append(normalized)
|
||||||
save_primary_normalized(customer, current)
|
save_primary_normalized(customer, current)
|
||||||
return _notice(_customer_url(c_id), "primary_updated")
|
return _notice(_customer_sms_url(c_id), "primary_updated")
|
||||||
return redirect("admin_panel:customer", c_id=c_id)
|
return redirect("admin_panel:customerSmsHistory", c_id=c_id)
|
||||||
|
|
||||||
|
|
||||||
@login_required(login_url='/panel/p_login/')
|
@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):
|
def sms_send_custom(request, c_id):
|
||||||
"""ارسال پیامک با متن سفارشی برای همین مشتری.
|
"""ارسال پیامک با متن سفارشی برای همین مشتری.
|
||||||
|
|
||||||
اگر کادر متن خالی بماند، متن قالب «پیام سفارشی» استفاده میشود. متغیرهایی مثل
|
متن باید توسط مدیر نوشته شود (قالب پیشفرضی وجود ندارد)؛ متغیرهایی مثل
|
||||||
``{name}`` در متن واردشده هم رندر میشوند.
|
``{name}`` در متن واردشده هم رندر میشوند.
|
||||||
"""
|
"""
|
||||||
customer = get_object_or_404(Customer, id=c_id)
|
customer = get_object_or_404(Customer, id=c_id)
|
||||||
if request.method == "POST":
|
if request.method == "POST":
|
||||||
text = (request.POST.get("text", "") or "").strip()
|
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()
|
rendered = render_template(text, {"name": customer.name_family}).strip()
|
||||||
if not rendered:
|
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(
|
created = enqueue_sms(
|
||||||
customer=customer, sms_type=SMSType.CUSTOM, message=rendered,
|
customer=customer, sms_type="", message=rendered,
|
||||||
created_by=request.user,
|
created_by=request.user,
|
||||||
approved=True, # متن را خودِ مدیر نوشته و ارسال را خواسته است.
|
approved=True, # متن را خودِ مدیر نوشته و ارسال را خواسته است.
|
||||||
)
|
)
|
||||||
code = "custom_queued" if created else "custom_no_phone"
|
code = "custom_queued" if created else "custom_no_phone"
|
||||||
return _notice(_customer_url(c_id), code)
|
return _notice(_customer_sms_url(c_id), code)
|
||||||
return redirect("admin_panel:customer", c_id=c_id)
|
return redirect("admin_panel:customerSmsHistory", c_id=c_id)
|
||||||
|
|
||||||
|
|
||||||
@login_required(login_url='/panel/p_login/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@_manage_required
|
@_manage_required
|
||||||
def sms_queue(request):
|
def sms_queue(request):
|
||||||
|
"""صف ارسال: فقط مواردی که هنوز «کارِ باقیمانده» دارند.
|
||||||
|
|
||||||
|
پیامکهای ارسالشده (``sent``) از این فهرست بیرون میمانند چون کارشان تمام است و
|
||||||
|
سابقهشان در «گزارش ارسال» دیده میشود؛ ماندنشان در صف فقط باعث میشد دکمهٔ
|
||||||
|
«حذف» روی تاریخچه ظاهر شود. بقیهٔ وضعیتها (در انتظار تأیید، تأییدشده، در حال
|
||||||
|
پردازش، ناموفق) در صف میمانند چون هنوز نیاز به اقدام دارند.
|
||||||
|
"""
|
||||||
status = request.GET.get("status", "")
|
status = request.GET.get("status", "")
|
||||||
delivery = request.GET.get("delivery", "")
|
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:
|
if status:
|
||||||
qs = qs.filter(status=status)
|
qs = qs.filter(status=status)
|
||||||
if delivery:
|
if delivery:
|
||||||
@@ -364,24 +415,226 @@ def sms_queue(request):
|
|||||||
counts = dict(
|
counts = dict(
|
||||||
SMSQueue.objects.order_by().values_list("status").annotate(n=Count("id"))
|
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 = {
|
data = {
|
||||||
"queue": page,
|
"queue": page,
|
||||||
"status": status,
|
"status": status,
|
||||||
"delivery": delivery,
|
"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,
|
"delivery_choices": SMSQueue.DeliveryStatus.choices,
|
||||||
"pending_count": counts.get(SMSQueue.Status.PENDING, 0),
|
"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,
|
"filtered_count": paginator.count,
|
||||||
# (کد وضعیت، برچسب، تعداد) — به ترتیب تعریف Status.
|
# (کد وضعیت، برچسب، تعداد) — فقط وضعیتهای درون صف.
|
||||||
"status_stats": [
|
"status_stats": [
|
||||||
(code, label, counts.get(code, 0))
|
(code, label, counts.get(code, 0))
|
||||||
for code, label in SMSQueue.Status.choices
|
for code, label in SMSQueue.Status.choices
|
||||||
|
if code not in DONE_STATUSES
|
||||||
],
|
],
|
||||||
}
|
}
|
||||||
return render(request, "admin_panel/sms_queue.html", data)
|
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):
|
def _approve(queryset):
|
||||||
"""پیامکهای «در انتظار تأیید» را تأیید و آمادهٔ ارسال میکند."""
|
"""پیامکهای «در انتظار تأیید» را تأیید و آمادهٔ ارسال میکند."""
|
||||||
return queryset.filter(status=SMSQueue.Status.PENDING).update(
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@_manage_required
|
@_manage_required
|
||||||
def sms_queue_delete(request, q_id):
|
def sms_queue_delete(request, q_id):
|
||||||
"""حذف یک پیامک از صف (مثلاً پس از بازبینی و رد آن)."""
|
"""حذف یک پیامک از صف (مثلاً پس از بازبینی و رد آن).
|
||||||
|
|
||||||
|
پیامکِ ارسالشده حذف نمیشود؛ سابقهٔ آن در «گزارش ارسال» میماند و حذفش یعنی
|
||||||
|
پاککردنِ تاریخچه. برای چنین موردی فقط پیام هشدار برمیگردد.
|
||||||
|
"""
|
||||||
item = get_object_or_404(SMSQueue, id=q_id)
|
item = get_object_or_404(SMSQueue, id=q_id)
|
||||||
if request.method == "POST":
|
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()
|
item.delete()
|
||||||
return _notice(reverse("admin_panel:sms_queue"), "deleted")
|
return _notice(reverse("admin_panel:sms_queue"), "deleted")
|
||||||
return redirect("admin_panel:sms_queue")
|
return redirect("admin_panel:sms_queue")
|
||||||
@@ -427,7 +690,10 @@ def sms_queue_bulk(request):
|
|||||||
count = _approve(selected)
|
count = _approve(selected)
|
||||||
code, extra = "bulk_approved", {"count": count}
|
code, extra = "bulk_approved", {"count": count}
|
||||||
elif action == "delete_selected":
|
elif action == "delete_selected":
|
||||||
|
# تاریخچهٔ ارسالشدهها از طریق صف حذف نمیشود.
|
||||||
|
selected = selected.exclude(status__in=DONE_STATUSES)
|
||||||
count = selected.count()
|
count = selected.count()
|
||||||
|
_remember_keys(selected)
|
||||||
selected.delete()
|
selected.delete()
|
||||||
code, extra = "bulk_deleted", {"count": count}
|
code, extra = "bulk_deleted", {"count": count}
|
||||||
else:
|
else:
|
||||||
@@ -436,21 +702,31 @@ def sms_queue_bulk(request):
|
|||||||
return redirect("admin_panel:sms_queue")
|
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/')
|
@login_required(login_url='/panel/p_login/')
|
||||||
@_manage_required
|
@_manage_required
|
||||||
def sms_queue_empty(request):
|
def sms_queue_empty(request):
|
||||||
"""خالی کردن کل صف — هر وضعیتی، بدون بازگشت.
|
"""خالی کردن صف — فقط موارد باقیمانده (بدون بازگشت).
|
||||||
|
|
||||||
پیش از حذف، کلید یکتاسازیِ هر رکورد در دفتر ``SMSDedup`` تضمین میشود تا اسکنر
|
پیامکهای ارسالشده جزو صف نیستند و حذف نمیشوند؛ تاریخچهشان در «گزارش ارسال»
|
||||||
در اجرای بعدی همان پیامکها را از نو نسازد. رکوردهایی که کلید ندارند (مثلاً
|
لازم است. پیش از حذف، کلید یکتاسازیِ هر رکورد در دفتر ``SMSDedup`` تضمین میشود
|
||||||
پیامک دستی) کلید مشتق از خودشان را میگیرند.
|
تا اسکنر در اجرای بعدی همان پیامکها را از نو نسازد.
|
||||||
"""
|
"""
|
||||||
if request.method == "POST":
|
if request.method == "POST":
|
||||||
rows = SMSQueue.objects.all()
|
rows = SMSQueue.objects.exclude(status__in=DONE_STATUSES)
|
||||||
keys = [k for k in rows.values_list("dedup_key", flat=True) if k]
|
_remember_keys(rows)
|
||||||
SMSDedup.objects.bulk_create(
|
|
||||||
[SMSDedup(key=k) for k in keys], ignore_conflicts=True,
|
|
||||||
)
|
|
||||||
count = rows.count()
|
count = rows.count()
|
||||||
rows.delete()
|
rows.delete()
|
||||||
return _notice(reverse("admin_panel:sms_queue"), "queue_emptied", count=count)
|
return _notice(reverse("admin_panel:sms_queue"), "queue_emptied", count=count)
|
||||||
|
|||||||
File diff suppressed because it is too large.
Load diff
+34
-19
@@ -1,43 +1,58 @@
|
|||||||
# راهاندازی چهار سرویس از یک ایمیج مشترک:
|
version: '3.8'
|
||||||
# web → وبسرور Gunicorn (میگریشن/استاتیک فقط اینجا اجرا میشود)
|
|
||||||
# worker → تخلیه صف پیامک (sms_worker)
|
|
||||||
# scheduler → اسکن دورهای و صفکردن یادآوریها (sms_scan --loop)
|
|
||||||
# delivery → استعلام وضعیت تحویل پیامکها (sms_delivery --sleep 30)
|
|
||||||
#
|
|
||||||
# توجه: دیتابیس SQLite است؛ مقیاس افقی (چند replica) ممنوع.
|
|
||||||
x-app: &app
|
x-app: &app
|
||||||
build: .
|
build: .
|
||||||
|
image: khatibi-app:latest
|
||||||
env_file: production.env
|
env_file: production.env
|
||||||
volumes:
|
volumes:
|
||||||
- ./sqlite:/app/sqlite
|
# دقیقاً نام کامل ولوم را اینجا بگذارید:
|
||||||
|
- khatibi-sqlite-db:/app/sqlite:rw
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
networks:
|
||||||
|
- coolify
|
||||||
|
|
||||||
services:
|
services:
|
||||||
|
# سرویس یکبارهٔ مایگریشن: تنها جایی که اسکیما را جلو میبرد.
|
||||||
|
# بقیهٔ سرویسها منتظر «اتمام موفق» آن میمانند، پس هیچوقت با اسکیمای عقب
|
||||||
|
# بالا نمیآیند (خطای no such column). اجرای دوبارهاش بیخطر است.
|
||||||
|
migrate:
|
||||||
|
<<: *app
|
||||||
|
restart: "no"
|
||||||
|
command: ["python", "manage.py", "migrate", "--noinput"]
|
||||||
|
|
||||||
web:
|
web:
|
||||||
<<: *app
|
<<: *app
|
||||||
ports:
|
expose:
|
||||||
- "8000:8000"
|
- "8000"
|
||||||
healthcheck:
|
depends_on:
|
||||||
test: ["CMD-SHELL", "python -c \"import urllib.request;urllib.request.urlopen('http://127.0.0.1:8000/').read()\""]
|
migrate:
|
||||||
interval: 30s
|
condition: service_completed_successfully
|
||||||
timeout: 10s
|
|
||||||
retries: 5
|
|
||||||
start_period: 60s
|
|
||||||
|
|
||||||
worker:
|
worker:
|
||||||
<<: *app
|
<<: *app
|
||||||
command: ["python", "manage.py", "sms_worker", "--sleep", "3"]
|
command: ["python", "manage.py", "sms_worker", "--sleep", "3"]
|
||||||
depends_on:
|
depends_on:
|
||||||
- web
|
migrate:
|
||||||
|
condition: service_completed_successfully
|
||||||
|
|
||||||
scheduler:
|
scheduler:
|
||||||
<<: *app
|
<<: *app
|
||||||
command: ["python", "manage.py", "sms_scan", "--loop", "--interval", "300"]
|
command: ["python", "manage.py", "sms_scan", "--loop", "--interval", "300"]
|
||||||
depends_on:
|
depends_on:
|
||||||
- web
|
migrate:
|
||||||
|
condition: service_completed_successfully
|
||||||
|
|
||||||
delivery:
|
delivery:
|
||||||
<<: *app
|
<<: *app
|
||||||
command: ["python", "manage.py", "sms_delivery", "--sleep", "30"]
|
command: ["python", "manage.py", "sms_delivery", "--sleep", "30"]
|
||||||
depends_on:
|
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
@@ -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) |
|
||||||
@@ -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. عدد «تعیین تکلیف نشده» در داشبورد همان لیست کاریِ فوری است.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@@ -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شده |
|
||||||
|
|
||||||
|
|
||||||
+1872
-693
File diff suppressed because it is too large.
Load diff
+223
-140
@@ -1,142 +1,225 @@
|
|||||||
{
|
{
|
||||||
"0": "views/store.py",
|
"0": "views/sms.py",
|
||||||
"1": "project_tree.py",
|
"1": "AutoSendTests",
|
||||||
"2": "sqlite_db_backup.py",
|
"2": "django_db",
|
||||||
"3": "django_db",
|
"3": "views/store.py",
|
||||||
"4": "Customer ID Backup/New Factor Template",
|
"4": "ModelsPackageContractTests",
|
||||||
"5": "views/customers.py",
|
"5": "PhoneCleanupTests",
|
||||||
"6": "cheque_inquiry.py",
|
"6": ".load",
|
||||||
"7": "admin_panel/templates/admin_panel/baseHesabdari.html",
|
"7": "models/sms.py",
|
||||||
"8": "django_db_models_deletion",
|
"8": "django_db_models",
|
||||||
"9": "0051_auto_20260705_1356.py",
|
"9": "views/customers.py",
|
||||||
"10": "admin_panel/storeBK1.html",
|
"10": "django_db_models_deletion",
|
||||||
"11": "ViewSmokeTests",
|
"11": "PanelTestCase",
|
||||||
"12": "admin_panel/templates/admin_panel/customerAction.html",
|
"12": "mark_primary",
|
||||||
"13": "User",
|
"13": "EventTriggerTests",
|
||||||
"14": "run_all",
|
"14": "views/finance.py",
|
||||||
"15": "admin_panel/admin.py",
|
"15": "django_conf",
|
||||||
"16": "stock_in",
|
"16": "sms0098ws.py",
|
||||||
"17": "admin_panel/templates/admin_panel/bedehi.html",
|
"17": "Admin Panel Customization",
|
||||||
"18": "hesabdariCheckPassFail.html",
|
"18": "views/actions.py",
|
||||||
"19": "Reference guide",
|
"19": "timing_for",
|
||||||
"20": "normalize_mobile",
|
"20": "InactiveCustomerHiddenTests",
|
||||||
"21": "graphify",
|
"21": "normalize_mobile",
|
||||||
"22": "hesabdariResidNashode.html",
|
"22": "Login Template Forms",
|
||||||
"23": "0017_factoriteam_garantyesh.py",
|
"23": "cheque_inquiry.py",
|
||||||
"24": "scanner.py",
|
"24": "factories.py",
|
||||||
"25": "0002_auto_20220114_1616.py",
|
"25": "Rip'n Fast. Fewer Tokens. Better Code.",
|
||||||
"26": "SMSResult",
|
"26": "views/factors.py",
|
||||||
"27": "Rip'n Fast. Fewer Tokens. Better Code.",
|
"27": "SMSResult",
|
||||||
"28": "models/sms.py",
|
"28": "make_user",
|
||||||
"29": "admin_panel/templates/admin_panel/baseStore.html",
|
"29": "QueueReviewTests",
|
||||||
"30": "views/finance.py",
|
"30": "NoticeMechanismTests",
|
||||||
"31": "Customer Modals UI",
|
"31": "name_fix.py",
|
||||||
"32": "views/factors.py",
|
"32": "scanner.py",
|
||||||
"33": "0034_alter_article_sarresid.py",
|
"33": "ZeroZeroNinetyEightWebServiceTests",
|
||||||
"34": "views/sms.py",
|
"34": "ScannerTests",
|
||||||
"35": "0035_alter_article_sarresid.py",
|
"35": "admin_panel/templates/admin_panel/baseHesabdari.html",
|
||||||
"36": "django_db_models",
|
"36": "Reference guide",
|
||||||
"37": "0010_auto_20220122_1546.py",
|
"37": "Factor Creation UI",
|
||||||
"38": "0040_customer_laghv_bazdid.py",
|
"38": "hesabdariResidNashode.html",
|
||||||
"39": "test_sms.py",
|
"39": "requests",
|
||||||
"40": "0048_alter_productinstore_options.py",
|
"40": "CustomerSmsHistoryTests",
|
||||||
"41": "0032_article_paystatus.py",
|
"41": "TemplatesPageUITests",
|
||||||
"42": "0033_article_nahvepardakht.py",
|
"42": "SMS Integration Docs",
|
||||||
"43": "make_customer",
|
"43": "enqueue.py",
|
||||||
"44": "sms0098.py",
|
"44": "django_shortcuts",
|
||||||
"45": "0044_sarresid_desc.py",
|
"45": "stock_in",
|
||||||
"46": "models/__init__.py",
|
"46": "admin_panel/templates/admin_panel/customerAction.html",
|
||||||
"47": "make_user",
|
"47": "SmsReportTests",
|
||||||
"48": "GEMINI.md",
|
"48": "generate_snapshot",
|
||||||
"49": "admin/migrations/__init__.py",
|
"49": "CustomerInfoCardUITests",
|
||||||
"50": "Customer Action Include",
|
"50": "enqueue_sms",
|
||||||
"51": "New Customer Base Template",
|
"51": "Phone Cleanup Guide",
|
||||||
"52": "Customer Feedback Partial",
|
"52": ".run_command",
|
||||||
"53": "Customer Factor Detail",
|
"53": "project_tree.py",
|
||||||
"54": "Customer Accounting Template",
|
"54": "Agent Operating Guidelines",
|
||||||
"55": "Customer Factor List",
|
"55": "Command",
|
||||||
"56": "Customer Feedback Page",
|
"56": "BehinSMSProvider",
|
||||||
"57": "commands/__init__.py",
|
"57": "run_all",
|
||||||
"58": "management/__init__.py",
|
"58": "Financial Data Objects",
|
||||||
"59": "admin_panel/migrations/__init__.py",
|
"59": "Hybrid Migration Command",
|
||||||
"60": "Action List Template",
|
"60": "PhoneNumber",
|
||||||
"61": "base.html",
|
"61": "Resource Cleanup Handler",
|
||||||
"62": "Customer New Factor",
|
"62": "SMS Timing Migration",
|
||||||
"63": "Customer New Factor V2",
|
"63": "admin_panel/templates/admin_panel/bedehi.html",
|
||||||
"64": "Customer Satisfaction List",
|
"64": "customerIDFactorBackup.html",
|
||||||
"65": "Customer Satisfaction Partial",
|
"65": "VisitHoldTests",
|
||||||
"66": "Customer Check/Debt Management",
|
"66": "reconciliation_tool.py",
|
||||||
"67": "admin_panel/templates/admin_panel/customerBaseNew.html",
|
"67": "Graphify Tooling Docs",
|
||||||
"68": "Customer List",
|
"68": "Command",
|
||||||
"69": "admin_panel/templates/admin_panel/entezarBK.html",
|
"69": "ZeroZeroNinetyEightLinkTests",
|
||||||
"70": "Financial Dashboard",
|
"70": "SMS Template Seeding",
|
||||||
"71": "Accounting Main View",
|
"71": "admin_panel/entezar.html",
|
||||||
"72": "admin_panel/templates/admin_panel/index.html",
|
"72": "customerNewBackup.html",
|
||||||
"73": "New Inventory Operation",
|
"73": "SMSProvider",
|
||||||
"74": "Inventory Operations List",
|
"74": "0070_sms_types_seven.py",
|
||||||
"75": "Operations Backup Template",
|
"75": "ViewSmokeTests",
|
||||||
"76": "Financial Report Template",
|
"76": "Timezone Migration History",
|
||||||
"77": "Debt Collection Dashboard",
|
"77": "Command",
|
||||||
"78": "Inventory Movement Report",
|
"78": "TodayFollowupTests",
|
||||||
"79": "Customer Satisfaction Dashboard",
|
"79": "Brand Scrubbing Migration",
|
||||||
"80": "Check and Credit Report Template",
|
"80": "SMS Dedup Migration",
|
||||||
"81": "Satisfaction List Template",
|
"81": "Installation Guide",
|
||||||
"82": "Store Inventory Template",
|
"82": "Project Honesty Contract",
|
||||||
"83": "Store Transfers Template",
|
"83": "Flow Control Migration",
|
||||||
"84": "Stores List Template",
|
"84": "Permission Label Migration",
|
||||||
"85": "toCurrency",
|
"85": "visit_policy.py",
|
||||||
"86": "templatetags/__init__.py",
|
"86": "Output Format Specs",
|
||||||
"87": "URL: newStore",
|
"87": "Performance Benchmarks",
|
||||||
"88": "URL: process_transfer_action",
|
"88": "SMS Integration Overview",
|
||||||
"89": "URL: rezayatEdit",
|
"89": "CustomerNameFixJob",
|
||||||
"90": "khatibi/__init__.py",
|
"90": "Customer Modal UI",
|
||||||
"91": "Extended Requirements File",
|
"91": "decide_prefix",
|
||||||
"92": "Requirements File",
|
"92": "Infrastructure Services",
|
||||||
"93": "django_shortcuts",
|
"93": "Agent Setup Guide",
|
||||||
"94": "resolve_recipients",
|
"94": "First Use Guide",
|
||||||
"95": "factories.py",
|
"95": "console.py",
|
||||||
"96": "write_tree",
|
"96": "test_sms.py",
|
||||||
"97": "TemplatesPageUITests",
|
"97": "تجمیع شمارههای پیامک مشتریان",
|
||||||
"98": "reconciliation_tool.py",
|
"98": "Command",
|
||||||
"99": "ModelsPackageContractTests",
|
"99": "Base Template",
|
||||||
"100": "django_conf",
|
"100": "test_customer_name_fix.py",
|
||||||
"101": "Command",
|
"101": "Customer",
|
||||||
"102": "UrlContractTests",
|
"102": "WorkerTests",
|
||||||
"103": "customerIDFactorBackup.html",
|
"103": "manage.py",
|
||||||
"104": "system.py",
|
"104": "افزودن پیشوند «آقای/خانم» به نام مشتریان",
|
||||||
"105": "BehinSMSProvider",
|
"105": "Command",
|
||||||
"106": "test_customers.py",
|
"106": "make_customer",
|
||||||
"107": "tests/__init__.py",
|
"107": "admin_panel/apps.py",
|
||||||
"108": "Command",
|
"108": "SMS Domain Logic",
|
||||||
"109": "Command",
|
"109": "Customer Communication Partials",
|
||||||
"110": "0061_sms_timing_and_primary.py",
|
"110": "SMS Template Management",
|
||||||
"111": "bale/providers.py",
|
"111": "Documentation and Graphing",
|
||||||
"112": "os",
|
"112": "Admin Migration Package",
|
||||||
"113": "Command",
|
"113": "resolve_recipients",
|
||||||
"114": "0058_seed_sms_templates.py",
|
"114": "Customer Action Templates",
|
||||||
"115": "test_factors.py",
|
"115": "Customer Feedback Components",
|
||||||
"116": "Customer",
|
"116": "Customer Invoice Details",
|
||||||
"117": "customerNewBackup.html",
|
"117": "Accounting Document Templates",
|
||||||
"118": "0059_sms_flow_control.py",
|
"118": "Customer Invoice List",
|
||||||
"119": "0060_sms_permission_label.py",
|
"119": "Customer Feedback Interface",
|
||||||
"120": "datetime",
|
"120": "Custom Management Commands",
|
||||||
"121": "0008_storeroom_user.py",
|
"121": "Django Management Package",
|
||||||
"122": "0013_alter_factor_options.py",
|
"122": "Admin Panel Migrations",
|
||||||
"123": "0018_alter_factoriteam_product.py",
|
"123": "Action List Interface",
|
||||||
"124": "0020_auto_20220126_1532.py",
|
"124": "Base HTML Layout",
|
||||||
"125": "0022_article_typepy.py",
|
"125": "New Invoice Creation",
|
||||||
"126": "0025_action_actiontype.py",
|
"126": "Customer Satisfaction Records",
|
||||||
"127": "0028_action_grade.py",
|
"127": "Satisfaction UI Components",
|
||||||
"128": "0030_auto_20220414_1047.py",
|
"128": "Debt and Credit Management",
|
||||||
"129": "0036_sarresid.py",
|
"129": "Customer Base Layout",
|
||||||
"130": "0037_sarresid_sarresiddt.py",
|
"130": "Waiting List Template",
|
||||||
"131": "0039_customer_last_bazdid_dt.py",
|
"131": "Financial Dashboard",
|
||||||
"132": "0041_auto_20240216_1607.py",
|
"132": "Accounting Main View",
|
||||||
"133": "0047_alter_productinstore_movement_type.py",
|
"133": "Admin Dashboard Index",
|
||||||
"134": "0049_alter_productinstore_options.py",
|
"134": "Inventory Entry Form",
|
||||||
"135": "0057_sms.py",
|
"135": "Inventory Operations History",
|
||||||
"136": "admin_panel/sms/__init__.py",
|
"136": "Operations Backup View",
|
||||||
"137": "bale/__init__.py",
|
"137": "Financial Reporting",
|
||||||
"138": "integrations/__init__.py",
|
"138": "Debt Collection Interface",
|
||||||
"139": "integrations/sms/__init__.py"
|
"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 @@
|
|||||||
{"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 @@
|
|||||||
{"output_tokens": 126792}
|
{"output_tokens": 201}
|
||||||
+627
-316
File diff suppressed because it is too large.
Load diff
@@ -63,12 +63,12 @@
|
|||||||
</div>
|
</div>
|
||||||
<div id="legend"></div>
|
<div id="legend"></div>
|
||||||
</div>
|
</div>
|
||||||
<div id="stats">1280 nodes · 2237 edges · 140 communities</div>
|
<div id="stats">2509 nodes · 4876 edges · 223 communities</div>
|
||||||
</div>
|
</div>
|
||||||
<script>
|
<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_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": "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 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/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'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 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'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
|
// HTML-escape helper — prevents XSS when injecting graph data into innerHTML
|
||||||
function esc(s) {
|
function esc(s) {
|
||||||
@@ -293,7 +293,7 @@ LEGEND.forEach(c => {
|
|||||||
</script>
|
</script>
|
||||||
<script>
|
<script>
|
||||||
// Render hyperedges as shaded regions
|
// 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.
|
// afterDrawing passes ctx already transformed to network coordinate space.
|
||||||
// Draw node positions raw — no manual pan/zoom/DPR math needed.
|
// Draw node positions raw — no manual pan/zoom/DPR math needed.
|
||||||
|
|
||||||
|
|||||||
+59440
-14484
File diff suppressed because it is too large.
Load diff
+496
-214
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
+2
-2
@@ -78,11 +78,11 @@ WSGI_APPLICATION = 'khatibi.wsgi.application'
|
|||||||
DATABASES = {
|
DATABASES = {
|
||||||
'default': {
|
'default': {
|
||||||
'ENGINE': 'django.db.backends.sqlite3',
|
'ENGINE': 'django.db.backends.sqlite3',
|
||||||
'NAME': BASE_DIR / 'data9/kt.sqlite3',
|
'NAME': BASE_DIR / 'data9/khatibi92669266_backups_db_backup_20261021_223009.sqlite3',
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#
|
||||||
# Password validation
|
# Password validation
|
||||||
# https://docs.djangoproject.com/en/3.2/ref/settings/#auth-password-validators
|
# https://docs.djangoproject.com/en/3.2/ref/settings/#auth-password-validators
|
||||||
|
|
||||||
|
|||||||
@@ -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` را دیدهای (خصوصاً `سرریز طول` و `مقدار موجودِ محافظتشده`)؟
|
||||||
|
|
||||||
@@ -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` است، نه این ستون. در صورت شک، همان کوئریهای بخش
|
||||||
|
«بررسی صحت داده» ملاک هستند.
|
||||||
|
```
|
||||||
@@ -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()
|
||||||
@@ -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()
|
||||||
|
|
||||||
@@ -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()
|
||||||
@@ -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
@@ -4,7 +4,7 @@
|
|||||||
from django.test import TestCase
|
from django.test import TestCase
|
||||||
from django.urls import reverse
|
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
|
from .factories import login_superuser, make_customer, make_user
|
||||||
|
|
||||||
@@ -55,6 +55,94 @@ class CustomerCrudTests(TestCase):
|
|||||||
self.assertEqual(phones[0].phone_number, '09120009999')
|
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):
|
class InactiveCustomerHiddenTests(TestCase):
|
||||||
"""مشتری غیرفعال (is_active=False) در فهرست و در جستجو دیده نمیشود."""
|
"""مشتری غیرفعال (is_active=False) در فهرست و در جستجو دیده نمیشود."""
|
||||||
|
|
||||||
|
|||||||
File diff suppressed because it is too large.
Load diff
+1368
-137
File diff suppressed because it is too large.
Load diff
@@ -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()
|
||||||
|
|
||||||
@@ -7,7 +7,7 @@
|
|||||||
from django.test import SimpleTestCase
|
from django.test import SimpleTestCase
|
||||||
from django.urls import reverse
|
from django.urls import reverse
|
||||||
|
|
||||||
# snapshot قطعی نامهای مسیرهای اپ admin_panel (۷۲ مسیر)
|
# snapshot قطعی نامهای مسیرهای اپ admin_panel (۷۷ مسیر)
|
||||||
EXPECTED_URL_NAMES = {
|
EXPECTED_URL_NAMES = {
|
||||||
'index',
|
'index',
|
||||||
'p_login',
|
'p_login',
|
||||||
@@ -36,6 +36,7 @@ EXPECTED_URL_NAMES = {
|
|||||||
'customerNazar',
|
'customerNazar',
|
||||||
'customerNewAction',
|
'customerNewAction',
|
||||||
'customerEditAction',
|
'customerEditAction',
|
||||||
|
'customerActionDelete',
|
||||||
'customerDel',
|
'customerDel',
|
||||||
'customerFactors',
|
'customerFactors',
|
||||||
'customerFactor',
|
'customerFactor',
|
||||||
@@ -76,10 +77,12 @@ EXPECTED_URL_NAMES = {
|
|||||||
'sms_settings',
|
'sms_settings',
|
||||||
'sms_templates',
|
'sms_templates',
|
||||||
'sms_template_edit',
|
'sms_template_edit',
|
||||||
|
'customerSmsHistory',
|
||||||
'sms_customer_toggle',
|
'sms_customer_toggle',
|
||||||
'sms_primary_toggle',
|
'sms_primary_toggle',
|
||||||
'sms_send_custom',
|
'sms_send_custom',
|
||||||
'sms_queue',
|
'sms_queue',
|
||||||
|
'sms_report',
|
||||||
'sms_queue_retry',
|
'sms_queue_retry',
|
||||||
'sms_queue_approve',
|
'sms_queue_approve',
|
||||||
'sms_queue_delete',
|
'sms_queue_delete',
|
||||||
@@ -97,6 +100,7 @@ PARAMETERIZED = {
|
|||||||
'customerNazar': {'c_id': 1},
|
'customerNazar': {'c_id': 1},
|
||||||
'customerNewAction': {'c_id': 1},
|
'customerNewAction': {'c_id': 1},
|
||||||
'customerEditAction': {'c_id': 1, 'action_id': 1},
|
'customerEditAction': {'c_id': 1, 'action_id': 1},
|
||||||
|
'customerActionDelete': {'c_id': 1, 'action_id': 1},
|
||||||
'customerDel': {'c_id': 1},
|
'customerDel': {'c_id': 1},
|
||||||
'customerFactors': {'c_id': 1},
|
'customerFactors': {'c_id': 1},
|
||||||
'customerFactor': {'c_id': 1, 'f_id': 1},
|
'customerFactor': {'c_id': 1, 'f_id': 1},
|
||||||
@@ -124,6 +128,7 @@ PARAMETERIZED = {
|
|||||||
'addSarresid': {'cs_id': 1},
|
'addSarresid': {'cs_id': 1},
|
||||||
'pardakhtNesiye': {'cs_id': 1},
|
'pardakhtNesiye': {'cs_id': 1},
|
||||||
'sms_template_edit': {'t_id': 1},
|
'sms_template_edit': {'t_id': 1},
|
||||||
|
'customerSmsHistory': {'c_id': 1},
|
||||||
'sms_customer_toggle': {'c_id': 1},
|
'sms_customer_toggle': {'c_id': 1},
|
||||||
'sms_primary_toggle': {'c_id': 1},
|
'sms_primary_toggle': {'c_id': 1},
|
||||||
'sms_send_custom': {'c_id': 1},
|
'sms_send_custom': {'c_id': 1},
|
||||||
|
|||||||
@@ -9,6 +9,8 @@
|
|||||||
هیچ پاسخی نباید کد ۵۰۰ داشته باشد.
|
هیچ پاسخی نباید کد ۵۰۰ داشته باشد.
|
||||||
"""
|
"""
|
||||||
import json
|
import json
|
||||||
|
import re
|
||||||
|
from html.parser import HTMLParser
|
||||||
|
|
||||||
from django.test import TestCase
|
from django.test import TestCase
|
||||||
from django.urls import reverse
|
from django.urls import reverse
|
||||||
@@ -224,7 +226,9 @@ class ViewSmokeTests(TestCase):
|
|||||||
'phone': '09120000000', 'is_primary': 'true',
|
'phone': '09120000000', 'is_primary': 'true',
|
||||||
}),
|
}),
|
||||||
('sms_send_custom', {'c_id': c.id}, POST, {'text': 'پیامک دودی'}),
|
('sms_send_custom', {'c_id': c.id}, POST, {'text': 'پیامک دودی'}),
|
||||||
|
('customerSmsHistory', {'c_id': c.id}, GET, None),
|
||||||
('sms_queue', {}, GET, None),
|
('sms_queue', {}, GET, None),
|
||||||
|
('sms_report', {}, GET, None),
|
||||||
('sms_queue_retry', {'q_id': self.sms_queue.id}, POST, None),
|
('sms_queue_retry', {'q_id': self.sms_queue.id}, POST, None),
|
||||||
# در انتهای لیست: خروج از حساب، چون بعد از آن تمام درخواستها بیاعتبار میشوند
|
# در انتهای لیست: خروج از حساب، چون بعد از آن تمام درخواستها بیاعتبار میشوند
|
||||||
('p_logout', {}, GET, None),
|
('p_logout', {}, GET, None),
|
||||||
@@ -255,3 +259,114 @@ class ViewSmokeTests(TestCase):
|
|||||||
f"دادهاند: {failures}"
|
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
Reference in new issue
Block a user