🚀 {PROJECT_NAME}

# 1. Клонировать репозиторий (если применимо)
git clone https://github.com/username/{PROJECT_NAME}.git
cd {PROJECT_NAME}

# 2. Установить зависимости
# Python:
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate  # Windows
pip install -r requirements.txt

# Node.js:
npm install

# 3. Настроить конфигурацию
cp .env.example .env
# Отредактировать .env (см. комментарии в файле)

# 4. Инициализировать БД (если применимо)
alembic upgrade head
# или
python scripts/init_db.py

# 5. Запустить проект
# Python/Streamlit:
streamlit run app.py

# Node.js:
npm start

# Django:
python manage.py runserver

# Flask:
flask run

# Открыть в браузере
http://localhost:8501  # Streamlit
http://localhost:3000  # React/Node
http://localhost:8000  # Django/FastAPI

# Или выполнить тест
pytest tests/
npm test

# Разработка
{КОМАНДА_ЗАПУСКА_DEV}          # Запустить в dev режиме
{КОМАНДА_ТЕСТОВ}               # Запустить тесты
{КОМАНДА_ЛИНТЕРА}              # Проверить код линтером

# База данных (если применимо)
alembic revision --autogenerate -m "description"  # Создать миграцию
alembic upgrade head                               # Применить миграции
alembic downgrade -1                               # Откатить последнюю миграцию

# Сборка и деплой
{КОМАНДА_СБОРКИ}               # Собрать production версию
{КОМАНДА_ДЕПЛОЯ}               # Задеплоить на сервер

{PROJECT_NAME}/
├── README.md                          # Этот файл
├── {PROJECT}-PROJECT-MASTER.md        # Главный документ проекта
├── {PROJECT}-CHANGELOG.md             # История изменений
├── .env.example                       # Пример конфигурации
├── requirements.txt / package.json    # Зависимости
│
├── app.py / src/                      # Основной код приложения
├── modules/                           # Модули/компоненты
├── pages/                             # Страницы (Streamlit)
├── tests/                             # Тесты
├── scripts/                           # Вспомогательные скрипты
├── docs/                              # Дополнительная документация
│   ├── diagrams/                      # Диаграммы
│   └── screenshots/                   # Скриншоты
│
└── data/ (gitignored)                 # Локальные данные

# Запустить все тесты
pytest tests/

# С покрытием
pytest --cov=modules tests/

# Конкретный тест
pytest tests/test_specific.py -v

# E2E тесты (если есть)
npm run test:e2e
playwright test