97 lines
4.9 KiB
Markdown
97 lines
4.9 KiB
Markdown
# Реестр объектов ВОЛС | Kazakhtelecom Business
|
||
|
||
Приложение для учёта и мониторинга объектов корпоративного сегмента ВОЛС.
|
||
|
||
## Возможности
|
||
|
||
- ✅ Учёт объектов: 18 полей (клиент, адрес, сегмент, статусы строительства и подключения, ARPU и др.)
|
||
- ✅ Фильтрация и поиск: по сегментам, областям, статусам, тексту
|
||
- ✅ Сортировка таблицы по любой колонке
|
||
- ✅ Дашборд с KPI и графиками (объекты по областям, статусы подключения)
|
||
- ✅ Аналитика по подразделениям (ДПБО / ДПККК)
|
||
- ✅ Ролевой доступ: админ (полный), редактор (ограниченные поля), просмотр
|
||
- ✅ Мобильная версия: карточки вместо таблицы
|
||
- ✅ Экспорт в Excel (.xlsx)
|
||
- ✅ Журнал аудита всех действий
|
||
- ✅ Сохранение данных в localStorage
|
||
|
||
## Демо-пользователи
|
||
|
||
| Роль | ФИО | Телефон | Доступ |
|
||
|------|-----|---------|--------|
|
||
| Админ | Торегожиев Саяжан Сабырович | +77771112233 | Полный доступ ко всем объектам и пользователям |
|
||
| Редактор | Иванов Петр | +77774445566 | Редактирование объектов ДПБО |
|
||
| Редактор | Смирнов Алексей | +77777778899 | Редактирование объектов ДПККК |
|
||
| Просмотр | Гость Тестовый | +77770001122 | Только просмотр |
|
||
|
||
## Поля объекта
|
||
|
||
1. Подразделение (ДПБО / ДПККК)
|
||
2. Область
|
||
3. Район
|
||
4. Город
|
||
5. Адрес
|
||
6. Клиент
|
||
7. Вид деятельности
|
||
8. Наличие ТВ
|
||
9. Сегмент (Корпоративный, Гос.органы, Банки, Телеком, Нефтегаз, Энергетика, Транспорт, Другой)
|
||
10. Статус строительства (Проект, СМР, СМР завершено, Исключено)
|
||
11. Начало строительства
|
||
12. Срок строительства
|
||
13. Примечание
|
||
14. № устройства
|
||
15. Статус подключения (Подключено, Заявка, Отказ, Перспектива)
|
||
16. Дата подключения
|
||
17. Тариф
|
||
18. ARPU (₸)
|
||
|
||
## Запуск
|
||
|
||
```bash
|
||
npm install
|
||
npm start
|
||
```
|
||
|
||
Или через команду `run` в среде Vibe42.
|
||
|
||
## Технологии
|
||
|
||
- HTML5, CSS3, Vanilla JavaScript (ES6+)
|
||
- Chart.js — графики и диаграммы
|
||
- XLSX — экспорт в Excel
|
||
- localStorage — персистентное хранилище данных
|
||
- Kazakhtelecom branding: цвета #4B1D6B (фиолетовый), #8DC63F (лайм), шрифты Manrope/Inter
|
||
|
||
## Структура файлов
|
||
|
||
- `index.html` — разметка и стили
|
||
- `app.js` — логика приложения (состояние, рендеринг, управление данными)
|
||
- `server.js` — статический сервер для раздачи файлов
|
||
- `package.json` — зависимости и скрипты
|
||
|
||
## Данные
|
||
|
||
Данные хранятся в localStorage браузера:
|
||
- `volsRecords` — массив объектов реестра
|
||
- `volsUsers` — массив пользователей
|
||
- `volsAudit` — журнал аудита (последние 300 записей)
|
||
|
||
При первом запуске генерируются seed-данные: 30 объектов и 4 пользователя.
|
||
|
||
## Администрирование
|
||
|
||
Администратор может:
|
||
- Просматривать список всех пользователей
|
||
- Редактировать пользователей (ФИО, телефон, роль, регион)
|
||
- Удалять пользователей (кроме себя)
|
||
- Просматривать журнал аудита
|
||
- Видеть popup с контактами администратора (кнопка вверху справа)
|
||
|
||
## Экспорт
|
||
|
||
Кнопка «Excel» в верхней панели экспортирует все отфильтрованные записи в файл `reestr_vols_ГГГГ-ММ-ДД.xlsx` с полями:
|
||
- Подразделение, Область, Район, Город, Адрес
|
||
- Клиент, Вид деятельности, Наличие ТВ, Сегмент
|
||
- Статус строительства, Начало строительства, Срок строительства, Примечание
|
||
- № устройства, Статус подключения, Дата подключения, Тариф, ARPU
|