Bu proje, bir Todo (Görev Yönetim) uygulamasıdır. Aşağıdaki teknolojileri içerir:

• Node.js (Express.js)
• MongoDB (veritabanı)
• RabbitMQ (iş kuyruğu)
• Microservice mimarisi (Worker servisler)
• Socket.IO (gerçek zamanlı bildirimler)
• Node-RED (görsel akış tasarımı, CRUD örnekleri)
• Docker ve Docker Compose (konteynerleştirme)
• Nginx (Frontend için basit servis, Dockerfile içerisinde)
• SurveyJS (frontend form oluşturma)
• DataTables (listeleme/tablo görünümü)

.
├── backend/
│   ├── controllers/
│   │   ├── authController.js
│   │   ├── categoryController.js
│   │   ├── taskController.js
│   │   ├── taskGatewayController.js
│   │   ├── userController.js
│   │   └── userGatewayController.js
│   ├── middlewares/
│   │   └── authMiddleware.js
│   ├── models/
│   │   ├── Category.js
│   │   ├── Task.js
│   │   └── User.js
│   ├── routes/
│   │   ├── authRoutes.js
│   │   ├── categoryRoutes.js
│   │   ├── taskRoutes.js
│   │   └── userRoutes.js
│   ├── services/
│   │   ├── rabbitMQ.js
│   │   └── socket.js
│   ├── todoService.js
│   ├── userService.js
│   ├── server.js
│   ├── config/
│   │   └── config.js
│   ├── package.json
│   ├── Dockerfile
│   └── ...
├── frontend/
│   ├── index.html
│   ├── login.html
│   ├── register.html
│   ├── tasks.html
│   ├── categories.html
│   ├── users.html
│   ├── scripts/
│   │   ├── config.js
│   │   ├── login.js
│   │   ├── register.js
│   │   ├── tasks.js
│   │   ├── categories.js
│   │   └── users.js
│   ├── package.json
│   ├── Dockerfile
│   └── ...
├── docker-compose.yml
└── README.md

git clone <repository-url>
cd <repository-folder>

Proje içerisinde .env dosyası veya docker-compose.yml dosyası üzerinden aşağıdaki değişkenlerin tanımlandığından emin olun:

• MONGO_URI: MongoDB bağlantı adresi (örn. mongodb://mongodb:27017/todo-app)
• PORT: Uygulamanın dinleyeceği port (örn. 4000)
• JWT_SECRET: JWT token oluştururken kullanılacak gizli anahtar
• RABBITMQ_URI: RabbitMQ bağlantı adresi (örn. amqp://user:pass@rabbitmq:5672)

docker-compose up --build

Bu komutla beraber:

• mongo:4.4 imajı ile MongoDB başlatılır.
• rabbitmq:3-management imajı ile RabbitMQ başlatılır (5672 ve 15672 portları).
• backend dizini içerisindeki Dockerfile build edilir ve todo-backend olarak başlatılır (4000 portu).
• frontend dizini içerisindeki Dockerfile build edilir ve todo-frontend olarak başlatılır (3000 portu).
• İki farklı worker da (todo-worker, user-worker) RabbitMQ ve MongoDB'ye bağlanır.

Ardından aşağıdaki servisler çalışıyor olacaktır:

Not: Yönetim paneline erişmek için localhost:15672 üzerinden RabbitMQ kullanıcı adı ve şifrenizi giriniz (varsayılanı user, pass).

• /api/auth, /api/users, /api/tasks, /api/categories gibi uç noktaları (routes) barındırır.
• Socket.IO entegrasyonu sayesinde anlık bildirimler gönderebilir.
• RabbitMQ ile iletişime geçebilir (publish).

• todoService.js: "task_queue" kuyruğunu tüketir. Gelen "create" aksiyonunda, MongoDB'ye yeni Task kaydı oluşturur. Ardından Socket.IO ile geri bildirim yapar.
• userService.js: "user_queue" kuyruğunu tüketir. Gelen "create" aksiyonunda, MongoDB'ye yeni User kaydı oluşturur. Ardından Socket.IO ile geri bildirim yapar.

• Backend üzerinde socket.js ile init edilir.
• Worker'lar da socket.io-client ile backend'e bağlanır.
• Görev veya kullanıcı oluşturma gibi olaylar tetiklendiğinde, gerçek zamanlı bildirim gönderilir.

• server.js içinde Node-RED entegrasyonu yapılmıştır.
• /red path'i üzerinden Node-RED editörü çalışır.
• /api path'i de Node-RED'in akışlarının httpNodeRoot olarak kullanılır.
• Örnek CRUD akışları (flows.json) proje içinde gösterilmiştir.

• index.html, login.html, register.html, tasks.html, categories.html, users.html gibi sayfalar yer alır.
• SurveyJS ile form oluşturma.
• DataTables ile veri listeleme/tablo düzeni.
• Socket.IO üzerinden anlık bildirimleri dinleme (görev oluşturma, görev güncelleme vb.).
• Tarayıcı tarafında localStorage içinde JWT token saklama ve her istek için Authorization header'a ekleme.

POST /api/auth/register

{
  "email": "[email protected]",
  "password": "secret",
  "role": "user" 
}

POST /api/auth/login

{
  "email": "[email protected]",
  "password": "secret"
}

Dönen cevaptaki token değeri, sonrasında tüm isteklerde Bearer Token olarak kullanılmalıdır:

Authorization: Bearer <token>

Not: POST /api/tasks isteği direkt veritabanına değil RabbitMQ kuyruğuna eklenir (taskGatewayController). Worker (todoService.js) kuyruğu tüketerek görevi veritabanına kaydeder ve Socket.IO üzerinden "taskCreated" bildirimi gönderir.

Not: POST /api/users isteği, RabbitMQ kuyruğuna eklenir (userGatewayController). Worker (userService.js) kuyruğu tüketerek kullanıcıyı veritabanına kaydeder ve Socket.IO üzerinden "userCreated" bildirimi gönderir.

• taskCreated: Worker'dan tetiklenir. Frontend bu olayı dinleyerek yeni oluşturulan görevi tabloya ekler.
• taskUpdated: Görev güncellendiğinde tetiklenir.
• taskDeleted: Görev silindiğinde tetiklenir.
• userCreated: Yeni kullanıcı oluşturulduğunda tetiklenir (admin yetkili kullanıcılar için).

• httpAdminRoot = /red
  • Tarayıcıdan http://localhost:4000/red adresine giderek Node-RED editörüne erişebilirsiniz.
• httpNodeRoot = /api
  • Node-RED akışları /api altında çalışır (Örnek: /node-red/categories gibi).
• Örnek akışlar flows.json içerisinde mevcuttur. Dilerseniz Node-RED editöründen import edebilirsiniz.