Field survey editor for networks, devices, cabling and sites. Projects stay on the device; Android and Windows exchange copies manually through .ofam v1 packages. Only the explicit download of map tiles needs a network connection.
- Survey data model: sites, floors, devices, racks, ports, cables and patching, with photos attached to the right target.
- Map views: project overview of sites, site topology and floor plans, with logical, device and list views where applicable.
- Object configurator: configure devices and ports from the map or the inventory.
- Documents: export PDF, XLSX and Markdown reports from a project.
- Manual exchange:
.ofampackages with comparison, replace or three-way merge and conflict selection; password-protected copies are supported. - Local-first storage: Room with SQLCipher on Android; a portable
data/folder next to the executable on Windows. Interrupted saves can be recovered. - Localization: multiple UI languages.
| Platform | Module | Notes |
|---|---|---|
| Android 14+ | mobile/app |
minSdk 34, targetSdk 35 |
| Windows 11 x64 | pc/app |
Compose Desktop, portable ZIP |
| Shared | shared/core, shared/exchange, shared/configurator |
Domain model, .ofam exchange, configurator |
Requirements: JDK 17 for the Kotlin code, a JDK 21 toolchain with jpackage for the Windows package, Android SDK for the mobile app. Dependency versions are in gradle/libs.versions.toml.
.\gradlew.bat :mobile:app:assembleDebug # Android debug APK
.\gradlew.bat :pc:app:packagePortable # Windows portable folder and ZIPgradle.properties sets org.gradle.java.home to the Android Studio JBR path; adjust it for your machine. The repository contains a manual/tag-triggered release workflow, but GitHub Actions are disabled for this repository: build locally. Details in Build and release.
Guides and technical documents are written in Italian.
- User guides: Android, Windows, exchange and documents, demo and checks.
- Product decisions: plan.md; recorded verifications: roadmap.md.
| Topic | Document |
|---|---|
| Modules and boundaries | Architecture |
Data, validation, .ofam |
Domain and data contract |
| PDF, XLSX, Markdown, filters | Documents |
| Persistence and recovery | Storage and interoperability |
| Tests and demo | Verification |
| Distribution | Build and release |
| Application workflows | Workflows |
| Scenes and floor plans | Map |
| Languages | Localization |
| Objects and ports | Configurator |
The Android and Windows matrices separate native checks still open from automated ones. Brand assets are described in assets/README.md. The PDF OnlyFieldAssetManager_Manuale_Utente.pdf is a historical version; use the guides above for current workflows.
Project data is stored locally; there is no cloud backend. See SECURITY.md to report a vulnerability.
Proprietary, all rights reserved. See LICENSE. Third-party dependencies keep their own licenses.