# PROJECT-CONTEXT — سند زمینه پروژه Raymand-CTI > **هدف:** منبع حقیقت برای توسعه‌دهندگان و مدل‌های زبانی جدید برای درک سریع ساختار، وابستگی‌ها و وضعیت build. > **محصول:** Raymand-CTI نسخه ۲.۰.۳ > **تاریخ:** 2026-10-07 --- ## 1. شناسنامه | مورد | مقدار | |---|---| | شرکت | Raymand Communications Naqsh Jahan | | محصول | Raymand-CTI (سامانه CTI/VoIP مبتنی بر Asterisk) | | نسخه | ۲.۰.۳ | | سیستم‌عامل هدف | Debian GNU/Linux 12 (bookworm) — در محیط توسعه: Ubuntu 22.04 LTS | | Java | ۲۵ (LTS) | | Spring Boot | ۳.۴.۵ (ترویج از ۲ → ۳ در حال انجام) | | فرانت‌اند | React ۱۸.۳.۱ + TypeScript + Vite | | دیتابیس | PostgreSQL ۱۴+ (localhost:5432/pline) | | Asterisk | ۱۸+ | | مسیر ریشه | `/home/it003/Desktop/project/cti` | --- ## 2. ساختار ریپو ``` cti/ ├── Self-Evaluation-v1.0.docx # سند خودارزیابی افتا (اصلی، دست‌نخورده) ├── راهنمای_تکمیل_پرسشنامه_نرم_افزار_1.pdf # راهنمای پرسشنامه امنیتی ├── p-line/ # بک‌اند (Java 25 + Spring Boot) │ ├── pom.xml │ ├── src/main/java/ir/peeco/pline/ │ │ ├── PlineApplication.java # نقطه ورود │ │ ├── configuration/ # Spring Config، JWT Filter │ │ ├── controllers/ # ۵۴ کنترلر REST │ │ ├── models/ # ۵۷ Entity (_tbl_*) │ │ ├── repositories/ # ۵۸ Repository │ │ ├── webSocket/ # WebSocket /ws │ │ ├── plineServer/ # منطق سرویس، لایسنس، شبکه │ │ ├── coreController/ # تماس، AGI، fax │ │ ├── tools/ # GlobalTools (شامل MD5 - NC-003) │ │ └── init/ # Initializer (admin default - NC-019) │ └── src/main/resources/ │ └── application.properties # تنظیمات (شامل secretهای آشکار - NC-011) ├── cti-app/ # فرانت‌اند (React) │ ├── package.json │ └── src/ │ ├── App.tsx # Composition اصلی │ ├── components/ │ │ ├── application-components/ │ │ │ ├── routes/AppRoutes.tsx # ۱۲ دامنه مسیر │ │ │ ├── layout/ # Header، Sidebar │ │ │ ├── common/ # Context، loading │ │ │ └── reuseables/ # input، modal، grid │ │ ├── pages/ # ۱۲ صفحه دامنه │ │ ├── services/ │ │ │ ├── PlineTools.tsx # Utility مرکزی (auth، URL) │ │ │ ├── RequestService.ts # Axios interceptor │ │ │ └── UpdateService.ts # به‌روزرسانی │ │ └── context/ # زبان، تم، polling │ └── i18n/ # ترجمه فارسی ├── docs/ │ ├── markdown/ │ │ ├── HANDOFF-CONTEXT.md # سند تحویل و ادامه │ │ ├── CTI-ARCHITECTURE-ANALYSIS.md # تحلیل معماری │ │ ├── الزامات-پرسشنامه-نرم‌افزار-تحت-شبکه.md # الزامات امنیتی │ │ ├── عدم‌انطباق-الزامات-امنیتی-CTI.md # فهرست NC-001 تا NC-018 │ │ ├── SELF-EVALUATION-CTI-ANSWERS.md # پاسخ‌نامه ۸۵ آیتم │ │ ├── SECURITY-REMEDIATION-PLAN.md # نقشه راه رفع (جدید) │ │ └── PROJECT-CONTEXT.md # این فایل │ ├── tools/ │ │ ├── fill_self_evaluation.py # اسکریپت تولید docx + MD │ │ ├── fill_part1.py # بانک پاسخ بخش ۱ │ │ ├── fill_part2.py # بانک پاسخ بخش ۲ │ │ ├── fill_part3.py # بانک پاسخ بخش ۳ │ │ └── fill_part4.py # بانک پاسخ بخش ۴ │ └── questionnaire/ │ ├── Self-Evaluation-v1.0-CTI-Filled.docx # نسخه تکمیل‌شده │ └── Self-Evaluation-v1.0-CTI-Filled.pdf # نسخه PDF └── .kilo/ # تنظیمات Kilo ``` **آمار کلیدی:** - فایل TS/TSX/JS در `cti-app/src`: ۲۲۷ فایل - فایل Java در `p-line/src/main/java`: ۳۰۱ فایل - Mappingهای endpoint در کنترلرها: ۳۱۷ مورد - ۱۲ دامنه صفحه در فرانت - ۵۴ کنترلر REST در بک‌اند --- ## 3. دستورات Build و Run ### بک‌اند (p-line) ```bash # Compile cd p-line && mvn clean compile # Run cd p-line && mvn spring-boot:run # Run با profile cd p-line && mvn spring-boot:run -Dspring-boot.run.profiles=prod # Build JAR cd p-line && mvn clean package -DskipTests # Run JAR java -jar target/pline-2.0.3.jar ``` **وضعیت مهاجرت Spring Boot ۳:** - ✅ parent در `pom.xml` به ۳.۴.۵ ارتقا یافته - ✅ `SipUsersRepository.java` — ۸ query تبدیل شد - ✅ `SipTrunksRepository.java` — ۲ query تبدیل شد - ❌ بقیه ۶۳ query `nativeQuery=true` با `SELECT t.*` هنوز باقی‌اند (جدول migration-chat-log.md) - ❌ خطای Jackson: `NetworkInterfacePhyInfo.link_index` (نیاز به `@JsonIgnoreProperties`) - ❌ خطای DDL: ستون `sound_ids` در `tbl_announces` (نیاز به `ALTER TABLE ... USING`) ### فرانت‌اند (cti-app) ```bash cd cti-app npm install npm run dev # dev server روی http://localhost:5173 npm run build # build production ``` ### تولید مستندات Self-Evaluation ```bash # تولید docx + MD از اسکریپت python3 docs/tools/fill_self_evaluation.py # اعتبارسنجی docx (باید ۸۵ "وضعیت:" داشته باشد) soffice --headless --convert-to "txt:Text (encoded):UTF8" --outdir /tmp/verify \ docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx grep -c "وضعیت:" /tmp/verify/Self-Evaluation-v1.0-CTI-Filled.txt # تولید PDF soffice --headless --convert-to pdf --outdir docs/questionnaire \ docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.docx ``` --- ## 4. لایه‌های امنیتی | لایه | مسئول | جزئیات | |---|---|---| | احراز هویت | `jwtAuthorizationCheck.java` | JWT HS512، ۳۱ روز انقضا (NC-020) | | کنترل دسترسی | `jwtAuthorizationCheck.java` | منو بر اساس هدر `Mid` و `tbl_user_access` | | فیلتر CORS | `jwtAuthorizationCheck.java` | Wildcard `*` با `Allow-Credentials: true` (NC-009) | | لاگ | `UserLogger.java` | `tbl_user_logs` — بدون hash/append-only (NC-012) | | secretها | `application.properties` | متن آشکار (NC-011) | **نقش‌ها:** `ADMIN` (دسترسی کامل)، `CLIENT` (مجوزهای تخصیصی) --- ## 5. وضعیت امنیتی فعلی - **کل NCها:** ۱۸ (NC-001 تا NC-018) - **فعال در حال رفع:** ۰ (هیچ مرحله‌ای آغاز نشده) - **برنامه ریزی شده:** مرحله ۱ بحرانی (NC-011 → NC-003 → NC-002 → NC-001) - **پیشنهادی برای افزودن:** NC-۰۱۹ (admin MD5 default)، NC-۰۲۰ (JWT ۳۱ روزه) جدول کامل و جزئیات هر NC در `docs/markdown/عدم‌انطباق-الزامات-امنیتی-CTI.md` و نقشه راه رفع در `SECURITY-REMEDIATION-PLAN.md`. --- ## 6. محدودیت‌ها - این سند بر اساس static analysis است؛ رفتار وابسته به دیتابیس واقعی، reverse proxy، Asterisk، و متغیرهای محیطی باید با اجرای سیستم و مستندات عملیاتی تأیید شود. - schema دیتابیس خودکار تولید نمی‌شود (`ddl-auto=none`). - تست، deployment topology و ارزیابی امنیتی کامل در دامنه این سند نیستند.