2026-03-22
Git 6cd2c76
Giai đoạn phát triển đầu tiên có ý nghĩa
Flashcard, lưu trữ Hive và text-to-speech hình thành vòng lặp học tập đầu tiên.
Engineering case study · Evidence pack
FM Dictionary.
Một case study dựa trên bằng chứng về ứng dụng Flutter giúp học thuật ngữ Facilities Management — từ learning core local-first đến các ranh giới cloud và speech.
1,847
Thuật ngữ hiện tại
50
Bộ test bundled
27
Flutter tests đã ghi nhận
1.1.0+9
App version
Timeline đã kiểm chứng
Không biến Git history thành marketing copy
2026-05-19
Git a6b69ed
Kiến trúc speech được thay đổi
Kế hoạch Whisper local được chuyển sang các speech API online sau ranh giới proxy.
2026-05-31
Git tag v1.0.0
Tag release đầu tiên
Repository ghi nhận tag release ứng dụng đầu tiên.
2026-06-05
Git tag v1.1.0
Mốc social learning
Leaderboard nhóm toàn cục và các bản sửa UI được đưa vào tag ứng dụng mới nhất.
2026-09-06
Phase 2 baseline f59332b
Hoàn tất production cleanup
Hoàn tất canonicalization và cleanup; Phase 3 chỉ bổ sung tài liệu.
Vai trò thực tế
Product owner, maintainer và AI-assisted engineering
Vai trò bao gồm định nghĩa vấn đề, yêu cầu, quyết định UX/product, điều phối AI agents, manual testing, acceptance và quyết định release. Repository không được dùng để suy diễn rằng maintainer tự tay viết hoặc thiết kế mọi dòng code.
Architecture exploration
Refactoring
Automated tests
Debugging & audits
Kiến trúc
Ranh giới rõ ràng thay cho claim tuyệt đối
Local
Hive, SharedPreferences và bundled JSON phục vụ các luồng học cốt lõi.
Firebase
Auth, Firestore progress sync và RTDB social data có các boundary riêng.
Cloudflare
Authenticated proxy, rate limit và provider fallback cho speech/content requests.
Engineering areas
Những phần đáng nói trong codebase
Dữ liệu học local-first
CODE VERIFIEDTừ điển và bộ test được import vào Hive. Tra cứu, từ đã lưu, quiz, test và phần lớn progress có local path.
Thay thế content an toàn
CODE + TEST VERIFIEDBản cập nhật validate ID, lưu backup, thay Hive box và khôi phục từ điển cũ nếu một bước thất bại.
Ranh giới local và cloud
CODE VERIFIED / PARTIALFirebase Auth, Firestore progress sync và RTDB social data phục vụ các luồng khác nhau; boundary hiện tại không được trình bày như social backend hoàn toàn authoritative.
Phản hồi phát âm
CODE + TEST VERIFIEDAudio WAV tạm thời đi qua authenticated proxy, sau đó transcript được chấm local bằng rule-based scorer.
Claim boundary
Nói chính xác cũng là một feature
Có thể nói
- Ứng dụng Flutter giúp học thuật ngữ Facility Management.
- Snapshot hiện tại chứa 1.847 thuật ngữ và 50 item test.
- Ứng dụng kết hợp speech-to-text fallback bên ngoài với rule-based pronunciation scorer local.
Không nên nói
- Đã public trên App Store, Google Play hoặc TestFlight khi chưa có store evidence.
- Full offline-first, local storage mã hóa hoặc privacy tuyệt đối.
- Private groups authoritative, production scale hoặc generic AI assistant đang active.
FM Dictionary