Architecture Documentation
This folder contains the architectural documentation published to * ddon-research.github.io/ddon-extractor* via Docusaurus.
Documents
| # | Document | Summary |
|---|---|---|
| 1 | Architecture Overview | Module structure, dependency graph, build system, quantitative breakdown. |
| 2 | Core Concepts | Key classes and interfaces: Resource, FileHeader, BufferReader, deserializers, serializers, error types, custom data types. |
| 3 | Deserialization Flow | End-to-end sequence from CLI invocation to JSON output, including header identification and metadata enrichment. |
| 4 | Season Handling | How the project's layered architecture manages file format changes across DDON's three game seasons. |
| 5 | Extension Mapping | Comprehensive mapping of file extensions to ClientResourceFileExtension enum values, DTI.txt, and FrameworkResourcesUtil. |
| 6 | CLI & Packet System | Command-line interface structure (picocli), packet deserialization (experimental, Season 3 only), utility classes. |
| 7 | Serialization | Text serialization (JSON/YAML via Jackson), proof-of-concept binary round-trip serializers, MetaInformation annotation. |
| 8 | Crypto & Archives | Encrypted and reference archive handling, Blowfish decryption, zlib decompression, JamCRC hashing. |
| 9 | Testing | Test module structure, round-trip serialization tests, archive tests, JMH benchmarks. |
Conventions
- Diagrams use Mermaid syntax.
- Front matter follows the Docusaurus docs convention.
- Source references point to package/class names rather than line numbers to remain stable across refactors.