add new Readme with new structure and .env sample

README.md

@@ -1,46 +1,48 @@
-# 🍪 Kuki SaaS - Cookie Consent Solution
-A lightweight, GDPR/CCPA compliant Cookie Consent banner widget, management dashboard, and backend API.
+# 🏗 AlpineSAAS — Infrastructure & Orchestration
+
+Core infrastructure layer for the AlpineConsent ecosystem. Manages container orchestration, reverse proxy, relational databases, in-memory caching, and self-hosted CI/CD runners.
 
 ---
 
-## 🚀 Features
+## 💤 Stack Overview
 
-- **⚡ Ultra-lightweight Client (`kuki.js`):** Vanilla JS under 10KB with Shadow DOM isolation.
-- **🛡️ Privacy & Compliance:** GDPR, CCPA, and ePrivacy directive ready.
-- **🐳 Dockerized Infrastructure:** One-command startup using PostgreSQL and Redis.
-- **⚡ Fast API:** High-performance backend for consent logging and license verification.
+| Service | Technology | Internal Port | Host Binding | Purpose |
+| :--- | :--- | :--- | :--- | :--- |
+| **Edge Gateway** | Caddy 2 | 80, 443 | 0.0.0.0:80, 443 | Auto TLS termination & Reverse Proxy |
+| **Git Server** | Gitea | 3000, 22 | 0.0.0.0:2222->22 | Git server & VCS API |
+| **CI/CD Runner** | Act Runner | - | Worker | Executes Actions workflows in Docker |
+| **Primary DB** | PostgreSQL 15 | 5432 | Internal only | Multi-tenant persistent relational store |
+| **Cache & Queue** | Redis 7 | 6379 | Internal only | Rate limiting & session store |
 
 ---
 
-## 🛠️ Project Structure
+## 🚨 Deployment & Operations
 
-```text
-kuki-saas/
-├── client/              # Lightweight embeddable JavaScript widget (kuki.js)
-├── backend/             # Node.js / Go API for consent & user settings
-├── docker-compose.yml   # Infrastructure setup (PostgreSQL, Redis)
-└── README.md            # Documentation
+### Prerequisites
+* Docker Engine 24+ & Docker Compose v2+
+* Open inbound TCP ports on host/firewall: 80, 443, 2222
+
+### 1. Setup Environment
+```bash
+cp .env.example .env
+nano .env
 ```
 
-
-## ⚙️ Quick Start (Development)
-
-1. Clone the repository
-```Bash
-git clone [https://github.com/YOUR_USERNAME/kuki-saas.git](https://github.com/YOUR_USERNAME/kuki-saas.git)
-cd kuki-saas
-```
-
-2. Start Services with Docker
-```Bash
+### 2. Launch Infrastructure
+```bash
 docker compose up -d
 ```
 
-3. Verify Containers
-```Bash
-docker ps
+### 3. Verify Health & Logs
+```bash
+docker compose ps
+logs: docker compose logs -f caddy
 ```
 
-## 📝 License
+---
 
-Proprietary - All rights reserved.
+## Security & Networking
+
+* **Internal Isolation:** PostgreSQL and Redis containers do *not* expose ports to the public host. They communicate exclusively over the isolated bridge network `alpine_net`.
+* **Database Auth:** Native password authentication enabled with dedicated health checks.
+* **TLS:** Handled automatically by Caddy at the edge.