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