GestAImmo Platform Documentation v2.4

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.

Next.js 15 & React 19 Express / Node.js Engine PostgreSQL 16 & Prisma (45+ Tables) AI Engine (Claude 3.7 & Gemini 2.0) 72 Modular Features

Interactive System Visualizations

Built with Archify. Fully interactive standalone SVG applications with real-time zooming, layer filtering, relationship probing, and light/dark styling.

Technical Documentation Library

Click any card to read directly in the built-in viewer, or open raw in GitHub.

Feature Catalog (72 Features)

Complete 3-level top-down catalog mapping Modules → Sub-modules → 72 Features with 160 bidirectional links and status verification.

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.

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.