17 KiB
История изменений ERP WaterSurf
История изменений ERP WaterSurf
2025-02-25 22:25 UTC – Временное отключение авторизации для отладки
Проблема: Для быстрой разработки и отладки нужно работать без входа.
Решение: Добавлена настройка REQUIRE_LOGIN (по умолчанию false). При REQUIRE_LOGIN=false представления не требуют входа; мидлварь OptionalAuthMiddleware подставляет первого активного суперпользователя для анонимных запросов, чтобы меню и поле «Автор» работали. Миксин config.mixins.LoginRequiredMixin проверяет REQUIRE_LOGIN и при false не перенаправляет на логин. Чтобы вернуть авторизацию: в .env задать REQUIRE_LOGIN=true и перезапустить приложение.
Изменения: config/settings.py (REQUIRE_LOGIN, OptionalAuthMiddleware), config/mixins.py, config/middleware.py, documents/views.py, references/views.py, users/views.py (импорт LoginRequiredMixin из config.mixins), .env.example (комментарий про REQUIRE_LOGIN).
2025-02-25 22:15 UTC – Поле «Дата»: размер и кнопка календаря
Проблема: Дата не помещалась в поле (обрезка по ширине), кнопка выбора календаря сливалась с тёмным фоном.
Решение: Ширина поля даты увеличена до 11.5rem. Для кнопки календаря (::-webkit-calendar-picker-indicator) задан акцентный фон (--ws-accent), белая иконка календаря через SVG data URI, при наведении — --ws-accent-hover.
Изменения: theme-compact.css.
2025-02-25 22:10 UTC – Поле «Дата» как ввод даты (type=date)
Проблема: Поле даты в документах было текстовым (size=10).
Решение: Во всех формах документов (заказ клиента, заказ поставщику, поступление, перемещение, расход) виджет даты заменён на DateInput(attrs={"type": "date"}) — отображается нативный выбор даты в браузере.
Изменения: documents/forms.py (виджеты date во всех пяти формах).
2025-02-25 22:00 UTC – Компактные формы денежных документов (поступление, перемещение, расход)
Проблема: Формы поступления, перемещения и расхода денежных средств выводили все поля списком с подписями сверху.
Решение: Общий шаблон cash_doc_form.html переведён на компактную раскладку по образцу заказов: первая строка — Дата и Номер (подпись слева от поля, 10 и 15 символов), остальные поля — парами в одну строку в две колонки (подпись слева). Добавлены виджеты даты/номера в CashInflowForm, CashTransferForm, CashExpenseForm.
Изменения: documents/forms.py (виджеты date/number в трёх формах), documents/cash_doc_form.html (компактная разметка с ws-form-compact).
2025-02-25 21:45 UTC – Подписи полей слева от полей в одну строку
Проблема: Подписи полей в формах заказов были расположены над полями ввода.
Решение: В компактных формах подписи выровнены слева от полей в одну строку: группа поля — flex-строка (label + поле), минимальная ширина подписи 6.5rem, сообщения об ошибках переносятся на следующую строку с отступом.
Изменения: theme-compact.css (стили .ws-form-group как flex row, выравнивание подписей).
2025-02-25 21:30 UTC – Компактные формы документов (заказы клиента и поставщику)
Проблема: Формы создания/редактирования заказов занимали много места: каждое поле с новой строки на всю ширину.
Решение:
- Дата и Номер в одной строке: поле «Дата» — 10 символов (size=10), «Номер» — 15 символов (size=15, maxlength=15).
- Вид заказа и Организация в одной строке; Клиент и Автор в одной строке (заказ клиента). Аналогично заказ поставщику: Организация и Поставщик, Валюта и Курс, затем Автор.
- Таблица товаров: колонка «Товар» шире (35%, min 14rem), колонка «Количество» уже (поле ввода 4ch, до двухзначного числа).
- Добавлены виджеты для даты/номера в формах и для количества в formset (size=3, width: 4ch). Новый файл
static/css/theme-compact.cssс раскладкой строк формы (grid) и ширинами колонок таблицы.
Изменения: documents/forms.py (CustomerOrderForm, SupplierOrderForm, CustomerOrderItemForm, SupplierOrderItemForm, виджеты), documents/order_form.html и supplier_order_form.html (компактная разметка по полям), base.html (подключение theme-compact.css), новый theme-compact.css.
2025-02-25 21:00 UTC – Принудительное применение темы (кэш, шрифт, кнопки)
Проблема: На скриншоте стили не применялись: кнопка бирюзовая вместо синей (#34AFE3), шрифт Geologica не отображался.
Решение:
- К ссылке theme.css добавлен параметр ?v=4 для сброса кэша браузера и прокси.
- Для кнопки .btn-ws-primary заданы явные цвета #34AFE3 и #00868F и усилена специфичность селекторов (body .btn.btn-ws-primary).
- На html и body задан font-family Geologica; для потомков — font-family: inherit, чтобы шрифт применялся ко всей странице.
Изменения: base.html (theme.css?v=4), theme.css (коммент v4, кнопки по HEX, наследование шрифта).
2025-02-25 20:45 UTC – Логотип убран; дизайн строго по брендбуку
Проблема: Логотип в шапке был вставлен некорректно; визуально тема не отличалась от дефолтной — цвета и шрифты не применялись.
Решение:
- Логотип из шапки убран, в навбаре снова текст «WaterSurf ERP».
- Файл логотипа удалён из
static/images/. - Фон страницы и поверхностей задан только основными цветами бренда: Black #0A121D; границы — Gray 04 #617E92; текст — Gray 01 #F5F9FD, Gray 03 #B1C7D7, Gray 04 #617E92.
- Ключевой акцент взят только из дополнительных цветов: Blue (02) #34AFE3, при наведении Blue (03) #00868F.
- Добавлены переопределения Bootstrap с !important для body, main, кнопок, полей ввода, таблиц и типографики, чтобы гарантированно применялись Geologica и палитра брендбука.
Изменения: base.html (удалён img логотипа), theme.css (палитра только из брендбука, акцент из дополнительных, переопределения Bootstrap), удалён app/static/images/watersurf-logo.png.
2025-02-25 20:15 UTC – Стили по корпоративному брендбуку и логотип
Проблема: Нужно привести интерфейс в соответствие с корпоративным брендбуком WaterSurf и использовать логотип компании.
Решение:
- В
static/css/theme.cssприменены цвета брендбука: базовый фон #0A121D, ключевой акцент #0DADBB, градации серого (Gray 01–04), дополнительные красный/зелёный для состояний. - Подключён шрифт Geologica (Google Fonts): Light для основного текста, Medium для подзаголовков, Bold для заголовков; учтён letter-spacing по брендбуку.
- В шапке вместо текстовой надписи выводится логотип WaterSurf из
static/images/watersurf-logo.png, рядом — подпись «ERP». - Сохранены тёмная тема, минималистичные карточки, таблицы и формы в едином стиле.
Изменения: base.html (подключение Geologica, логотип в навбаре), theme.css (палитра и типографика брендбука), добавлен каталог static/images и файл watersurf-logo.png.
2025-02-25 19:00 UTC – Кнопка «Добавить строку» в табличной части заказов
Проблема: В форме заказа клиента (и заказа поставщику) нельзя было добавить более одной строки товаров — formset показывал только одну пустую строку (extra=1).
Решение: Под таблицей товаров добавлена кнопка «+ Добавить строку». По нажатию скрипт клонирует последнюю строку, подменяет в ней индексы полей (items-N-…) и значение TOTAL_FORMS в management form, очищает значения и добавляет строку в таблицу. Аналогично реализовано для заказа поставщику.
2025-02-25 18:45 UTC – Тёмная тема и обновлённый UI/UX
Проблема: Требовался современный тёмный интерфейс, минималистичный и удобный.
Решение:
- Добавлена кастомная тема в
static/css/theme.css: тёмный фон (оттенки #0d1117–#21262d), акцент бирюзовый (#2dd4bf), типографика Inter, переменные для цветов и отступов. - Обновлён базовый шаблон: навбар с выпадающими меню в стиле темы, контейнер контента с ограничением ширины, сообщения (alerts) в стиле темы.
- Все страницы переведены на карточки (ws-card), таблицы (ws-table) с чередованием и hover, кнопки (btn-ws-primary, btn-ws-secondary, btn-ws-danger), формы с группами полей и явными метками.
- Учтены UX: читаемый контраст, фокус на полях ввода, разделители секций в формах, выравнивание чисел в таблицах, пустые состояния.
Изменения: base.html, registration/login.html, home.html, шаблоны references/* и documents/*, новый static/css/theme.css. В Dockerfile добавлен collectstatic при сборке образа.
2025-02-25 18:15 UTC – Ошибка 500 при создании заказа клиента
Проблема: При открытии формы создания заказа клиента возникала ошибка 500 (AttributeError: 'NoneType' object has no attribute 'pk').
Решение: В CustomerOrderCreate.get_context_data при создании нового заказа self.object ещё None; обращение к self.object.pk вызывало исключение. Условие заменено на if self.object and self.object.pk, как в форме заказа поставщику.
2025-02-25 15:25 UTC – Исправление 403 CSRF при входе
Проблема: При первой авторизации под администратором по https://erp.gen7x.ru возникала ошибка 403 (ошибка проверки CSRF, запрос отклонён).
Решение: Добавлена настройка CSRF_TRUSTED_ORIGINS в config/settings.py: указаны https://erp.gen7x.ru, а также localhost/127.0.0.1 для локальной отладки. При работе за Nginx Django проверяет заголовок Origin/Referer; без доверенного источника запросы с формы логина отклонялись.
Изменения: app/config/settings.py — список CSRF_TRUSTED_ORIGINS; опциональная переменная CSRF_TRUSTED_ORIGINS в .env.example.
2025-02-25 15:10 UTC – Администратор и SSH для Git
Проблема: Требовалось создать первого администратора системы и настроить SSH для самостоятельного push в Gitea.
Решение:
- Создан Django superuser (логин
admin, пароль и email записаны в/root/docs/secrets/mysecrets.md). - Сгенерирован SSH-ключ для Gitea (
/root/.ssh/gitea_cursor_agent_ed25519), публичный ключ добавлен в учётную запись cursor-agent через API. - В
~/.ssh/configдобавлен хостgit.gen7x.ru(HostName 127.0.0.1, Port 2222, User git, указан ключ). - Remote репозитория переведён на SSH:
git@git.gen7x.ru:cursor-agent/watersurf-erp.git, выполнен успешный push ветки main.
Изменения:
- README.md: секция «Git и пуш» обновлена с указанием SSH и отсутствия необходимости ввода пароля с сервера.
2025-02-25 15:00 UTC – Начальная структура проекта (MVP)
Проблема: необходимо развернуть систему класса ERP для WaterSurf с веб-доступом, авторизацией и хранением данных в БД.
Решение:
- Создан проект в
/opt/watersurf-erp: Django 5, PostgreSQL 16, Docker Compose. - Реализованы справочники: Валюты, Виды заказов, Клиенты, Организации, Поставщики, Сотрудники, Счета денежных средств, Товары (CRUD через веб и админку).
- Реализованы документы: Заказ клиента, Заказ поставщику (с табличными частями товаров), Поступление/Перемещение/Расход денежных средств (автогенерация номера).
- Связь пользователь → сотрудник (профиль) для автоматической подстановки автора в документах.
- Настроены Nginx (erp.gen7x.ru), добавлен volume в список бэкапов платформы.
Изменения:
- Структура приложения: config, references, documents, users; шаблоны, формы, представления; миграции.
- Файлы: README.md, HISTORY.md, .env.example, docker-compose.yml, Dockerfile, manage.sh, requirements.txt.
Проверка:
cd /opt/watersurf-erp
docker compose up -d
docker compose logs -f app
# Открыть https://erp.gen7x.ru/ (после перезагрузки Nginx)