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

180 lines
8.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 و ارزیابی امنیتی کامل در دامنه این سند نیستند.