# 🏭 Система 5С

> ⚠️ **ВНИМАНИЕ: ПРОТОТИП СИСТЕМЫ**
> 
> Это прототип приложения для демонстрации возможностей. Не использовать в production среде!
> - Система находится в стадии активной разработки
> - Могут присутствовать ошибки и недоделанные функции  
> - Безопасность не полностью протестирована
> - Используйте на свой страх и риск

> 🤖 **ПРОЦЕСС РАЗРАБОТКИ**
>
> Данный проект создается методом **AI-ассистированного программирования** (vibe coding)
> - Задумка и концепция: авторские
> - Реализация: совместная работа человека и ИИ
> - Итеративная разработка: постоянное улучшение и доработка

Производственная система управления участками по методике 5С с веб-интерфейсом и API.

## 🎯 Статус проекта

**Текущий статус:** 🟡 Прототип (Alpha)

**Что готово:**
- ✅ Базовая аутентификация
- ✅ Управление пользователями и ролями
- ✅ CRUD операции для участков
- ✅ Веб-интерфейс
- ✅ REST API

**Что в разработке:**
- 🔄 Система проверок 5С
- 🔄 Мобильное приложение  
- 🔄 Расширенная отчетность
- 🔄 Уведомления

## ⚠️ Ограничения прототипа

1. **Безопасность:**
   - Пароли хранятся в открытой базе данных
   - Нет защиты от SQL-инъекций (используется ORM)
   - Сессии не защищены должным образом

2. **Производительность:**
   - Не оптимизировано для высокой нагрузки
   - Нет кэширования
   - SQLite не подходит для production

3. **Функциональность:**
   - Нет восстановления пароля
   - Нет email подтверждений
   - Минимальная валидация данных

## 🚀 Быстрый старт

### Установка и запуск

1. **Клонирование репозитория:**
```bash git clone https://github.com/maxfrank76/5s-system.git
cd 5s-system

2. Создание виртуального окружения:

source venv/bin/activate  # Linux/MacOS
# или .\venv\Scripts\activate  # Windows

3. Установка зависимостей: bash pip install -r requirements.txt

4. Запуск системы:

python simple_test.py

5. Открыть в браузере:
   • Главная страница: http://localhost:5000/
   • Веб-приложение: http://localhost:5000/app
   • API документация: http://localhost:5000/api/docs

👤 Тестовые пользователи

Пользователь	Пароль	Роль	Описание
admin	admin123	admin	Полный доступ
manager	manager123	manager	Управление участками
user1	user1123	user	Просмотр участков

📡 API Endpoints

Аутентификация

• POST /auth/login - вход в систему
• POST /auth/logout - выход из системы
• GET /auth/profile - профиль пользователя

Участки

• GET /api/areas - список участков
• POST /api/areas - создать участок (manager/admin)

Система

• GET /api/dashboard/stats - статистика системы
• GET /api/docs - документация API

🏗️ Архитектура

5s-system/
├── simple_test.py          # Основное приложение (прототип)
├── requirements.txt        # Зависимости Python
├── README.md              # Документация
└── 5s_system.db          # База данных (создается автоматически)

🔧 Технологии

• Backend: Flask, SQLAlchemy, Flask-Login
• Frontend: HTML5, CSS3, JavaScript (Vanilla)
• Database: SQLite
• Auth: Flask-Login с сессиями
• API: RESTful JSON API

📝 Методология 5С

Система поддерживает принципы 5С:

1. Сейри (Sort) - сортировка необходимого
2. Сейтон (Set) - соблюдение порядка
3. Сейсо (Shine) - содержание в чистоте
4. Сейкэцу (Standardize) - стандартизация
5. Сицукэ (Sustain) - совершенствование

🛠️ Для разработчиков

Процесс разработки

Этот проект создается с использованием AI-ассистированного программирования:

• Авторская концепция - оригинальная идея системы 5С
• Совместная реализация - человек и ИИ работают вместе
• Итеративный подход - постоянное тестирование и улучшение
• Быстрое прототипирование - ускоренная разработка функционала

Планы по развитию

• Рефакторинг на модульную структуру
• Добавление системы проверок 5С
• Интеграция с внешними системами
• Улучшение безопасности
• Docker контейнеризация

⚠️ Важное предупреждение

НЕ ИСПОЛЬЗУЙТЕ ЭТУ СИСТЕМУ В ПРОДАКШЕН СРЕДЕ!

Это прототип для демонстрации концепции. Для production использования требуется:

• Миграция на PostgreSQL/MySQL
• Реализация надежной аутентификации
• Добавление HTTPS
• Тестирование безопасности
• Резервное копирование данных
• Мониторинг и логирование

📄 Лицензия

MIT License - смотрите файл LICENSE для деталей.

Это прототип системы, созданный с помощью AI-ассистированного программирования. Используйте для ознакомления и тестирования концепции.