TIMEMARK STUDIO — PANDUAN

APLIKASI
Editor tanggal dan jam pada foto lampiran PDF. Seluruh pengolahan berlangsung
di browser. Tidak ada layanan unggah PDF, akun, API key, atau database.

CARA PAKAI
1. Pilih PDF (maksimum 50 MB). File asli tidak ditimpa.
2. Foto dideteksi otomatis mulai halaman 2, atau halaman 1 untuk PDF satu halaman.
   Jika perlu, ubah halaman awal dan klik Deteksi foto lampiran.
   Deteksi ulang menggantikan semua area pilihan sebelumnya.
3. Isi jam mulai, jam akhir, durasi, dan jeda.
   Durasi tersedia: 10, 20, 30, 40, 45, 60, 120 menit.
   Jeda default 1 menit dan dapat diatur 0–120 menit.
   Jam berikutnya = jam sebelumnya + durasi + jeda.
   Jam akhir adalah batas SELESAI perawatan terakhir, bukan hanya waktu foto.
   00:00 sebagai jam akhir berarti tengah malam setelah hari tersebut.
   Aplikasi tidak melanjutkan otomatis ke hari berikutnya.
4. Pilih Tambahkan jam saja, atau Ganti tanggal + tambahkan jam.
   Penggantian tanggal hanya pada area foto pilihan; tanggal judul/formulir
   tidak ikut berubah. Format pengganti: Selasa, 07 Jul 2026  08:00.
5. Periksa semua area pada pratinjau. Posisi awal disesuaikan dengan PDF contoh
   W11A JAKG. Untuk format lain, klik lalu geser area; tarik sudut kanan bawah
   untuk mengubah ukuran. Ukuran font akan diperkecil bila teks tidak muat.
   Sesuaikan posisi ke foto mengembalikan posisi standar area hasil deteksi.
6. Bila foto tidak terdeteksi (misalnya hasil scan satu halaman penuh), klik
   Tandai area manual lalu tarik kotak tepat di lokasi jam/tanggal. Satu area
   dihitung sebagai satu foto. Pilih area lalu Hapus pilihan untuk membuangnya.
7. Urutan jam mengikuti halaman, lalu posisi awal atas-ke-bawah/kiri-ke-kanan.
   Memindahkan kotak teks tidak mengubah urutan foto. Foto yang dihapus akan
   membuat jam lainnya dihitung ulang. Tombol Lihat membuka halaman foto.
8. Klik Buat PDF hasil, tunggu selesai, lalu klik Simpan PDF.
   Perubahan pengaturan setelah ekspor membatalkan tautan hasil lama: buat ulang.

CATATAN HASIL
- Penggantian tanggal memakai bidang latar untuk menutup teks lama secara visual.
  Pilih latar Gelap atau Putih dan pastikan kotak menutup seluruh tanggal lama.
  Transparan hanya sesuai untuk penambahan jam; tidak menghilangkan tanggal lama.
  Ini bukan alat redaksi/penghapusan data gambar atau pemulihan latar foto.
- Timemark bukan OCR: aplikasi mendeteksi penempatan gambar dalam PDF, bukan
  mengenali tulisan tanggal. Posisi yang berbeda harus dikoreksi manual.
- Pada PDF biasa, isi asli dipertahankan dan timemark ditambahkan sebagai overlay.
- Pada PDF berproteksi internal yang tetap bisa dibuka tanpa password, seperti
  contoh pengguna, ekspor memakai gambar tiap halaman pada skala 2,5x (180 dpi).
  Tampilan dipertahankan, tetapi teks tidak bisa diseleksi, formulir/link tidak
  interaktif, dan ukuran file bisa bertambah. Pesan ini juga muncul di aplikasi.
- PDF yang meminta password tidak didukung. Sediakan salinan yang dapat dibuka.
- Satu PDF diproses setiap kali. Belum mendukung antrean PDF/ZIP atau OCR otomatis.
- Input PDF besar/halaman banyak memerlukan memori dan waktu lebih banyak.
- Gunakan browser desktop modern Chrome, Edge, atau Firefox melalui HTTP/HTTPS.
  Jangan membuka index.html langsung melalui file:// karena modul/worker PDF.
- Seluruh pustaka disertakan lokal. Tidak ada CDN/font/analitik eksternal.

DEPLOY CLOUDFLARE PAGES
Paket ZIP ini berisi index.html pada tingkat teratas, siap Direct Upload.
1. Masuk ke dashboard Cloudflare, buka Workers & Pages.
2. Create application > Pages > Use direct upload (nama menu dapat berubah).
3. Buat nama proyek, unggah ZIP atau folder hasil ekstraksi, lalu deploy.
4. Buka URL pages.dev yang diberikan Cloudflare.
Tidak perlu build command, environment variable, API key, atau database.
Jika memakai integrasi Git, tempatkan isi ZIP pada root repository, gunakan
build command kosong dan output directory sesuai folder aset (root jika
semua file diletakkan di root). Direct Upload adalah cara termudah untuk ZIP ini.
Panduan resmi: https://developers.cloudflare.com/pages/get-started/direct-upload/

MENJALANKAN LOKAL
Ekstrak ZIP, buka terminal di folder index.html:
  python -m http.server 8080
Lalu buka http://localhost:8080

ISI PAKET
index.html       Antarmuka
style.css        Tampilan responsif
app.mjs          Unggah, pratinjau, manipulasi area, ekspor
core.mjs         Perhitungan jadwal dan deteksi posisi foto
render.mjs       Penggambaran timemark dan pembuatan PDF
vendor/          PDF.js 5.6.205, pdf-lib 1.17.1, worker, font, WASM, lisensi
_headers         Header keamanan untuk Cloudflare Pages
PANDUAN.txt      Panduan ini

PENGEMBANGAN
Tidak membutuhkan npm/build. Edit berkas statis lalu unggah ulang.
Pustaka PDF.js dan pdf-lib memiliki lisensi masing-masing di folder vendor.