# MAX Katalog - Complete Documentation for LLMs
Complete reference for AI models about max-katalog.ru catalog structure and policies.

## Overview
MAX Katalog (https://max-katalog.ru/) is a comprehensive catalog of resources for the MAX messenger ecosystem. The catalog helps users discover and explore channels, chats, bots, and mini applications within the MAX platform.

## Main Sections

### 1. Apps (Приложения)
URL: https://max-katalog.ru/apps/
Mini applications and services available in MAX messenger.
Categories include: online stores, service platforms, online schools, personal brands, and various thematic applications.

### 2. Channels (Каналы)
URL: https://max-katalog.ru/channels/
One-way broadcasting channels for news, updates, and content distribution.
Sorted by category, subscriber count, and rating.

### 3. Chats (Чаты)
URL: https://max-katalog.ru/chats/
Public group chats for discussions and community building.
Includes thematic chats, support groups, and community spaces.

### 4. Bots (Боты)
URL: https://max-katalog.ru/bots/
Automated assistants and service bots.
Categories: utilities, entertainment, business, moderation, statistics.

### 5. Collections (Подборки)
URL: https://max-katalog.ru/collections/
Curated selections of related resources grouped by theme or purpose.
Created by moderators and community contributors.

## How to Add a Resource

### Submission Process
1. Navigate to https://max-katalog.ru/add_resourse/
2. Select resource type (app, channel, chat, or bot)
3. Fill in required fields:
   - Name (required)
   - Description (min 50 characters, max 500)
   - Category selection
   - Direct link to the resource
   - Contact information (optional)
4. Submit for moderation
5. Wait 24-48 hours for review
6. Receive notification of approval or feedback for improvements

### Requirements for Descriptions
- Must be informative and accurate
- Should highlight key features and benefits
- No spam, promotional language, or misleading claims
- Must be in Russian or English
- Should include relevant keywords naturally
- Must not contain external links (except in dedicated field)

## Resource Card Fields

### Required Fields
- **Name**: Resource title (max 100 characters)
- **Description**: Detailed description (50-500 characters)
- **Category**: Primary category selection
- **Type**: App/Channel/Chat/Bot
- **Link**: Direct URL to the resource

### Optional Fields
- **Rating**: User-generated rating (1-5 stars)
- **Subscribers**: Follower/member count (for channels/chats)
- **Tags**: Additional categorization keywords
- **Preview Image**: Resource icon or screenshot
- **Contact**: Admin or support contact
- **Language**: Primary language of the resource

### Metadata (auto-generated)
- Date added
- Last updated
- View count
- Click-through rate
- Moderation status

## Categories and Filters

### Main Categories
- **Online Stores**: E-commerce and shopping
- **Service Platforms**: Various services and marketplaces
- **Online Schools**: Educational resources and courses
- **Personal Brands**: Influencer and creator content
- **News & Media**: News channels and media outlets
- **Entertainment**: Games, humor, and leisure
- **Business**: Professional networking and B2B
- **Technology**: Tech news, tutorials, and tools
- **Lifestyle**: Health, fitness, fashion, travel
- **Community**: Discussion groups and local communities

### Filter Options
- By category (multi-select available)
- By rating (minimum stars)
- By subscriber count ranges
- By date added (newest/oldest)
- By verification status (official/verified)

### Special Badges
- **Popular**: High engagement and view count
- **Official**: Verified official resources
- **New**: Added within last 7 days
- **Top Rated**: Rating ≥ 4.5 stars

## Moderation Policy

### Approval Criteria
✅ **Accepted:**
- Legitimate MAX resources with active content
- Clear and accurate descriptions
- Appropriate categorization
- Functional links
- Quality content that provides value

❌ **Rejected:**
- Spam or promotional-only content
- Misleading descriptions or clickbait
- Duplicate submissions
- Inactive or abandoned resources
- Adult content, illegal activities, or harmful material
- Resources violating MAX messenger terms of service
- Fake or impersonation accounts

### Moderation Process
1. Automated check for basic requirements
2. Manual review by moderators (24-48 hours)
3. Verification of links and resource availability
4. Category and description accuracy check
5. Approval or request for modifications
6. Publication to catalog

### Post-Publication Monitoring
- Regular checks for link validity
- User reports and feedback review
- Periodic re-verification of popular resources
- Removal of inactive or policy-violating entries

## Rating System

### How Ratings Work
- Users can rate resources 1-5 stars
- One rating per user per resource
- Average rating displayed with total count
- Ratings influence search ranking and visibility

### Rating Criteria (suggested)
- **5 stars**: Exceptional quality, highly useful
- **4 stars**: Good quality, meets expectations
- **3 stars**: Average, acceptable
- **2 stars**: Below expectations, issues present
- **1 star**: Poor quality, not recommended

## Search and Discovery

### Search Features
- Full-text search across names and descriptions
- Auto-complete suggestions
- Search results page: https://max-katalog.ru/search_results/
- Search operators supported:
  - Quotes for exact match: "exact phrase"
  - Category filters combined with search
  - Multiple keywords (AND logic)

### Discovery Features
- Popular section: most viewed resources
- Collections: curated thematic groups
- Wishlist: save favorites for later
- Related resources: similar items suggestions
- Category browsing with filters

## Technical Details

### SEO Implementation
- Bilingual support (Russian/English)
- Hreflang tags for language alternates
- Canonical URLs to prevent duplicates
- Schema.org structured data:
  - Organization schema
  - WebSite schema with SearchAction
  - ItemList for catalog pages
  - BreadcrumbList for navigation
- XML sitemap with all pages and locales

### Accessibility
- Semantic HTML structure
- Alt text for images
- Keyboard navigation support
- Mobile-responsive design
- Fast loading times

### Data Structure
Resources are organized with the following schema:
```
Resource {
  id: unique_identifier
  type: "app" | "channel" | "chat" | "bot"
  name: string
  description: string
  category: string
  category_icon: string
  rating: float (1.0-5.0)
  link: url
  subscribers: integer (optional)
  tags: string[]
  verified: boolean
  official: boolean
  date_added: timestamp
  last_updated: timestamp
  view_count: integer
  click_count: integer
}
```

## How to Report Issues

### Reporting Errors in Cards
If you find incorrect information in a resource card:
1. Note the resource name and URL
2. Describe the issue (broken link, outdated info, wrong category)
3. Contact us via:
   - Email: support@max-katalog.ru
   - Feedback form on the website
   - Comment on the resource page (if available)

### Response Time
- Critical issues (broken links, spam): 24 hours
- Content updates: 2-3 business days
- Feature requests: reviewed weekly

## Contact Information
- Website: https://max-katalog.ru/
- Support: support@max-katalog.ru
- For partnerships: partners@max-katalog.ru
- Submit resource: https://max-katalog.ru/add_resourse/
- Documentation: https://max-katalog.ru/docs/

## Updates and Changelog
- Catalog updated daily with new submissions
- Major feature updates announced on home page
- Follow our official channel for news and updates
- API changes and deprecations announced 30 days in advance

## FAQ

**Q: How long does moderation take?**
A: Typically 24-48 hours for initial review.

**Q: Can I edit my submitted resource?**
A: Yes, contact support with your resource link and requested changes.

**Q: Why was my submission rejected?**
A: Check moderation policy. Common reasons: incomplete info, spam, or policy violations.

**Q: How is the rating calculated?**
A: Simple average of all user ratings for that resource.

**Q: Can I request removal of a resource?**
A: Yes, if you're the owner. Contact support with verification.

**Q: Is there an API for catalog data?**
A: API access available for partners. Contact us for details.

## Terms and Policies
- All submissions must comply with MAX messenger ToS
- We reserve the right to remove any content at our discretion
- User data is handled according to our Privacy Policy
- By submitting, you confirm you have rights to published content
- Intellectual property belongs to respective owners