# HANDOFF-CONTEXT — سند تحویل و ادامه مسیر پروژه CTI > **هدف این سند:** هر مدل زبانی / توسعه‌دهنده‌ای که این فایل را می‌خواند، بتواند بدون دانستن تاریخچه چت، کار را دقیقاً از همین نقطه ادامه دهد. > **آخرین به‌روزرسانی:** 2026-10-07 > **محل ذخیره پیشنهادی:** docs/markdown/HANDOFF-CONTEXT.md --- ## 1) شناسنامه پروژه | مورد | مقدار | |---|---| | مسیر ریشه | /home/it003/Desktop/project/cti | | محصول | Raymand-CTI نسخه 2.0.3 (سامانه CTI/VoIP مبتنی بر Asterisk) | | شرکت | Raymand Communications Naqsh Jahan | | فرانت‌اند | cti-app/ — React 18.3.1 + TypeScript + Vite، پورت dev، cookie-based auth | | بک‌اند | p-line/ — Java 25 + Spring Boot + PostgreSQL + asterisk-java، پورت 8080 | | اسکریپت‌های عملیاتی | p-line/tools/ (ha.sh و ...) | | مستندات | docs/markdown/ | --- ## 2) فایل‌های کلیدی مستندات (docs/markdown/) 1. **CTI-ARCHITECTURE-ANALYSIS.md** — تحلیل معماری (React/Vite فرانت، Spring/JPA بک‌اند، Asterisk، WebSocket /ws، 301 فایل Java، 54 کنترلر، 57 Entity، 58 Repository). 2. **الزامات-پرسشنامه-نرم‌افزار-تحت-شبکه.md** — استخراج الزامات امنیتی نسخه ۱.۱ (لاگ، احراز هویت، گذرواژه، نشست، رمزنگاری، TLS/SSH). 3. **عدم‌انطباق-الزامات-امنیتی-CTI.md** — فهرست NC-001 تا NC-018 با اولویت و اقدام اصلاحی (همگی باز/در بررسی). 4. **SELF-EVALUATION-CTI-ANSWERS.md** — پاسخ‌نامه ۸۵ آیتم سند خودارزیابی (تولیدشده توسط اسکریپت، منبع حقیقت پاسخ‌ها). 5. **migration-chat-log.md** — لاگ مهاجرت Spring Boot 2→3 (۶۳ کوئری nativeQuery خراب؛ SipUsers/SipTrunks اصلاح شد؛ IvrRepository و بقیه هنوز باقی‌اند؛ خطای Jackson در NetworkInterfacePhyInfo فیلد link_index؛ خطای DDL ستون sound_ids در tbl_announces). --- ## 3) تصمیم‌های گرفته‌شده (Decision Log — به ترتیب زمانی) 1. رفع عدم‌انطباق‌های امنیتی **مرحله‌به‌مرحله با هماهنگی کاربر** (هر مرحله فقط با تأیید او). 2. ابتدا **سند عدم‌انطباق با شواهد دقیق کد به‌روز شود**، بعد رفع شروع شود. 3. سند نقشه راه رفع ایجاد شود: **SECURITY-REMEDIATION-PLAN.md** (هنوز ساخته نشده — TODO). 4. سند زمینه پروژه ایجاد شود: **PROJECT-CONTEXT.md** (هنوز ساخته نشده — TODO). 5. زبان اسناد جدید: **عنوان‌ها انگلیسی، توضیحات فارسی**. 6. دو فایل **Word + PDF پرسشنامه** باید ساخته شود تا پاسخ پرسش‌های دو مستند ممکن باشد. 7. فایل `Self-Evaluation-v1.0.docx` (سند خودارزیابی افتا، ریشه پروژه) خوانده شد؛ **نسخه تکمیل‌شده با پاسخ‌ها** تولید شد. 8. پاسخ‌ها **وضعیت واقعی فعلی کد** را منعکس می‌کنند؛ آیتم‌های پیاده‌نشده بدون علامت (طبق قاعده پرسشنامه). 9. کاربر خواست **همه داده‌ها مستند شود تا مدل‌های زبانی دیگر بتوانند ادامه دهند** → همین سند. --- ## 4) فهرست عدم‌انطباق‌ها (NC) + شواهد دقیق کد ### بحرانی - **NC-001 (HTTPS/TLS):** application.properties:3 (`server.port=8080`، هیچ ssl/keystore) | فرانت: PlineTools.tsx:26 (`http://localhost:8080`) - **NC-002 (HTTP حساس):** application.properties:69 (`pline.license_url=http://license.raymandcti.com:8008`)، خط 68 و 70 - **NC-003 (MD5):** GlobalTools.java:59-63 (پیاده‌سازی MD5) — مصرف: UsersController.java:97 (login)، :166,171 (change-password)، :218,256 (create/update)، Initializer.java:204 (**پیش‌فرض admin با MD5("admin")**)، QueueLiveInfoController.java:87,104 - **NC-011 (secret آشکار):** application.properties:14 (`spring.datasource.password=Mehdi@123`)، :51 (`pline.jwt_secret=...` متن آشکار)، :52 (انقضای JWT = 2678400 ثانیه ≈ 31 روز) | فرانت: PlineTools.tsx:35 (IP هاردکد `http://192.168.180.7:8684`) ### بالا (احراز هویت/نشست) - **NC-004 (policy گذرواژه):** UsersController.java:137-182 (فقط null-check)، :209 (create بدون validation) | فرانت فقط پیام UI: Persian.json:1337 («حداقل ۶ کاراکتر») - **NC-005 (تلاش ناموفق):** UsersController.java:83-135 (login بدون شمارنده/قفل؛ فقط لاگ + `token=""`) - **NC-006 (CAPTCHA سمت کلاینت):** Captcha.tsx:12-22 (تولید با Math.random)؛ Login.tsx:58 (`captcha.image.toLowerCase() === captcha.input.toLowerCase()` — مقایسه در کلاینت، به سرور ارسال نمی‌شود) | بک‌اند: UsersController.java:84 هیچ فیلد captcha نمی‌گیرد - **NC-007 (نشست):** jwtAuthorizationCheck.java:101 (`getSession()` بدون setMaxInactiveInterval/سقف نشست) - **NC-008 (logout/revoke):** هیچ endpoint logout در UsersController نیست | App.tsx:50-54 (logout فقط removeCookies؛ JWT تا 31 روز معتبر) ### بالا (دسترسی/CORS/لاگ) - **NC-009 (CORS):** jwtAuthorizationCheck.java:56,89-90,127,144,154,164,175,188 (`Access-Control-Allow-Origin: *` + `Allow-Credentials: true`)؛ ~50 کنترلر با `@CrossOrigin(value="*")` (نمونه: UsersController.java:46)؛ WebSocketConfig.java:15 (`setAllowedOrigins("*")`) - **NC-010 (مسیرهای عمومی):** jwtAuthorizationCheck.java:73-81 (`/users/login`, `/app/get-version`, `/error/`, `/download/`, `/crm/`, `/tmp/` بدون auth)؛ DownloadControllers.java:31,63,83 (دانلود بدون authorization) - **NC-012 (یکپارچگی لاگ):** UserLogger.java + TblUserLog بدون hash/tamper-proof؛ حذف لاگ ممکن است (SystemLogs.tsx:429 DELETE به /users/user-logs) - **NC-013 (پوشش لاگ):** لاگ‌های کامنت‌شده: UsersController.java:204، AmisController.java:85، MusicOnHoldsController.java:55، RingGroupUsersController.java:45 ### متوسط/کم (در حال بررسی) - **NC-014** ظرفیت لاگ — **NC-015** امضای update (AppControllers.java، UpdateService.ts) — **NC-016** NTP (endpoint /app/ntp-check/{server} در AppControllers.java:544) — **NC-017** validation گواهینامه (Certificates.tsx) — **NC-018** SSH (محصول ندارد → خارج از دامنه) ### ترتیب رفع توافق‌شده - مرحله ۱ (بحرانی): NC-011 → NC-003 → NC-002 → NC-001 - مرحله ۲: NC-005 → NC-004 → NC-006 → NC-008 → NC-007 - مرحله ۳: NC-009 → NC-010 → NC-012/013 - مرحله ۴: NC-014 تا NC-018 (ابتدا تعیین تکلیف) ### تصمیم طراحی مهم برای NC-003 مهاجرت تدریجی MD5→bcrypt: پسوردهای MD5 موجود قابل بازیابی نیستند → در اولین login موفق، rehash با bcrypt و جایگزینی در DB. --- ## 5) سند خودارزیابی افتا (Self-Evaluation-v1.0.docx) - مسیر فایل اصلی: **ریشه پروژه** `/Self-Evaluation-v1.0.docx` (~۱MB، حفاظت Restrict Editing صرفاً راهنمای کاربر است؛ در سطح XML قفل ندارد). - ساختار: ۸۵ آیتم، هر آیتم جدولی با ردیف‌های: شناسه الزام | نام الزام | متن الزام | راهنمایی | نحوه‌ی دسترسی | تصویر | توضیحات بیشتر. - شناسه‌ها به سبک CC: FAU_GEN/SAR/STG/COP، FCS_CKM/HTTPS/TLSC/TLSS/SSH، FIA_AFL/ATD/PMG/UAU/UID/USB/X509، FDP_*, FMT_*, FPT_*, FRU_FLT، FTA_*, FTP_TRP + ۶ آزمون آسیب‌پذیری بی‌شناسه (بروز بودن اجزا، سرآیندها، Cookie، Ports، متدهای ناامن، Anti-CSRF). - آیتم ۱ = جدول منابع (بدون شناسه)؛ آیتم‌های ۸۰–۸۵ با متن الزام تطبیق داده می‌شوند نه شناسه. ### کاری که انجام شد - اسکریپت تولید شد: **docs/tools/fill_self_evaluation.py** (فقط stdlib: zipfile+regex) + پارت‌های fill_part1-4.py (بانک ۸۵ پاسخ + منطق). - خروجی: **docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx** — نسخه تکمیل‌شده (فایل اصلی دست‌نخورده). - پاسخ‌نامه MD: **docs/markdown/SELF-EVALUATION-CTI-ANSWERS.md**. - توزیع وضعیت پاسخ‌ها: پیاده‌سازی شده ≈20، جزئی ≈25، بدون ادعا ≈32، خارج از دامنه (SSH) = 9. - جلد سند پر شد: نام متقاضی/محصول/نسخه/تاریخ (2026-09-16). جدول منابع: GNU/Linux Ubuntu 22.04، 4 هسته، 8GB، 100GB. - **اعتبارسنجی:** تبدیل LibreOffice بدون خطا؛ 85 «وضعیت:» و 85 «نحوه‌ی دسترسی» در خروجی؛ بدون duplicate/unmatched. ### منطق تطبیق اسکریپت (برای توسعه آینده) 1. `table_id()`: سلول بعد از برچسب «شناسه الزام». 2. تطبیق پاسخ با کلیدها (substring) روی شناسه؛ برای ۶ آیتم آسیب‌پذیری: تطبیق روی متن الزام با دیکشنری `BODIES` (کلیدها: 'ابزارها و چارچوب', 'Strict Transport Security', 'پیکربندی صحیح Cookie', 'درگاه‌هایی', 'متدهای ناامن', 'Anti-CSRF'). 3. جدول منابع با کلید 'تعداد هسته'؛ جدول جلد با 'نام متقاضی'. 4. درج پاراگراف RTL: `…` در سلول خالی بعد از سلول برچسب. 5. نکته: به‌جای `sed -i` از python replace استفاده کنید (محیط sed -i را بلاک می‌کند). --- ## 6) وضعیت TODO — به ترتیب اولویت ### فوری (بلافاصله) 1. **[بلاک‌شده توسط plan mode]** کپی از /tmp به پروژه: - `mkdir -p docs/tools docs/questionnaire` - `cp /tmp/fill_self_evaluation.py /tmp/fill_part1.py /tmp/fill_part2.py /tmp/fill_part3.py /tmp/fill_part4.py docs/tools/` - `cp /tmp/selfeval_out/Self-Evaluation-v1.0-CTI-Filled.docx docs/questionnaire/` - `cp /tmp/selfeval_out/SELF-EVALUATION-CTI-ANSWERS.md docs/markdown/` - ⚠️ اگر /tmp پاک شده: اسکریپت را از docs/tools اجرا کنید تا دوباره تولید شود (`python3 docs/tools/fill_self_evaluation.py`) — پاسخ‌ها داخل پارت‌ها هستند. 2. تولید **PDF** از همان محتوا: `soffice --headless --convert-to pdf --outdir docs/questionnaire docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx` ### کوتاه‌مدت (مستندسازی) 3. ساخت **SECURITY-REMEDIATION-PLAN.md** (نقشه راه رفع NC ها + چک‌لیست اعتبارسنجی + Decision Log). 4. ساخت **PROJECT-CONTEXT.md** (ساختار ریپو، دستورات build، وضعیت مهاجرت SB3). 5. به‌روزرسانی **عدم‌انطباق-الزامات-امنیتی-CTI.md** با ستون شواهد دقیق (بخش 4 همین سند را کپی کنید) + افزودن یافته‌های جدید (Initializer admin/MD5، JWT 31 روزه) به‌عنوان NC-019/NC-020. ### میان‌مدت (رفع — فقط با هماهنگی کاربر، مرحله‌به‌مرحله) 6. مرحله ۱ بحرانی: NC-011 → NC-003 → NC-002 → NC-001 (سپس سرآیندها/Cookie از آزمون‌های آسیب‌پذیری خودبه‌خود رفع می‌شوند) 7. مرحله ۲ تا ۴ طبق ترتیب بالا. پس از هر رفع: پاسخ آیتم مرتبط در SELF-EVALUATION-CTI-ANSWERS.md و docx را به‌روز کنید (اسکریپت را دوباره اجرا کنید) و ستون وضعیت NC را «رفع‌شده» کنید. ### باقی‌مانده مهاجرت Spring Boot (مستقل از امنیت) - تبدیل بقیه 63-تایی کوئری‌های `nativeQuery=true` خراب (شروع از IvrRepository) — الگو: `SELECT t.*`→`SELECT t`، `COUNT(t.*)`→`COUNT(t)`، underscore→camelCase، حذف nativeQuery=true. - خطای Jackson: افزودن `@JsonIgnoreProperties(ignoreUnknown=true)` به NetworkInterfacePhyInfo. - خطای DDL: `ALTER TABLE tbl_announces ALTER COLUMN sound_ids TYPE bigint[] USING sound_ids::bigint[]`. --- ## 7) دستورات کاربردی ```bash # بازسازی docx تکمیل‌شده از اسکریپت‌ها python3 docs/tools/fill_self_evaluation.py # خروجی: /tmp/selfeval_out/ (سپس کپی به docs/questionnaire/) # اعتبارسنجی سند Word soffice --headless --convert-to "txt:Text (encoded):UTF8" --outdir /tmp/verify docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx grep -c "وضعیت:" /tmp/verify/*.txt # باید 85 باشد # ساخت PDF soffice --headless --convert-to pdf --outdir docs/questionnaire docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx # بیلد پروژه cd p-line && mvn clean compile && mvn spring-boot:run cd cti-app && npm install && npm run build