Projects/docs/architecture.md

System Architecture & Directory Specifications

Backend Structure (src/main/java/ir/ac/ut/ece/ie/)

ir/ac/ut/ece/ie/
├── Main.java                           # Entry point
├── config/                             # Configuration classes (Security, CORS, DB, App)
├── controller/                         # REST Controllers (Auth, User, Article, etc.)
├── model/                              # JPA Data Entities (User, Article, Message, etc.)
├── repository/                         # Data Access JPA Repositories
├── service/                            # Business Logic Services
├── security/                           # JWT, PasswordEncoder, Rate Limiting
├── util/                               # Utilities (JSON, Sanitizer, Generators)
├── filter/                             # Request/Response Security Filters
├── websocket/                          # WebSockets & Messaging Handlers
├── search/                             # Search Indexing
├── job/                                # Scheduled Maintenance & Background Jobs
├── audit/                              # Audit Logging
└── server/                             # Embedded Server Engine & Dynamic Routes

---

Frontend Structure (front/src/)

front/src/
├── api/                                # API client definitions & modules
├── services/                           # Export, RAG, Search services
├── security/                           # Client-side security (JWT, CSRF)
├── audit/                              # Client-side audit logger
├── utils/                              # File, Date, Error helpers
├── config/                             # App & Environment configuration
├── styles/                             # Global CSS & Tailwind definitions
├── types/                              # TypeScript interfaces & DTOs
├── components/                         # React UI components & modals
│   ├── ui/
│   ├── layout/
│   ├── article/
│   ├── dashboard/
│   ├── messages/
│   └── ...
├── pages/                              # Main application page views (130+ views)
├── hooks/                              # Custom React Hooks
└── lib/                                # Core Axios API instance & offline cache