> For the complete documentation index, see [llms.txt](https://easyauth.papelship.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easyauth.papelship.com/documentation/overview/project-structure.md).

# Project Structure

This page illustrates the internal directory structure and recommended project layout for software utilizing EasyAuth Core SDK.

## Recommended Project Directory Structure

```
MyProtectedApp/
├── include/                          # Header files
│   ├── qPapelEasyAuth.h             # Core EasyAuth API Header
│   ├── PluginManager.h              # Plugin Extensibility Interface
│   ├── obfuscate.h                  # Compile-Time String Encryption
│   ├── VMProtectSDK.h               # (Optional) VMProtect SDK Integration
│   ├── qPapelEasyAuthqPAnalyzer.h   # (Optional) AI Anti-Cheat Plugin Header
│   └── qPapelEasyAuthBinaryTrace.h  # (Optional) BinaryTrace Plugin Header
│
├── lib/
│   └── x64/
│       └── Release/                 # Static Libraries (.lib)
│           ├── qPapelEasyAuth.lib   # EasyAuth Core Library
│           ├── libsodium.lib        # Cryptography Engine
│           ├── qPapelEasyAuthqPAnalyzer.lib   # (Optional Plugin Lib)
│           └── qPapelEasyAuthBinaryTrace.lib  # (Optional Plugin Lib)
│
├── src/
│   └── main.cpp                     # Application Entrypoint
│
├── MyProtectedApp.vcxproj           # Visual Studio Project File
└── MyProtectedApp.sln               # Visual Studio Solution File
```

## Architectural Flow

The diagram below outlines how the client SDK interacts with the security layers and remote cluster:

```
[ Your Application (main.cpp) ]
       │
       ▼
[ EasyAuth Client Engine ] ──► [ Function Remapping & Stealth Honeypots ]
       │                   ──► [ Anti-Debug & Injection Monitors ]
       │                   ──► [ Plugin Engine (qPAnalyzer AI, BinaryTrace) ]
       ▼
[ Encrypted 7-Layer Crypto Pipeline (ChaCha20-Poly1305 + Argon2) ]
       │
       ▼
[ EasyAuth Cloud Cluster (TCP:7710 / 8888) ]
       │
       ├──► [ License & HWID Validation ]
       ├──► [ Dynamic Variables & File Streaming (up to 150 MB) ]
       ├──► [ Server-Assisted Manual Mapping ]
       └──► [ Multimodal AI Threat Analysis (Gemini 2.5 Flash Lite) ]
```

## Distribution Packages

When distributing your source or software to team members, only the `include/` headers and `lib/` static binaries need to be distributed. No external runtime DLLs are required by clients.