Add project context and documentation

This commit is contained in:
2026-02-19 20:44:09 +03:00
parent 7104d81f25
commit 7166f535d6
3 changed files with 359 additions and 0 deletions
+174
View File
@@ -0,0 +1,174 @@
# Chronicle — Context for AI Assistants
## 📋 Project Overview
**Chronicle** — «The Operating System for Technical Creators»
Единая платформа для технических авторов (разработчики, DevOps, IT-евангелисты), решающая проблему фрагментации цифровой идентичности и отсутствия редакторов лонгридов с нормальной подсветкой синтаксиса.
### Миссия
Дать техническим креаторам инструмент для:
- Написания статей с кодом (подсветка синтаксиса как в IDE)
- Публикации в несколько платформ одной кнопкой (Telegram, Habr, VK, Medium)
- Архивирования всего контента на собственном сайте
### Текущий статус
Проект на стадии концепции и планирования. Существует MVP — Telegram Archiver (консольная утилита на Go, конвертирующая Telegram-каналы в Markdown для Hugo).
---
## 🗂️ Directory Structure
```
chronicle.nixg.ru/
├── ROADMAP.md # Дорожная карта проекта (5 фаз, монетизация, метрики)
├── todo.md # Ближайшие задачи (DNS, SSL, лендинг, GitHub)
├── упаковка.md # Полная концепция продукта (ценность, архитектура, слоганы)
├── упаковка2.md # Расширенная версия: редактор + кросс-постинг + календарь
├── Имяобразование.md # История нейминга (от Telegram Archiver к Chronicle)
├── deepseek.md # Лог диалога с DeepSeek о брендинге
└── QWEN.md # Этот файл (контекст для AI)
```
---
## 📁 Key Files Description
| File | Purpose |
|------|---------|
| `ROADMAP.md` | Детальная дорожная карта: 5 фаз (Telegram Archiver → Редактор → Интеграция → Кросс-постинг → Аналитика), монетизация ($9–49/мес), метрики успеха |
| `упаковка.md` | Концепция продукта: проблема фрагментации, ценность для авторов/аудитории/инвесторов, архитектура, слоганы, план упаковки бренда |
| `упаковка2.md` | Расширенная концепция: «Операционная система для технических креаторов» — редактор с подсветкой кода, кросс-постинг, календарь публикаций |
| `todo.md` | Практические задачи: DNS для c7e.ru, SSL, лендинг, GitHub репозиторий |
| `Имяобразование.md` | История выбора имени: от рекурсивных аббревиатур (TARMAC, THOR) к Chronicle |
| `deepseek.md` | Полный лог диалога о нейминге и концепции (1794 строки) |
---
## 🎯 Product Vision
### Проблема
1. **Фрагментация идентичности**: контент разбросан по Telegram, YouTube, Habr, VK
2. **Нет редактора с кодом**: в рунете нет платформы для лонгридов с подсветкой синтаксиса
3. **Зависимость от платформ**: алгоритмы контролируют охваты, контент принадлежит платформе
### Решение
Chronicle — единая экосистема:
```
[Источники: Telegram, YouTube, Habr, VK]
↓
[CHRONICLE ENGINE]
• Редактор (Monaco Editor)
• Планировщик
• Архив
↓
[Личный сайт автора]
• Единая лента
• Подсветка кода
• Поиск
```
### Roadmap (5 фаз)
| Фаза | Цель | Статус |
|------|------|--------|
| 0: Telegram Archiver | Парсинг канала → Markdown → Hugo | ⬜ Не начата |
| 1: Брендинг + сайт | c7e.ru, лендинг, GitHub | ⬜ В плане |
| 2: Редактор с кодом | Monaco Editor, Markdown, WYSIWYG | ⬜ Q2 2026 |
| 3: Интеграция | Редактор + архив, поиск, версионность | ⬜ Q3 2026 |
| 4: Кросс-постинг | Telegram, VK, Habr, календарь | ⬜ Q4 2026 |
| 5: Аналитика | Статистика, комментарии, API | ⬜ Q1–Q2 2027 |
---
## 💰 Business Model
| План | Цена | Что включает |
|------|------|--------------|
| Free | $0 | 1 соцсеть, базовый архив, редактор |
| Pro | $9/мес | До 3 соцсетей, календарь, аналитика |
| Creator | $19/мес | До 10 соцсетей, приоритетная поддержка, API |
| Team | $49/мес | Команда, общий архив, white-label |
**Дополнительно:**
- White-label сайты: $299 разово
- Хостинг: $5/мес
- API доступ: $29/мес
---
## 🏷️ Brand Identity
**Название:** Chronicle
**Домен:** c7e.ru (основной), chronicle.nixg.ru (текущий)
**Слоган:** «Your digital home.» / «The Operating System for Technical Creators»
**Альтернативные слоганы:**
- «Your identity. Unified.»
- «All your voices. One place.»
- «Write once, publish everywhere.»
- «From chaos to chronicle.»
---
## 📅 Immediate Next Steps (из todo.md)
- [x] DNS для c7e.ru настроен
- [ ] SSL-сертификат (Caddy / Let's Encrypt)
- [ ] Лендинг (1 экран): заголовок, описание, форма подписки
- [ ] GitHub репозиторий: `github.com/evgenystor/c7e` или `github.com/evgenystor/chronicle`
- [ ] README.md с ASCII-логотипом и roadmap
- [ ] Начать Phase 0: парсинг Telegram
---
## 👤 Author Context
**Автор проекта:** Evgeny Storozhenko
**Telegram-канал:** dedinit (ded in it / ded init())
**Локация:** РФ (ориентация на русскоязычный рынок)
**Личный бренд:**
- Никнейм `dedinit` используется как личный бренд
- Проект Chronicle — эволюция от простого архиватора к полноценной платформе
---
## 🛠️ Technical Stack (Planned)
| Компонент | Технология |
|-----------|------------|
| Редактор | React + Monaco Editor |
| Бэкенд | Go (существующий) / Node.js |
| База данных | SQLite / PostgreSQL |
| Генерация сайта | Hugo (MVP) / Next.js |
| Деплой | Netlify / Vercel / свой VPS |
---
## 📝 Usage Notes for AI Assistants
При работе с этим проектом:
1. **Контекст**: Это проект на стадии планирования, не production-код
2. **Язык**: Документация на русском, код будет на английском
3. **Фокус**: Помощь в реализации Phase 0 (Telegram Archiver) и Phase 1 (лендинг + бренд)
4. **Стиль**: Технический, но с элементами маркетинга (проект для инвесторов и пользователей)
**Ключевые темы для обсуждения:**
- Архитектура парсера Telegram (MTProto / API)
- Конвертация в Markdown для Hugo
- Front-matter (дата, теги, ID)
- Дедупликация при повторном запуске
- Брендинг и упаковка продукта
---
## 🔗 Related Resources
- **Основной домен:** c7e.ru (здесь развивается проект)
- **Telegram:** dedinit (канал автора)
---
*Последнее обновление: 19 февраля 2026 г.*
*Версия документа: 1.0*
+174
View File
@@ -0,0 +1,174 @@
# CHRONICLE ROADMAP
> **The Operating System for Technical Creators**
> Единая среда для создания, публикации и архивирования технического контента
---
## 🎯 Миссия
Решить проблему фрагментации цифровой идентичности технических авторов (разработчики, DevOps, IT-евангелисты) и дать им инструмент для работы с кодом в статьях без боли.
**Боль:** В рунете нет редактора лонгридов с нормальной подсветкой синтаксиса. Тех-блогеры мучаются между Telegram (нет подсветки), Хабром (закрытая платформа) и скриншотами кода (🤮).
**Решение:** Chronicle — редактор + кросс-постинг + архив на своём сайте.
---
## 🗺️ Дорожная карта
### **Фаза 0: Telegram Archiver (MVP)** ⬜ (НЕ НАЧАТА)
**Цель:** Базовый архиватор Telegram-канала в Markdown для Hugo
- [ ] Парсинг Telegram-канала (API / MTProto)
- [ ] Конвертация постов в Markdown (с сохранением форматирования)
- [ ] Экспорт медиа (изображения, видео, документы)
- [ ] Генерация структуры файлов для Hugo
- [ ] Front-matter для каждого поста (дата, теги, ID)
- [ ] Базовая дедупликация при повторном запуске
**Результат:** Консольная утилита, которая по ссылке на канал скачивает все посты в папку `content/posts/` для Hugo
**Критерий готовности:** Можно запустить на своём канале `dedinit` и получить работающий статический сайт
---
### **Фаза 1: Брендинг и запуск сайта** ⬜
**Цель:** Зарегистрировать бренд, запустить сайт-визитку
- [x] DNS для `c7e.ru` настроен
- [ ] SSL-сертификат (Caddy / Let's Encrypt)
- [ ] Лендинг (1 экран):
- Заголовок + слоган
- Краткое описание идеи
- Email для связи / форма подписки на ранний доступ
- [ ] GitHub репозиторий: `github.com/evgenystor/c7e` или `github.com/evgenystor/chronicle`
- [ ] README.md с:
- ASCII-арт логотипом
- Описанием проекта
- Roadmap
- Инструкциями для контрибьюторов
**Результат:** `c7e.ru` — рабочая точка входа, есть куда направить первых пользователей
---
### **Фаза 2: Редактор с подсветкой кода** (Q2 2026)
**Цель:** Дать тех-блогерам редактор, в котором можно писать статьи с кодом
- [ ] Веб-редактор (React / Vue)
- [ ] Интеграция Monaco Editor (как в VS Code)
- [ ] Поддержка языков: Python, JavaScript, Go, Rust, Bash, SQL
- [ ] Темы оформления (светлая / тёмная)
- [ ] Блоки кода с кнопкой «скопировать»
- [ ] Markdown-режим + WYSIWYG превью
- [ ] Сохранение черновиков (локально / в GitHub)
- [ ] Drag-and-drop изображений
**Результат:** Можно написать статью с кодом, и она будет выглядеть как в IDE
---
### **Фаза 3: Интеграция с архивом** (Q3 2026)
**Цель:** Объединить редактор и архив в единую систему
- [ ] Написанное в редакторе → автоматически в архив (Markdown-файлы)
- [ ] Импорт постов из Telegram (через Phase 0)
- [ ] Редактирование старых постов из архива
- [ ] Поиск по всему контенту (full-text)
- [ ] Теги и категории
- [ ] Версионность постов (как Git: история изменений, откат)
**Результат:** Весь контент в одном месте, можно редактировать и искать
---
### **Фаза 4: Публикация и кросс-постинг** (Q4 2026)
**Цель:** Публикация в несколько соцсетей одной кнопкой
- [ ] Интеграция с Telegram Bot API (публикация в канал)
- [ ] Интеграция с VK API
- [ ] Интеграция с Habr API (или парсинг формы)
- [ ] Интеграция с Medium API
- [ ] Календарь публикаций
- [ ] Отложенные посты (очередь)
- [ ] Адаптация контента под платформы:
- Telegram: коротко, без сложных блоков
- Habr: полная версия с кодом
- VK: адаптированный текст
- [ ] Превью: как пост будет выглядеть на каждой платформе
**Результат:** Написал один раз → опубликовал везде с адаптацией
---
### **Фаза 5: Аналитика и экосистема** (Q1-Q2 2027)
**Цель:** Превратить Chronicle в полноценную платформу
- [ ] Сбор статистики по платформам (просмотры, реакции, комментарии)
- [ ] Аналитика вовлеченности
- [ ] Лучшее время для постов (рекомендации)
- [ ] Сбор комментариев с платформ обратно в Chronicle
- [ ] Командная работа (несколько авторов)
- [ ] API для разработчиков
- [ ] Мобильное приложение (черновики, заметки)
- [ ] White-label решения для брендов
**Результат:** Полноценная операционная система для технического креатора
---
## 💰 Монетизация
| План | Цена | Что включает |
|------|------|--------------|
| **Free** | $0 | 1 соцсеть (Telegram), базовый архив, редактор |
| **Pro** | $9/мес | До 3 соцсетей, календарь, базовая аналитика |
| **Creator** | $19/мес | До 10 соцсетей, приоритетная поддержка, API |
| **Team** | $49/мес | Командная работа, общий архив, white-label |
**Дополнительно:**
- White-label сайты: $299 разово
- Хостинг сайта: $5/мес (опционально)
- API доступ: $29/мес
---
## 📊 Метрики успеха
| Фаза | Метрика | Цель |
|------|---------|------|
| Phase 0 | Каналов архивировано | 10+ |
| Phase 1 | Посетителей на c7e.ru | 100+ за первый месяц |
| Phase 2 | Активных редакторов | 50+ |
| Phase 4 | Публикаций в день | 100+ |
| Phase 5 | Платящих пользователей | 500+ |
---
## 🚀 Ближайшие шаги (эта неделя)
- [x] DNS для `c7e.ru` настроен
- [ ] SSL-сертификат (Caddy)
- [ ] GitHub репозиторий
- [ ] README.md с ASCII-логотипом
- [ ] Лендинг (1 экран) на `c7e.ru`
- [ ] Начать Phase 0: парсинг Telegram
---
## 📝 История изменений
| Дата | Изменение |
|------|-----------|
| 19 февраля 2026 | Создан документ ROADMAP.md |
---
*Документ создан на основе диалога о проекте Telegram Archiver и его эволюции в Chronicle.*
+11
View File
@@ -0,0 +1,11 @@
Следующие шаги (практичные)
Сегодня:
[ x ]Настроить DNS-записи для c7e.ru (A-запись на VPS)
[ ]Получить SSL-сертификат через Caddy
Завтра:
[ ] Создать простой лендинг на c7e.ru (один экран: что это, зачем, как начать)
[ ] Завести репозиторий github.com/evgenystor/c7e
На этой неделе:
Обновить задачу №13 в списке:
[ ] Настроить chronicle.nixg.ru → c7e.ru как точку сбора контента...
Написать README.md с ASCII-арт логотипом