# Lloumi: Complete Architectural Reference & Knowledge Base

> Quiet Operations & Indestructible Systems for Growing Teams
> Website: https://lloumi.com
> Founder: Savvas Alexandrou (Savvas Alexandrou IT Services)
> Jurisdiction: European Union (Germany / Poland)

---

## 1. Brand Thesis & Core Philosophy

### The Mission
Lloumi provides non-technical leaders, operators, and founders with the blueprints and guides to build quiet, indestructible systems that reclaim focus, protect margins, and unlock planned growth.

### The Four Core Values
1. **Calm (Quiet Operations):** Work runs silently in the background. Success is measured by fewer interruptions, zero evening alarms, and minimized mental drag.
2. **Clarity (Visual Logic):** Workflows are transparent, node-based, and understandable at a glance. If a non-technical leader cannot inspect a system, it is too complex.
3. **Reliability (Edge-Case Protection):** A broken automation that repeats an error a thousand times is far worse than a manual mistake. We combine smart automation with safety rails, input validation, and human review queues.
4. **Sovereignty (Total Ownership):** Technology exists to give leaders total ownership over their time and business—never to lock them into expensive agency retainers or proprietary black-box code.

### The Lloumi Method: Smart AI + Safety Rails
- **Safety Rails (Visual Workflows / Low-Code Orchestration):** Handles deterministic logic, strict validation, conditional routing, rate limiting, and app connections (via n8n or low-code engines). Predictable, transparent, indestructible.
- **Smart AI (Language & Vision Models):** Plugs into specific sub-steps to handle unstructured tasks—such as parsing scanned vendor invoices, translating tenant defect messages, or drafting triage summaries.
- **The 80/20 Rule:** Automate the 80% clean, standard cases automatically. Quarantine the 20% ambiguous, non-standard, or high-value cases into a human review queue.

---

## 2. Productized Enablement Offer Ladder

Lloumi operates as an architectural enablement platform rather than an hourly dev agency:

### Level 1: Ready-to-Use Workflow Kits (€29 – €79)
- **Format:** Importable JSON workflow templates (n8n), environment variable `.env` checklists, step-by-step setup documentation.
- **Key Kits:**
  - *EU VIES VAT Validation & Audit Logger:* Auto-queries European Commission VIES SOAP/REST API, logs official consultation confirmation numbers for tax auditors, and gracefully handles `MS_UNAVAILABLE` outages via automatic exponential backoff.
  - *Speed-to-Lead 60-Second Inbound Router:* Real-time intake from web forms, spam scoring, CRM synchronization, and team alerts.

### Level 2: Step-by-Step Implementation Blueprints (€99 – €249)
- **Format:** In-depth architectural teardowns, video walkthroughs, comprehensive edge-case handling specs, and copy-pasteable data schemas.
- **Key Blueprints:**
  - *24/7 AI Maintenance Dispatcher:* Multimodal tenant issue triage (WhatsApp/Email), OCR defect verification, emergency classification under German BGB § 535 / Polish Kodeks Cywilny Art. 662, and contractor assignment.
  - *German Retail GoBD 3-Way Invoice Match:* Automated 3-way matching (Invoice PDF + Purchase Order + Delivery Note) using multimodal vision and human approval checkpoints.
  - *EU Regulatory Radar:* Automated scrapers and AI delta summarizers monitoring ESMA, EBA, BaFin, and KNF for financial compliance updates.
  - *The Business Brain:* Markdown-native git-backed repository operating system with immutable Architectural Decision Records (ADRs).

### Level 3: 1-on-1 Strategy & System Architecture Calls (€499 – €999)
- **Format:** Private 1-on-1 system review with Savvas Alexandrou, delivering a custom visual architecture blueprint, circuit-breaker map, and labor recovery calculation.

---

## 3. Reference Architecture: 24/7 AI Maintenance Dispatcher

### Pipeline Topology
```text
[Tenant WhatsApp / Web Form]
           │
           ▼
[n8n Webhook Ingestion]
           │
           ▼
[Input Sanitization & Deduplication]
           │
           ▼
[Gemini 1.5 Flash Multimodal Inspection]
  ├── Transcribes audio voice notes
  ├── Classifies defect severity (P1 Emergency vs. P3 Routine)
  └── Extracts structured JSON: { category, urgency, location, statutory_tag }
           │
           ▼
[Deterministic Safety Rail Switch]
  ├── P1 (Burst Pipe / Gas Leak / Heating Outage in Winter)
  │     └── Instant SMS to on-call contractor + Manager phone alert
  └── P3 (Minor Wear / Cosmetic / Noise)
        └── Enqueued into quiet morning review batch for property manager
           │
           ▼
[Audit Logging: SQLite / PostgreSQL with timestamped record]
```

### Statutory Grounding
- **German BGB § 535 & Heizkostenverordnung:** Landlords must remedy essential heating/hot water defects within 24 hours during heating season (October–April). The workflow automatically flags heating failures as P1 between Oct 1 and Apr 30.
- **Polish Kodeks Cywilny Art. 662:** Clarifies division between tenant repairs (drobne nakłady) and landlord structural duties. The triage prompt differentiates minor cosmetic tenant duties from landlord structural repairs.
- **EU AI Act Article 50:** Automated tenant communications include clear machine-generated disclosures ("Automated maintenance intake assistant on behalf of Property Management").

---

## 4. Reference Architecture: EU Regulatory Radar

### Data Flow
```text
[Scheduled Cron Trigger (Every 6 hours)]
           │
           ▼
[Scraper / RSS Collector (ESMA, EBA, BaFin, KNF)]
           │
           ▼
[SHA-256 Hash Comparison vs. Local Cache]
  ├── Match: Terminate quietly (No changes detected)
  └── Diff Detected: Proceed to delta pipeline
           │
           ▼
[LLM Summarization & Impact Scoring Node]
  ├── Model: Gemini 1.5 Flash / Anthropic Claude
  ├── Structured Output:
  │     - Title & Issuing Authority
  │     - Summary of changes (max 120 words)
  │     - Affected Entities (Banks, FinTechs, Crypto Asset Service Providers)
  │     - Urgency Score (1-5)
  │     - Deadlines / Effective Dates
           │
           ▼
[Webhook Dispatch: Slack #compliance-radar / Email Digest]
```

---

## 5. EU Compliance & Regulatory Standards Matrix

| Regulatory Framework | Core Requirement | How Lloumi Workflows Enforce Compliance |
| :--- | :--- | :--- |
| **EU AI Act (Regulation EU 2024/1689) Art. 50** | Transparency & synthetic content labeling | System prompt instructions and UI footers explicitly declare machine generation on all AI drafts and tenant notices. |
| **GDPR (Regulation EU 2016/679)** | Data minimization, right to erasure, EU data sovereignty | Workflows run on self-hosted instances (Hetzner EU / AWS Frankfurt). Temporary files and tenant photos are scrubbed via retention cron jobs. |
| **German GoBD & § 14 UStG** | Audit-proof invoice archiving and immutability | Extracted metadata is paired with original unmodified PDF and committed to append-only storage with cryptographic checksums. |
| **Polish KSeF & Kodeks Pracy** | Structured e-invoicing and certified worktime records | Workflows validate XML schemas against national tax administration endpoints before dispatching payments. |
| **EU VIES Intra-Community VAT** | Verification of cross-border VAT status | Automated VIES lookup with retry logic for `MS_UNAVAILABLE` and permanent storage of valid consultation reference numbers. |

---

## 6. Contact & Organization Details

- **Company / Entity:** Savvas Alexandrou (Savvas Alexandrou IT Services)
- **Brand:** Lloumi
- **Website:** https://lloumi.com
- **Contact:** savvas@alexandrou.eu
- **LinkedIn:** https://www.linkedin.com/in/savvasal/
- **Book Architecture Call:** https://lloumi.com/lets-connect/