From 0ff915eb968756277927d38ccec1421097819fe2 Mon Sep 17 00:00:00 2001 From: iN0mad Date: Sat, 3 Jan 2026 08:20:05 +0000 Subject: [PATCH] Add Architecture --- Architecture.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 Architecture.md diff --git a/Architecture.md b/Architecture.md new file mode 100644 index 0000000..b2d2515 --- /dev/null +++ b/Architecture.md @@ -0,0 +1,30 @@ +# 🏗️ Architecture Overview + +Наша інфраструктура базується на **Docker Compose** і використовує **Caddy** як Reverse Proxy для SSL/TLS. + +## 📦 Stack Components +* **Core**: Docker, Portainer, Watchtower (auto-updates). +* **Gateway**: Caddy (Server C). +* **DevOps**: Gitea (Code), n8n (Automation). +* **AI Memory**: Neo4j (Graph DB), Graphiti (Memory API), Redis (Cache). +* **Data**: Postgres (Relational DB), Metabase (Analytics). +* **Monitoring**: Dozzle (Logs), Adminer (DB Admin). + +## 🔌 Ports Configuration (Server Maps) + +| Service | Internal Port | Host Port | External Access | +| :--- | :--- | :--- | :--- | +| **Caddy** | 80/443 | 80/443 | 🌍 Global (HTTPS) | +| **Gitea** | 3000 | 3002 | 🌍 git.smagentsconsulting.uk | +| **n8n** | 5678 | N/A | 🌍 n8n.smagentsconsulting.uk | +| **Metabase**| 3000 | 3001 | 🛡️ SSH Tunnel / Localhost | +| **Neo4j** | 7474/7687 | 7474/7687 | 🛡️ Localhost Only | +| **Graphiti**| 8000 | 8000 | 🛡️ Localhost Only | +| **Adminer** | 8080 | 8080 | 🛡️ Localhost Only | +| **Dozzle** | 8080 | 8888 | 🛡️ Localhost Only | + +## 🧠 MCP Schema (Antigravity) +Antigravity агент підключається до системи через **MCP (Model Context Protocol)**: +1. **Postgres MCP**: Прямий доступ до бази даних Gitea для читання Issues/Milestones. +2. **Filesystem MCP**: Доступ до конфігурацій ([docker-compose.yml](cci:7://file:///home/serhii/stack/docker-compose.yml:0:0-0:0), [.env](cci:7://file:///home/serhii/stack/.env:0:0-0:0)). +3. **Brave/Browser MCP**: Доступ до веб-інтерфейсів (n8n, Neo4j Browser) для дебагу. \ No newline at end of file