How gebort/festu.navigator works
Project type and purpose
• This is a native Android application (“app” Gradle module) implementing AR navigation inside university buildings.
• It uses Google ML Kit for classroom-number recognition, SceneView for AR rendering, Room as local graph database, and a Clean-Architecture layering (data, domain, presentation).
File structure
• Top-level “app” module with build.gradle, ProGuard rules and two build flavors: adminDebug/adminRelease vs. userDebug/userRelease.
• app/src/main:
• assets/database: pre-populated Room graph (nodes.db)
• java/com/example/festunavigator/data: data_source (Room + DAOs), ML classification helpers, pathfinding (AStar), repositories, utils
• java/com/example/festunavigator/domain: DI module, abstract entities (Tree, Path), repositories interfaces, use_cases (AnalyzeImage, FindWay, HitTest, SmoothPath), utilities
• java/com/example/festunavigator/presentation: MainActivity + Fragments (Preview, Scanner, Router, Search, Orientation, Confirm), MVVM view-models, adapters, common helpers (DisplayRotationHelper, DrawerHelper), navigation graph
• Tests: unit tests under src/test, instrumentation tests under src/androidTest.
README for insights
• Describes features: scanning classroom numbers, confirming 3D position, path building via A* + Bezier smoothing, AR route visualization.
• Explains admin mode for graph editing.