Skip to content

Docs/comprehensive docs v2#33

Merged
IceDarold merged 30 commits intodocumentationfrom
docs/comprehensive-docs-v2
Feb 9, 2026
Merged

Docs/comprehensive docs v2#33
IceDarold merged 30 commits intodocumentationfrom
docs/comprehensive-docs-v2

Conversation

@IceDarold
Copy link
Owner

No description provided.

IceDarold and others added 29 commits January 27, 2026 12:42
* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation
* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* feat: complete posthog analytics integration with caching, correct query api and documentation

* fix: make configuration fields optional with defaults to fix CI test failures

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* fix: make configuration fields optional with defaults to fix CI test failures

* fix: resolve CI test failures by adding aiosqlite and fixing sqlite engine parameters

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#18)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* feat: complete posthog analytics integration with caching, correct query api and documentation

* fix: make configuration fields optional with defaults to fix CI test failures

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* fix: exclude .venv and .git from production deployment to avoid EOF errors (#21)

* Fix/deployment eof (#22)

* fix: exclude .venv and .git from production deployment to avoid EOF errors

* fix: use explicit file list for deployment SCP to avoid timeouts/EOF on large files

* Fix deploy target path

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
…d reminders, and enhanced Telegram bot user management.
* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#18)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* feat: complete posthog analytics integration with caching, correct query api and documentation

* fix: make configuration fields optional with defaults to fix CI test failures

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* fix: exclude .venv and .git from production deployment to avoid EOF errors

* fix: use explicit file list for deployment SCP to avoid timeouts/EOF on large files

* feat: add analytics proxying, technical monitoring, and investors page API

* Fix: Aggregate hub/category stats, improve Telegram bot UI

* feat: Introduce Weeek integration with new routes, services, scheduled reminders, and enhanced Telegram bot user management.

* Fix weeek connect flow and onboarding tasks

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#18)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* feat: complete posthog analytics integration with caching, correct query api and documentation

* fix: make configuration fields optional with defaults to fix CI test failures

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* fix: exclude .venv and .git from production deployment to avoid EOF errors

* fix: use explicit file list for deployment SCP to avoid timeouts/EOF on large files

* feat: add analytics proxying, technical monitoring, and investors page API

* Fix: Aggregate hub/category stats, improve Telegram bot UI

* feat: Introduce Weeek integration with new routes, services, scheduled reminders, and enhanced Telegram bot user management.

* Add telegram invite flow with mentor assignment

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#18)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* feat: complete posthog analytics integration with caching, correct query api and documentation

* fix: make configuration fields optional with defaults to fix CI test failures

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* fix: exclude .venv and .git from production deployment to avoid EOF errors (#21)

* Fix/deployment eof (#22)

* fix: exclude .venv and .git from production deployment to avoid EOF errors

* fix: use explicit file list for deployment SCP to avoid timeouts/EOF on large files

* Fix deploy target path

* Revert "Fix deploy target path"

This reverts commit b6fc633.

* Add developer onboarding docs

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3b80c1bdcf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +449 to +453
data = await self.redis.get(key)
if data:
workers.append(json.loads(data))
except Exception as e:
logger.error(f"Error fetching workers from Redis: {e}")

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Fix NameError in get_active_workers

The new ParsingRepository.get_active_workers references json and logger, but neither is imported or defined in this module. When /internal/workers calls this method, it will raise a NameError the first time it hits json.loads(...) or the exception handler’s logger.error(...), resulting in a 500 response instead of returning worker data. Add the missing imports (and a logger instance) at the top of app/repositories/parsing.py to avoid the runtime failure.

Useful? React with 👍 / 👎.

…ng conflicts in favor of latest features and revamped docs
@IceDarold IceDarold merged commit fc7765d into documentation Feb 9, 2026
1 check failed
IceDarold added a commit that referenced this pull request Feb 10, 2026
* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* Cleanup/legacy parsing (#6)

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* Docs/parsing guide update (#7)

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: comprehensive update to parsing guide (strategies, yield, advanced routing)

* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#18)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* feat: complete posthog analytics integration with caching, correct query api and documentation

* fix: make configuration fields optional with defaults to fix CI test failures

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* fix: exclude .venv and .git from production deployment to avoid EOF errors

* fix: use explicit file list for deployment SCP to avoid timeouts/EOF on large files

* Remove wildcard branch trigger for docs workflow (#23)

* feat: add analytics proxying, technical monitoring, and investors page API

* Fix: Aggregate hub/category stats, improve Telegram bot UI

* feat: Introduce Weeek integration with new routes, services, scheduled reminders, and enhanced Telegram bot user management.

* Make Weeek workspace check optional if not configured

* fix: resolve alembic conflicts, api attribute errors, and bot connection issues

* docs: add telegram bot guide and update parsing docs

* docs: comprehensive update of documentation structure, onboarding, and technical guides

* Docs/comprehensive docs v2 (#33)

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: u…
TaronAi added a commit that referenced this pull request Feb 19, 2026
* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

* Develop (#17)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/nashi podarki spider (#9)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

* feat: implement nashi podarki spider

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarold@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#16)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* feat: complete posthog analytics integration with caching, correct query api and documentation

---------

Co-authored-by: TaronSeynyan <158126563+TaronAi@users.noreply.github.com>
Co-authored-by: Your Name <your_email@isl.cy>

* Feature/analytics (#18)

* feat: Implement a web parsing system with generic and site-specific product data extraction capabilities.

* feat: implement scalable catalog parsing system with MrGeek support

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* docs: expand parsing guide with discovery strategy and advanced tips

* feat: implement GroupPrice and NashiPodarki spiders with discovery support

* docs: finalize analytics and documentation structure

* Feature/groupprice spider (#8)

* feat: enhance Weeek widget UI with card layout, modal improvements, and loading state

- Redesigned task display with card-based grid layout
- Improved modal window: narrower, taller design with cleaner header
- Added loading spinner during data fetch
- Removed 'All' tab, default to first column
- Fixed HTML rendering issues and ID handling
- Reorganized mkdocs navigation structure
- Enhanced visual hierarchy in task cards and modal

* docs: comprehensive documentation restructure and bilingual support

- Reorganized documentation into clear sections: Architecture, API, Guides
- Added bilingual support (English and Russian) for all major docs
- Created detailed architecture documentation:
  - Parsing system architecture and implementation plan
  - Recommendation system overview
  - Gift query rules and intelligence API
- Added API reference documentation for models, repositories, and services
- Created deployment and development guides
- Added Weeek API integration reference
- Improved navigation structure in mkdocs
- Moved and renamed legacy docs for better organization

* feat: implement parsing infrastructure and Weeek integration

Parsing Infrastructure:
- Add RabbitMQ integration for async task processing
- Implement Scrapy-based parsing service with mrgeek spider
- Create parsing scheduler for automated data collection
- Add ingestion service for processing parsed data
- Create parsing repository and database models
- Add Alembic migration for parsing tables

Weeek Integration:
- Implement Weeek API service for task management
- Add integration routes for Weeek tasks endpoint
- Create setup and cleanup scripts for Weeek data

Infrastructure & Configuration:
- Add RabbitMQ to docker-compose
- Update dependencies in requirements.txt
- Configure new environment variables
- Add GitHub Actions deployment workflow
- Create documentation build script
- Update main app with new routes and services
- Add __init__.py files for new modules

* ci: add GitHub Pages deployment for documentation

- Add GitHub Actions workflow for automatic docs deployment
- Configure MkDocs for GitHub Pages with proper site_url
- Create requirements-docs.txt for documentation dependencies
- Add comprehensive setup guide in docs/README.md

Documentation will be available at:
https://icedarold.github.io/gifty-backend/

* ci: configure custom domain dev.giftyai.ru for documentation

* feat: implement Intelligence API and AI product classification

- Add IntelligenceService for AI-powered gift analysis
- Implement AIClassifier job for automatic product categorization
- Add schemas for intelligence requests and parsing ingestion

* refactor: update routes and final infrastructure cleanup

- Update authentication and recommendation routes
- Sync database models with latest schema changes
- Update README with project status and documentation links
- Include Gemini experiments and debug utilities
- Finalize schema transitions

* cleanup: remove deprecated app/schemas.py in favor of app/schemas/ directory

* ci: implement zero-downtime blue-green deployment

- Add healthchecks to API service in docker-compose.yml
- Use dynamic APP_PORT for parallel service execution
- Add scripts/deploy.sh for seamless switching between ports 8000 and 8001
- Create GitHub Actions workflow for automated production deployment via SSH
- Update Nginx upstream configuration dynamically during deployment

* ci: implement configurable tests and CI pipeline

- Create tests_config.yaml for toggling test groups
- Add tests/conftest.py for dynamic test skipping logic
- Fix Python 3.9 compatibility in test_ranker_v1.py
- Refactor test_recommendations_generate.py for new architecture
- Add pytest.ini to limit test discovery
- Create GitHub Actions workflow for automated testing on push and PR

* docs: add CI/CD and testing guides

- Document Blue-Green deployment strategy and server setup
- Add instructions for GitHub Secrets and CI/CD monitoring
- Document Pytest usage and tests_config.yaml management
- Update architecture overview with Infrastructure & CI/CD section

* ci: unify tests and deployment into a single production workflow

- Updated deploy-prod.yml to include a test job that blocks deployment
- Modified tests.yml to run only on PRs and develop branch
- Ensured zero-downtime deployment is only triggered if all tests pass

* docs: optimize documentation workflow and fix translations

- Restrict automated deployment to 'docs' branch only
- Add pull request build checks for documentation
- Update 'Edit this page' links to point to 'docs' branch
- Complete translations for development guide (RU/EN)
- Fix formatting and missing variables in documentation

* fix: resolve mkdocs-i18n configuration error by switching to mkdocs-static-i18n and dictionary syntax

* chore: rename docs branch to documentation and update CI/CD triggers

* chore: use documentation-main as base branch for docs to avoid git folder conflict

* docs: add pip install to docs.sh helper script

* chore: set documentation as primary branch and docs/* as working branches

* docs: test final branch structure

* fix: use python3 -m pip instead of pip in docs.sh for better compatibility

* fix: revert i18n languages to list format as required by mkdocs-static-i18n

* fix: resolve mkdocs build warnings hindering strict mode

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* fix: resolve mkdocs build warnings hindering strict mode (#4)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* feat: implement AI parsing infrastructure and Kaggle workers

- Added internal API endpoints for category mapping and scoring
- Implemented batch ingestion in Scrapy pipeline
- Created GiftyBaseSpider for standardized parser development
- Added AI worker templates and Kaggle notebooks
- Created local spider testing utility
- Updated parsing architecture documentation

* docs: add guide for creating new parsers

* docs: restructure navigation to group architecture and guides by module

* docs: fix YAML syntax error in mkdocs.yml navigation

* docs: move all navigation sections to the left sidebar (disabled tabs)

* chore: remove legacy parsing prototype and legacy docs

* docs: remove roadmap from parsing documentation

* docs: link Quick Start to dedicated Parsing Guide in architecture docs

* docs: add Grand Unified Theory of Gifting (GUTG) as core recommendation philosophy

* docs: expand GUTG with complete taxonomy (5 dimensions, 30 subtypes, AI cues)

* docs: define Gift Query & Feedback Strategy aligned with GUTG

* docs: expand Gift Query Rules with detailed quiz modules and feedback logic

* docs: finalized Gift Query Rules with full 44-question branching architecture and active learning logic

* fix: resolve mkdocs build warnings hindering strict mode (#5)

- Removed conflicting docs/README.md
- Added weeek_api_reference.md to navigation

* docs: satisfy user request to clarify Aesthetic as both a driver and a filter

* chore: remove parsing_plan.md leftovers

* docs: humanize GUTG descriptions with empathetic explanations and real-world examples

* docs: use storytelling format for The Fanatic description in GUTG

* docs: use narrative style for The Aesthetic in GUTG covering dual role and dark academia

* docs: fix list formatting in GUTG by adding empty lines

* docs: improve navigation by promoting subtypes to H4 headers

* docs: fix markdown rendering by removing indentation from Fanatic and Aesthetic text blocks

* docs: remove numerical prefixes from subtypes in GUTG

* feat: add GroupPrice spider, test script, and Weeek static documentation integration

* chore: update requirements.txt with pika and other installed dependencies

* fix: cleanup requirements.txt to remove local packages and fix install

* feat: implement group price spider and common scraper infrastructure

---------

Co-authored-by: Artyom Konukhov <artemkonuhov008@gmail.com>
Co-authored-by: Artyom Konukhov <93391108+IceDarol…
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants