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

8.6 KiB
Raw Blame History

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)

# 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)

cd cti-app
npm install
npm run dev          # dev server روی http://localhost:5173
npm run build        # build production

تولید مستندات Self-Evaluation

# تولید 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 و ارزیابی امنیتی کامل در دامنه این سند نیستند.