Pre-release software (v0.26.0-alpha) - Under active development. Not yet recommended for production use.

Overview

PRAHO is a hosting provider management platform built for Romanian business compliance. It handles customer management, VAT-compliant invoicing, e-Factura integration, service provisioning, support tickets, and GDPR compliance - all in a single Django-based system.

Key Features

• Customer Management - Multi-user accounts with role-based access and soft deletes
• EU VAT Billing - All 27 EU country rates, Romanian 21% (Aug 2025), reverse charge for EU B2B, e-Factura XML
• Service Provisioning - Virtualmin integration with two-phase provisioning and rollback
• Support System - SLA-based ticket management with time tracking
• Domain Management - Multi-registrar support (.ro via ROTLD, international)
• Security - 2FA (TOTP), encrypted credentials, HMAC inter-service auth
• Compliance - GDPR with data export/erasure, immutable audit trails

Architecture

PRAHO uses a two-service architecture for security isolation:

services/
├── platform/   # Staff/admin service (:8700) - full database access
│   ├── apps/   # 17 Django apps with models, services, views
│   ├── config/ # Django settings (base, dev, prod, staging, test)
│   └── tests/  # Mirrors apps/ structure
│
└── portal/     # Customer-facing service (:8701) - SQLite sessions only
    ├── apps/   # 9 Django apps (API proxies, no business models)
    └── tests/  # Enforces no business DB access

• Platform owns all data (PostgreSQL) and business logic
• Portal uses SQLite for session storage only - NO business data access
• Portal is stateless - communicates with Platform via HMAC-signed requests
• No Redis required - uses Django's database cache

Architecture Diagrams: See docs/architecture/ for Mermaid diagrams showing system overview, data flow, and deployment topology.

Quick Start

Prerequisites

• Python 3.13+
• uv - Python package manager (used for workspace management)
• Git
• Node.js (optional, only if modifying CSS)

Installation

# 1. Clone the repository
git clone https://github.com/captainpragmatic/PRAHO.git
cd PRAHO

# 2. Install dependencies (installs uv workspace for both services)
make install

# 3. Configure environment
cp .env.example.dev .env
# Edit .env — generate the encryption keys noted in the file
# For production config, see .env.example

# 4. Set up database and load sample data
make migrate
make fixtures        # Full sample data (or: make fixtures-light for minimal)

# 5. Start development servers
make dev             # Both services: platform (:8700) + portal (:8701)

Visit:

• Platform: http://localhost:8700 (staff interface)
• Portal: http://localhost:8701 (customer API)

Test credentials: admin@pragmatichost.com / admin123

Using PostgreSQL instead of SQLite? Run make docker-dev to start Platform + Portal + PostgreSQL in Docker containers with hot reload.

Development Commands

All commands run from project root via Makefile:

# Development servers
make dev               # Start both services
make dev-platform      # Platform only (:8700)
make dev-portal        # Portal only (:8701)
make docker-dev        # Development with PostgreSQL (Docker)

# Testing
make test              # Run ALL tests (platform + portal + integration)
make test-platform     # Platform tests (Django test runner)
make test-portal       # Portal tests (no DB access enforced)
make test-integration  # Cross-service integration tests
make test-e2e          # Playwright E2E tests
make test-security     # Service isolation validation

# Code quality
make lint              # Ruff linting (all services)
make check-types       # MyPy type checking
make pre-commit        # Run all pre-commit hooks

# Database
make migrate           # Run platform migrations
make fixtures          # Load sample data

Configuration

Settings Structure

Each service has its own Django settings under config/settings/:

services/{platform,portal}/config/settings/
├── base.py       # Shared Django settings
├── dev.py        # Development (DEBUG=True, SQLite OK)
├── prod.py       # Production (security hardening, PostgreSQL)
├── staging.py    # Staging environment
└── test.py       # Test configuration

Environment Variables

Copy .env.example to .env and configure. Key variables:

# Core
DJANGO_SETTINGS_MODULE=config.settings.dev
SECRET_KEY=your-secret-key
DEBUG=True

# Database (PostgreSQL for production, SQLite for dev)
DATABASE_URL=postgresql://user:pass@localhost:5432/praho

# Security (required for 2FA and credential vault)
DJANGO_ENCRYPTION_KEY=your-fernet-key
CREDENTIAL_VAULT_MASTER_KEY=your-vault-key

# Romanian compliance
EFACTURA_API_URL=https://api.anaf.ro/prod/FCTEL/rest
EFACTURA_API_KEY=your-key
COMPANY_CUI=RO12345678

# Payments
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

See .env.example for the complete list with documentation.

Production Deployment

PRAHO supports three deployment methods. Choose based on your infrastructure:

All methods include automatic HTTPS (Caddy/Let's Encrypt), database backups, health checks, and rollback support.

Full guide: Deployment Guide — includes multi-server setups, Ansible automation, backup/restore, and troubleshooting.

Tech Stack

• Backend: Django 5.2, Python 3.13+
• Database: PostgreSQL 16+ (production), SQLite (development)
• Frontend: Tailwind CSS + HTMX + Alpine.js (zero-runtime JavaScript)
• Package Management: uv (workspace)
• Code Quality: Ruff (linting/formatting), MyPy (type checking)
• Testing: Django test runner + pytest, Playwright (E2E)
• Deployment: Native (systemd + Gunicorn), Docker, Ansible (in deploy/)

VAT & Romanian Compliance

PRAHO is built for Romanian hosting providers with full EU VAT support:

• All 27 EU VAT rates - Centralized TaxService with temporal validity (rate changes tracked by date)
• EU B2B reverse charge - 0% VAT for intra-EU business transactions with valid VAT number
• EU B2C destination rate - Automatic country-specific rate for consumer sales (e.g., DE 19%, HU 27%)
• Non-EU export - 0% VAT for customers outside the EU
• Romanian 21% VAT - Updated for Emergency Ordinance 156/2024 (Aug 2025), reduced rate consolidated to 11%
• e-Factura - Electronic invoicing via ANAF (Romanian tax authority)
• CUI/VAT validation - Romanian company identifier validation
• Sequential invoice numbering - Required by Romanian tax law
• GDPR compliance - Romanian Law 190/2018, data export/erasure, consent tracking
• Full i18n coverage - 100% Romanian + English translations across Platform (4,470 entries) and Portal (1,285 entries), with automated translation tooling (make translate-*), i18n linter, and YAML review workflow

Security

• Email-based auth (no usernames), Argon2 hashing
• Two-factor authentication (TOTP with encrypted secrets)
• Credential vault with Fernet encryption and rotation
• HMAC inter-service auth (SHA-256 signed requests)
• CSRF/XSS/CSP protection, rate limiting, audit logging
• Portal isolation - customer-facing service has zero database access

Documentation

• Architecture Guide - System design and patterns
• Architecture Diagrams - Mermaid diagrams (system, data flow, deployment)
• Deployment Guide - Production deployment scenarios
• Linting Guide - Code quality framework
• Changelog - Version history (SemVer)
• ADRs - Architecture decision records

Contributing

We welcome contributions! See CONTRIBUTING.md for details.

• License: GPL-3.0-or-later (inbound = outbound)
• DCO required: Sign off commits with git commit -s
• Quality gates: Pre-commit hooks enforce linting, type checking, and template validation

Versioning

This project follows Semantic Versioning. Current version: v0.26.0 (alpha).

• Pre-1.0: API and features may change between minor versions
• Each minor bump (0.Y.0) represents a new feature milestone
• See git tag -l 'v*' --sort=version:refname for all release tags
• Version tracked in pyproject.toml and annotated git tags

License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). See LICENSE.md.

Built for Romanian hosting providers | PRAHO - Automation that really works