Pactown MVP: Executable Markdown SaaS - Status Projektu Luty 2026

Pactown MVP v0.1.8 — platforma SaaS z edytorem Markdown, LLM, desktop/mobile builds, i18n, programem poleceń i polskimi płatnościami. Status: Beta

2026-02-10 • Softreck

Pactown MVP: Executable Markdown SaaS Platform

Status: ⚠️ Beta (v0.1.8)
Deploy URL: [app]{sep}[username].DOMAIN (domyślnie sep = -)
Target Market: Polski SMB + Global
Infrastructure: Podman Quadlet (rootless containers)

Co to jest Pactown MVP?

Platforma SaaS umożliwiająca użytkownikom tworzenie i uruchamianie aplikacji poprzez edytor Markdown z integracją LLM (OpenRouter) i polskimi płatnościami (Stripe + BLIK).

Dlaczego Podman Quadlet zamiast Docker Swarm?

CechaDocker SwarmPodman Quadlet
Daemonless❌ Wymaga dockerd✅ Bez demona
Rootless⚠️ Eksperymentalny✅ Natywny
Systemd integration❌ Osobne zarządzanie✅ Natywne
Security isolation⚠️ Shared daemon✅ Per-user namespaces
Memory footprint~100MB daemon~0MB (on-demand)
Multi-tenant⚠️ Labels✅ User namespaces

Stack Technologiczny

WarstwaTechnologia
FrontendNext.js 14, TipTap Editor, Tailwind CSS
BackendFastAPI, SQLAlchemy, PostgreSQL
AuthOAuth2 (Google, GitHub), Auth0, Clerk
PaymentsStripe Connect + P24 (BLIK)
LLMOpenRouter (darmowe modele)
InfrastructurePodman Quadlet, Traefik, Hetzner VPS
Orchestrationpactown CLI v0.1.141
i18nnext-intl (PL, EN, DE, FR, ES, UK, RU)
BuildsElectron, Tauri, Capacitor, Kivy + 6 innych

Architektura

┌─────────────────────────────────────────────────────────────────┐
│                    pactown.com (Traefik Quadlet)                │
├─────────────────────────────────────────────────────────────────┤
│  *.pactown.com → Wildcard SSL (Let's Encrypt)                   │
│                                                                 │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────┐     │
│  │   Web    │  │   API    │  │  Editor  │  │ User Apps    │     │
│  │ :3000    │  │  :8000   │  │  :3001   │  │ :10000-20000 │     │
│  └──────────┘  └──────────┘  └──────────┘  └──────────────┘     │
│       │              │             │              │              │
│  [Quadlet]      [Quadlet]     [Quadlet]       [Quadlet]         │
│       ▼              ▼             ▼              ▼              │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │       systemd user services (rootless containers)        │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

Integracja z Pactown CLI

Projekt wykorzystuje wewnętrzny moduł pactown.deploy.quadlet:

# Inicjalizacja Traefik
pactown quadlet init --domain pactown.com --email admin@pactown.com


# Interaktywna powłoka
pactown quadlet shell --tenant default --domain pactown.com


# Deploy serwisu użytkownika
pactown quadlet deploy ./readme.md \
  --domain pactown.com \
  --subdomain api.jan \
  --tenant jan \
  --tls


# Lista serwisów
pactown quadlet list --tenant jan

Security Features

Moduł pactown.deploy.quadlet zawiera zaawansowane zabezpieczenia:

  • sanitize_name - ochrona przed injection w nazwach kontenerów
  • sanitize_env_value - escape wartości zmiennych środowiskowych
  • sanitize_domain - walidacja domen dla Traefik
  • validate_volume - blokowanie niebezpiecznych mount paths
  • check_dangerous_content - wykrywanie niebezpiecznych wzorców

24 testy bezpieczeństwa w tests/test_quadlet_security.py.

Status Funkcjonalności MVP

Authentication

  • Google OAuth2
  • GitHub OAuth2
  • Auth0 (OIDC broker)
  • Clerk (opcjonalny)
  • Facebook OAuth2

Markdown Editor (TipTap)

  • WYSIWYG editing
  • Code blocks z syntax highlighting
  • markpact:* codeblocks
  • Live preview

LLM Integration (OpenRouter)

  • Generowanie projektów z opisu
  • Auto-fix błędów runtime
  • Chat z kontekstem projektu
  • Darmowe modele (nemotron)
  • Wybór modelu LLM

Płatności

  • Stripe (karty)
  • BLIK via Przelewy24
  • Tpay native

User Services (Quadlet)

  • Dynamiczne tworzenie subdomen
  • Konfigurowalny separator subdomen (. lub -)
  • Rootless container isolation
  • Systemd health checks
  • Custom domains

Desktop & Mobile Builds

  • Electron (AppImage, exe, dmg)
  • Tauri
  • PyInstaller / PyQt
  • Capacitor (Android/iOS)
  • React Native / Flutter / Kivy
  • Build artifacts z retencją (max 3 per scope)
  • Download artefaktów z UI

Marketplace / Examples

  • DB-backed examples (seed z marketplace.ts)
  • Publiczne API: GET /public/examples
  • Build z przykładu (POST /public/examples/{slug}/build)
  • Download counter
  • Kategorie i tagi

Internationalization (i18n)

  • 7 języków: PL, EN, DE, FR, ES, UK, RU
  • Automatyczne wykrywanie locale
  • Przełącznik języka w UI

Program Poleceń (Referrals)

  • Unikalne linki polecające
  • Śledzenie rejestracji i aktywności
  • Punkty za polecenia
  • Wypłata od 100 PLN

Diagnostyka

  • Synchronizacja stanu UI z URL
  • Ślad działań użytkownika (trace)
  • Modal "Zgłoś problem" ze screenshotem
  • SSE real-time runner status

Model Cenowy

Free Tier

  • 2 równoległe demo
  • Publiczne URL + SSL
  • Subdomeny *.pactown.com
  • Darmowe modele LLM

Pro Tier (39 PLN/msc)

  • 10 równoległych demo
  • Większe zasoby i limity
  • Priorytetowe uruchamianie
  • Płatność BLIK/P24
  • Priorytetowe wsparcie

Quick Start

# Sklonuj repo
git clone https://github.com/wronai/pactown-com.git
cd pactown-com


# Konfiguracja
make config


# Instalacja Podman + pactown
make install


# Inicjalizacja Quadlet (Traefik)
make quadlet-init


# Uruchom
make up


# Status
make status

Roadmap

Styczeń 2026

  • Migration to Podman Quadlet
  • Integration with pactown CLI
  • Desktop/Mobile builds
  • i18n (7 języków)
  • Program poleceń
  • DB-backed examples/marketplace

Luty 2026

  • Configuration management system
  • Deep code analysis engine
  • Tpay native integration
  • Beta launch

Q2 2026

  • Custom domains
  • Team workspaces
  • Terraform support

Linki

Ostatnia aktualizacja: 10 lutego 2026