Proyek

Apa & untuk apa

Proyek adalah repositori karya Anda di PSD — tempat menyimpan kode, notebook, skrip, dan dokumen pendukung, mirip repositori di GitHub. Setiap proyek punya halaman detail dengan README, daftar berkas, versi, branch, dan kontributor, sehingga karya Anda mudah dibaca, dijelajahi, dan dipakai ulang oleh orang lain.

Proyek adalah fondasi portofolio sains data: analisis eksplorasi, pipeline kecil, laporan berbasis kode, atau solusi tim bisa semuanya hidup di satu repositori. Anda bisa membuat proyek publik agar ditemukan komunitas, atau privat untuk pekerjaan pribadi atau tim.

Cara kerja

Setiap proyek adalah aset dengan kind="project". Saat proyek dibuat, PSD menyiapkan repositori Git (Gitea) yang terhubung ke akun Anda — satu identitas untuk login PSD dan push kode.

Alur tipikal:

1. Buat proyek (kosong, dari template, atau sebagai template).
2. Isi berkas lewat unggah peramban atau git clone → edit → commit → push.
3. Kelola versi dengan branch dan tag; kolaborator bisa mengirim Pull Request untuk review.
4. Publikasikan README yang jelas agar proyek mudah ditemukan lewat pencarian dan kategori.

Proyek juga bisa dibuat dalam konteks Tim Kolaborasi (aset milik tim) atau dari Ruang Ide (jejak asal ruang tercatat di metadata proyek).

Kapan dipakai

Cocok untuk:

• Menyimpan dan membagikan kode analisis, skrip Python, atau notebook pendukung.
• Membangun portofolio yang bisa dilihat instruktur, rekruter, atau komunitas.
• Kolaborasi berbasis Git: branch eksperimen, review lewat Pull Request, daftar kontributor otomatis.
• Tugas pembelajaran berbasis template (instruktur memberi acuan struktur, Anda mengerjakan salinan).

Kurang tepat bila:

• Anda hanya perlu menyimpan data mentah atau tabel — gunakan Dataset (termasuk SatuDanau).
• Anda ingin melatih dan menerbitkan model ML — gunakan Model atau Ruang Kuantum (QML).
• Anda butuh dashboard analitik — hasil olahan sebaiknya di Ruang Analitik, bukan di repo proyek.

Langkah demi langkah

Membuat proyek baru

1. Buka menu Aset → Proyek, lalu tekan Buat Proyek.
2. Pilih salah satu mode:

• Proyek Kosong — mulai dari nol.
• Dari Template — salin struktur & berkas awal dari template yang sudah ada.
• Sebagai Template — buat proyek yang sekaligus jadi acuan orang lain.

1. Isi nama proyek (dan deskripsi singkat bila diminta).
2. Proyek siap — Anda akan melihat halaman detail dengan tab README, Files, Versi, Branch, dan Kontributor.

Menambah berkas

Opsi A — Unggah dari peramban

1. Buka tab Files di halaman proyek.
2. Unggah berkas yang Anda butuhkan (skrip, notebook, dokumen).
3. Perhatikan batas ukuran unggah sesuai tier Anda (lihat tabel di bawah).

Opsi B — Git (disarankan untuk pengembangan rutin)

1. Di Pengaturan → SSH Keys, tambahkan kunci SSH Anda *(atau buat Personal Access Token untuk HTTPS)*.
2. Salin URL clone dari halaman proyek.
3. Di komputer lokal:

   git clone git@git.<domain-psd>:username/nama-proyek.git
   cd nama-proyek
   # edit berkas...
   git add .
   git commit -m "Deskripsi perubahan"
   git push origin main

Menulis README & metadata

1. Buka tab README dan tulis penjelasan: tujuan proyek, cara menjalankan, dependensi, dan contoh output.
2. Tambahkan kategori/tag agar proyek muncul di filter pencarian.
3. Atur visibilitas (publik/privat) sesuai kebutuhan.

Branch, versi, dan kolaborasi

1. Buat branch baru dari header proyek untuk bereksperimen tanpa mengganggu branch utama.
2. Tandai versi/tag saat mencapai milestone penting.
3. Untuk berkontribusi ke proyek orang lain: fork → buat branch → push → buka Pull Request di PSD.
4. Tab Kontributor menampilkan siapa saja yang commit — termasuk anggota Tim Kolaborasi terkait.

Mengerjakan tugas dari instruktur

1. Dari course Belajar, buka tugas yang ditugaskan.
2. Tekan Mulai — proyek otomatis dibuat dari template tugas.
3. Kerjakan deliverable yang diminta, lalu kumpulkan dari halaman tugas.

Batas tier

Kapasitas proyek mengikuti tier reputasi Anda. Angka berikut ilustratif — angka dapat berubah.

Poin & quest

Quest bertema Proyek:

1. Portofolio Perdana — buat dan publikasikan proyek pertama (+bonus poin).
2. README Rapi — isi README minimal 200 kata dengan penjelasan tujuan & cara pakai.
3. Kolaborator — terima atau kirim Pull Request pertama Anda.
4. Template Master — buat proyek sebagai template dan bagikan ke komunitas.
5. Tugas Selesai — kumpulkan satu tugas course berbasis template tepat waktu.

Masalah umum & solusi

Fitur terkait

• Dataset — simpan data terstruktur & danau data (SatuDanau); fondasi analisis proyek Anda.
• Notebook — tulis & jalankan kode langsung di PSD; hasil bisa di-push ke proyek.
• Tim Kolaborasi — kerja bersama; anggota tim otomatis punya akses repo tim.
• Belajar — tugas berbasis template proyek dari instruktur.
• Kategori — bantu proyek Anda ditemukan lewat tag dan filter penemuan.