Files
cti/docs/markdown/HANDOFF-CONTEXT.md
2026-10-14 23:05:02 +03:30

13 KiB
Raw Blame History

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: <w:p><w:pPr><w:bidi/><w:spacing w:after="120"/></w:pPr><w:r><w:rPr><w:rtl/></w:rPr><w:t>…</w:t></w:r></w:p> در سلول خالی بعد از سلول برچسب.
  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

کوتاه‌مدت (مستندسازی)

  1. ساخت SECURITY-REMEDIATION-PLAN.md (نقشه راه رفع NC ها + چک‌لیست اعتبارسنجی + Decision Log).
  2. ساخت PROJECT-CONTEXT.md (ساختار ریپو، دستورات build، وضعیت مهاجرت SB3).
  3. به‌روزرسانی عدم‌انطباق-الزامات-امنیتی-CTI.md با ستون شواهد دقیق (بخش 4 همین سند را کپی کنید) + افزودن یافته‌های جدید (Initializer admin/MD5، JWT 31 روزه) به‌عنوان NC-019/NC-020.

میان‌مدت (رفع — فقط با هماهنگی کاربر، مرحله‌به‌مرحله)

  1. مرحله ۱ بحرانی: NC-011 → NC-003 → NC-002 → NC-001 (سپس سرآیندها/Cookie از آزمون‌های آسیب‌پذیری خودبه‌خود رفع می‌شوند)
  2. مرحله ۲ تا ۴ طبق ترتیب بالا. پس از هر رفع: پاسخ آیتم مرتبط در 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) دستورات کاربردی

# بازسازی 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