/api_finance

Primary LanguageJavaScriptMIT LicenseMIT

Личный финансовый менеджер

Описание

Этот проект представляет собой сервер на Node.js для приложения "Личный финансовый менеджер". Сервер обрабатывает данные о доходах и расходах, сохраняя их в JSON-файле. Также поддерживается работа с категориями доходов и расходов.

Технологии

  • Node.js
  • Express
  • uuid для генерации уникальных идентификаторов
  • fs/promises для асинхронной работы с файловой системой

API Endpoints

  • GET /api/finance: Получение всех записей о доходах и расходах, передав searchParams startDate и/или endDate можно отфильтровать по дате (формат ГГГГ-ММ-ДД)
  • POST /api/finance: Добавление новой записи о доходе или расходе
  • GET /api/categories: Получение списка категорий
  • DELETE /api/finance/:id: Удаление записи
  • GET /api/reset: Сброс БД до стартового состояния
  • GET /api/test: Получение тестовых записей

Формат данных

Объекты о доходах и расходах имеют следующую структуру:

{
  "id": "уникальный идентификатор",
  "type": "тип записи (income/outcome)",
  "amount": "сумма",
  "description": "описание операции",
  "category": "категория операции"
}

Пример структуры категорий:

{
  "income": ["Зарплата", "Подарки"],
  "outcome": ["Еда", "Транспорт", "Развлечения", "Образование"]
}