updating the documentation of the SilverLinux Insftracture

docs/cicd.md

@@ -0,0 +1,247 @@
+# CI/CD
+
+## Overview
+
+The goal of SilverLinux is to become the central deployment platform for Silver Solutions applications.
+
+Source code is managed through Gitea and future deployments should be automated through CI/CD pipelines.
+
+---
+
+## Current Situation
+
+Application deployments are currently performed manually.
+
+Typical process:
+
+1. Developer commits code.
+2. Developer publishes application.
+3. Files are deployed manually.
+4. IIS application is restarted if necessary.
+
+Status:
+
+```text
+Manual
+```
+
+---
+
+## Future Goal
+
+Automate deployments from Gitea repositories to target servers.
+
+Examples:
+
+* Windows IIS servers
+* Application servers
+* Test environments
+* Future Linux deployments
+
+---
+
+## Planned Architecture
+
+```text
+Developer
+    ↓
+Git Commit
+    ↓
+Gitea
+    ↓
+Gitea Actions
+    ↓
+Build
+    ↓
+Test
+    ↓
+Deploy
+    ↓
+Target Server
+```
+
+---
+
+## Deployment Targets
+
+### Windows IIS
+
+Purpose:
+
+Deploy:
+
+* ASP.NET Core
+* Blazor Server
+* Blazor Web App
+
+Method:
+
+```text
+Publish
+→ Copy Files
+→ Restart IIS Site
+```
+
+Status:
+
+Planned
+
+---
+
+### Linux Containers
+
+Purpose:
+
+Future Docker deployments.
+
+Method:
+
+```text
+Build Docker Image
+→ Push Image
+→ Deploy Stack
+```
+
+Status:
+
+Future
+
+---
+
+## Planned Tooling
+
+### Gitea Actions
+
+Purpose:
+
+* Build automation
+* Testing
+* Deployment automation
+
+Status:
+
+Planned
+
+---
+
+### Self-Hosted Runner
+
+Purpose:
+
+Execute build pipelines.
+
+Potential Location:
+
+```text
+SilverLinux
+```
+
+Status:
+
+Planned
+
+---
+
+## Pipeline Stages
+
+### Build
+
+Examples:
+
+* Restore NuGet packages
+* Build solution
+* Publish application
+
+---
+
+### Test
+
+Examples:
+
+* Unit tests
+* Integration tests
+* Build validation
+
+---
+
+### Deploy
+
+Examples:
+
+* IIS deployment
+* Docker deployment
+* Environment updates
+
+---
+
+## Notifications
+
+Future CI/CD notifications should use:
+
+```text
+noreply@silveressence.net
+```
+
+Examples:
+
+* Build succeeded
+* Build failed
+* Deployment completed
+* Deployment failed
+
+---
+
+## Security
+
+Deployment credentials should never be stored in repositories.
+
+Store credentials in:
+
+```text
+/ srv/secrets/company.env
+```
+
+or platform-specific secret stores.
+
+---
+
+## Initial Target
+
+First automated deployment target:
+
+```text
+Gitea
+    →
+Windows Server IIS
+    →
+Blazor Applications
+```
+
+This provides the highest immediate value.
+
+---
+
+## Future Enhancements
+
+* Automatic testing
+* Automatic deployment
+* Release pipelines
+* Docker image registry
+* BaGet integration
+* Multi-environment deployments
+
+---
+
+## Related Services
+
+* Gitea
+* Portainer
+* Nginx Proxy Manager
+
+---
+
+## Related Documentation
+
+* gitea/README.md
+* docs/server.md
+* docs/security.md