UI
DirancangReact · TypeScript · Vite
Antaramuka mobile-first untuk borang artifak, dashboard, rekod foto dan navigasi aplikasi.
OCEAN RANGER DIGITAL INITIATIVE · 2026
Rekod bukti.
Lindungi warisan.
AquaArchive ialah konsep aplikasi dokumentasi lapangan yang direka untuk membantu pasukan merekod artifak arkeologi, mengurus bukti fotografi, bekerja ketika tiada internet dan mengekalkan kawalan terhadap data tapak yang sensitif.
Dibentangkan untuk Majlis Tertinggi Ocean Ranger · Dokumen asas v1.0 Draft · 28 Oktober 2026
Digital development partnerWM StudioDesign | Print | Event·Dibangunkan dengan kerjasama WM Studio
FIELD WORKSPACE
Artifact record overviewArtifact recordTemporary tag · TEMP-D1-0042
DRAFTPhoto evidenceOriginal file · SHA-256 check
PENDINGSync queueSaved locally · waiting for connection
OFFLINEField reportProject · date range · source records
DRAFT6Dokumen asas pembangunan
OfflineRekod lapangan dan barisan sync direka untuk sambungan terhad
SHA-256Semakan integriti bukti foto
Role-basedKoordinat tepat dihadkan mengikut kebenaran
01 · Gambaran produk
Apakah sebenarnya AquaArchive?
Ruang kerja digital untuk dokumentasi arkeologi bawah air. Fokusnya bukan sekadar menyimpan gambar, tetapi menghubungkan rekod, konteks lapangan, bukti asal, identiti artifak dan laporan yang boleh dijejaki.
Masalah yang ingin diselesaikan
Rekod yang berselerak antara nota, spreadsheet dan fail foto menyukarkan kesinambungan kerja, semakan bukti dan audit. Sambungan internet di lapangan juga tidak semestinya stabil.
- ✓Satukan metadata artifak, sesi lapangan dan bukti foto.
- ✓Simpan draf secara lokal dan sambung sync apabila tersedia.
- ✓Jejak identiti artifak dan status laporan dengan lebih jelas.
Nilai kepada Ocean Ranger
Menjadi asas dokumentasi yang lebih konsisten untuk aktiviti penyelidikan dan pemeliharaan warisan bawah air, tertakluk kepada pengesahan teknikal, keselamatan dan kelulusan organisasi.
- ✓Rekod lebih tersusun dan boleh disemak.
- ✓Perlindungan koordinat tapak yang sensitif.
- ✓Laluan audit dan pelaporan yang dirancang.
Penting untuk Majlis Tertinggi: halaman ini menerangkan produk dan reka bentuk yang dicadangkan berdasarkan enam dokumen draf. Ia bukan pengesahan bahawa semua fungsi telah siap atau bahawa sistem telah diluluskan untuk operasi sebenar.
02 · Seni bina yang dicadangkan
Ringkas di hadapan. Kawalan ketat di belakang.
Susunan teknologi yang dirancang memisahkan pengalaman pengguna, pintu masuk API, pangkalan data dan simpanan bukti. Pelaksanaan sebenar mesti disahkan terhadap kod, konfigurasi dan polisi semasa.
LAPISAN 01
Web App / PWA
React, TypeScript, Vite. Antara muka mesra telefon, draf lokal dan barisan sync.
LAPISAN 02
Cloudflare Worker
Gerbang API yang dirancang untuk validasi, kawalan akses, had permintaan dan respons selamat.
LAPISAN 03
Supabase
Auth dan PostgreSQL dengan RLS untuk data berstruktur, peranan dan rekod audit.
LAPISAN 04
Storage + R2
Bukti foto asal, laporan dan salinan sandaran objek yang perlu diuji secara berasingan.
Nota: Cloudflare R2 ialah sasaran sandaran objek yang dicadangkan. Sandaran dan kebolehpulihan belum boleh dianggap terbukti sehingga inventori, checksum dan ujian restore terpencil direkodkan.
03 · Status teknologi
Teknologi yang dirancang, dengan status yang jujur.
Senarai ini membezakan keputusan seni bina daripada bukti pelaksanaan. Status di bawah berpandukan dokumen TRD dan IPD v1.0 Draft bertarikh 28 Oktober 2026, bukan pemeriksaan langsung terhadap persekitaran produksi.
Dirancang / ditetapkan dalam seni bina
Sedang dibangunkan
Disahkan dengan bukti
OFF
DirancangPWA · IndexedDB
Menyimpan draf dan barisan penyegerakan secara lokal apabila internet tidak tersedia.
API
DirancangCloudflare Workers
Gerbang API tunggal yang dirancang untuk validasi permintaan, kawalan akses, had permintaan dan respons selamat.
DB
DirancangSupabase Auth · PostgreSQL · RLS
Pengesahan pengguna, rekod berstruktur dan polisi akses mengikut peranan serta projek.
FILE
DirancangSupabase Storage
Storan objek aplikasi untuk bukti foto dan fail yang perlu diurus melalui polisi akses terkawal.
R2
DirancangCloudflare R2
Sasaran salinan sandaran objek yang berasingan untuk foto dan PDF. Sandaran tidak dianggap boleh dipulihkan sehingga ujian restore berjaya.
PDF
DirancangPDF: draf lokal + renderer rasmi
Reka bentuk mencadangkan draf PDF di sisi klien dan laluan berasingan untuk laporan rasmi.
SHA
DirancangSHA-256 · integriti bukti
Checksum dirancang untuk membantu mengesan perubahan pada foto asal dan menjejak status pengesahan.
Tiada komponen ditandakan “Sedang Dibangunkan” atau “Disahkan” buat masa ini kerana bukti khusus yang mencukupi belum ditetapkan dalam dokumen semakan.
Dokumen IPD merekodkan semakan bebas sebagai HOLD, manakala checksum provenance sejarah dan kebolehpulihan backup ialah NOT VERIFIED. Label “Sedang dibangunkan” juga tidak digunakan tanpa bukti kemajuan komponen yang khusus.
03 · Aliran kerja pengguna
Daripada penyelaman kepada rekod yang boleh dijejaki.
Aliran berikut ialah perjalanan logik yang ditakrifkan dalam AFD. Ia perlu dibandingkan dengan aplikasi semasa sebelum dianggap tersedia kepada pengguna.
⌖
1. Rekod artifak
Pengguna membuat draf, memasukkan metadata, menambah tag lapangan dan merekod konteks penemuan.
Client UUIDTemporary tag
▧
2. Simpan bukti
Foto asal disimpan berasingan daripada preview. Checksum dan status upload membantu menjejak integriti bukti.
Original bytesSHA-256
⇅
3. Sync dengan selamat
Jika offline, draf kekal dalam barisan. Apabila tersedia, permintaan dihantar semula menggunakan identiti stabil untuk mengelakkan rekod berganda.
RetryableIdempotent
◈
4. Lindungi lokasi
Maklumat tapak umum dipisahkan daripada koordinat tepat yang hanya boleh dicapai oleh peranan yang dibenarkan.
Role checksRLS
▤
5. Hasilkan laporan
Laporan draf lokal tidak boleh disalah anggap sebagai laporan rasmi. Output rasmi perlu mempunyai sumber dan kawalan akses yang jelas.
Draft / OfficialTraceable
✓
6. Semak dan audit
Uji kebenaran, sync, checksum, migrasi dan pemulihan sebelum sistem dipertimbangkan untuk staging atau operasi.
Evidence-ledApproval gates
04 · Pusat dokumen
Enam dokumen penting. Satu gambaran menyeluruh.
Setiap dokumen menjawab lapisan keputusan yang berbeza. Pilih “Baca ringkasan” untuk melihat kandungan dokumen terus di halaman ini, atau muat turun fail Markdown asal untuk semakan lanjut.
01
DOKUMEN 01
Product Requirements
Apa produk ini, siapa penggunanya, skop MVP, keperluan fungsi dan syarat pelepasan.
02
DOKUMEN 02
Technical Requirements
Seni bina teknologi, keselamatan, aliran offline/sync, bukti foto dan operasi.
03
DOKUMEN 03
Application Flow
Perjalanan pengguna daripada membuka aplikasi hingga rekod artifak, sync dan laporan.
04
DOKUMEN 04
Design Brief
Prinsip UI/UX lapangan, skrin utama, kebolehgunaan, aksesibiliti dan kriteria reka bentuk.
05
DOKUMEN 05
Backend Schema
Model data, identiti artifak, pengasingan koordinat, RLS dan kawalan migrasi.
06
DOKUMEN 06
Implementation Plan
Pelan kerja berperingkat, audit bebas, bukti backup/restore dan gerbang kelulusan.
05 · Tadbir urus & kesiapsiagaan
Keselamatan dan bukti mesti mendahului pelancaran.
Dokumen pelaksanaan merekodkan status semasa sebagai HOLD untuk operasi staging. Showcase ini tidak memberi kuasa untuk migrasi pangkalan data, rollback, reset atau deployment.
GATE 01
Semakan dokumen
Selaraskan PRD, TRD, AFD, DBD, BSD dan IPD dengan kod sumber, SQL dan ADR yang diluluskan.
Menunggu semakanGATE 02
Remediasi & audit bebas
Semak laluan migrasi, RLS, fungsi privileged, koordinat, skrip ujian dan bukti checksum.
HOLD belum dilepaskanGATE 03
Bukti backup & restore
Sahkan database serta objek foto/laporan dan jalankan pemulihan di sasaran terpencil yang boleh dibuang.
Belum disahkanGATE 04
Kelulusan berasingan
Kelulusan migrasi staging dan kelulusan deployment aplikasi ialah dua keputusan yang berasingan.
Perlu kebenaran bertulisStatus yang perlu disebut secara telus: checksum provenance sejarah dan kebolehpulihan backup direkodkan sebagai NOT VERIFIED dalam dokumen. Jangan paparkan “backup selamat” atau “sedia production” tanpa bukti yang boleh diaudit.
06 · Risiko yang perlu diurus
Risiko utama dan respons yang dirancang.
Kebocoran koordinat tepat
Asingkan koordinat, uji akses dibenarkan/tidak dibenarkan dan periksa cache serta log.
Foto asal atau laporan hilang
Jejak inventori objek, checksum, salinan bebas dan hasil ujian restore sebenar.
Migrasi atau deployment tidak sengaja
Satu migrasi bagi setiap gerbang kelulusan, pemeriksaan read-only dan kebenaran bertulis khusus.
Rekod berganda atau konflik
Gunakan client UUID stabil, operasi idempotent dan polisi konflik yang diluluskan.
Draf lokal disalah anggap sebagai backup
Terangkan had browser storage dan bezakan simpanan lokal daripada salinan pelayan/sandaran.
Cadangan dianggap fungsi siap
Label setiap ciri sebagai cadangan, dalam pembangunan atau disahkan hanya berdasarkan bukti semasa.
Keputusan yang diminta daripada Majlis Tertinggi
Terima dokumen ini sebagai asas semakan, tetapkan pemilik keputusan bagi perkara terbuka, dan benarkan audit bebas diteruskan. Jangan anggap halaman ini sebagai kelulusan untuk migrasi atau pelancaran.