feat(): push notifications via firebase admin

src/template_project/web_api/configuration.py

@@ -50,12 +50,18 @@ class YandexOAuthConfiguration:
     client_secret: SecretString
 
 
+@to_configuration
+class FirebaseConfiguration:
+    certificate_path: str
+
+
 @to_configuration
 class Configuration:
     server: ServerConfiguration
     database: DatabaseConfiguration
     access_token: AccessTokenConfiguration
     yandex_oauth: YandexOAuthConfiguration
+    firebase: FirebaseConfiguration
 
 
 retort = Retort(

src/template_project/web_api/entry_point.py

@@ -8,15 +8,17 @@ from contextlib import asynccontextmanager
 from pathlib import Path
 from typing import Final
 
+import firebase_admin  # type: ignore[import-untyped]
 import uvicorn
 from dishka import AsyncContainer
 from dishka.integrations.fastapi import setup_dishka
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
+from firebase_admin import credentials
 
-from template_project.web_api.configuration import load_configuration
+from template_project.web_api.configuration import Configuration, load_configuration
 from template_project.web_api.ioc.make import make_ioc
-from template_project.web_api.routes import auth, healthcheck, profile
+from template_project.web_api.routes import auth, healthcheck, notification, profile
 
 LOG_CONFIG: Final = {
     "version": 1,
@@ -41,6 +43,9 @@ LOG_CONFIG: Final = {
 
 @asynccontextmanager
 async def lifespan(app: FastAPI) -> AsyncIterator[None]:
+    configuration: Configuration = app.state.dishka_container.context[Configuration]
+    cred = credentials.Certificate(configuration.firebase.certificate_path)
+    firebase_admin.initialize_app(cred)
     yield
     await app.state.dishka_container.close()
 
@@ -66,6 +71,7 @@ def make_asgi_application(
     app.include_router(auth.router)
     app.include_router(healthcheck.router)
     app.include_router(profile.router)
+    app.include_router(notification.router)
 
     setup_dishka(container=ioc, app=app)
 

src/template_project/web_api/ioc/data_gateway.py

@@ -2,6 +2,7 @@ from dishka import BaseScope, Provider, Scope, WithParents, provide, provide_all
 
 from template_project.adapters.data_gateways.access_token import DefaultAccessTokenDataGateway
 from template_project.adapters.data_gateways.auth_identity import DefaultAuthIdentityDataGateway
+from template_project.adapters.data_gateways.notification_device import DefaultNotificationDeviceDataGateway
 from template_project.adapters.data_gateways.profile import DefaultProfileDataGateway
 from template_project.adapters.data_gateways.user import DefaultUserDataGateway
 from template_project.adapters.unit_of_work import DefaultUnitOfWork
@@ -16,4 +17,5 @@ class DataGatewayProvider(Provider):
         WithParents[DefaultAccessTokenDataGateway],
         WithParents[DefaultAuthIdentityDataGateway],
         WithParents[DefaultProfileDataGateway],
+        WithParents[DefaultNotificationDeviceDataGateway],
     )

src/template_project/web_api/ioc/interactor.py

@@ -2,6 +2,7 @@ from dishka import BaseScope, Provider, Scope, provide_all
 
 from template_project.application.auth_identity.interactors.sign_in import SignInInteractor
 from template_project.application.auth_identity.interactors.sign_up import SignUpInteractor
+from template_project.application.user.notification.interactors.send_notification import NotificationInteractor
 from template_project.application.user.profile.interactors.get_profile import GetProfileInteractor
 from template_project.application.user.profile.interactors.patch_profile import PatchProfileInteractor
 
@@ -14,4 +15,5 @@ class InteractorProvider(Provider):
         SignUpInteractor,
         GetProfileInteractor,
         PatchProfileInteractor,
+        NotificationInteractor,
     )

src/template_project/web_api/ioc/make.py

@@ -5,6 +5,7 @@ from template_project.web_api.configuration import (
     AccessTokenConfiguration,
     Configuration,
     DatabaseConfiguration,
+    FirebaseConfiguration,
     ServerConfiguration,
     YandexOAuthConfiguration,
 )
@@ -14,6 +15,7 @@ from template_project.web_api.ioc.data_gateway import DataGatewayProvider
 from template_project.web_api.ioc.factory import FactoryProvider
 from template_project.web_api.ioc.idp import IdPProvider
 from template_project.web_api.ioc.interactor import InteractorProvider
+from template_project.web_api.ioc.notifications import NotificationServiceProvider
 from template_project.web_api.ioc.oauth import OAuthClientProvider
 
 
@@ -27,11 +29,14 @@ def make_ioc(configuration: Configuration) -> AsyncContainer:
         DataGatewayProvider(),
         CryptographerProvider(),
         OAuthClientProvider(),
+        NotificationServiceProvider(),
         validation_settings=STRICT_VALIDATION,
         context={
             ServerConfiguration: configuration.server,
             DatabaseConfiguration: configuration.database,
             AccessTokenConfiguration: configuration.access_token,
             YandexOAuthConfiguration: configuration.yandex_oauth,
+            FirebaseConfiguration: configuration.firebase,
+            Configuration: configuration,
         },
     )

src/template_project/web_api/ioc/notifications.py

@@ -0,0 +1,12 @@
+from dishka import BaseScope, Provider, Scope, provide
+
+from template_project.adapters.notifications.fcm import FCMNotificationService
+from template_project.application.common.notifications.service import NotificationService
+
+
+class NotificationServiceProvider(Provider):
+    scope: BaseScope | None = Scope.APP
+
+    @provide
+    def notification_service(self) -> NotificationService:
+        return FCMNotificationService()

src/template_project/web_api/routes/notification.py

@@ -0,0 +1,31 @@
+from dishka import FromDishka
+from dishka.integrations.fastapi import DishkaRoute
+from fastapi import APIRouter, Depends, HTTPException, status
+from fastapi.security import HTTPBearer
+from pydantic import BaseModel
+
+from template_project.application.user.notification.interactors.send_notification import (
+    NotificationInteractor,
+    SendNotificationRequest,
+)
+from template_project.application.user.notification_device.errors import NotificationDeviceNotFoundError
+
+security = HTTPBearer()
+router = APIRouter(route_class=DishkaRoute, tags=["Notifications"], dependencies=[Depends(security)])
+
+
+class SendNotificationRequestModel(BaseModel):
+    title: str
+    body: str
+
+
+@router.post("/notifications/send")
+async def send_notification(
+    request: SendNotificationRequestModel,
+    interactor: FromDishka[NotificationInteractor],
+) -> None:
+    try:
+        notification_request = SendNotificationRequest(title=request.title, body=request.body)
+        await interactor.send_notification(notification_request)
+    except NotificationDeviceNotFoundError as error:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Notification device not found") from error