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