{"id":48136186,"url":"https://github.com/zamik36/glinka","last_synced_at":"2026-04-04T16:46:47.542Z","repository":{"id":341473335,"uuid":"1170239644","full_name":"zamik36/glinka","owner":"zamik36","description":"TG bot for help with study and planning","archived":false,"fork":false,"pushed_at":"2026-03-18T15:15:22.000Z","size":320,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-19T05:41:41.716Z","etag":null,"topics":["bot","planer","telegram"],"latest_commit_sha":null,"homepage":"https://t.me/glinka_hw_bot","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zamik36.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-01T22:26:54.000Z","updated_at":"2026-03-14T22:11:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zamik36/glinka","commit_stats":null,"previous_names":["zamik36/glinka"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zamik36/glinka","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zamik36%2Fglinka","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zamik36%2Fglinka/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zamik36%2Fglinka/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zamik36%2Fglinka/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zamik36","download_url":"https://codeload.github.com/zamik36/glinka/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zamik36%2Fglinka/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31406005,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","planer","telegram"],"created_at":"2026-04-04T16:46:46.691Z","updated_at":"2026-04-04T16:46:47.521Z","avatar_url":"https://github.com/zamik36.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Glinka — трекер домашних заданий\n\nTelegram Mini App для студентов: создавай задачи с дедлайнами, прикрепляй файлы и получай напоминания прямо в Telegram.\n\n## Возможности\n\n- **Задачи с дедлайнами** — создание, редактирование, отметка выполнения\n- **Напоминания** — автоматические (за 2 дня и за 1 день) или пользовательские, приходят в Telegram\n- **Файлы** — до 5 вложений на задачу (фото, PDF, документы, архивы)\n- **Календарь** — визуализация дедлайнов по дням с цветовой индикацией\n- **Мгновенная доставка** — PostgreSQL LISTEN/NOTIFY для push-уведомлений с минимальной задержкой\n- **Мониторинг** — Prometheus + Grafana + Loki из коробки\n\n## Стек технологий\n\n| Слой | Технологии |\n|------|-----------|\n| Backend | Python 3.14, FastAPI, SQLAlchemy 2.0, asyncpg, aiogram |\n| Frontend | React 19, TypeScript 5.9, Vite 8, Tailwind CSS 4, Framer Motion |\n| БД | PostgreSQL 16, Alembic (миграции) |\n| Сервер | Granian (ASGI), Caddy (reverse proxy + TLS) |\n| Мониторинг | Prometheus, Grafana, Loki, Promtail |\n| CI/CD | GitHub Actions, Docker Compose |\n| Пакетные менеджеры | uv (backend), npm (frontend) |\n\n## Быстрый старт\n\n### Docker (рекомендуется)\n\n```bash\n# 1. Клонировать репозиторий\ngit clone https://github.com/your-username/glinka.git\ncd glinka\n\n# 2. Настроить переменные окружения\ncp .env.example .env\n# Заполнить .env: BOT_TOKEN, POSTGRES_USER, POSTGRES_PASSWORD и т.д.\n\n# 3. Создать внешнюю сеть (если ещё нет)\ndocker network create web\n\n# 4. Собрать и запустить\ndocker compose build\ndocker compose run --rm migrate\ndocker compose up -d\n```\n\nПриложение будет доступно на портах 80/443 через Caddy.\n\n### Локальная разработка (без Docker)\n\nПотребуется: Python \u003e= 3.13, Node.js \u003e= 20, PostgreSQL 16.\n\n```bash\n# Backend\nuv sync --group dev\ncp .env.example .env  # заполнить переменные\nuv run alembic upgrade head\nuv run python main_api.py\n\n# Frontend (в отдельном терминале)\ncd frontend\nnpm install\nnpm run dev\n```\n\nBackend запустится на `http://localhost:8000`, frontend — на `http://localhost:5173`.\n\n## Разработка\n\n### Backend\n\n```bash\nuv sync --group dev              # установить зависимости\nuv run python main_api.py        # запустить API-сервер\nuv run python -m app.worker.main # запустить воркер уведомлений\nuv run ty check app/             # проверка типов\n```\n\n### Frontend\n\n```bash\ncd frontend\nnpm install       # установить зависимости\nnpm run dev       # dev-сервер с HMR\nnpm run build     # production-сборка\nnpm run lint      # линтинг\n```\n\n### Миграции БД\n\n```bash\nuv run alembic upgrade head          # применить все миграции\nuv run alembic revision --autogenerate -m \"описание\"  # создать миграцию\n```\n\n## Тестирование\n\n```bash\nuv run pytest -v --cov=app                  # все тесты с покрытием\nuv run pytest tests/test_api.py             # тесты API\nuv run pytest tests/test_task_service.py    # тесты бизнес-логики\nuv run pytest -k \"test_name\"               # конкретный тест\n```\n\nТесты используют in-memory SQLite через `aiosqlite` — PostgreSQL для запуска не нужен.\n\n## CI/CD\n\nGitHub Actions запускается на push в `main`/`dev` и на pull request:\n\n1. **Аудит зависимостей** — `pip-audit` на известные уязвимости\n2. **Проверка типов** — `ty check app/`\n3. **Миграции** — `alembic upgrade head` на тестовой БД\n4. **Тесты** — `pytest` с отчётом о покрытии\n\nПри push в `main` — автодеплой на VPS (build → migrate → up).\nПри push в `dev` — деплой на staging-окружение.\n\n## Структура проекта\n\n```\nglinka/\n├── app/\n│   ├── domain/           # Сущности и интерфейсы (без внешних зависимостей)\n│   ├── application/      # Бизнес-логика (TaskService)\n│   ├── infrastructure/   # БД, репозитории, файловое хранилище\n│   ├── presentation/     # FastAPI-маршруты, DI, middleware\n│   ├── core/             # Конфигурация, безопасность, утилиты\n│   └── worker/           # Воркер уведомлений + scheduler\n├── alembic/              # Миграции БД\n├── tests/                # Тесты (pytest + asyncio)\n├── frontend/             # React-приложение\n├── monitoring/           # Конфиги Prometheus, Grafana, Loki\n├── docker-compose.yml    # Продакшен-конфигурация (9 сервисов)\n├── Dockerfile            # Multi-stage сборка backend\n├── Caddyfile             # Reverse proxy + TLS\n└── main_api.py           # Точка входа\n```\n\nПодробнее об архитектуре — в [ARCHITECTURE.md](ARCHITECTURE.md).\nПланы развития — в [ROADMAP.md](ROADMAP.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzamik36%2Fglinka","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzamik36%2Fglinka","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzamik36%2Fglinka/lists"}