Zero-Server, Peer-to-Peer (P2P) Real-Time Office Presence & Meeting Room Management System.
English Documentation • 🇹🇷 Türkçe Dokümantasyon • 📖 Case Study
OfisPresence is a high-performance desktop application for tracking workplace presence, employee availability, and meeting room occupancy without requiring a central server or cloud backend (Zero-Server Architecture).
Peers on the same local area network (LAN) discover each other automatically via mDNS/UDP multicasting and synchronize presence states in real time using Yjs CRDTs (Conflict-free Replicated Data Types) with Ed25519 cryptographic authentication.
| 📊 Employee Presence & 2D Floor Plan | 🚪 Meeting Room Occupancy & Auto-Sync |
|---|---|
 |
 |
| Real-time employee presence grid, custom statuses, 2D floor plan map, and presence audit history. | Interactive meeting rooms ("Mars", "Venüs") with automated participant tracking and "In Meeting" status broadcast. |
flowchart TD
subgraph LAN["🏠 Local Area Network (LAN Mesh)"]
PeerA["💻 Peer Node A (Alice)"]
PeerB["💻 Peer Node B (Bob)"]
PeerC["💻 Peer Node C (Charlie)"]
end
subgraph Discovery["📡 Discovery & Transport Layer"]
mDNS["mDNS / UDP Multicast Discovery
(Port 5353 / 41234)"]
WSServer["Embedded WebSocket Server / Client"]
end
subgraph CoreEngine["🧠 P2P Core Engine (Electron Main)"]
YjsDoc["Yjs Shared CRDT Document
(Presence Map & Room State)"]
CryptoEngine["Ed25519 Cryptographic Signatures
(Tamper-Proof Status Updates)"]
KeytarStore["Keytar OS Keychain & SQLite Encrypted Fallback"]
Simulator["Virtual Mesh Simulation Engine
(5 Virtual Teammates Demo Mode)"]
end
subgraph UI["🖥️ Presentation Layer (React 18 & Tailwind)"]
PresenceGrid["Employee Presence Grid & Status Selectors"]
FloorPlan["Interactive 2D Floor Plan Visualizer"]
Rooms["Meeting Room Management & Modals"]
AuditLog["Timeline Audit History & Admin Panel"]
end
PeerA <===> mDNS <===> PeerB
PeerB <===> WSServer <===> PeerC
WSServer <--> YjsDoc
YjsDoc <--> CryptoEngine
CryptoEngine <--> KeytarStore
YjsDoc <--> UI
- No centralized database, server, or cloud subscriptions required.
- Devices discover each other on the local network via mDNS/UDP multicasting and establish direct peer-to-peer WebSocket channels.
- Fully offline-first: works seamlessly even if internet connectivity drops.
- State synchronization is powered by Yjs (CRDT).
- Status changes, room entries/exits, and custom availability broadcasts propagate across all active nodes within milliseconds with zero merge conflicts.
- Test the full multi-user P2P experience on a single machine!
- Enables 5 virtual AI teammates who dynamically change statuses, move between meeting rooms, and simulate realistic office presence.
- Real-time visual map of the office layout.
- See at a glance who is currently at their desk, in meeting room "Mars", or on the field.
- Join virtual rooms ("Mars", "Venüs", "Jüpiter") with a single click.
- Entering a meeting room automatically broadcasts an "In Meeting" status to the entire office mesh.
- Role-based administrator panel allows adding, editing, and deleting rooms dynamically.
- All status broadcasts are cryptographically signed with Ed25519 key pairs to prevent spoofing.
- Private keys are stored in the OS native keychain (Keytar). If unavailable, an encrypted local SQLite storage fallback is automatically activated.
- Instant desktop notifications on room joins and emergency field status broadcasts.
- Comprehensive timeline history tracking employee availability transitions throughout the day.
- Node.js (v18+)
- npm or yarn
git clone https://github.com/adacreativeco/OfisPresence.git
cd OfisPresence
npm installnpm testnpm run devnpm run buildnpm run packageOfisPresence/
├── electron/ # Electron Main & Preload processes
│ ├── main.ts # Electron lifecycle & window management
│ ├── preload.ts # Secure IPC bridge (contextBridge)
│ └── lib/ # Core P2P networking & state libraries
│ ├── crypto.ts # Ed25519 signing & verification
│ ├── discovery.ts # mDNS / UDP mesh peer discovery
│ ├── identity.ts # Cryptographic keypair generation & identity
│ ├── ipc.ts # IPC handler registry
│ ├── notifications.ts # Native OS desktop notification dispatch
│ ├── persistence.ts # SQLite state storage & Keytar fallback
│ ├── simulation.ts # Virtual mesh 5-agent simulation engine
│ ├── ws-server.ts # Peer-to-peer WebSocket transport
│ └── yjs-manager.ts # Yjs CRDT document & awareness manager
├── src/ # React 18 & TailwindCSS Renderer
│ ├── App.tsx # Main layout & tab orchestration
│ ├── main.tsx # React DOM entry point
│ ├── components/
│ │ ├── admin/AdminPanel.tsx # Role-based room & office management
│ │ ├── history/StatusHistory.tsx # Availability timeline & audit trail
│ │ ├── map/FloorPlan.tsx # Interactive 2D floor plan visualizer
│ │ ├── rooms/ # Meeting room cards & join dialogs
│ │ ├── setup/SetupWizard.tsx # First-launch onboarding & identity setup
│ │ ├── status/ # Custom status & field dialogs
│ │ └── ui/ # Reusable Shadcn/Radix UI components
│ ├── lib/
│ │ ├── i18n.ts # Bilingual translation engine (TR ⟷ EN)
│ │ └── locales/ # JSON dictionaries (en.json, tr.json)
│ └── styles/globals.css # Dark-themed Tailwind design system
├── shared/
│ └── types.ts # Shared TypeScript interfaces & models
├── tests/ # Automated Vitest test suite
│ ├── crypto.test.ts # Ed25519 signature & tamper tests
│ ├── i18n.test.ts # Locale key parity tests
│ ├── persistence.test.ts # Encrypted storage & fallback tests
│ └── yjs.test.ts # CRDT document mutation & sync tests
├── electron.vite.config.ts # Electron-Vite compilation config
├── package.json # Package metadata & build scripts
└── tsconfig.json # TypeScript compiler configuration
Distributed under the Apache 2.0 License. See LICENSE for details.
Built with 🏢 by ADA Creative Co.