ivan-meer/admin-hero-telegram

Stars: 0
Forks: 0
Open beginner issues: 0
Indexed issues: 59

Dominant language: Python
License: No license data
Last GitHub push: Aug 13, 2026
Latest indexed: Sep 18, 2026
Contributing guide: No contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed
PR merge metrics: No merged PRs in 30d

Open All

59 open issues indexed

T001: Create top‑level project directories (`backend/`, `bot/`, `frontend/`, `infra/`, `tests/`). Open

ivan-meer/admin-hero-telegram#1 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T002: Initialise Python 3.12 FastAPI project with `poetry init` and add core dependencies (`fastapi`, `sqlalchemy`, `alembic`, `uvicorn`, `redis`, `arq`, `aiogram`, `pydantic`). Open

ivan-meer/admin-hero-telegram#2 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T003: Initialise Vite + React + TypeScript project with Tailwind CSS and Telegram Mini‑App SDK. Open

ivan-meer/admin-hero-telegram#3 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T004: Configure linting/formatting tools (flake8, black, isort for Python; eslint, prettier for TypeScript). Open

ivan-meer/admin-hero-telegram#4 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T005: Add Docker‑Compose file (`infra/docker-compose.yml`) with services: `postgres`, `redis`, `backend`, `bot`, `frontend`, `arq‑worker`. Open

ivan-meer/admin-hero-telegram#5 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T006: Create CI workflow (`.github/workflows/ci.yml`) for lint, unit tests, contract tests, and Docker build. Open

ivan-meer/admin-hero-telegram#6 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T007: Add `.env.example` with placeholders for DB URL, Redis URL, Bot token, JWT secret, and Mini‑App secret. Open

ivan-meer/admin-hero-telegram#7 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T008: Create Alembic migration for core tables (`tenants`, `users`, `communities`, `community_members`, `roles`, `permissions`, `role_permissions`, `grants`, `sessions`, `bots`, `bot_bindings`, `telegram_api_calls`, `audit_logs`, `outbox_events`, `idempotency_keys`). Open

ivan-meer/admin-hero-telegram#8 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T009: Implement PostgreSQL RLS policies for tenant isolation on all tables. Open

ivan-meer/admin-hero-telegram#9 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T010: Add SQLAlchemy base and session management (`backend/src/db.py`). Open

ivan-meer/admin-hero-telegram#10 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T011: Implement outbox pattern infrastructure (`backend/src/outbox/producer.py`, `backend/src/outbox/consumer.py`). Open

ivan-meer/admin-hero-telegram#11 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T012: Add Idempotency‑Key middleware (`backend/src/middleware/idempotency.py`). Open

ivan-meer/admin-hero-telegram#12 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T013: Add `update_id` deduplication for bot webhook using Redis (`bot/src/dedup.py`). Open

ivan-meer/admin-hero-telegram#13 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T014: Implement rate‑limit middleware for Bot API (global 30 msg/s, per‑group 20 msg/min) (`backend/src/middleware/rate_limit.py`). Open

ivan-meer/admin-hero-telegram#14 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T015: Add global error handling and structured JSON logging (`backend/src/middleware/error_handler.py`). Open

ivan-meer/admin-hero-telegram#15 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T016: Add health (`GET /api/v1/health`) and meta (`GET /api/v1/meta`) endpoints (`backend/src/api/health.py`). Open

ivan-meer/admin-hero-telegram#16 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T017: Implement authentication endpoints (`POST /auth/telegram`, `POST /auth/refresh`, `POST /auth/logout`, `GET /auth/me`) (`backend/src/api/auth.py`). Open

ivan-meer/admin-hero-telegram#17 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T018: Implement audit‑log writer (`backend/src/audit/writer.py`) – append‑only, `REVOKE UPDATE, DELETE`. Open

ivan-meer/admin-hero-telegram#18 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T019: Add OpenAPI documentation generation (FastAPI default) and ensure contracts are reflected. Open

ivan-meer/admin-hero-telegram#19 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T020: Write unit tests for `initData` validation (invalid signature, stale `auth_date`, wrong `origin`). Open

ivan-meer/admin-hero-telegram#20 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T021: Implement `initdata_validator.py` – verify HMAC‑SHA256 signature, enforce `auth_date` ≤ 300 s, check `origin` whitelist. Open

ivan-meer/admin-hero-telegram#21 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T022: Implement JWT generation service (`token_service.py`) – access & refresh tokens, include `tenant_id` and `user_id` claims. Open

ivan-meer/admin-hero-telegram#22 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T023: Add audit‑log entry for successful and failed auth attempts (`audit/writer.py`). Open

ivan-meer/admin-hero-telegram#23 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T024: Write integration test for full auth flow (RED → GREEN) covering success and failure cases. Open

ivan-meer/admin-hero-telegram#24 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T025: Implement bot webhook handler for `/start` (`bot/src/handlers/start.py`) – retrieve user context, send welcome message. Open

ivan-meer/admin-hero-telegram#25 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T026: Add `update_id` deduplication check in webhook handler (`bot/src/dedup.py`). Open

ivan-meer/admin-hero-telegram#26 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T027: Write contract test for bot `/start` response (mock Telegram API, expect specific text). Open

ivan-meer/admin-hero-telegram#27 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T028: Add audit‑log entry for each bot command processed. Open

ivan-meer/admin-hero-telegram#28 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T029: Write contract test for `POST /communities` (reject without `community.edit`). Open

ivan-meer/admin-hero-telegram#29 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T030: Add SQLAlchemy model `Community` (`backend/src/models/community.py`). Open

ivan-meer/admin-hero-telegram#30 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T031: Add SQLAlchemy model `CommunityMember` (`backend/src/models/community_member.py`). Open

ivan-meer/admin-hero-telegram#31 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T032: Implement service `create_community` (`backend/src/services/community.py`) – inserts Community, creates CommunityMember with `community_owner` role via `grants`. Open

ivan-meer/admin-hero-telegram#32 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T033: Implement endpoint `POST /communities` (`backend/src/api/community.py`) – RBAC check (`community.edit`), call service, return result. Open

ivan-meer/admin-hero-telegram#33 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T034: Emit audit‑log entry for community creation (`audit/writer.py`). Open

ivan-meer/admin-hero-telegram#34 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T035: Write integration test for community creation (RED → GREEN) including RLS isolation check. Open

ivan-meer/admin-hero-telegram#35 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T036: Add OpenAPI schema for community endpoints. Open

ivan-meer/admin-hero-telegram#36 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T037: Write contract test for empty Overview block (`GET /communities/{id}/overview`). Open

ivan-meer/admin-hero-telegram#37 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T038: Implement service `compute_attention_block` (`backend/src/services/overview.py`) – query `audit_logs`, `telegram_api_calls`, coverage metrics; apply sorting rules. Open

ivan-meer/admin-hero-telegram#38 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T039: Add Redis caching layer for overview payload (`backend/src/cache/overview_cache.py`) – TTL 30 s, invalidate on relevant events. Open

ivan-meer/admin-hero-telegram#39 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T040: Implement endpoint `GET /communities/{id}/overview` (`backend/src/api/overview.py`) – uses service, reads from cache, ensures p95 ≤ 300 ms. Open

ivan-meer/admin-hero-telegram#40 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T041: Emit audit‑log entry for each overview request. Open

ivan-meer/admin-hero-telegram#41 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T042: Write integration test with mock data to verify block ordering, empty state, and cache behaviour. Open

ivan-meer/admin-hero-telegram#42 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T043: Add frontend page `frontend/src/pages/Overview.tsx` – fetches endpoint, renders attention cards, shows empty state message. Open

ivan-meer/admin-hero-telegram#43 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T044: Add UI component `AttentionCard` (`frontend/src/components/AttentionCard.tsx`) – displays severity, description, action button, and “Отложить” button. Open

ivan-meer/admin-hero-telegram#44 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T045: Write end‑to‑end Playwright test covering login → Overview → attention block display. Open

ivan-meer/admin-hero-telegram#45 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T046: Write contract test for `GET /audit` with filters and CSV export. Open

ivan-meer/admin-hero-telegram#46 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T047: Implement endpoint `GET /audit` (`backend/src/api/audit.py`) – supports query parameters (`actor`, `action`, `status`, `date_from`, `date_to`), `format=csv`. Open

ivan-meer/admin-hero-telegram#47 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T048: Ensure endpoint is protected by `audit.view` permission (RBAC check). Open

ivan-meer/admin-hero-telegram#48 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T049: Add CSV generation utility (`backend/src/utils/csv_export.py`). Open

ivan-meer/admin-hero-telegram#49 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
T050: Write integration test verifying filtering, CSV output, and permission enforcement. Open

ivan-meer/admin-hero-telegram#50 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026

A short digest of beginner-friendly GitHub issues.