Tentang Aplikasi
Apa yang dikerjakan aplikasi ini, bagaimana dibuat, dan bagaimana diuji.
Keunggulan
Dua metode independen
Use Case Points dan bottom-up dihitung terpisah. Bila sepakat, angkanya lebih dapat dipercaya; bila berbeda, Reviewer Agent memeriksa barisnya.
Setiap angka bisa ditelusuri
Satu baris = satu item WBS untuk satu role, lengkap dengan alasan klasifikasi dan alokasi. Tidak ada angka tanpa asal.
Model menilai, kode menghitung
Model bahasa hanya memilih dari pilihan tertutup dan menjelaskan alasannya. Semua angka berasal dari satu mesin hitung yang deterministik.
Agent yang memeriksa dirinya sendiri
Reviewer Agent mengirim baris yang janggal kembali ke Estimator, maksimal dua putaran, lalu sisanya ditandai untuk manusia.
Tanpa penyimpanan
Tidak ada database dan tidak ada file yang ditulis di server. API key hanya di memori tab. Data pribadi disamarkan sebelum dikirim ke model.
Bebas memilih model
Gemini, Claude, OpenAI, Azure OpenAI, atau endpoint kustom. Ganti penyedia tanpa mengubah kode skill.
Excel yang hidup
File unduhan berisi rumus, bukan angka mati. Reviewer bisa mengubah satu input dan semua total ikut berubah.
Skenario bantuan AI
Augmentation Agent memetakan tugas yang dapat dipercepat AI per capability, terpisah dari angka dasar.
Cara kerja
Langkah 1
Intake Agent
Membaca WBS dan dokumen permintaan
Langkah 2
Estimator Agent
Menilai role, kelas, dan alokasi per item; menghitung
Langkah 3
Reviewer Agent
Membandingkan dua metode; mengirim baris janggal untuk dinilai ulang
Langkah 4
Augmentation Agent
Memetakan peluang bantuan AI per capability
Langkah 5
Report
Menyusun ringkasan, Excel, dan draf pesan
Augmentation berjalan setelah review selesai, jadi tugas AI dipetakan ke baris yang sudah final. Review manusia dilakukan setelah agent selesai: setiap koreksi dihitung ulang tanpa memanggil model.
Stack teknologi
| Agent | Python 3.12, LangGraph Graph berurutan dengan loop review terbatas dan cabang opsional untuk skenario AI |
| Kontrak data | Pydantic v2 Setiap jawaban model divalidasi skema; jawaban tidak valid dicoba ulang dengan pesan galat |
| Model | LangChain chat models Satu antarmuka structured output untuk lima jenis penyedia |
| API | FastAPI di Vercel Python Functions Stateless, streaming progres per agent (NDJSON) |
| Mesin hitung | Python murni Satu sumber kebenaran untuk layar dan Excel |
| Excel | openpyxl Workbook dengan rumus, dihitung ulang Excel saat dibuka |
| Antarmuka | Next.js, React, Tailwind CSS, Recharts Mengikuti 10 heuristik usability Nielsen Norman Group |
| Evaluasi | Kedro Pipeline offline: akurasi per penyedia dan kalibrasi PHM |
| Tooling | uv, Ruff, mypy, pytest, pre-commit Environment identik untuk semua orang; docstring gaya NumPy |
Verifikasi otomatis
Berjalan otomatis di GitHub Actions setiap ada perubahan.
- Ruff lint · Gaya kode, impor, pola bug, docstring NumPy
- Ruff format · Format kode konsisten
- mypy · Kebenaran tipe seluruh package
- pytest + coverage · 23 test unit, integrasi, dan API; coverage 94%
- Uji rumus Excel · LibreOffice menghitung ulang workbook; hasilnya harus sama dengan mesin hitung
- Golden test · Mesin hitung mereproduksi workbook yang dihitung manual pada proyek nyata, sampai 6 desimal
- Pipeline Kedro · Pipeline evaluasi berjalan pada kasus contoh
- Sinkron dependensi · requirements.txt untuk Vercel sama dengan uv.lock
- TypeScript dan build · Antarmuka lolos cek tipe dan build produksi
Kesiapan produksi
Fondasi teknisnya sudah siap untuk pilot. Beberapa langkah berikut perlu diselesaikan sebelum dipakai sebagai sistem produksi organisasi.
Sudah siap
- Arsitektur stateless tanpa penyimpanan data
- CI otomatis untuk setiap push, dengan laporan per pemeriksaan
- Test otomatis untuk mesin hitung, agent, Excel, dan API
- Validasi skema dan batas putaran untuk setiap keputusan model
- Penyamaran data pribadi sebelum dikirim ke model
- Dokumentasi analisis dan desain lengkap dengan diagram dan ADR
Sebelum produksi
- Uji dengan model nyataJalankan pada beberapa proyek dengan tiap penyedia yang akan dipakai dan bandingkan dengan keputusan reviewer.
- Kalibrasi PHMNilai bawaan 15 diambil dari batas bawah literatur. Kalibrasi dengan pipeline Kedro pada beberapa proyek yang sudah direview.
- AutentikasiAktifkan perlindungan deployment atau SSO organisasi agar hanya pengguna berwenang yang bisa membuka aplikasi.
- Persetujuan keamanan dataPastikan penyedia model dan region pemrosesan disetujui untuk jenis dokumen yang diunggah.
- ObservabilitasTambahkan pemantauan galat dan latensi tanpa mencatat isi dokumen atau key.
- Pembatasan pemakaianBatasi jumlah run per pengguna untuk mencegah penyalahgunaan endpoint.