Next-Generation Real Estate Platform
Architecture & Documentation
Comprehensive architectural topology, interactive data flow state machines, modular feature catalog, and production deployment specifications for the GestAImmo property management platform.
Interactive System Visualizations
Built with Archify. Fully interactive standalone SVG applications with real-time zooming, layer filtering, relationship probing, and light/dark styling.
Live Interactive SVG
System Architecture Topology
Explore the entire software architecture: Web Clients (Admin, Owner, Supplier), API Gateway, Authentication & RBAC, AI Orchestration, Asynchronous Workers, Document OCR Engine, and PostgreSQL relational clusters.
Data Flow Pipeline
Bank Reconciliation Data Flow
End-to-end dataflow pipeline depicting raw statement ingestion, parsing, duplicate hashing, AI-driven transaction categorization, invoice matching confidence scoring, manual dispute workflow, and double-entry ledger settlement.
Process & REST Flows
Core Processes & REST API Flows
End-to-end operational pipelines across 5 stages (Trigger Portals → REST API Endpoints → Process Engines → Durable Ledgers → Settlement & Audit) covering Bank Reconciliation, Invoice Split Allocation, Maintenance Contractor Triage, and Document OCR with AI Tool Dispatching.
Accounting Lifecycle
Financial Accounting & Split
Multi-stage dataflow covering annual Preventivo budget baseline modeling, 2-level lossless invoice allocation across exercises, millesimal shares distribution, Consuntivo matrix rendering, and closed exercise freeze guards.
Procurement Pipeline
Maintenance Triage & Bidding
End-to-end incident lifecycle from tenant mobile filing to administrative triage, cryptographically tokenized magic-link public supplier tender packages, side-by-side bid comparison, and atomic contract award.
Document Intelligence
Document OCR & FTS5 Search
Multi-engine document processing pipeline ingesting deeds, invoices, and contracts, extracting text asynchronously with PDF/Word parsers, indexing into SQLite FTS5 virtual tables, and streaming to AI chatbot tools.
Messaging & AI
Communications & AI Drafting
Multi-tier resident notification highway combining condominium/building scope filters, context-aware Italian notice draft generation via Claude 3.5 / Ollama LLMs, and per-user read receipt audit logs for assemblies.
Governance & Identity
Onboarding & Property Setup
Administrator initialization journey featuring multi-tenant OAuth/Bcrypt authentication, automated user-to-person normalization, hierarchical condominium tree construction, cadastral validation, and millesimi sum-to-1000 mathematical closure.
Smart Invoice AI Parsing
Zero-token SDI electronic invoice extraction, Gemini multimodal vision fallback for scanned receipts, fuzzy condominium taxonomy classification, and real-time Split & Allocate Wizard integration.
Resident Telegram Gateway
Resident conversational self-service for personal condominium dues, instant ticket reporting with attachments, HMAC webhook security, and scheduled automated reminder broadcasts via n8n.
3D Spatial Digital Twin
Interactive 60fps digital twin turntable viewer, camera orientation reset, native mobile Augmented Reality (AR QuickLook), multi-photo photogrammetry tracking, and authenticated GLB streaming.
Technical Documentation Library
Click any card to read directly in the built-in viewer, or open raw in GitHub.
Option A: Smart Invoice AI Parsing
Zero-token FatturaPA XML parsing engine, Gemini 1.5 Flash multimodal receipt fallback, and fuzzy condominium accounting taxonomy classification.
Option B: Resident Telegram Gateway
Bi-directional resident Telegram bot gateway, OTP chat binding, dues query, maintenance photo ticket creation, and n8n automated reminder broadcast.
Option C: 3D Spatial Digital Twin
Interactive WebGL turntable viewer, orientation reset, mobile WebXR Augmented Reality (AR QuickLook), and photogrammetry lifecycle management.
Test Suite & Quality Report
354 passing tests (99.7% success rate) across 10 functional modules and 45 test suites. Interactive verification matrix with pass status highlights and execution times.
Maestro E2E Automation Report
End-to-End browser UI flows executed via Maestro Web on desktop Chromium. Tests complete user lifecycles: Admin login, UI localization (EN/IT), recovery navigation, security alerts, and registration validation.
Feature Catalog (72 Features)
Complete 3-level top-down catalog mapping Modules → Sub-modules → 72 Features with 160 bidirectional links and status verification.
Operational Processes & Workflows
Complete inventory of implemented multi-step processes: Bank Reconciliation, Invoice 2-Level Split Allocation, Consuntivo Matrix & Closure, Maintenance Triage & Tender, OCR & AI Tool-Calling, and Identity Normalization.
Database Schema & Dictionary
Comprehensive relational dictionary with 45+ tables, Prisma schemas, indexes, foreign keys, and migration history (00007-00024).
Developer Guide (EN)
Local setup, prerequisites, Docker container initialization, migrations, test suites, architecture patterns, and contribution guide.
Guida Sviluppatori (IT)
Guida completa in italiano per l'avvio, l'ambiente Docker, configurazione database, API Express e convenzioni di codice.
Self-Host Runbook
Production self-hosting setup using Docker Compose, reverse proxy (Caddy / Nginx TLS), persistent volumes, automated backups, and health checks.
GCP Cloud Run Serverless
Deploying containerized GestAImmo workloads onto Google Cloud Run, Cloud SQL PostgreSQL connection, Secret Manager, and VPC connector.
Environments & Cloud DNS
Complete topology of DEV (name-marmac-gestimmo-dev) and PROD (gestimmo-prod), Google Cloud DNS zone (gestimmo.cc), CNAME mappings, and GitHub Actions CI/CD.
GitOps Branching & Deploy
Correlation between Git branches (features/*, develop, main) and environments, dual-layer guardrails, ephemeral preview environments, and promotion workflows.
Project Inception & Pattern
Standardized blueprint & master TODO checklist for incepting and leading modern cloud projects: dual-GCP topology, GitOps guardrails, in-memory test isolation, living architecture, and maintenance.
Platform Changelog & Notes
Official release notes and feature changelog across environments. Clickable corner ribbon on all docs pages directly inspects current version features.
REST API Reference
Complete specification of all REST endpoints: Condos, Units, Financial Managements, Invoices, Messages, Maintenance Bids, and AI tools.
Role-Based Access Control
Tenant permission boundaries, Admin/Owner/Renter matrix, condominium-scoped middleware, JWT token claims, and access control audit trails.
AI Chatbot & Function Calling
Model orchestration (Claude 3.7 / Gemini 2.0 / Ollama), tool definitions for financial queries, document search, and natural language property management.
Maintenance & Bidding Workflow
Full lifecycle for maintenance requests, inspection dispatching, supplier quote invitations, bid award rules, and completion signoff.
Architecture Overview
High-level architectural patterns, domain layers, synchronous vs asynchronous communication, and external service integrations.
Development Sessions Index
Complete historical audit trail of daily AI development prompts, feature decisions, schema migrations, and codebase changes across all 44 sessions.
GestAImmo — Development Gantt Chart
Interactive timeline tracking 220+ platform features (207 plotted) across all 44 engineering sessions with Day, Week, and Month views.