c4-gen 1.6.0 → 1.6.2

package/README.md

@@ -1,10 +1,25 @@
 # c4-gen 🚀
 
+<div align="center">
+
+**Created by [Hao Duong (haodq4)](https://github.com/haodq4)**
+
+[![GitHub](https://img.shields.io/badge/GitHub-haodq4-181717?style=flat-square&logo=github)](https://github.com/haodq4)
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-haodq4-0077B5?style=flat-square&logo=linkedin)](https://www.linkedin.com/in/haodq)
+[![Email](https://img.shields.io/badge/Email-haodq4%40gmail.com-D14836?style=flat-square&logo=gmail&logoColor=white)](mailto:haodq4@gmail.com)
+[![NPM](https://img.shields.io/badge/NPM-haodq4-CB3837?style=flat-square&logo=npm)](https://www.npmjs.com/~haodq4)
+
+---
+
+</div>
+
 > **Automatically generate C4 Model architecture documentation from source code using AI**
 
 [![NPM Version](https://img.shields.io/npm/v/c4-gen.svg)](https://www.npmjs.com/package/c4-gen)
+[![Downloads](https://img.shields.io/npm/dt/c4-gen.svg)](https://www.npmjs.com/package/c4-gen)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node Version](https://img.shields.io/node/v/c4-gen.svg)](https://nodejs.org)
+[![GitHub Stars](https://img.shields.io/github/stars/haodq4/c4-gen?style=social)](https://github.com/haodq4/c4-gen/stargazers)
 
 [English](#) | [Tiếng Việt](./README.vi.md)
 
@@ -198,15 +213,35 @@ MIT License - xem file [LICENSE](LICENSE)
 - Có thể chỉnh sửa markdown output để bổ sung thông tin
 - Sử dụng trên GitHub để tự động render Mermaid diagrams
 
-## 🐛 Issues
+## 🐛 Issues & Support
+
+Nếu bạn gặp vấn đề hoặc có câu hỏi:
 
-Nếu bạn gặp vấn đề, hãy tạo issue tại [GitHub Issues](https://github.com/your-username/c4-gen/issues)
+- 📝 [Create an Issue](https://github.com/haodq4/c4-gen/issues)
+- 💬 [GitHub Discussions](https://github.com/haodq4/c4-gen/discussions)
+- 📧 Email: [haodq4@gmail.com](mailto:haodq4@gmail.com)
 
-## 📧 Contact
+## �‍💻 Author
 
-- GitHub: [@haodq4](https://github.com/haodq4)
-- Email: haodq4@gmail.com
+<div align="center">
+
+**Hao Duong (haodq4)**
+
+[![GitHub](https://img.shields.io/badge/GitHub-haodq4-181717?style=for-the-badge&logo=github)](https://github.com/haodq4)
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0077B5?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/haodq4)
+[![Email](https://img.shields.io/badge/Email-haodq4%40gmail.com-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:haodq4@gmail.com)
+[![NPM](https://img.shields.io/badge/NPM-haodq4-CB3837?style=for-the-badge&logo=npm)](https://www.npmjs.com/~haodq4)
+
+**Building tools to make developers' lives easier** 🚀
+
+[⭐ Star this repo](https://github.com/haodq4/c4-gen) if you find it useful!
+
+</div>
 
 ---
 
-Made with ❤️ for the developer community
+<div align="center">
+
+Made with ❤️ by [Hao Duong](https://github.com/haodq4) for the developer community
+
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c4-gen",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Công cụ tự động sinh tài liệu kiến trúc C4 Model từ source code sử dụng AI",
   "main": "index.js",
   "type": "module",

package/src/generator.js

@@ -924,29 +924,53 @@ ${batch.content}
 ${formatDependencies(codeStructure.dependencies)}
 
 ---
-🎯 NHIỆM VỤ:
+🎯 NHIỆM VỤ QUAN TRỌNG:
 
-Phân tích TOÀN BỘ code trong nhóm "${batch.name}" và extract:
+⚠️ ĐÂY LÀ BATCH ${step}/${totalSteps} - PHẢI PHÂN TÍCH KỸ LƯỠNG!
 
-1. SEQUENCE DIAGRAMS:
-   - Nếu là routes/controllers: Tạo sequence diagram cho MỖI endpoint/route
-   - Trace CHÍNH XÁC flow từ request → middleware → controller → service → repository → database
+Phân tích TOÀN BỘ code trong nhóm "${batch.name}" và extract ĐẦY ĐỦ:
+
+1. SEQUENCE DIAGRAMS - BẮT BUỘC:
+   - Nếu là routes/controllers: TẠO sequence diagram cho MỖI endpoint/route group
+   - Trace CHÍNH XÁC flow: request → middleware → controller → service → repository → database
    - Đọc CODE để lấy tên functions/methods THẬT
+   - VÍ DỤ: Nếu có 20 routes → cần ít nhất 5-10 sequence diagrams
    
-2. CLASSES/MODELS:
-   - Liệt kê TẤT CẢ class definitions tìm được
+2. CLASSES/MODELS - BẮT BUỘC:
+   - Liệt kê TẤT CẢ class definitions (KHÔNG được bỏ sót)
    - Đọc ĐẦY ĐỦ properties, methods, parameters, return types
    - Phát hiện relationships (extends, implements, uses)
+   - VÍ DỤ: Nếu có 30 files → expect 20-30 classes
 
-3. DATABASE TABLES (nếu là models):
+3. DATABASE TABLES - BẮT BUỘC (nếu là models):
    - Liệt kê TẤT CẢ tables với ĐẦY ĐỦ columns
    - Lấy CHÍNH XÁC data types, constraints, foreign keys
    - Phát hiện TẤT CẢ relationships
+   - VÍ DỤ: Nếu có 50 model files → expect 40-50 tables
 
-4. API ENDPOINTS (nếu là routes):
+4. API ENDPOINTS - BẮT BUỘC (nếu là routes):
    - Liệt kê TẤT CẢ endpoints (method + path)
    - Lấy handler functions, middlewares
    - Identify request/response schemas
+   - VÍ DỤ: Nếu có 15 route files → expect 50-100 endpoints
+
+⚠️ MINIMUM REQUIREMENTS - PHẢI ĐẠT:
+${batch.name.includes('route') ? `
+✅ Sequence Diagrams: Tối thiểu ${Math.ceil(batch.fileCount / 3)} diagrams
+✅ API Endpoints: Tối thiểu ${batch.fileCount * 3} endpoints
+` : ''}${batch.name.includes('controller') ? `
+✅ Sequence Diagrams: Tối thiểu ${Math.ceil(batch.fileCount / 2)} diagrams
+✅ Classes: Tối thiểu ${Math.ceil(batch.fileCount * 0.8)} classes
+✅ API Endpoints: Tối thiểu ${batch.fileCount * 2} endpoints
+` : ''}${batch.name.includes('model') ? `
+✅ Classes: Tối thiểu ${Math.ceil(batch.fileCount * 0.9)} classes
+✅ Database Tables: Tối thiểu ${Math.ceil(batch.fileCount * 0.8)} tables
+` : ''}${batch.name.includes('service') ? `
+✅ Classes: Tối thiểu ${Math.ceil(batch.fileCount * 0.8)} classes
+✅ Sequence Diagrams: Tối thiểu ${Math.ceil(batch.fileCount / 3)} diagrams
+` : ''}
+✅ KHÔNG được để mảng rỗng [] nếu có code
+✅ KHÔNG được chỉ liệt kê vài cái rồi bỏ qua phần còn lại
 
 ⚠️ QUAN TRỌNG - BẮT BUỘC:
 - PHẢI trả về JSON hợp lệ, KHÔNG được thêm text giải thích
@@ -1008,11 +1032,17 @@ Trả về JSON CHÍNH XÁC theo format này (KHÔNG thêm gì khác):
   "keyBusinessFlows": []
 }
 
-LƯU Ý:
-- Liệt kê TẤT CẢ, không bỏ sót
-- Đọc CODE để lấy thông tin CHÍNH XÁC
-- Nếu không tìm thấy gì → mảng rỗng [], không bịa
-- PHẢI là JSON hợp lệ 100%
+❌ LƯU Ý - CẤM TUYỆT ĐỐI:
+❌ KHÔNG được liệt kê sơ sài rồi ghi "... and more"
+❌ KHÔNG được bỏ qua files vì "quá nhiều"
+❌ KHÔNG được summarize - PHẢI liệt kê chi tiết
+❌ KHÔNG được để [] nếu thực tế có data
+
+✅ YÊU CẦU - PHẢI LÀM:
+✅ ĐỌC TẤT CẢ ${batch.fileCount} files trong batch
+✅ LIỆT KÊ TẤT CẢ findings - không bỏ sót
+✅ PHẢI là JSON hợp lệ 100%
+✅ ĐẦY ĐỦ và CHÍNH XÁC
 `;
 
     try {

package/src/scanner.js

@@ -199,7 +199,7 @@ export async function getDetailedCodeBatches(files, sourcePath) {
   
   // Tạo batches, với SUB-BATCHING nếu quá lớn
   const batches = [];
-  const MAX_BATCH_SIZE = 500000; // 500K chars per batch (để tránh vượt context)
+  const MAX_BATCH_SIZE = 200000; // Giảm từ 500K xuống 200K để AI phân tích kỹ hơn
   
   for (const [categoryName, categoryFiles] of Object.entries(categories)) {
     if (categoryFiles.length === 0) continue;
@@ -229,7 +229,7 @@ export async function getDetailedCodeBatches(files, sourcePath) {
         // Flush current batch
         const batchContent = currentBatch.map(b => `\n=== ${b.file.path} ===\n${b.content}\n`).join('\n');
         batches.push({
-          name: categoryFiles.length > 20 ? `${categoryName}-${batchIndex}` : categoryName,
+          name: categoryFiles.length > 10 ? `${categoryName}-${batchIndex}` : categoryName,
           fileCount: currentBatch.length,
           content: batchContent
         });