Untuk pengembang
Pengembang โ buat aplikasi di VTC
Unduh paket aturan Kursor publik, daftarkan aplikasi di Space Anda sebagai admin, kloning remote Git, dan terapkan ke apps.vtc.com dengan git push normal.
Paket aturan kursor
Repositori publik โ hanya aturan pembuatan aplikasi. Salin ke proyek Anda sebagai .cursor/rules/ (jangan pernah symlink; jangan pernah komit .cursor/ ke repo aplikasi Anda).
git clone https://github.com/vtcdotcom/vtc-app-rules.git ~/vtc-app-rulesgit clone [email protected]:vtcdotcom/vtc-app-rules.git ~/vtc-app-rules~/vtc-app-rules/scripts/copy-cursor-rules.sh /path/to/your-app- Buka Kursor di root folder aplikasi Anda โ satu aplikasi per ruang kerja.
- Minta Kursor untuk mengikuti scaffold-checklist.mdc saat melakukan scaffolding.
- Aplikasi bersama mengisolasi data per Ruang; Aplikasi khusus menggunakan satu database penerbit.
- Tarik pembaruan aturan secara berkala dan jalankan kembali copy-cursor-rules.sh.
Bagaimana cara kerjanya
Anda membangun aplikasi secara lokal dengan Cursor. VTC menghostingnya, memasukkan auth dan platform env saat penerapan, dan menyajikannya dari katalog Space Anda.
- 1
Kloning aturan Kursor
Kloning repositori vtc-app-rules publik (di atas). Ini adalah standar yang diharapkan oleh AI dan pipeline build kami โ auth, file env, shell aplikasi, i18n, dan tata letak penerapan.
- 2
Masuk ke VTC
Gunakan akun dengan akses admin ke Ruang tempat aplikasi akan berada.
https://app.vtc.com - 3
Buat aplikasi di Space Anda
Di dasbor aplikasi, buka Space โ Aplikasi โ Buat. Tetapkan nama aplikasi, nama pendek, penerapan Bersama vs Khusus, dan visibilitas katalog (Ruang, Jaringan, atau Platform).
- 4
Salin jarak jauh Git
Setelah aplikasi dibuat, buka pengaturan pengembangnya dan salin URL Git (SSH atau HTTPS). Jarak jauh itu adalah tempat Anda memasukkan kode โ platform dibangun dan diterapkan pada setiap dorongan.
- 5
Perancah secara lokal di Cursor
Salin aturan ke folder proyek Anda, buka folder itu di Cursor (bukan direktori induk dengan banyak repo), dan scaffold menggunakan scaffold-checklist.mdc. Arahkan repo lokal Anda ke remote Git dari langkah 4.
- 6
Dorong untuk mempublikasikan
Komit dan dorong ke aplikasi jarak jauh. Layanan build menghasilkan gambar atau paket statis Anda dan menyajikannya pada nama host penerbit โ tidak ada langkah penerapan manual.
Pola URL langsung:
https://myapp.apps.vtc.com
Aplikasi Vite statis bisa langsung di-push dan dipublikasikan. Aplikasi Next.js menjalankan kode server, jadi baru bisa di-deploy setelah Space Anda disetujui sebagai developer tepercaya. Untuk mengajukan, kirim email ke [email protected].
Space MCP di Cursor
Hubungkan Cursor (atau Claude / VS Code) ke Ruang yang sudah Anda ikuti. MCP bersifat terikat Ruang โ bukan cara untuk menyambungkan basis data produk eksternal ke VTC.
- 1
Hubungkan
Tambahkan https://mcp.vtc.com/mcp di Cursor Settings โ MCP (konfigurasi di bawah). Klik Connect โ browser terbuka untuk login VTC.
- 2
Masuk dan pilih Ruang
Selesaikan OTP di popup, pilih Ruang Anda, lalu kembali ke Cursor. Klien menyimpan dan menyegarkan token secara otomatis.
- 3
Tanya terhadap Ruang itu
Periksa data aplikasi Shared (list_collections โ sample/find), katalog dan manifest, aksi Guide (list_available_actions โ execute_action), atau usulkan/jalankan alur kerja. Mutasi dan eksekusi alur kerja sungguhan memerlukan confirmation_token yang ditampilkan kepada Anda terlebih dahulu.
{
"mcpServers": {
"vtc-space-db": {
"type": "http",
"url": "https://mcp.vtc.com/mcp"
}
}
}Klien interaktif memakai OAuth Connect (login browser + pemilih Ruang). Agen headless dapat mengirim JWT admin Developer Help sebagai Bearer sebagai gantinya.
- Gerbang peran dan jalur penagihan yang sama dengan Guide di produk, jika berlaku.
- CI / headless: buat JWT admin di Developer Help dan setel Authorization: Bearer <jwt> di header MCP.
- Jangan pernah membuat group_id lain untuk alat DB โ silo-nya hanya Ruang JWT.
Apa yang tercakup dalam peraturan
Otentikasi & Spasi
JWT melalui ?token= dari shell, bootstrap localStorage, dan pelingkupan group_id untuk aplikasi Bersama.
UI & i18n
Shell aplikasi standar, Tailwind v4, warna aksen runtime, dan file lokal sejak hari pertama.
API & data
Rute CRUD, penghapusan sementara, URL berbasis env, dan @posif/sdk untuk akses DB produksi yang disewa.
Menyebarkan
Melakukan .env.production hanya untuk kunci milik aplikasi; platform menyuntikkan URL API, MongoDB, dan identitas saat dibangun.
Buku Besar VTC
EVM tanpa gas yang diizinkan untuk catatan yang tidak dapat diubah, bukti on-chain, dan penandatanganan dompet โ berintegrasi dari aplikasi saat Anda memerlukan penerbitan anti-rusak.
Siap membangun?
Kloning aturannya, buat aplikasi di Space Anda, dan dorong saat Anda siap.