Skip to content
Orinuno

Project Structure

Orinuno is a multi-module Maven reactor. Five modules live side-by-side:

  • orinuno-app/ — the Spring Boot service: controllers, MyBatis, Liquibase, the demo UI, REST/HTTP surface, Kodik client.
  • kodik-sdk-drift/ — domain-neutral schema-drift detector. Spring-free, reusable elsewhere. See docs/adr/0001-kodik-sdk-extraction.md.
  • jutsu-sdk/ — standalone JutSu client (DLE auth, sticky cookies, 1 RPS rate-limit, premium decode). See docs/adr/0012-jutsu-sdk-extraction.md.
  • sibnet-sdk/ — standalone Sibnet decoder (shell.php + player.src(...) regex). Stateless. See docs/adr/0013-sibnet-and-aniboom-sdk-extraction.md.
  • aniboom-sdk/ — standalone Aniboom decoder (<input id="video-data"> + Jackson). Stateless.

The provider SDKs (jutsu-sdk, sibnet-sdk, aniboom-sdk) are designed for direct consumption by external projects — they do not pull in MySQL, Liquibase, MyBatis, or any orinuno-specific type. orinuno-app wires them in through thin *SdkConfiguration beans (JutsuSdkConfiguration, SibnetSdkConfiguration, AniboomSdkConfiguration); since the SDK-split Step 4 (c09f283) the controllers (SourcesController, ProvidersController) inject the SDK facades (JutsuClient, SibnetClient, AniboomClient) directly — no adapter *DecoderService shims.

.
├── pom.xml                            # reactor parent (packaging=pom)
├── kodik-sdk-drift/
│   ├── pom.xml                        # jackson-annotations + lombok + slf4j
│   └── src/{main,test}/java/com/kodik/sdk/drift/
├── jutsu-sdk/
│   ├── pom.xml                        # spring-webflux + reactor-netty + bucket4j
│   └── src/{main,test}/java/com/orinuno/jutsu/
├── sibnet-sdk/
│   ├── pom.xml                        # spring-webflux + reactor-netty
│   └── src/{main,test}/java/com/orinuno/sibnet/
├── aniboom-sdk/
│   ├── pom.xml                        # spring-webflux + reactor-netty + jackson-databind
│   └── src/{main,test}/java/com/orinuno/aniboom/
└── orinuno-app/
    ├── pom.xml                        # Spring Boot parent
    ├── spotbugs-exclude.xml
    └── src/{main,test}/...

Source tree (orinuno-app)

Section titled “Source tree (orinuno-app)”
orinuno-app/src/main/java/com/orinuno/
├── client/                    # Kodik API client
│   ├── KodikApiClient.java    # 7 endpoints, raw + typed responses
│   ├── KodikResponseMapper.java  # Schema drift detection (uses kodik-sdk-drift)
│   ├── KodikApiRateLimiter.java  # Token-bucket rate limiter
│   └── dto/                   # Request/Response DTOs
├── controller/                # REST controllers
│   ├── ContentController.java
│   ├── ParseController.java
│   ├── ParseRequestController.java
│   ├── ExportController.java
│   ├── HlsController.java
│   ├── DownloadController.java
│   ├── StreamController.java
│   ├── KodikEmbedController.java
│   └── HealthController.java
├── service/                   # Business logic
│   ├── ParserService.java     # Search, decode, TTL refresh
│   ├── KodikVideoDecoderService.java  # 8-step decode + brute-force
│   ├── GeoBlockDetector.java  # CDN + API geo-block detection
│   ├── HlsManifestService.java  # m3u8 URL + absolutized manifest
│   ├── ProxyWebClientService.java  # Proxy-aware HTTP with fallback
│   ├── ProxyProviderService.java   # Round-robin proxy pool
│   ├── VideoDownloadService.java   # Orchestrates Playwright downloads
│   ├── PlaywrightVideoFetcher.java # Headless Chromium + HLS parallel
│   └── KodikEmbedService.java # /get-player iframe URL shortcut
├── model/                     # Entities + DTOs
├── mapper/                    # Entity ↔ DTO converters
├── repository/                # MyBatis mapper interfaces
└── configuration/             # Spring configs, properties, filters
                                # ParseInboundRateLimitFilter (Bucket4j)
                                # ApiKeyAuthFilter

Source tree (kodik-sdk-drift)

Section titled “Source tree (kodik-sdk-drift)”
kodik-sdk-drift/src/main/java/com/kodik/sdk/drift/
├── DriftDetector.java
├── DriftRecord.java
├── DriftSamplingProperties.java
├── DtoFieldExtractor.java
└── ItemSamplingMode.java

Source trees (provider SDKs)

Section titled “Source trees (provider SDKs)”
jutsu-sdk/src/main/java/com/orinuno/jutsu/
├── JutsuClient.java               # public facade
├── JutsuConfig.java               # immutable record + builder
├── JutsuDecodeResult.java
├── JutsuErrorCodes.java
├── auth/JutsuSessionManager.java  # DLE login + sticky cookies
├── decoder/JutsuDecoder.java      # premium gate + Yandex CDN extractor
├── parser/JutsuSourceParser.java  # URL-shape parser
└── ratelimit/JutsuRateLimiter.java # Bucket4j 1 RPS hard cap


sibnet-sdk/src/main/java/com/orinuno/sibnet/
├── SibnetClient.java              # decode(long videoId) + decode(String shellUrl)
├── SibnetConfig.java
├── SibnetDecodeResult.java
├── SibnetErrorCodes.java
├── decoder/SibnetDecoder.java
└── parser/SibnetSourceParser.java


aniboom-sdk/src/main/java/com/orinuno/aniboom/
├── AniboomClient.java
├── AniboomConfig.java
├── AniboomDecodeResult.java
├── AniboomErrorCodes.java
├── decoder/AniboomDecoder.java    # HTML-entity decode + Jackson
└── parser/AniboomSourceParser.java

Resources (orinuno-app)

Section titled “Resources (orinuno-app)”
orinuno-app/src/main/resources/
├── application.yml
└── com/orinuno/db/
    ├── mapper/                # MyBatis XML with resultMaps and SQL
    └── changelog/
        ├── liquibase-changelog.yaml
        └── scripts/           # *.sql migrations

Tests

Section titled “Tests”
orinuno-app/src/test/java/com/orinuno/
├── *Test.java                          # unit tests
├── KodikLiveIntegrationTest.java       # live Kodik API, needs KODIK_TOKEN
├── KodikApiStabilityTest.java          # 37 schema-drift assertions
└── VideoDownloadLiveIntegrationTest.java


kodik-sdk-drift/src/test/java/com/kodik/sdk/drift/
└── DriftDetectorTest.java              # generic drift detector tests


jutsu-sdk/src/test/java/com/orinuno/jutsu/
├── JutsuClientTest.java
├── auth/JutsuSessionManagerTest.java
├── decoder/JutsuDecoderTest.java
├── parser/JutsuSourceParserTest.java
└── ratelimit/JutsuRateLimiterTest.java  # SDK-pure, no Spring context


sibnet-sdk/src/test/java/com/orinuno/sibnet/
├── SibnetClientTest.java
├── decoder/SibnetDecoderTest.java
└── parser/SibnetSourceParserTest.java


aniboom-sdk/src/test/java/com/orinuno/aniboom/
├── AniboomClientTest.java
├── decoder/AniboomDecoderTest.java
└── parser/AniboomSourceParserTest.java

Run any single SDK suite without booting the orinuno-app context:

Terminal window
mvn -pl jutsu-sdk test
mvn -pl sibnet-sdk test
mvn -pl aniboom-sdk test
mvn -pl kodik-sdk-drift test

Where to start when something breaks

Section titled “Where to start when something breaks”
SymptomFirst place to look
4xx/5xx on a REST callThe controller in controller/
Wrong or missing field in a responsemapper/ + the DTO in model/dto/
Decoding failsKodikVideoDecoderService, then the iframe HTML
Download returns 0 bytesPlaywrightVideoFetcher + Playwright logs
Schema drift noiseGET /api/v1/health/schema-drift
Section titled “Related”