Seri Qoder CN:Praktik terbaik untuk peningkatan penyelesaian kode enterprise

Panduan untuk memilih dan menyiapkan repositori kode

Bagian berikut menjelaskan cara menyiapkan repositori kode dalam dua skenario berbeda:

• Skenario 1: Pengembangan rekayasa harian — tingkatkan efisiensi R&D. Dalam pengembangan enterprise, Anda dapat menggunakan beberapa repositori kode untuk mendukung augmentasi pengambilan, yang meningkatkan penggunaan ulang kode dan efisiensi pengembangan. Berikut adalah cara utama memilih repositori kode:

• Skenario 2: Skenario bisnis spesifik — pastikan konsistensi kode dan kurangi pengembangan berulang. Dalam pengembangan aplikasi enterprise, beberapa logika bisnis harus tetap konsisten untuk memastikan stabilitas dan kemudahan pemeliharaan sistem. Tanpa standar terpadu, developer berbeda mungkin menerapkan implementasi berbeda, yang menyebabkan ketidakkonsistenan logika bisnis, pemeliharaan kode yang lebih kompleks, dan potensi masalah stabilitas sistem.

/**
 * Gunakan framework kunci terdistribusi yang dikembangkan enterprise untuk kontrol konkurensi
 */
@Service
public class InventoryService {

    @Autowired
    private DistributedLockFramework lockFramework;

    @Autowired
    private InventoryRepository inventoryRepository;

    /**
     * Kurangi inventaris. Gunakan kunci terdistribusi untuk memastikan keamanan konkurensi.
     * @param productId ID produk.
     * @param quantity Jumlah yang akan dikurangi.
     * @return Apakah pengurangan berhasil.
     */
    public boolean deductInventory(Long productId, int quantity) {
        String lockKey = "inventory:" + productId;
        return lockFramework.withLock(lockKey, 30, TimeUnit.SECONDS, () -> {
            Inventory inventory = inventoryRepository.findByProductId(productId);
            if (inventory == null || inventory.getQuantity() < quantity) {
                return false;
            }
            inventory.setQuantity(inventory.getQuantity() - quantity);
            inventoryRepository.save(inventory);
            return true;
        });
    }
}

/**
 * Layanan mesin rekomendasi
 * Mengimplementasikan mekanisme rekomendasi personalisasi berdasarkan perilaku pengguna dan fitur komoditas
 */
@Service
public class RecommendationService {

    @Autowired
    private UserBehaviorRepository userBehaviorRepo;

    @Autowired
    private ProductRepository productRepo;

    /**
     * Hasilkan daftar rekomendasi personalisasi untuk pengguna tertentu
     * @param userId ID pengguna.
     * @param limit Jumlah rekomendasi.
     * @return Daftar ID komoditas yang direkomendasikan.
     */
    public List<Long> generateRecommendations(Long userId, int limit) {
        // Peroleh data perilaku pengguna
        List<UserBehavior> behaviors = userBehaviorRepo.findRecentByUserId(userId, 100);

        // Ekstraksi fitur minat pengguna
        Map<String, Double> userInterests = extractUserInterests(behaviors);

        // Peroleh kumpulan kandidat komoditas
        List<Product> candidateProducts = productRepo.findRecentlyActive(1000);

        // Beri skor dan urutkan komoditas
        List<ScoredProduct> scoredProducts = candidateProducts.stream()
            .map(product -> new ScoredProduct(product, calculateScore(product, userInterests)))
            .sorted(Comparator.comparing(ScoredProduct::getScore).reversed())
            .collect(Collectors.toList());

        // Kembalikan komoditas dengan skor tertinggi
        return scoredProducts.stream()
            .limit(limit)
            .map(sp -> sp.getProduct().getId())
            .collect(Collectors.toList());
    }

    // Metode bantu lainnya...
}

Spesifikasi file kode

• Bahasa dan framework yang didukung:

  • Backend: Java, C#, C/C++, Go, Python.

  • Frontend: JavaScript, TypeScript, Vue, React.

• Batas unggah: Hanya file kode sumber yang diterima. Repositori kode harus hanya berisi file kode sumber yang benar-benar ditulis. Misalnya, unggah file .java untuk Java, file .cs untuk C#, dan file .js atau .jsx untuk JavaScript.

• Hindari mengunggah konten berikut:

  • Data dan kode pengujian: Jangan unggah skrip pengujian, kasus uji, atau kode terkait pengujian apa pun yang tidak berisi logika bisnis.

  • Metode mock: Kecualikan semua kode yang dihasilkan oleh metode dan alat mock, kecuali kode tersebut berisi implementasi spesifik logika bisnis.

  • Artefak build:

    • Frontend: Kecualikan file yang dihasilkan oleh alat build seperti Webpack dan Gulp. File-file ini biasanya berada di direktori dist atau build.

    • Backend: Kecualikan file DLL terkompilasi dan semua output kompilasi lainnya.

• Persyaratan komentar:

  • Tambahkan komentar detail di header setiap fungsi yang ingin diambil.

  • Komentar harus memberikan informasi cukup untuk membedakan fungsi berbeda. Rujuk templat komentar atau sesuaikan komentar sesuai spesifikasi enterprise Anda.

/**
 * Perbarui status pesanan tertentu.
 *
 * @param orderId Pengidentifikasi unik pesanan.
 * @param newStatus Status pesanan baru.
 * @return boolean Menunjukkan apakah pembaruan berhasil.
 */

• Persyaratan penamaan fungsi:

  • Jika komentar fungsi singkat, nama fungsi harus secara akurat menggambarkan fungsinya.

  • Gunakan nama yang jelas dan deskriptif, seperti exportOrdersToPDF dan updateOrderStatus, bukan func1.

Panduan unggah

• Paket file terkompresi: Paket file kode ke dalam format .zip, .gz, atau .tar.gz.

• Batas ukuran paket kode: Setiap paket kode tidak boleh melebihi 100 MB.

Praktik terbaik backend

Hasilkan kode dari komentar bahasa alami

• Unggah kode ke repositori kode enterprise: Unggah paket terkompresi yang berisi kode fungsi yang diperlukan ke repositori kode enterprise, misalnya kode algoritma Snowflake, dan pastikan fungsi target mengikuti spesifikasi komentar dengan komentar ditempatkan di header fungsi. Untuk informasi lebih lanjut tentang menyiapkan repositori kode, lihat Cara administrator menyiapkan repositori kode enterprise berkualitas tinggi.

/**
 * Gunakan algoritma Snowflake untuk menghasilkan nomor seri unik
 * @param workerId
 * @return
*/
public synchronized Long getSnowFlowerId(long workerId){
 long id = -1L;

 if (workerId < 0 || workerId > snowFlowerProperties.getMaxWorkerId()) {
    throw new IllegalArgumentException(
      String.valueOf("workerID must gte 0 and lte " + snowFlowerProperties.getMaxWorkerId()));
 }

 // ... kode implementasi algoritma ...

return id;
}

• Masukkan komentar: Di IDE, buka kelas Java dan masukkan komentar yang sesuai dengan fungsi yang ingin diambil. Format komentar bisa fleksibel, tetapi pastikan maknanya akurat dan konsisten.

//Harap hasilkan kode yang menggunakan algoritma Snowflake untuk menghasilkan ID unik dan kembalikan ID yang dihasilkan

/**
 * Gunakan algoritma Snowflake untuk menghasilkan nomor seri unik
 * @param wId
 * @return
*/

Persyaratan komentar:

• Panjang komentar: Hindari komentar yang terlalu singkat saat menulis kode. Gunakan minimal 15 karakter. Komentar yang terlalu pendek tidak dapat memicu pengambilan.

• Semantik komentar: Pastikan semantik komentar akurat dan bermakna. Sertakan kata kunci dan deskripsi nilai kembali bila memungkinkan, sehingga Qoder CN dapat memahami dan mencocokkan kode yang sesuai secara akurat.

• Dukungan multi-bahasa: Komentar dalam bahasa Mandarin dan Inggris didukung. Komentar di repositori kode dan komentar yang digunakan selama pengkodean aktual dapat dalam bahasa berbeda.

• Fleksibilitas nama parameter: Nama parameter dapat ditangani secara fleksibel. Qoder CN secara otomatis menyesuaikan dengan parameter yang diberikan untuk mencocokkan kode yang diambil. Berikut adalah contoh negatif:

  • //Algoritma Snowflake — Masalah: Informasi yang diberikan tidak cukup, dan komentar terlalu pendek.

  • //Hasilkan nomor seri unik — Masalah: Tidak ada kata kunci spesifik yang digunakan, yang dapat memengaruhi pemahaman dan pencocokan.

• Pembuatan kode: Setelah Anda menekan Enter pertama kali, Qoder CN memberikan saran penyelesaian yang dihasilkan dari komentar. Setelah Anda menekan Enter lagi, Qoder CN menyelesaikan kode berdasarkan kode di repositori kode enterprise.

/**
 * Gunakan algoritma Snowflake untuk menghasilkan nomor seri unik
 * @param workerId
 * @return
 */
public synchronized Long get(long workerId) {
    long id = -1L;
    if (workerId < 0 || workerId > snowFlowerProperties.getMaxWorkerId()) {
        throw new IllegalArgumentException(
                String.valueOf("workerID must gte 0 and lte " + snowFlowerProperties.getMaxWorkerId()));
    }
    long timestamp = timeGen();
    if (timestamp < lastTimestamp) {
        long refusedSeconds = (lastTimestamp - timestamp) / 1000;
        throw new RuntimeException(
                String.valueOf("Clock moved backwards. Refusing for " + refusedSeconds + " seconds"));
    }
    if (lastTimestamp == timestamp) {
        // Dalam milidetik yang sama, nomor urutan dinaikkan
        sequence = (sequence + 1) & snowFlowerProperties.getSequenceMask();
        if (sequence == 0) {
            // Jumlah maksimum nomor urutan dalam milidetik yang sama telah tercapai
            timestamp = tilNextMillis(lastTimestamp);
        }
    } else {
        // Dalam milidetik berbeda, nomor urutan diatur ke 0
        sequence = 0L;
    }
    lastTimestamp = timestamp;
    // Bagian timestamp
    id = (timestamp - snowFlowerProperties.getTwepoch()) << snowFlowerProperties.getTimestampLeftShift();
    // Bagian pengidentifikasi pekerja
    id |= (workerId << snowFlowerProperties.getWorkerIdShift());
    // Bagian nomor urutan
    id |= sequence;
    return id;
}

• Jika komentar Anda berisi parameter, Qoder CN secara otomatis menyesuaikan parameter dalam kode yang dihasilkan untuk memastikan konsistensi penamaan.

• Untuk menyegarkan cache dan mendapatkan saran penyelesaian baru, tekan ⌥(option) + P di macOS atau Alt + P di Windows untuk memicu penyelesaian inline secara manual.

Hasilkan kode dari signature fungsi

• Unggah kode ke repositori kode: Unggah paket terkompresi yang berisi kode fungsi yang diperlukan ke repositori kode enterprise, dan pastikan fungsi-fungsi ini memiliki pengidentifikasi yang jelas dan unik untuk pengambilan dan pengenalan. Untuk informasi lebih lanjut tentang menyiapkan repositori kode, lihat Cara administrator menyiapkan repositori kode enterprise berkualitas tinggi.

• Masukkan signature fungsi: Di IDE, buka kelas Java dan masukkan signature fungsi target. Nama parameter dapat ditangani secara fleksibel. Qoder CN secara otomatis menyesuaikan dengan parameter yang diberikan untuk mencocokkan kode yang diambil.

public List<Object> nextList(String name, int size)

Persyaratan signature fungsi:

• Nama fungsi: Gunakan nama fungsi yang jelas dengan semantik cukup untuk menjadi dasar pencocokan kemiripan.

• Parameter dan nilai kembali: Jenis dan urutannya harus sesuai dengan fungsi target, tetapi nama parameter dapat ditangani secara fleksibel. Qoder CN secara otomatis menyesuaikan dengan parameter yang diberikan untuk mencocokkan kode yang diambil. Berikut adalah contoh negatif:

  • public List<Object> func1(String name, int size) — Masalah: Nama fungsi memiliki semantik tidak jelas dan tidak dapat secara akurat mencerminkan fungsinya.

  • public List<String> nextList(int orderId) — Masalah: Jenis parameter dan jenis nilai kembali tidak sesuai dengan fungsi target.

• Saran penyelesaian: Setelah Anda menekan Enter pertama kali, Qoder CN memberikan saran penyelesaian kode. Setelah Anda menekan Enter lagi, Qoder CN secara otomatis menyelesaikan kode berdasarkan kode di repositori kode enterprise.

• Qoder CN secara otomatis menyesuaikan nama parameter dalam kode yang dihasilkan berdasarkan nama parameter yang Anda berikan, untuk memastikan konsistensi penamaan.

• Untuk menyegarkan cache dan mendapatkan saran penyelesaian baru, tekan ⌥(option) + P di macOS atau Alt + P di Windows untuk memicu penyelesaian inline secara manual.

Praktik terbaik frontend

Lengkapi kode komponen kustom frontend dari tag

• Unggah kode ke repositori kode: Sebelum memulai, pastikan semua kode komponen frontend yang diperlukan telah diunggah ke repositori kode enterprise. Berikut adalah contoh framework React:

<LTable
      isReady={isReady}
      formInitialValues={formInitialValues}
      rowKey="key"
      tableRef={tableRef}
      toolbarLeft={
          <Button type="primary">Add</Button>
      }
      formItems={formItems}
      formRef={formRef}
      columns={columns}
      request={async (params, requestType) => {
        const res: Record<string, any> = await apiGetUserList(params);
        return {
          data: res.data,
          total: res.total,
        };
      }}
/>

• Tulis kode komponen: Buka file .jsx yang sesuai di IDE Anda dan mulai menulis kode. Masukkan tag HTML dasar atau tag komponen kustom, seperti <LTable />.

• Penyelesaian kode otomatis: Saat kode yang Anda masukkan mencapai panjang tertentu dan sesuai dengan kode di pustaka komponen enterprise, IDE secara otomatis memicu penyelesaian kode dan menghasilkan kode komponen lengkap. Anda juga dapat menekan Enter untuk memicu penyelesaian kode secara manual.

Picu penyelesaian di dalam tag komponen lengkap.

Hasilkan kode dari komentar bahasa alami

• Unggah kode ke repositori kode: Unggah paket terkompresi yang berisi kode fungsi yang diperlukan ke repositori kode enterprise, dan pastikan setiap fungsi mengikuti spesifikasi komentar dengan komentar ditempatkan di header fungsi. Untuk informasi lebih lanjut tentang menyiapkan repositori kode, lihat Cara administrator menyiapkan repositori kode enterprise berkualitas tinggi. Berikut adalah contoh JavaScript:

/**
 * Hasilkan objek yang diindeks berdasarkan id berdasarkan pesan error
 * @param {Array<validator,Result>} results
 * @return {Record<string,string>}
*/
function getErrObj(results) {
  // ... kode implementasi fungsi ...
}

• Masukkan komentar: Di IDE, masukkan konten komentar spesifik dalam file JavaScript, seperti pada contoh berikut:

//Hasilkan objek yang diindeks berdasarkan id berdasarkan pesan error

Persyaratan komentar:

• Panjang komentar: Hindari komentar yang terlalu singkat saat menulis kode. Gunakan minimal 15 karakter. Komentar yang terlalu pendek tidak dapat memicu pengambilan.

• Semantik komentar: Pastikan semantik komentar akurat dan bermakna. Sertakan kata kunci dan deskripsi nilai kembali bila memungkinkan, sehingga Qoder CN dapat memahami dan mencocokkan kode yang sesuai secara akurat.

• Dukungan multi-bahasa: Komentar dalam bahasa Mandarin dan Inggris didukung. Komentar di repositori kode dan komentar yang digunakan selama pengkodean aktual dapat dalam bahasa berbeda.

• Fleksibilitas nama parameter: Nama parameter dapat ditangani secara fleksibel. Qoder CN secara otomatis menyesuaikan dengan parameter yang diberikan untuk mencocokkan kode yang diambil.

• Pembuatan kode: Setelah Anda menekan Enter pertama kali, Qoder CN memberikan saran penyelesaian yang dihasilkan dari komentar. Setelah Anda menekan Enter lagi, Qoder CN menyelesaikan kode berdasarkan kode di repositori kode enterprise.

//Hasilkan objek yang diindeks berdasarkan id berdasarkan pesan error
export function getErrObj(results) {
    if (!results || results.length <= 0) return {};

    const obj = {};
    for (let i = 0; i < results.length; i++) {
        const result = results[i];
        if (result.ok === false) {
            obj[result.id] = result.msg || '';
        }
    }
    return obj;
}

• Jika komentar Anda berisi parameter, Qoder CN secara otomatis menyesuaikan nama parameter dalam kode yang dihasilkan untuk memastikan konsistensi penamaan.

• Untuk menyegarkan cache dan mendapatkan saran penyelesaian baru, tekan ⌥(option) + P di macOS atau Alt + P di Windows untuk memicu penyelesaian inline secara manual.

FAQ

Setelah instalasi ulang, kode di basis pengetahuan masih tidak dapat diambil, bahkan setelah Anda restart IDE atau login kembali.

Solusi:

• Di macOS, jalankan perintah berikut untuk restart proses dan membersihkan cache:

  ps -ef|grep lingma|grep start|awk '{print $2}'|xargs -I {} kill -9 {}

• Di Windows, hentikan proses Qoder CN di Task Manager.