# PlusFacility.cz

> Mobilně orientovaná SaaS platforma pro rychlé hlášení závad přes QR kódy a koordinaci údržby pronajímaných nemovitostí.

PlusFacility propojuje čtyři klíčové role nemovitostního provozu (nájemník, pronajímatel, dispečer a servisní technik) do jednoho integrovaného workflow bez nutnosti instalace aplikace pro koncového uživatele.

## Klíčové funkce a schopnosti

- **Hlášení přes QR kód jednotky (`/qr/[token]`):** Anonymní nebo ověřené hlášení závad ve 3 krocích s ochranou proti spamu (honeypot, rate limiting).
- **Sledování incidentu (`/sledovat/[token]`):** Transparentní časová osa, potvrzování termínů návštěv technika a hodnocení vyřešení závady přes SHA-256 hashovaný magic link.
- **Dispečink a triage (`/dispecink`):** Prioritizace hlášení, položková kalkulace cenových nabídek, výběr a přiřazování řemeslníků.
- **Portál pronajímatele (`/pronajimatel`):** Správa nemovitostí a jednotek, schvalování/odmítání cenových nabídek, kontrola rozpočtu a CSV export nákladů.
- **Mobilní rozhraní technika (`/technik`):** Zakázky optimalizované pro ovládání jednou rukou, návrh termínů, evidence práce a spotřebovaného materiálu v CZK.

## Dokumentace a strojová rozhraní pro AI agenty

- [OpenAPI 3.1 Specifikace](/openapi.json): Kompletní strojový popis všech REST API endpointů
- [Auth.md Registrace & Autentizace](/auth.md): Návod pro autentizaci, identity assertion a demo přístupy
- [MCP Server Card](/.well-known/mcp/server-card.json): Model Context Protocol manifest pro přímé volání nástrojů
- [A2A Agent Card](/.well-known/agent-card.json): Agent-to-Agent discovery manifest (A2A protokol)
- [Agent Skills Index](/.well-known/agent-skills/index.json): Přehled dovedností a instrukcí pro autonomní agenty
- [API Catalog (RFC 9727)](/.well-known/api-catalog): Standardní katalog odkazů a relačních metadat
- [Rozšířená LLM dokumentace](/llms-full.txt): Detailní popis datových entit, životního cyklu incidentu a JSON schémat