Initial release of P2P Governance prototype

README.md

@@ -1,39 +1,24 @@
-# P2P Poll App
+# 🗳️ Simple P2P Poll & Chat
 
-There are various issues of Trust:
-The possiblity to generate lots of users that do a lot of things (at a rather low cost)
-The possibility to put out wrong data, maby not even contradicting but additional to existing data.
-The possibility to do all kinds of shenenigans like spam other users with some requests
+This is a minimal prototype of a decentralized governance tool built for the **Demcode Evocracy** experiment. It allows for basic deliberation and voting without a central database or server-side logic.
 
-Due to low programming knowledge, the starting point of this proposal was to mirror how normal groups of people solve issues of trust to then automate and possibly improve the process. There are already some systems out there like Trust flow or random walk. As far as i understand it, the Flexible Trust Web also already does something like this, also maby RWOT and GNUweb but i didn't read into them too much since i discovered them rather late and want to look for feedback anyway. After all, a system with a clearer consensus might be preferable to some.
+## What it does
+- **P2P Connectivity:** Uses WebRTC (via PeerJS) to link browsers directly.
+- **Mesh-capable:** Allows multiple connections to sync the same poll state.
+- **Live Sync:** Changes to the poll topic, options, or votes are broadcast to all connected peers.
+- **Chat:** A simple sidebar to discuss the poll in real-time.
 
-If random new people should be able to use the system as equals to previous users, but the system never has real identities as an input, then there is no way to fully prevent the creation of new users to manipulate or sabotage the poll. But it can be assumed, that your friends are rather trustworthy and most likely also their friends and so on. And if someone makes huge ammounts or just one second account, they will probably only have the creator or maby some other people as friends, and even they might already be less socially connected than a normal user.
-So the social distance to another user should be evaluated to see, whether you should count their vote.
-This is evaluated for and by every user individually, based on the information they were sent. The ammount of contacts you won't count are displayed to you, such that you get a hint at how many people you are missing but also how many people are not counting you. This encourages people to try to prove others/vise versa and make social connections to officially tie the network closer together such that the voting system works and confirms itself. It would be great, if there was some chat attached to the poll. If people want to prove their (or others) trusworhiness within this system, they are then also encouraged to have productive discussions, probably about the matter of the poll.
-Everyone in a poll with you is a "contact" of yours.
-"users" can have "friends".
-You can also manually mark users as suspicious or trustworthy or normal again.
-The system for evaluating the trustworthyness of users is somehow a mix between the concepts "weighted path score" and "trust flow" with 5 steps.
-That means for 5 steps starting with you, all friends and trusted people of people looked at in this step get some trust from the people we look at: 0.8 * The trust of the looked at person (if trusted) + 0.8 * The trust of the looked at person / friends the looked at person has (if friend). Then the trust of the person that received trust may maximally be 100. The Trust you have to yourself is 100.
-You can also mark someone as trustworthy or untrustworthy. That is then also sent around to everyone if you want(should be the standard, but maby a user wants to just see how the trustworthyness will look like after the change).
-If you receive such an information, you can make the following calculations immidiately and after every assesment of everyones trustworthyness:
-If the accused is less trustworthy then the accusing person, decrease the accused trustworthyness to 0 and the accused friends and trustees trustworthyness by the trustworthyness of the accusing person.
-If the trustworhyness of the accusing person is less than the trustworthyness of the accused, then reduce the trustworthyness of the accusing person to 0 and the accusing persons friends and trustees by the trustworthyness of the accused * 0,2.
-If you mark someone as trustworthy:
-The Trust flowing to the trusted person from you will also be 0.8 of your trust.
-Maby this should also be the effect of beeing "friends" since "trust" might be something you could more intuitively casually deal out after a short chat. If that change were to occur, then the effect would have to be switched around.
-All contacts can maximally have the Trust 100.
+## How to use it
+1. Open the page: [https://andrewlehr.github.io/evocracy-p2p-poll/]
+2. Set your **Nickname** and click "Set".
+3. Share your nickname with a friend.
+4. One person enters the other's nickname in the **Connect** box and clicks "Add Peer".
+5. Once connected, you can set a topic, add options, and vote.
 
+## Technical Notes
+- **Data Persistence:** There is no database. If everyone closes their browser, the data is lost.
+- **Networking:** It uses a public signaling server to find peers, but the actual data (votes/chat) stays between the browsers.
+- **Conflict Handling:** Uses a simple "Last Write Wins" broadcast to keep peers in sync.
 
-Future matters:
-If there can be any discrepancy of sent information, depending on what sender you trust most, you will mark one of the senders as untrustworthy and neglect all future information from this user. Since everything can be signed and such, that shouldnˋt be an issue tho, but if it was, the ammount of "useless" messages to already informed people might have to increase to validate received data.
-A system to showcase the social connections in a 2D - format would be neat.
-(most likely something like this exists already)
-Obviously the user would also have to see other context like the total of all votes (trusted or not)
-
-Anonymous polls:
-A system of individually assigned trust poses a challenge for a system where you can decide not to trust some voters.
-If there is no other option some compromises might be makable, such as:
--Your Friends can know what you voted for
--The Person initiating a poll just decides on the validity of participants according to an own judgement of trust at the moment of poll-creation
--A System with clear Consensus of who to trust
+## Transparency
+This code was generated with the assistance of **Gemini (Google AI)** to quickly prototype the WebRTC networking logic. The goal was to create a clean, readable foundation that is easy for others to merge or modify during the next phase of the experiment.

index.html

@@ -0,0 +1,212 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+    <title>Mesh Governance Tool</title>
+    <script src="https://unpkg.com/peerjs@1.5.2/dist/peerjs.min.js"></script>
+    <style>
+        :root { --primary: #007AFF; --bg: #f2f2f7; --success: #34c759; --secondary: #8e8e93; }
+        * { box-sizing: border-box; }
+        body { font-family: -apple-system, sans-serif; margin: 0; background: var(--bg); height: 100vh; display: flex; flex-direction: column; overflow: hidden; }
+        
+        /* Header & Peer List */
+        .header { background: #fff; padding: 12px; border-bottom: 1px solid #d1d1d6; flex-shrink: 0; }
+        .setup-row { display: flex; gap: 8px; margin-bottom: 10px; align-items: center; }
+        .peer-list-container { display: flex; gap: 6px; overflow-x: auto; padding-bottom: 4px; scrollbar-width: none; }
+        .peer-list-container::-webkit-scrollbar { display: none; }
+        .peer-chip { background: #e9ecef; padding: 4px 10px; border-radius: 12px; font-size: 11px; white-space: nowrap; border: 1px solid #dee2e6; display: flex; align-items: center; gap: 5px; }
+        .dot { width: 6px; height: 6px; background: var(--success); border-radius: 50%; }
+
+        /* Main Layout */
+        .main-container { display: flex; flex: 1; overflow: hidden; }
+        @media (max-width: 768px) { .main-container { flex-direction: column; } }
+        .column { flex: 1; display: flex; flex-direction: column; overflow: hidden; background: #fff; border-right: 1px solid #d1d1d6; }
+        .scroll-area { flex: 1; overflow-y: auto; padding: 16px; -webkit-overflow-scrolling: touch; }
+
+        /* Components */
+        .card { background: #f9f9f9; border-radius: 10px; padding: 12px; margin-bottom: 15px; border: 1px solid #e5e5ea; }
+        input { border: 1px solid #c6c6c8; padding: 10px; border-radius: 8px; font-size: 16px; width: 100%; outline: none; }
+        button { background: var(--primary); color: white; border: none; padding: 10px; border-radius: 8px; font-weight: 600; cursor: pointer; }
+        
+        /* Poll UI */
+        .poll-question { font-size: 20px; font-weight: 700; margin-bottom: 15px; color: var(--primary); }
+        .option-item { display: flex; justify-content: space-between; align-items: center; background: white; padding: 12px; border-radius: 10px; margin-bottom: 8px; border: 1px solid #e5e5ea; }
+        
+        /* Chat UI */
+        #chat-messages { display: flex; flex-direction: column; gap: 8px; }
+        .msg { padding: 8px 12px; border-radius: 14px; max-width: 85%; font-size: 14px; }
+        .msg.sent { background: var(--primary); color: white; align-self: flex-end; }
+        .msg.received { background: #e5e5ea; color: black; align-self: flex-start; }
+        .msg-sender { font-size: 10px; font-weight: bold; opacity: 0.7; display: block; }
+        .chat-input-bar { padding: 12px; background: #fff; border-top: 1px solid #d1d1d6; display: flex; gap: 8px; padding-bottom: calc(12px + env(safe-area-inset-bottom)); }
+    </style>
+</head>
+<body>
+
+    <div class="header">
+        <div class="setup-row">
+            <span style="font-size: 13px;">Me: <strong id="my-id-display">...</strong></span>
+            <div id="peer-list" class="peer-list-container">
+                </div>
+        </div>
+        <div class="setup-row">
+            <input type="text" id="nickname-input" placeholder="My Name" style="flex: 0.5;">
+            <button onclick="joinAs(document.getElementById('nickname-input').value)" style="background: var(--secondary); padding: 8px 12px;">Set</button>
+            <input type="text" id="peer-id-input" placeholder="Friend's Name" style="flex: 1;">
+            <button onclick="connectToPeer()" style="padding: 8px 12px;">Connect</button>
+        </div>
+    </div>
+
+    <div class="main-container">
+        <div class="column">
+            <div class="scroll-area">
+                <div class="card">
+                    <input type="text" id="poll-title-input" placeholder="Question/Topic?">
+                    <button onclick="updateTitle()" style="width:100%; margin-top:8px;">Set Topic</button>
+                </div>
+                <div id="active-question" class="poll-question">Waiting for Topic...</div>
+                <div style="display:flex; gap:8px; margin-bottom:15px;">
+                    <input type="text" id="new-option-text" placeholder="Add option...">
+                    <button onclick="addOption()">Add</button>
+                </div>
+                <div id="poll-container"></div>
+            </div>
+        </div>
+
+        <div class="column">
+            <div class="scroll-area" id="chat-scroll">
+                <div id="chat-messages"></div>
+            </div>
+            <div class="chat-input-bar">
+                <input type="text" id="chat-input" placeholder="Discuss...">
+                <button onclick="sendMessage()">Send</button>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        let pollData = { question: "Open Discussion", options: [] };
+        let myName = "";
+        let connections = []; 
+        let peer = null;
+
+        function joinAs(id) {
+            if (peer) peer.destroy();
+            peer = new Peer(id || undefined);
+            peer.on('open', newId => { 
+                myName = newId; 
+                document.getElementById('my-id-display').innerText = newId; 
+            });
+            peer.on('connection', conn => setupConnection(conn));
+        }
+
+        function connectToPeer() {
+            const target = document.getElementById('peer-id-input').value;
+            if (target && target !== myName) {
+                setupConnection(peer.connect(target));
+            }
+            document.getElementById('peer-id-input').value = "";
+        }
+
+        function setupConnection(conn) {
+            conn.on('open', () => {
+                // Prevent duplicate connections
+                if (!connections.find(c => c.peer === conn.peer)) {
+                    connections.push(conn);
+                    updatePeerUI();
+                    broadcast({ type: 'SYNC', payload: pollData });
+                }
+            });
+
+            conn.on('data', data => {
+                if (data.type === 'SYNC') {
+                    pollData = data.payload;
+                    renderPoll();
+                } else if (data.type === 'CHAT') {
+                    appendMessage(data.sender, data.payload, 'received');
+                }
+            });
+
+            conn.on('close', () => {
+                connections = connections.filter(c => c.peer !== conn.peer);
+                updatePeerUI();
+            });
+        }
+
+        function broadcast(data) {
+            connections.forEach(c => { if (c.open) c.send(data); });
+        }
+
+        function updatePeerUI() {
+            const list = document.getElementById('peer-list');
+            if (connections.length === 0) {
+                list.innerHTML = '<span style="font-size:11px; color:#999;">No peers connected</span>';
+                return;
+            }
+            list.innerHTML = connections.map(c => `
+                <div class="peer-chip"><div class="dot"></div>${c.peer}</div>
+            `).join('');
+        }
+
+        // --- APP LOGIC ---
+        function updateTitle() {
+            const val = document.getElementById('poll-title-input').value;
+            if (!val) return;
+            pollData.question = val;
+            renderPoll();
+            broadcast({ type: 'SYNC', payload: pollData });
+        }
+
+        function addOption() {
+            const txt = document.getElementById('new-option-text').value;
+            if (!txt) return;
+            pollData.options.push({ text: txt, votes: 0 });
+            document.getElementById('new-option-text').value = "";
+            renderPoll();
+            broadcast({ type: 'SYNC', payload: pollData });
+        }
+
+        function vote(i) {
+            pollData.options[i].votes++;
+            renderPoll();
+            broadcast({ type: 'SYNC', payload: pollData });
+        }
+
+        function renderPoll() {
+            document.getElementById('active-question').innerText = pollData.question;
+            const container = document.getElementById('poll-container');
+            container.innerHTML = pollData.options.map((opt, i) => `
+                <div class="option-item">
+                    <span>${opt.text}</span>
+                    <div style="display:flex; align-items:center;">
+                        <span style="font-weight:bold; color:var(--primary); margin-right:12px; font-size:18px;">${opt.votes}</span>
+                        <button onclick="vote(${i})" style="background:var(--success); padding:5px 12px;">Vote</button>
+                    </div>
+                </div>
+            `).join('');
+        }
+
+        function sendMessage() {
+            const input = document.getElementById('chat-input');
+            if (!input.value) return;
+            broadcast({ type: 'CHAT', sender: myName, payload: input.value });
+            appendMessage('You', input.value, 'sent');
+            input.value = "";
+        }
+
+        function appendMessage(sender, text, side) {
+            const div = document.createElement('div');
+            div.className = `msg ${side}`;
+            div.innerHTML = `<span class="msg-sender">${sender}</span>${text}`;
+            document.getElementById('chat-messages').appendChild(div);
+            const scroll = document.getElementById('chat-scroll');
+            scroll.scrollTop = scroll.scrollHeight;
+        }
+
+        document.getElementById('chat-input').addEventListener('keypress', (e) => { if (e.key === 'Enter') sendMessage(); });
+
+        joinAs(null);
+    </script>
+</body>
+</html>