Plings Documentation

Welcome to the Plings documentation. Plings is a Universal Object Graph System designed to track physical objects, their relationships, and spatial positions in the real world.

What is Plings?

Plings creates a global knowledge graph for physical objects, enabling identification, reuse, and enhanced lifecycle management. By attaching smart identifiers (QR codes, NFC tags) to objects, Plings helps organizations and individuals track, manage, and share physical items.

Documentation Structure

System Architecture

• System Overview
• Technology Stack
• Database Architecture
• Component Architecture

API Documentation

• API Endpoints
• Authentication
• Data Models
• Error Handling

Core Systems

• Object & Classification
  • Class System
  • Object Status System
  • Plings Identifier System
• Identity & Wallet Management
  • Wallet Management Architecture
  • Path Registry
  • Wallet Security Model
  • Key Compromise Procedures
• Relationship Systems
  • Spatial Relationships
  • Functional Relationships
  • Spatial Parent-Child Architecture
• Ownership & Organization
  • Ownership Handling
  • Organization Intelligence
• Advanced Features
  • Misplacement Detection
  • Set Object Scanning

Use Cases

• Overview
• Object Creation
• Inventory Management
• Tool Sharing

Frontend

• Overview
• Development Guidelines
• State Management
• Security

Database

• PostgreSQL Schema
• Neo4j Graph Schema
• Predicate Catalogue

Development

• Backend Guidelines
• Frontend Implementation
• Environment Variables

Admin

• Admin Console
• Class Management
• Permission Model

Getting Started

1. For Developers: Start with the System Overview and Development Guidelines
2. For API Integration: Check out the API Documentation
3. For Understanding Use Cases: Browse through Use Cases

Links

• Main Application
• GitHub Repository

---

Documentation last updated: 2025-07-29