Initial backend (#1)

* Update vite to address high severity vulnerability

* Add support for a backend server that optionally serves the frontend if it is already built

Author: hartmans

layout/carthage_plugin.py

@@ -1,14 +1,10 @@
-# Copyright (C) 2026, Hadron Industries.
-# Carthage is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License version 3
-# as published by the Free Software Foundation. It is distributed
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file
-# LICENSE for details.
 
 from carthage import inject, Injector
 from . import layout
+from .web_backend import start_web_server, web_server_key
 
 @inject(injector=Injector)
 def carthage_plugin(injector):
     injector.add_provider(layout.layout)
+    injector.add_provider(web_server_key, start_web_server)
+    

layout/carthage_plugin.yml

@@ -1,12 +1,6 @@
-# Copyright (C) 2026, Hadron Industries.
-# Carthage is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License version 3
-# as published by the Free Software Foundation. It is distributed
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file
-# LICENSE for details.
-
 name: viper-whs
+dependencies:
+  - deb: python3-fastapi
 config:
   authorized_keys: authorized_keys
   base_dir: /srv/viper-whs

layout/python/layout.py

@@ -1,11 +1,3 @@
-# Copyright (C) 2026, Hadron Industries.
-# Carthage is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License version 3
-# as published by the Free Software Foundation. It is distributed
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file
-# LICENSE for details.
-
 
 from carthage import *
 import carthage.libvirt
@@ -15,13 +7,17 @@
 from carthage.network import V4Config
 from carthage_base import *
 from .images import WhsBaseImage, whs_vm_image
+from .web_backend import web_server_key
 
 
 class layout(CarthageLayout):
     layout_name = 'viper-whs'
     domain = 'whs.local'
     from .images import WhsBaseImage, whs_vm_image
 
+    async def async_ready(self):
+        await self.ainjector.get_instance_async(web_server_key)
+        await super().async_ready()
     @provides('bridge_net')
     class net(NetworkModel):
         bridge_name = 'whs-lab'

layout/python/web_backend.py

@@ -0,0 +1,39 @@
+import asyncio
+import os
+from typing import Annotated
+import uvicorn
+from fastapi import FastAPI, APIRouter, Depends, Request
+from fastapi.staticfiles import StaticFiles
+from carthage import AsyncInjector, inject, InjectionKey, CarthagePlugin
+from carthage.modeling import CarthageLayout
+
+def get_ainjector(request:Request)->AsyncInjector:
+    return request.app.state.ainjector
+
+ainjector_dependency = Annotated[AsyncInjector, Depends(get_ainjector)]
+
+
+api_v1 = APIRouter(prefix="/api/v1")
+
+@api_v1.get("/devices")
+async def get_devices(ainjector:ainjector_dependency):
+    raise NotImplementedError
+
+@inject(
+    layout=InjectionKey(CarthageLayout, _ready=False),
+    plugin=InjectionKey(CarthagePlugin, name='viper-whs'))
+async def start_web_server(layout, plugin):
+    app = FastAPI()
+    app.state.ainjector = layout.ainjector
+    app.include_router(api_v1)
+    if (plugin.resource_dir/'../dist').exists():
+        breakpoint()
+        app.mount('/', StaticFiles(directory=plugin.resource_dir/'../dist', html=True), name='frontend')
+    config = uvicorn.Config(app,
+                             port=int(os.environ.get('PORT', 8080)),
+                             host='0.0.0.0',
+                            )
+    server = uvicorn.Server(config)
+    asyncio.get_event_loop().create_task(server.serve())
+
+web_server_key = InjectionKey('viper_whs.webserver')