Plings Documentation

/architecture/
├── README.md                           # Architecture overview and principles
├── system-overview.md                  # HIGH-PRIORITY: Multi-service ecosystem, Gateway layer
├── database_architecture.md            # Dual database design (PostgreSQL + Neo4j)
├── technology-stack-decisions.md       # Technology choices and rationale
├── solana-payment-architecture.md      # Blockchain payment integration
└── api-security-guidelines.md          # Security best practices

/core-systems/
├── README.md                           # Core systems overview
├── s-plings-io/                        # Gateway service documentation (transport-agnostic: QR/NFC/RFID)
│   ├── README.md                       # Gateway overview (4 functions)
│   ├── url-structure.md               # URL parameters and routing
│   ├── verification-strategy.md       # Cached public key verification
│   └── routing-logic.md               # Intelligent routing rules
├── plings_identifier.md               # HD wallet identifier system
├── spatial-relationships.md           # Object location tracking  
├── ownership-handling.md              # Ownership and transfer logic
└── class-system.md                     # Object classification system

/api/
├── README.md                          # API overview and integration guide
├── api-endpoints.md                   # GraphQL schema and endpoints
├── authentication.md                 # Authentication flows
├── data-models.md                    # Core data structures
└── integration-examples.md           # Code examples and patterns

/database/
├── README.md                          # Database overview (⚠️ READ SCHEMA-VERIFICATION.md FIRST!)
├── SCHEMA-VERIFICATION.md             # 🚨 CRITICAL: Verified production schema
├── neo4j-core-schema.md              # Graph database schema
├── supabase-core-schema.md           # PostgreSQL schema (wallet-first)
├── migration-strategy.md             # Database migration procedures
└── predicate-catalogue.md            # Relationship types catalog

/use-cases/
├── overview.md                        # Use case index
├── workflow-create-object.md          # Object creation workflows
├── workflow-scan-to-pay.md           # Commerce scanning flows
├── workflow-lost-and-found.md        # Lost object recovery
└── requirements-analysis.md          # Business requirements

/frontend/
├── README.md                          # Frontend architecture overview
├── component-architecture.md         # React component structure and patterns
├── state-management.md              # State management patterns
└── routing.md                        # Frontend routing system

/admin/
├── README.md                          # Admin docs index + Admin Pages → Components map
├── admin-dashboard.md                # Cross-org business operations (/admin)
├── developer-console.md              # Technical debugging tools (/dev)
├── super-admin-console.md            # System-wide administration (/super)
├── security-operations.md            # Security management
├── permission-model.md               # Core permission architecture
├── permission-model-detailed.md      # Detailed permission implementation
├── audit-log-system.md               # Activity tracking and compliance
└── class-management-console.md       # Object class / type management

/development/
├── README.md                          # Development setup overview
├── getting-started.md                # Quick start guide
├── api-integration.md               # Backend integration patterns
├── testing-strategy.md              # Testing approaches
└── deployment.md                    # Deployment procedures

/brand/
├── design-system.md                  # Design system guidelines
├── implementation-guide.md          # Implementation patterns
├── requirements.md                  # Brand requirements
└── fonts/Poppins/                   # Font assets
    └── [Poppins font files]

/security/
├── README.md                          # Security documentation overview
├── api-key-management.md             # API key handling and rotation
└── private-key-use-cases.md         # HD wallet private-key usage and trust

/deployment/
├── README.md                          # Deployment documentation overview
├── ci-cd.md                          # CI/CD pipeline (GitHub Actions / Vercel)
├── deployment-procedures.md         # Step-by-step deployment procedures
├── environment-config.md            # Environment variables and configuration
└── monitoring-logging.md            # Monitoring and logging setup

/workflows/
├── README.md                          # End-to-end operational workflows
├── batch-create-objects.md          # Bulk object creation
├── identifier-scan-flow.md          # Scan → resolve → route flow
├── process-unfinished-objects.md    # Handling incomplete objects
└── transfer-ownership.md            # Ownership transfer workflow

/specs/
└── YYYY-MM-DD-<feature>-design.md    # Dated design specs (e.g. password-management-design)

/troubleshooting/
├── README.md                          # Troubleshooting index
├── backend-import-errors.md         # Python import / module resolution issues
├── backend-troubleshooting.md       # General backend issues
├── database-troubleshooting.md      # PostgreSQL / Neo4j issues
├── drag-drop-troubleshooting.md     # Frontend drag-and-drop issues
└── spatial-predicates-migration.md  # Spatial predicate migration issues