# Tutorial P2P Sync Noterich: Sambungan Antara Peranti Tanpa Cloud > **Sambungkan nota anda antara peranti dengan selamat — tiada keperluan untuk storan cloud.** Dalam era di mana privasi data sangat penting, Noterich menawarkan pendekatan revolusioner untuk sambungan antara peranti. Fungsi **P2P (Peer-to-Peer) Sync** kami membolehkan perkongsian nota antara peranti tanpa bergantung pada pelayan cloud. Data anda tetap menjadi milik anda — selalu. ## Mengapa Pilih P2P Sync? Aplikasi mencatat nota tradisional menyimpan data pada pelayan pusat. Ini menimbulkan risiko privasi, kos langganan, dan ketergantungan pada infrastruktur pihak ketiga. Noterich mengambil jalan yang berbeza: ```mermaid graph LR A[Peranti Anda] <-->|Koneksi Langsung| B[Peranti Anda yang Lain] C[Pelayan Cloud] -.->|Tidak Diperlukan| A C -.->|Tidak Diperlukan| B style A fill:#4CAF50,color:#fff style B fill:#4CAF50,color:#fff style C fill:#9E9E9E,color:#fff,stroke-dasharray: 5 5 ``` ### Kelebihan Utama - **🔒 Privasi Pertama**: Nota anda tidak pernah bersentuhan dengan pelayan pihak ketiga - **⚡ Cepat & Langsung**: Peranti berkomunikasi secara langsung untuk sambungan yang lebih cepat - **💰 Tanpa Langganan**: Sambungan P2P percuma tanpa tahap premium - **🌐 Berfungsi Di mana-mana**: Sambung melalui rangkaian tempatan atau internet - **📱 Antara Platform**: Berfungsi antara desktop, laptop, tablet, dan telefon bimbit ## Bagaimana P2P Sync Berfungsi Noterich menggunakan **teknologi WebRTC** bersama **PeerJS** untuk membina koneksi langsung antara peranti. Apabila anda memulakan sambungan: ```mermaid sequenceDiagram participant D1 as Peranti A (Pengirim) participant S as Pelayan Isyarat participant D2 as Peranti B (Penerima) D1->>S: Meminta ID koneksi S-->>D1: Menghasilkan ID bilik D1->>D2: Berkongsi link koneksi (QR/URL) D2->>S: Sambung menggunakan ID bilik S-->>D2: Membina koneksi antara rakan D1->>D2: Mendaftarkan & menghantar nota D2->>D2: Mendekripsi & memasukkan nota Nota di antara D1,D2: Pemindahan yang dienkripsi secara langsung<br/>Tiada data disimpan pada pelayan ### Teknologi Di Balik Tabir Pelaksanaan P2P Noterich menggunakan: 1. **Bibliotek PeerJS**: Menangani kerumitan WebRTC untuk komunikasi antara pelayar 2. **Enkripsi AES-GCM**: Enkripsi tahap tentera untuk data nota 3. **Penghasilan Kunci PBKDF2**: Penghasilan kunci enkripsi berdasarkan kata laluan yang selamat 4. **Penyusunan MessagePack**: Penyusunan data binari yang cekap untuk pemindahan cepat 5. **Penyimpanan IndexedDB**: Perpustakaan tempatan untuk akses luar talian ## Memulakan Penggunaan P2P Sync ### Prasyarat Sebelum anda memulakan, pastikan anda mempunyai: - ✅ Noterich diinstal pada kedua-dua peranti - ✅ Kedua-dua peranti disambungkan ke internet (atau rangkaian tempatan yang sama) - ✅ Pelayar web moden (Chrome, Firefox, Edge, Safari) ### Langkah 1: Mulakan Perkongsian dari Peranti Asal 1. Buka nota yang ingin anda kongsi dalam Noterich 2. Klik butang **Share** di toolbar 3. Pilih pilihan **"P2P Share"** 4. (Pilihan) Atur kata laluan untuk keselamatan tambahan - Kata laluan mesti mempunyai sekurang-kurangnya 8 aksara - Menggunakan enkripsi AES-256-GCM 5. Tunggu pelayan P2P untuk diaktifkan ```mermaid graph TD A[Buka Nota] --> B[Klik Butang Share] B --> C[Pilih P2P Share] C --> D{Atur Kata Laluan?} D -->|Ya| E[Jawab Kata Laluan ≥8 aksara] D -->|Tidak| F[Skip Enkripsi] E --> G[Aktifkan Pelayan P2P] F --> G G --> H[Generelkan Link Perkongsian & QR Code] ``` ### Langkah 2: Kongsi Link Koneksi Apabila pelayan P2P dimulakan, Noterich akan menghasilkan: - **Link yang boleh dikongsi yang unik** yang mengandungi parameter koneksi - **QR code** untuk skan cepat pada telefon bimbit Format link kelihatan seperti: ``` https://noterich.com/#dbshare=<infoHash>&server=<signaling-server> ``` **Cara Berkongsi:** | Kaedah | Terbaik Untuk | Cara Melakukannya | |--------|----------|--------| | 🔗 Sisipkan Link | E-mel, aplikasi mesej | Klik butang “Sisipkan Link” | | 📱 QR Code | Peranti mudah alih | Skan menggunakan kamera peranti | | 📧 E-mel | Rakan kerja jauh | Sisipkan link dalam e-mel | ### Langkah 3: Terima di Peranti Tujuan Di peranti penerima: 1. **Buka link perkongsian** - Klik langsung pada link, atau - Skan QR code dengan peranti mudah alih 2. **Semak nota yang diterima** - Lihat tajuk nota dan metadata - Semak maklumat pengirim 3. **Masukkan kata laluan** (jika dienkripsi) - Masukkan kata laluan yang diberikan oleh pengirim - Data akan didekripsi secara tempatan pada peranti anda 4. **Pilih ruang kerja destinasi** - Pilih ruang kerja yang sedia ada, atau - Cipta ruang kerja baru untuk nota yang dimasukkan 5. **Konfirmasi import** - Nota akan didekripsi dan disimpan dalam IndexedDB - Indeks carian akan dibina semula secara automatik ```mermaid graph LR A[Buka Link] --> B[Sambung ke Pengirim] B --> C{Dienkripsi?} C -->|Ya| D[Jawab Kata Laluan] C -->|Tidak| E[Semak Metadata] D --> E E --> F[Lihat Nota] F --> G[Pilih Ruang Kerja] G --> H[Import & Indeks] H --> I[Sambungan Selesai!] style I fill:#4CAF50,color:#fff ``` ## Kelebihan Lanjutan ### Pemindahan Dikenkripsi Untuk nota yang sensitif, Noterich menawarkan enkripsi end-to-end pilihan: **Proses Enkripsi:** ```javascript // Kata Laluan → Kunci Enkripsi (PBKDF2) password + salt → deriveKey() → Kunci AES-256-GCM // Data Nota → Buffer Dikenkripsi noteData + key + iv → encrypt() → encryptedBuffer // Paket Pemindahan { encryptedBuffer: ArrayBuffer, salt: Uint8Array, // Untuk penghasilan kunci iv: Uint8Array // Vector Inisiasi } ``` **Fungsi Keselamatan:** - 🔐 100,000 iterasi PBKDF2 untuk penghasilan kunci - 🔐 Salji rawak dan IV untuk setiap pemindahan - 🔐 Enkripsi Autentikasi AES-256-GCM - 🔐 Kata Laluan tidak pernah dihantar — hanya digunakan secara tempatan ### Pemindahan Nota Secara Secara Pindahkan beberapa nota dengan cekap: 1. Akses **Database Transfer** dari tetapan 2. Pilih mod **"P2P Sync"** 3. Pilih nota yang ingin disambungkan 4. Penerima akan mendapat senarai semak dengan pilihan **Peningkatan Prestasi:** - Nota dipindahkan dalam blok (512KB setiap) - Pemprosesan tidak berlaku secara berantai untuk mengelakkan UI sejuk - Pemantauan kemajuan dengan ketepatan byte - Tidak perlu lagi jika data rosak ### Penyelesaian Konflik Apabila menyambung nota yang ada pada kedua-dua peranti: ```mermaid graph TD A[Pemeriksaan Konflik] --> B{Perbandingan Tarikh Masa} B -->|Lokal Lebih Baru| C[Kekalkan Versi Lokal] B -->|Luar Lebih Baru| D[Tunjuk Dialog Konflik] D --> E[Pilih Versi] E --> F[Lokal] E --> G[Luar] E --> H[Merangkaikan Secara Manual] B -->|Kedua-duanya Dihapus| I[Sisihkan] style C fill:#2196F3,color:#fff style F fill:#2196F3,color:#fff style G fill:#4CAF50,color:#fff ``` **Jenis Konflik yang Dihadapi:** - `local-newer`: Versi anda lebih baru - `remote-newer`: Versi masuk lebih baru - `local-deleted`: Anda telah memadam nota ini secara lokal - `remote-deleted`: Nota telah dipadamkan pada peranti pengirim - `remote-restored`: Nota yang telah dipadamkan sebelum ini dipulihkan ## Penyelesaian Masalah ### Masalah Biasa & Penyelesaian #### ❌ “Bibliotek PeerJS tidak dimuatkan” **Sebab**: Penghalang rangkaian PeerJS CDN atau pelayan isyarat **Penyelesaian:** 1. Semak sambungan internet 2. Semak sama ada firewall membenarkan koneksi WebRTC 3. Cuba rangkaian alternatif (hotspot mudah alih) 4. Pastikan pelayar menyokong WebRTC #### ❌ “Waktu Tahan Koneksi” **Sebab**: NAT/Firewall menghalang koneksi langsung **Penyelesaian:** 1. Kedua-dua peranti berada dalam rangkaian yang sama membantu 2. Henti VPN secara sementara 3. Semak tetapan WebRTC router 4. Gunakan QR code untuk koneksi mudah alih #### ❌ “Enkripsi Gagal” **Sebab**: Kata laluan yang salah atau pemindahan rosak **Penyelesaian:** 1. Semak kata laluan sama persis (berbeza huruf besar/kecil) 2. Meminta link perkongsian baru dari pengirim 3. Pastikan koneksi stabil semasa pemindahan 4. Cuba ukuran blok yang lebih kecil #### ❌ “Sambungan sedang berjalan” ralat **Sebab**: Terdapat beberapa percubaan sambungan serentak **Penyelesaian:** 1. Tunggu sambungan semasa selesai 2. Tutup tab/window Noterich yang lain 3. Kemas kini halaman dan cuba lagi 4. Padam cache pelayar jika berterusan ### Indikator Status Koneksi | Status | Makna | Tindakan | |--------|---------|--------| | 🔵 Sedang Sambung | Membina koneksi antara rakan | Tunggu 5-10 saat | | 🟡 Sedang Membandingkan | Menganalisis perbezaan nota | Proses normal | | 🟠 Menunggu Pengguna | Perlu kata laluan atau pengesahan | Semak dialog modul | | 🟢 Sedang Menggunakan | Memasukkan nota ke dalam pangkalan data | Jangan tutup tab | | ✅ Berjaya | Sambungan selesai dengan baik | Boleh gunakan nota | | 🔴 Ralat | Koneksi atau pemindahan gagal | Semak penyelesaian masalah | ## Amalan Keselamatan Terbaik ### Melindungi Data Anda Walaupun P2P sync secara semula jadi selamat, ikuti garis panduan ini: 1. **Gunakan Kata Laluan yang Kuat** - Sekurang-kurangnya 8 aksara (disyorkan 12+) - Campurkan huruf besar, kecil, nombor, simbol - Jangan ulang kata laluan dari perkhidmatan lain 2. **Semak Penerima** - Kongsi hanya link dengan peranti yang dipercayai - Gunakan QR code untuk pemindahan jarak jauh - Elakkan memposting link di saluran awam 3. **Monitorkan Koneksi Aktif** - Semak rakan yang terhubung semasa proses sambungan - Terputus setelah pemindahan berjaya - Tarik balik link perkongsian jika terjejas 4. **Backup Berkala** - Eksport nota penting secara berkala - Simpan backup di lokasi yang selamat - Uji proses pemulihan secara berkala ### Memahami Had Enkripsi **Apa yang Dikenkripsi:** - ✅ Kandungan nota (teks, format, metadata) - ✅ Lampiran dan media yang dimuatkan - ✅ Struktur pangkalan data semasa pemindahan **Apa yang Tidak Dikenkripsi:** - ⚠️ Metadata koneksi (masa, saiz data) - ⚠️ Alamat IP (kelihatan oleh pelayan isyarat) - ⚠️ Identifikasi peranti (untuk laluan koneksi) ## Tips Prestasi ### Optimumkan Kelajuan Sambungan 1. **Keadaan Rangkaian** - Rangkaian tempatan yang sama = pemindahan paling cepat - WiFi 5GHz lebih baik daripada 2.4GHz - Ethernet kabel untuk peranti desktop 2. **Saiz Blok** - Pemindahan besar: Bahagikan kepada blok yang lebih kecil - Pantau indikator kemajuan - Tamatkan dan cuba lagi jika terhenti 3. **Prestasi Pelayar** - Jaga tab Noterich aktif semasa proses sambungan - Tutup tab pelayar yang tidak diperlukan - Terapkan versi pelayar terbaru 4. **Sumber Peranti** - Pastikan ruang penyimpanan yang cukup - Tutup aplikasi yang memerlukan banyak memori - Restart pelayar jika sambungan perlahan ### Pengurusan Memori Noterich melaksanakan pengkelasan blok pintar untuk mengelakkan kegagalan pelayar: ```javascript // Pemprosesan Blok Secara Acak dengan setTimeout async function asyncBatchProcessor(items, processor, batchSize = 10) { // Proses blok dalam blok 10 // Berikan kawalan setiap 10ms untuk menjaga respons UI // Elakkan memblokir thread utama semasa pemindahan besar } ``` **Cadangan:** - Bataskan pemindahan satu nota maksimum 100 nota - Tunggu 30 saat antara pemindahan besar - Padam cache pelayar secara berkala ## Soalan Kerap ### Q: Bolehkah saya sambungkan lebih dari dua peranti? **A:** Ya! Mulakan sesi P2P yang berasingan untuk setiap pasangan peranti. Untuk kerja pelbagai peranti: 1. Sambungkan Peranti A → Peranti B 2. Kemudian sambungkan Peranti B → Peranti C 3. Atau gunakan Peranti A sebagai pusat untuk semua yang lain ### Q: Adakah P2P sync berfungsi luar talian? **A:** P2P memerlukan sambungan internet untuk handshake pelayan isyarat. Selepas sambungan dibina: - ✅ Pemindahan lokal berfungsi tanpa internet - ✅ Data dipindahkan secara langsung antara peranti - ❌ Sambungan awal memerlukan akses pelayan isyarat ### Q: Apa yang berlaku jika sambungan terhenti? **A:** Noterich mengendalikan konflik dengan baik: - Nota yang dipindahkan sebahagian akan dibuang - Tiada data rosak masuk ke pangkalan data - Cukup restart proses sambungan - Nota yang sudah disambungkan tidak terjejas ### Q: Bolehkah saya sambung dengan akaun Noterich orang lain? **A:** Sudah tentu! P2P sync berfungsi antara pengguna Noterich: - Kongsi nota individu dengan rakan kerja - Tiada keperluan untuk kaitan akaun - Setiap pemindahan adalah bebas dan selamat - Sangat sesuai untuk berkongsi nota sekali sahaja ### Q: Adakah terdapat had saiz fail? **A:** Had praktikal bergantung pada: - Stok memori pelayar - Kestabilan rangkaian - Disarankan maksimum: 50MB setiap sesi - Pemindahan yang lebih besar: Bahagikan kepada beberapa blok ### Q: Berapa lama link perkongsian berkuat kuasa? **A:** Link perkongsian berdasarkan sesi: - Berkuat kuasa selagi tab Noterich dibuka - Tamat apabila pengirim tutup tab/browser - Disarankan gunakan sekali sahaja untuk keselamatan - Generelkan link baru untuk setiap sesi pemindahan ## Perbandingan: P2P vs Cloud Sync ```mermaid quadrantChart title "Perbandingan Kaedah Sambungan" x-axis "Privasi Rendah" --> "Privasi Tinggi" y-axis "Kawalan Rendah" --> "Kawalan Tinggi" quadrant-1 "Noterich P2P" quadrant-2 "Elakkan" quadrant-3 "Teknologi Cloud Tradisional" quadrant-4 "Perkhidmatan Terpusat" "Noterich P2P": [0.9, 0.9] "Teknologi Cloud Tradisional": [0.3, 0.4] "Perkhidmatan Terpusat": [0.4, 0.3] ``` | Ciri | Noterich P2P | Cloud Sync | |--------|--------------|------------| | **Penyimpanan Data** | Peranti anda sahaja | Peranti pihak ketiga | | **Tahap Privasi** | Maksimum | Bergantung pada penyedia | | **Kos** | Percuma | Seringkali berdasarkan langganan | | **Kesukaran Penyediaan** | Sederhana | Mudah | | **Kelajuan Sambungan** | Sangat Cepat (langsung) | Sederhana (melalui server) | | **Akses Luar Talian** | Sepenuhnya | Terhad | | **Pembebasan Pengguna** | Tiada | Tinggi | | **Ketergantungan Vendor** | Tiada | Tinggi | | **Kemampuan Pindahan** | Sepenuhnya | Terhad | ## Contoh Penggunaan Sebenar ### 📚 Pangkalan Pengetahuan Peribadi Sambungkan sistem PKM (Pengurusan Pengetahuan Peribadi) anda di antara: - Desktop rumah untuk kerja mendalam - Laptop untuk sesi di kafe - Tablet untuk membaca dan membuat nota - Telefon untuk merekod cepat ### 👥 Kerjasama Pasukan Kongsi nota kajian dengan selamat dalam pasukan: - Tiada infrastruktur IT diperlukan - Pemindahan enkripsi end-to-end - Semak rekod melalui log pemindahan - Mematuhi peraturan privasi ### 🎓 Penyelidikan Akademik Berkolaborasi dalam kertas kerja dan kajian literatur: - Kongsi PDF dan nota yang diberi nota - Pertahankan sejarah versi secara tempatan - Bekerja antara peranti universiti/personal - Lindungi kajian yang belum diterbitkan ### 🏢 Pelaksanaan Perusahaan Laksanakan Noterich dalam organisasi yang mementingkan privasi: - Tiada data meninggalkan rangkaian syarikat - Berfungsi di belakang firewall dengan konfigurasi - Diintegrasikan dengan polisi keselamatan sedia ada - Mengurangkan kebergantungan pada perkhidmatan cloud ## Analisis Teknikal (Untuk Pembangun) ### Gambaran Keseluruhan Arsitektur ```mermaid graph TB subgraph Sender["Peranti Pengirim"] A1[Data Nota] --> A2[Penyusunan Data MessagePack] A2 --> A3{Dienkripsi?} A3 -->|Ya| A4[Enkripsi AES-256-GCM] A3 -->|Tidak| A5[Binari Biasa] A4 --> A6[Blokkan ke 512KB] A5 --> A6 A6 --> A7[Komunikasi WebRTC Data Channel] end subgraph Penerima["Peranti Penerima"] B1[Komunikasi WebRTC Data Channel] --> B2[Reassemble Blok] B2 --> B3{Dienkripsi?} B3 -->|Ya| B4[Decryption AES-256-GCM] B3 -->|Tidak| B5[Binari Biasa] B4 --> B6[Penyusunan Semula MessagePack] B5 --> B6 B6 --> B7[Pangkalan Data IndexedDB] B7 --> B8[Pembinaan Semula Indeks Carian] end A7 -.->|Sambungan Langsung P2P| B1 style A4 fill:#FF5722,color:#fff style B4 fill:#FF5722,color:#fff style A7 fill:#4CAF50,color:#fff style B1 fill:#4CAF50,color:#fff ``` ### Butiran Penting Pelaksanaan **Konfigurasi Pelayan Isyarat:** ```javascript const peerConfig = { host: 'www.noterich.com', port: 443, secure: true, key: 'peerjs' } ``` **Aliran Enkripsi:** 1. Generakan salji rawak (16 bytes) 2. Generakan IV rawak (12 bytes) 3. Hasilkan kunci menggunakan PBKDF2 (100k iterasi) 4. Enkripsi dengan AES-256-GCM 5. Paket: `{encryptedBuffer, salji, iv}` **Protokol Pemindahan Data:** ```javascript // Jenis mesej yang diurus: { type: 'metadata', payload: {...} } // Senarai nota { type: 'note-chunk', payload: {...} } // Blok data nota { type: 'progress', payload: {...} } // Progresi pemindahan { type: 'complete', payload: {...} } // Pemindahan selesai { type: 'cancel-sync-request' } // Permintaan pembatalan { type: 'error', message: '...' } // Laporan ralat ``` ## Pelan Masa Depan Noterich terus memperbaiki kemampuan P2P: - 🔄 **Sambungan Secara Automatik**: Dapatkan peranti berdekatan dan sambungkan secara senyap - 🌐 **Rangkaian Mesh**: Pemindahan melalui peranti perantara - 📦 **Sambungan Secara Selektif**: Pilih bahagian nota tertentu untuk disambungkan - 🔔 **Notifikasi Push**: Notifikasi apabila permintaan sambungan tiba - 📊 **Analisis Sambungan**: Visualisasikan sejarah sambungan dan data yang dipindahkan - 📦 **Tautan Lanjutan**: Pembahagian nota secara langsung dengan tautan ## Kesimpulan P2P Sync Noterich merupakan perubahan paradigma dalam cara kita memikirkan sambungan nota. Dengan menghilangkan perantara cloud, kita telah mencipta sistem yang menghormati privasi, mengurangkan kos, dan memberikan kawalan penuh ke atas data anda. Sama ada anda seorang pelajar yang mengurus nota kajian, profesional yang mengatur dokumen projek, atau pasukan yang bekerjasama dalam dokumen sensitif, P2P Sync menyediakan keselamatan dan fleksibiliti yang anda perlukan. **Mulakan sambungan yang lebih bijak hari ini — nota anda, peranti anda, kawalan anda.** ---