- Unify API: lib/api.ts uses /api/v1, inbox uses /api/inbox (rewrites) - Remove localhost refs: openapi, inbox page - Add rewrites: /api/inbox|tmc -> inbox-server, /api/v1 -> FastAPI - Add stub routes: knowledge/insights, recommendations, search, log-error - Transfer from PAPA: prompts (inspection, tmc), scripts, supabase, data/tmc-requests - Fix inbox-server: ORDER BY created_at, package.json - Remove redundant app/api/inbox/files route (rewrites handle it) - knowledge/ in gitignore (large PDFs) Co-authored-by: Cursor <cursoragent@cursor.com>
4.0 KiB
4.0 KiB
Импорт данных из Jira
Описание
Система поддерживает импорт данных о задачах из Jira через CSV файлы, расположенные в папке новая папка.
Поддерживаемые файлы
- REFLY_Jira_Backlog_Subtasks_Dependencies.csv - основной файл с эпиками, историями и подзадачами
- REFLY_Jira_Issue_Links.csv - связи между задачами (зависимости)
- report_audit_trail.csv - история аудита и отчетов
Структура данных
Эпики (Epics)
- Issue Id
- Summary (название)
- Description (описание)
- Priority (приоритет)
- Components (компоненты)
- Labels (метки)
Истории (User Stories)
- Issue Id
- Parent Id (ID эпика)
- Summary
- Description (включая Acceptance Criteria)
- Priority
- Story Points
- Components
- Labels
Подзадачи (Sub-tasks)
- Issue Id
- Parent Id (ID истории)
- Summary
- Description
- Priority
- Components
- Labels
Зависимости
- From Issue Id
- To Issue Id
- Link Type (Blocks, Depends, Relates)
Использование
1. Импорт данных
npm run import:jira
Скрипт:
- Создаст необходимые таблицы в БД (если их нет)
- Импортирует эпики, истории и подзадачи
- Импортирует зависимости между задачами
- Импортирует данные audit trail
2. Просмотр данных
После импорта данные доступны через:
- Веб-интерфейс:
/jira-tasks - API:
GET /api/jira-tasks?type=epic|story|subtask|all
3. API Endpoints
Получить все эпики с историями
GET /api/jira-tasks?type=epic
Получить все истории
GET /api/jira-tasks?type=story
Получить истории конкретного эпика
GET /api/jira-tasks?type=story&epic_id=1001
Получить подзадачи
GET /api/jira-tasks?type=subtask
Получить подзадачи конкретной истории
GET /api/jira-tasks?type=subtask&story_id=1011
Получить все данные
GET /api/jira-tasks?type=all
Структура базы данных
Таблицы
- jira_epics - эпики
- jira_stories - истории пользователей
- jira_subtasks - подзадачи
- jira_task_dependencies - зависимости между задачами
Схема
См. файл lib/database/jira_tasks_schema.sql
Примеры использования
Получить все эпики с приоритетом High
SELECT * FROM jira_epics WHERE priority = 'High' ORDER BY created_at DESC;
Получить все истории для эпика E1
SELECT * FROM jira_stories WHERE parent_epic_id = '1001' ORDER BY story_points DESC;
Получить зависимости для задачи
SELECT * FROM jira_task_dependencies WHERE from_issue_id = '1011';
Обновление данных
Для обновления данных просто запустите импорт снова:
npm run import:jira
Скрипт использует ON CONFLICT DO UPDATE, поэтому существующие записи будут обновлены, а новые - добавлены.
Интеграция с системой
Импортированные данные можно использовать для:
- Отслеживания прогресса разработки
- Планирования спринтов
- Анализа зависимостей
- Генерации отчетов
- Управления рисками (связь с рисками через метки)