150 lines
13 KiB
Markdown
150 lines
13 KiB
Markdown
# 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`
|
||
|
||
### کوتاهمدت (مستندسازی)
|
||
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
|