ai-documentation-generator.js

/**
 * Rahyana AI API - تولیدکننده مستندات هوش مصنوعی
 * 
 * این پروژه یک سیستم کامل برای تولید مستندات با AI شامل:
 * - تولید README خودکار
 * - مستندسازی API
 * - تولید مثال‌های کد
 * - مستندات فنی
 * - راهنمای کاربر
 * - مستندات چندزبانه
 */

// Configuration - supports environment variable or placeholder
const API_KEY = process.env.RAHYANA_API_KEY || 'YOUR_API_KEY_HERE'; // کلید API خود را اینجا قرار دهید یا از متغیر محیطی RAHYANA_API_KEY استفاده کنید
const BASE_URL = process.env.RAHYANA_BASE_URL || 'https://rahyana.ir/api/v1';

class AIDocumentationGenerator {
  constructor(apiKey, baseUrl) {
    this.apiKey = apiKey;
    this.baseUrl = baseUrl;
    this.templates = new Map();
    this.languages = ['fa', 'en', 'ar', 'tr'];
  }

  // تولید README
  async generateReadme(projectInfo) {
    try {
      const prompt = `
      README کامل برای پروژه زیر تولید کنید:
      
      نام پروژه: ${projectInfo.name}
      توضیحات: ${projectInfo.description}
      ویژگی‌ها: ${projectInfo.features.join(', ')}
      تکنولوژی‌ها: ${projectInfo.technologies.join(', ')}
      نصب: ${projectInfo.installation || 'npm install'}
      استفاده: ${projectInfo.usage || 'node index.js'}
      
      README باید شامل:
      1. عنوان و توضیحات جذاب
      2. ویژگی‌های کلیدی
      3. نصب و راه‌اندازی
      4. مثال‌های استفاده
      5. API documentation
      6. مشارکت
      7. مجوز
      8. لینک‌های مفید
      `;

      const response = await fetch(`${this.baseUrl}/chat/completions`, {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json',
          'HTTP-Referer': 'https://ai-docs-app.com',
          'X-Title': 'AI Documentation Generator'
        },
        body: JSON.stringify({
          model: 'openai/gpt-4o',
          messages: [
            {
              role: 'system',
              content: 'شما یک متخصص تولید مستندات فنی و README هستید.'
            },
            {
              role: 'user',
              content: prompt
            }
          ],
          temperature: 0.4,
          max_tokens: 2500
        })
      });

      if (!response.ok) {
        throw new Error(`خطای HTTP! وضعیت: ${response.status}`);
      }

      const data = await response.json();
      return data.choices[0].message.content;
    } catch (error) {
      console.error('خطا در تولید README:', error);
      throw error;
    }
  }

  // مستندسازی API
  async generateApiDocs(apiEndpoints) {
    try {
      const prompt = `
      مستندات API کامل برای endpoint های زیر تولید کنید:
      
      ${JSON.stringify(apiEndpoints, null, 2)}
      
      مستندات شامل:
      1. توضیح کلی API
      2. Authentication
      3. هر endpoint با جزئیات:
         - Method و URL
         - Parameters
         - Request body
         - Response format
         - Error codes
         - مثال‌های کد
      4. Rate limiting
      5. Best practices
      `;

      const response = await fetch(`${this.baseUrl}/chat/completions`, {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json',
          'HTTP-Referer': 'https://ai-docs-app.com',
          'X-Title': 'AI Documentation Generator'
        },
        body: JSON.stringify({
          model: 'openai/gpt-4o',
          messages: [
            {
              role: 'system',
              content: 'شما یک متخصص مستندسازی API و OpenAPI هستید.'
            },
            {
              role: 'user',
              content: prompt
            }
          ],
          temperature: 0.3,
          max_tokens: 3000
        })
      });

      if (!response.ok) {
        throw new Error(`خطای HTTP! وضعیت: ${response.status}`);
      }

      const data = await response.json();
      return data.choices[0].message.content;
    } catch (error) {
      console.error('خطا در تولید مستندات API:', error);
      throw error;
    }
  }

  // تولید مثال‌های کد
  async generateCodeExamples(functions, language = 'javascript') {
    try {
      const prompt = `
      مثال‌های کد ${language} برای توابع زیر تولید کنید:
      
      ${JSON.stringify(functions, null, 2)}
      
      مثال‌ها شامل:
      1. مثال‌های ساده
      2. مثال‌های پیشرفته
      3. Error handling
      4. Best practices
      5. کامنت‌های مفصل
      6. تست‌ها
      `;

      const response = await fetch(`${this.baseUrl}/chat/completions`, {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json',
          'HTTP-Referer': 'https://ai-docs-app.com',
          'X-Title': 'AI Documentation Generator'
        },
        body: JSON.stringify({
          model: 'openai/gpt-4o',
          messages: [
            {
              role: 'system',
              content: 'شما یک متخصص تولید مثال‌های کد و آموزش برنامه‌نویسی هستید.'
            },
            {
              role: 'user',
              content: prompt
            }
          ],
          temperature: 0.5,
          max_tokens: 2000
        })
      });

      if (!response.ok) {
        throw new Error(`خطای HTTP! وضعیت: ${response.status}`);
      }

      const data = await response.json();
      return data.choices[0].message.content;
    } catch (error) {
      console.error('خطا در تولید مثال‌های کد:', error);
      throw error;
    }
  }

  // تولید مستندات چندزبانه
  async generateMultilingualDocs(content, targetLanguage) {
    try {
      const prompt = `
      محتوای زیر را به زبان ${targetLanguage} ترجمه کنید:
      
      ${content}
      
      الزامات:
      1. ترجمه دقیق و طبیعی
      2. حفظ اصطلاحات فنی
      3. فرمت markdown
      4. لینک‌ها و کدها دست نخورده
      5. مناسب برای مخاطب ${targetLanguage}
      `;

      const response = await fetch(`${this.baseUrl}/chat/completions`, {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json',
          'HTTP-Referer': 'https://ai-docs-app.com',
          'X-Title': 'AI Documentation Generator'
        },
        body: JSON.stringify({
          model: 'openai/gpt-4o',
          messages: [
            {
              role: 'system',
              content: `شما یک مترجم متخصص و تولیدکننده مستندات فنی به زبان ${targetLanguage} هستید.`
            },
            {
              role: 'user',
              content: prompt
            }
          ],
          temperature: 0.3,
          max_tokens: 2000
        })
      });

      if (!response.ok) {
        throw new Error(`خطای HTTP! وضعیت: ${response.status}`);
      }

      const data = await response.json();
      return data.choices[0].message.content;
    } catch (error) {
      console.error('خطا در تولید مستندات چندزبانه:', error);
      throw error;
    }
  }

  // تولید راهنمای کاربر
  async generateUserGuide(features, userType = 'beginner') {
    try {
      const prompt = `
      راهنمای کاربر ${userType} برای ویژگی‌های زیر تولید کنید:
      
      ${JSON.stringify(features, null, 2)}
      
      راهنما شامل:
      1. مقدمه و شروع
      2. نصب و راه‌اندازی
      3. آموزش گام به گام
      4. مثال‌های عملی
      5. حل مشکلات رایج
      6. نکات و ترفندها
      7. منابع بیشتر
      `;

      const response = await fetch(`${this.baseUrl}/chat/completions`, {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json',
          'HTTP-Referer': 'https://ai-docs-app.com',
          'X-Title': 'AI Documentation Generator'
        },
        body: JSON.stringify({
          model: 'openai/gpt-4o',
          messages: [
            {
              role: 'system',
              content: `شما یک متخصص تولید راهنمای کاربر برای ${userType} هستید.`
            },
            {
              role: 'user',
              content: prompt
            }
          ],
          temperature: 0.4,
          max_tokens: 2500
        })
      });

      if (!response.ok) {
        throw new Error(`خطای HTTP! وضعیت: ${response.status}`);
      }

      const data = await response.json();
      return data.choices[0].message.content;
    } catch (error) {
      console.error('خطا در تولید راهنمای کاربر:', error);
      throw error;
    }
  }
}

export default AIDocumentationGenerator;