13 KiB
13 KiB
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/)
- CTI-ARCHITECTURE-ANALYSIS.md — تحلیل معماری (React/Vite فرانت، Spring/JPA بکاند، Asterisk، WebSocket /ws، 301 فایل Java، 54 کنترلر، 57 Entity، 58 Repository).
- الزامات-پرسشنامه-نرمافزار-تحت-شبکه.md — استخراج الزامات امنیتی نسخه ۱.۱ (لاگ، احراز هویت، گذرواژه، نشست، رمزنگاری، TLS/SSH).
- عدمانطباق-الزامات-امنیتی-CTI.md — فهرست NC-001 تا NC-018 با اولویت و اقدام اصلاحی (همگی باز/در بررسی).
- SELF-EVALUATION-CTI-ANSWERS.md — پاسخنامه ۸۵ آیتم سند خودارزیابی (تولیدشده توسط اسکریپت، منبع حقیقت پاسخها).
- migration-chat-log.md — لاگ مهاجرت Spring Boot 2→3 (۶۳ کوئری nativeQuery خراب؛ SipUsers/SipTrunks اصلاح شد؛ IvrRepository و بقیه هنوز باقیاند؛ خطای Jackson در NetworkInterfacePhyInfo فیلد link_index؛ خطای DDL ستون sound_ids در tbl_announces).
3) تصمیمهای گرفتهشده (Decision Log — به ترتیب زمانی)
- رفع عدمانطباقهای امنیتی مرحلهبهمرحله با هماهنگی کاربر (هر مرحله فقط با تأیید او).
- ابتدا سند عدمانطباق با شواهد دقیق کد بهروز شود، بعد رفع شروع شود.
- سند نقشه راه رفع ایجاد شود: SECURITY-REMEDIATION-PLAN.md (هنوز ساخته نشده — TODO).
- سند زمینه پروژه ایجاد شود: PROJECT-CONTEXT.md (هنوز ساخته نشده — TODO).
- زبان اسناد جدید: عنوانها انگلیسی، توضیحات فارسی.
- دو فایل Word + PDF پرسشنامه باید ساخته شود تا پاسخ پرسشهای دو مستند ممکن باشد.
- فایل
Self-Evaluation-v1.0.docx(سند خودارزیابی افتا، ریشه پروژه) خوانده شد؛ نسخه تکمیلشده با پاسخها تولید شد. - پاسخها وضعیت واقعی فعلی کد را منعکس میکنند؛ آیتمهای پیادهنشده بدون علامت (طبق قاعده پرسشنامه).
- کاربر خواست همه دادهها مستند شود تا مدلهای زبانی دیگر بتوانند ادامه دهند → همین سند.
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.
منطق تطبیق اسکریپت (برای توسعه آینده)
table_id(): سلول بعد از برچسب «شناسه الزام».- تطبیق پاسخ با کلیدها (substring) روی شناسه؛ برای ۶ آیتم آسیبپذیری: تطبیق روی متن الزام با دیکشنری
BODIES(کلیدها: 'ابزارها و چارچوب', 'Strict Transport Security', 'پیکربندی صحیح Cookie', 'درگاههایی', 'متدهای ناامن', 'Anti-CSRF'). - جدول منابع با کلید 'تعداد هسته'؛ جدول جلد با 'نام متقاضی'.
- درج پاراگراف 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>در سلول خالی بعد از سلول برچسب. - نکته: بهجای
sed -iاز python replace استفاده کنید (محیط sed -i را بلاک میکند).
6) وضعیت TODO — به ترتیب اولویت
فوری (بلافاصله)
- [بلاکشده توسط plan mode] کپی از /tmp به پروژه:
mkdir -p docs/tools docs/questionnairecp /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) — پاسخها داخل پارتها هستند.
- تولید PDF از همان محتوا:
soffice --headless --convert-to pdf --outdir docs/questionnaire docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx
کوتاهمدت (مستندسازی)
- ساخت SECURITY-REMEDIATION-PLAN.md (نقشه راه رفع NC ها + چکلیست اعتبارسنجی + Decision Log).
- ساخت PROJECT-CONTEXT.md (ساختار ریپو، دستورات build، وضعیت مهاجرت SB3).
- بهروزرسانی عدمانطباق-الزامات-امنیتی-CTI.md با ستون شواهد دقیق (بخش 4 همین سند را کپی کنید) + افزودن یافتههای جدید (Initializer admin/MD5، JWT 31 روزه) بهعنوان NC-019/NC-020.
میانمدت (رفع — فقط با هماهنگی کاربر، مرحلهبهمرحله)
- مرحله ۱ بحرانی: NC-011 → NC-003 → NC-002 → NC-001 (سپس سرآیندها/Cookie از آزمونهای آسیبپذیری خودبهخود رفع میشوند)
- مرحله ۲ تا ۴ طبق ترتیب بالا. پس از هر رفع: پاسخ آیتم مرتبط در 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