High-level system architecture

Fishermen German COI app high level sys architecture.png

Client Layer:
- Web Application: A user interface for all system functionalities.
Load Balancer:
- Load Balancer: Distributes incoming traffic across multiple web servers to ensure high availability and optimal performance.
API Gateway:
- Routes requests to appropriate microservices
- Handles authentication and authorization
Microservices:
- Service: Manages PKO-related operations.
- Notification Service: Handles notifications.
- User Service: Manages user-related data and preferences.
- AI Service: Integrates AI capabilities for PKO suggestions and analysis.
The microservices architecture will allow us to easily modify or scale specific parts of the app without affecting the entire application.
Data Layer:
- Separate databases for each microservices to ensure data isolation
Integration Layer:
- Message Queue: Async communication between services using Kafka or RabbitMQ
- Email Service: Handles email notifications
Active Directory:
- Integrated for user authentication

Recommended Tech-Stack

Category	Technology	Reason
Frontend	Javascript + React/Next.Js	Component-based architecture, huge ecosystem and community support, easy to scale, and suitable for large and complex systems.
Backend	Node + Express	Javascript around ecosystem, large package ecosystem
Database	PostgreSQL	Supports complex queries and very robust
ORM	Prisma	Type-safe database access, supports migrations
Microservices	Docker + Kubernetes	Containerization and orchestration for scalable microservices architecture
Maps	Leaflet.js + OpenStreetMap	As recommended in the PRD
LLM Integration	OpenAI + Other LLM API	SOTA models for AI capabilities
Websockets	Socket.io	Real-time, bidirectional communication between web clients and servers

The system will use a REST API to communicate between FE and BE: