🚀 Developer Environment

Developer Environment — это современное веб-приложение для разработчиков, созданное для удобного управления проектами, задачами, отслеживания затраченного времени (time tracking) и хранения полезных материалов.

Проект построен с фокусом на производительность, чистый UI и надежную типизацию. Поддерживает бесшовную аутентификацию и гостевой доступ.

✨ Текущий функционал

• Управление проектами: Создание, редактирование и удаление проектов.
• Трекинг задач (Task Management): Управление списком задач внутри каждого проекта.
• Учет времени (Time Entries): Возможность логировать затраченное время прямо из таблицы задач.
• Аутентификация: Надежная система входа через Email/Password, Google и GitHub (на базе Better Auth), а также анонимные (гостевые) сессии для тестирования функционала.
• Темная/Светлая тема: Полная поддержка системной темы с помощью next-themes.

🚧 В планах (Roadmap)

• Детальная страница задачи: Полноценный рабочий экран для описания, заметок и индивидуального учета времени по задаче.
• Хранилище данных (Repository): Отдельный модуль для сохранения важных файлов, сниппетов и артефактов разработки.
• Быстрые ссылки (Quick Links): Дашборд с кастомными закладками для быстрого доступа к важным ресурсам.

🛠 Технологический стек

• Фреймворк: Next.js (App Router, Server Actions)
• База данных: PostgreSQL (via Supabase)
• ORM: Prisma
• Аутентификация: Better Auth
• Файловое хранилище: Vercel Blob
• Стилизация: Tailwind CSS v4
• UI Компоненты: Shadcn/ui
• Формы и Валидация: React Hook Form + Zod
• Инструменты кода: ESLint, Prettier, TypeScript, Lefthook, TypeScript strict mode.

---

💻 Локальный запуск (Getting Started)

Инструкция по развертыванию проекта на локальной машине.

1. Требования

Убедитесь, что у вас установлены:

• Node.js (v20+)
• pnpm (пакетный менеджер проекта)
• PostgreSQL (локально или облачно, например, Supabase)

2. Установка зависимостей

Клонируйте репозиторий и установите пакеты:

git clone https://github.com/shchurofff/developer_env.git
cd developer_env
pnpm install

3. Настройка переменных окружения

Создайте файл .env в корне проекта, скопировав структуру из .env.example:

cp .env.example .env

Затем заполните .env вашими реальными ключами

4. 🔐 Конфигурация .env (Environment Variables)

Для корректной работы приложения вам понадобятся следующие сервисы:

• База данных (PostgreSQL / Supabase):

  DATABASE_URL: Строка подключения к базе данных.

  DIRECT_URL: Прямая строка подключения.

• Vercel Blob:

  BLOB_READ_WRITE_TOKEN: Токен для загрузки и чтения файлов.

• Better Auth:

  BETTER_AUTH_SECRET: Случайная строка для шифрования сессий.

  BETTER_AUTH_URL: Базовый URL приложения (для локалки: http://localhost:3000).

• OAuth Провайдеры (Google & GitHub):

  Получите CLIENT_ID и CLIENT_SECRET в соответствующих консолях разработчика (Google Cloud Console и GitHub Developer Settings).

5. Инициализация Базы Данных

Сгенерируйте клиент Prisma и примените миграции:

pnpm prisma generate
pnpm prisma db push
# или pnpm prisma migrate dev (если используете историю миграций)

6. Запуск

Запустите сервер для разработки:

pnpm dev

⚡Интеграция с Zed IDE

Если вашим основным редактором является Zed, проект уже содержит преднастроенные задачи (tasks) для быстрого старта. Они лежат в файле .zed/tasks.json.

Как использовать:

1. Откройте проект в Zed.
2. Нажмите Cmd + Shift + R (на Mac) или Ctrl + Shift + R (на Windows/Linux), чтобы открыть меню задач.
3. Либо откройте Command Palette (Cmd/Ctrl + Shift + P) и введите task: spawn.
4. В появившемся списке выберите нужную команду:
   • Development Server — запускает pnpm dev в фоновом терминале.
   • Build the application — собирает проект.
   • Lint the project — запускает проверку кода.
   • Production Server — запускает собранный проект.

Терминал автоматически скроется при успешном выполнении (например, при линтинге) или останется в доке, если это запущенный сервер.

---

📁 Структура проекта

Проект использует гибридную архитектуру, разделяя общие UI-элементы и бизнес-логику:

app/                #  Роутинг Next.js (страницы, layout, API)
modules/            # Изолированные бизнес-модули (auth, projects, tasks, home)
components/
  ui/               # Переиспользуемые "глупые" UI-компоненты
server/             # Серверные действия (Server Actions) и сервисы для работы с БД
lib/                # Утилиты, хелперы и конфигурации
prisma/             # Схема базы данных и миграции