docs: refactor project docs and agents tasks

This commit is contained in:
vakabunga
2026-03-02 00:30:56 +03:00
parent 9551b93a09
commit 9d12702688
14 changed files with 1146 additions and 87 deletions

View File

@@ -16,22 +16,23 @@
- `edit_and_rules.md`
- `analytics.md`
- `auth.md`
- `api_reference_accounts_categories.md`
## Основные задачи MVP
1. Структура проекта
1 Структура проекта
- Создать каркас BE: `src/app.ts`, `src/routes/*`, `src/db/*`, `src/middleware/*`, `src/services/*`.
- Реализовать конфигурацию:
- переменные окружения (в т.ч. логин/пароль для авторизации),
- строки подключения к Postgres.
1. Миграции БД
2 Миграции БД
- Реализовать таблицы и поля строго по `db.md`, `category.md`, `edit_and_rules.md`, `analytics.md`.
- Включить все описанные CHECK/UNIQUE/FOREIGN KEY/дополнительные поля (`is_category_confirmed`, `comment`, `alias` для accounts, `budgets` и т.д.).
1. Авторизация и сессии
3 Авторизация и сессии
- Реализовать эндпоинты:
- `POST /api/auth/login`
@@ -44,7 +45,7 @@
- проверяет 3-часовой таймаут бездействия,
- обнуляет сессию и отдаёт `401` по истечении таймаута.
1. Импорт выписки
4 Импорт выписки
- Эндпоинт (например) `POST /api/import/statement`:
- Принимает JSON строго формата 1.0 (см. `format.md`).
@@ -56,23 +57,23 @@
- вставляет в `transactions` с учётом уникального индекса `(account_id, fingerprint)`,
- по умолчанию `is_category_confirmed = FALSE`, `category_id = NULL`.
1. История операций
5 История операций
- Реализовать `GET /api/transactions` по `api_history.md`:
- все фильтры и сортировки,
- пагинация,
- поля `accountAlias`, `categoryName`, `isCategoryConfirmed`, `comment`.
1. Редактирование транзакций и правила категорий
6 Редактирование транзакций и правила категорий
- Эндпоинт `PUT /api/transactions/{id}`:
- Обновляет `category_id`, `comment`, `is_category_confirmed`.
- Эндпоинты для `category_rules`:
- создание правила на основе входных данных (pattern, match_type, category_id, priority),
- обновление/деактивация,
- опционально — применение правила к истории (bulk-обновление транзакций с `is_category_confirmed = FALSE`).
- создание правила на основе входных данных (pattern, match_type, category_id, priority, requires_confirmation),
- обновление/деактивация (PATCH),
- применение правила к прошлым транзакциям (bulk-обновление: только `category_id IS NULL` или `is_category_confirmed = FALSE`).
1. Аналитика
7 Аналитика
- Реализовать:
- `GET /api/analytics/summary`