Перейти к основному содержимому

currency_account

Общее описание проекта​

Проект в области ИТ связан с управлением валютными счетами. Разработка ведется на языке программирования Python с использованием фреймворка Django.

Описание модулей проекта​

  1. Администрирование валютных счетов: Модуль, который позволяет администраторам управлять валютными счетами. Включает в себя формы и настройки для управления данными счетов.

  2. Модели данных: Определяет структуру данных валютных счетов, включая связи с пользователями и уникальные идентификаторы счетов.

  3. Миграции данных: Содержит скрипты для миграции базы данных, что необходимо для обновления и поддержания структуры данных в актуальном состоянии.

  4. Утилиты: Вспомогательные инструменты для работы с данными валютных счетов, например, для поиска главного счета по идентификатору.

Логика работы системы​

Система предназначена для администрирования и управления валютными счетами. Основная логика заключается в возможности просмотра, добавления, изменения и удаления информации о валютных счетах. Управление происходит через специально разработанные формы. Система также предоставляет функциональность для связывания пользователей с их валютными счетами.

Интеграция с внешними системами​

Проект включает интеграцию с внешними системами через модуль mgmt_google.oauth для обработки ошибок OAuth. Это позволяет системе взаимодействовать с внешними сервисами, использующими OAuth для аутентификации и авторизации. Дополнительно, система интегрирована с другими модулями, такими как модуль trackers, для управления информацией о пользователях и их валютных счетах.

Действия в системе​

  1. Создание валютного счета: Возможность создать новый валютный счет в системе.
  2. Изменение валютного счета: Редактирование существующего валютного счета, включая изменение связанных данных.
  3. Просмотр списка валютных счетов: Отображение списка всех валютных счетов в системе.
  4. Фильтрация валютных счетов: Возможность фильтрации списка валютных счетов по определенным критериям.
  5. Обработка ошибок OAuth: Интеграция с внешними системами через OAuth, включая обработку ошибок.
  6. Получение основного счета для идентификатора счета: Функция для определения основного счета по его уникальному идентификатору.

Сценарий использования​

Представим ситуацию в компании, занимающейся международной торговлей. У компании есть несколько валютных счетов в разных банках и странах. Система позволяет централизованно управлять этими счетами. Администратор системы может добавлять новые счета, изменять информацию о существующих, а также просматривать и фильтровать их по различным параметрам. Например, если требуется проверить состояние счетов, связанных с определенным пользователем, администратор может использовать функцию фильтрации. Кроме того, при взаимодействии с внешними сервисами, такими как банковские системы, используется интеграция через OAuth для обеспечения безопасности данных.

Модель данных​

  1. CurrencyAccount (Валютный счет)
    • trackerUser: Однонаправленная связь с моделью TrackerUser. Определяет пользователя, связанного с валютным счетом.
    • accountIds: Поле типа CharField. Содержит идентификаторы счетов, разделенные запятыми. Позволяет управлять несколькими счетами в рамках одного валютного счета.

Диаграмма состояний​

В данной диаграмме, представлены два основных состояния: "НеактивныйСчет" и "АктивныйСчет". Из состояния "НеактивныйСчет", возможен переход в состояние "АктивныйСчет" путем создания валютного счета. В состоянии "АктивныйСчет", возможно изменение счета, а также его удаление, что возвращает систему в состояние "НеактивныйСчет".

Анализ кода проекта​

Анализируя предоставленный код, можно выделить несколько аспектов для улучшения:

  1. Обработка исключений в utils.py: В функции get_main_account_for_account_id отсутствует эффективная обработка исключений. Рекомендуется добавить более конкретные исключения, а также логгирование для отслеживания ошибок. Пример кода:

    def get_main_account_for_account_id(id):
        try:
            # код функции...
        except SpecificException as e:
            logger.error("Ошибка: %s", e)
            raise

  2. Оптимизация запросов в модели CurrencyAccount: Метод get_main_account_for_account_id выполняет запрос ко всем объектам CurrencyAccount, что неэффективно для больших объемов данных. Рекомендуется использовать фильтрацию на уровне базы данных.

  3. Использование CharField для accountIds в модели CurrencyAccount: Хранение идентификаторов в строке и последующее их разделение - не самый эффективный подход. Лучше использовать связи многие-ко-многим или отдельную таблицу для учета этих связей.

  4. В CurrencyAccountAdmin: Метод get_form может быть улучшен за счет более четкого определения используемых полей и их валидации.

Оценка данного проекта по 10-балльной шкале - 7/10. Проект написан достаточно чисто, но имеются упомянутые недочеты. Для опытной команды разработки реализация такого проекта может занять около 40-50 часов, учитывая время на рефакторинг и тестирование.