Файлообменник (fileshare) — сведения о релизе

Текущая версия: 0.10
Дата фиксации описания: 2026-04-17

--------------------------------------------------------------------------------
1. Назначение
--------------------------------------------------------------------------------

Веб-приложение на Go для обмена файлами: загрузка на сервер, хранение на диске,
метаданные в PostgreSQL, скачивание по ссылке. Есть простая HTML-страница и REST API.
По умолчанию HTTP-порт приложения: 8090.

--------------------------------------------------------------------------------
2. Что сделано в проекте
--------------------------------------------------------------------------------

2.1 Язык и зависимости
  - Go 1.22
  - github.com/lib/pq — драйвер PostgreSQL
  - github.com/google/uuid — идентификаторы файлов

2.2 Структура каталогов
  - cmd/fileshare/     — точка входа (main.go), встроенная статика web/
  - cmd/fileshare/web/ — index.html (форма загрузки, список файлов)
  - internal/config/   — переменные окружения (LISTEN_ADDR, DATABASE_URL, …)
  - internal/store/    — работа с БД, миграция таблицы при старте
  - internal/handlers/ — HTTP-обработчики API и отдача файлов
  - internal/version/  — константа версии (сейчас 0.10)

2.3 База данных (PostgreSQL)
  - Таблица files: id (UUID), исходное имя, тип содержимого, размер,
    storage_key (путь к файлу на диске), created_at
  - Индекс по дате создания для списка

2.4 Хранение файлов на диске
  - Каталог из UPLOAD_DIR (по умолчанию ./data/uploads; в Docker — /data/uploads)
  - Подкаталоги по первым символам UUID: ??/??/{uuid}.bin

2.5 HTTP API
  - GET  /health                  — проверка работы; JSON: status, version (0.10)
  - GET  /api/files               — список файлов (JSON), поле download_url
  - POST /api/files               — multipart/form-data, поле "file"
  - GET  /api/files/{id}/download — скачивание (Content-Disposition: attachment)
  - GET  /                         — веб-интерфейс (загрузка и список)

2.6 Docker
  - Dockerfile: multi-stage сборка (Alpine), бинарник без CGO
  - docker-compose.yml:
      * сервис db — postgres:16-alpine, том pgdata
      * сервис app — приложение, порт 8090:8090, том uploads для файлов
      * зависимость app от здоровья БД (healthcheck)
  - Переменные: POSTGRES_PASSWORD (из .env или значение по умолчанию),
    DATABASE_URL для приложения, MAX_UPLOAD_MB и др.

2.7 Установка
  - install.ps1  (Windows, PowerShell) — проверка Docker, копирование .env из
    .env.example при отсутствии .env, docker compose up -d --build
  - install.sh   (Unix) — то же для sh

2.8 Конфигурация через окружение
  - DATABASE_URL   — обязательно при локальном запуске без compose
  - LISTEN_ADDR    — например :8090
  - UPLOAD_DIR     — каталог загрузок
  - MAX_UPLOAD_MB  — лимит размера тела запроса (по умолчанию 100)
  - PUBLIC_BASE_URL — опционально, базовый URL для ссылок в JSON за reverse-proxy

2.9 Репозиторий Git
  - .gitignore   — бинарники, .env, data/, uploads/, IDE и т.д.
  - .gitattributes — eol для go, yaml, sh, ps1
  - .dockerignore — уменьшение контекста сборки

--------------------------------------------------------------------------------
3. Публикация версии 0.10
--------------------------------------------------------------------------------

Версия зафиксирована в коде: internal/version/version.go (константа Version = "0.10").
При старте сервер пишет в лог: fileshare v0.10 listening on …
Ответ GET /health включает поле "version": "0.10".

Рекомендуемые шаги для «публикации»:
  - git add -A && git commit -m "Release 0.10"
  - при использовании тегов: git tag -a v0.10 -m "fileshare 0.10"
  - сборка образа: docker compose build
  - выкладка: по вашему registry/серверу — отправка образа и compose-файлов

--------------------------------------------------------------------------------
4. Быстрый старт (напоминание)
--------------------------------------------------------------------------------

  Windows:  .\install.ps1
  Затем в браузере: http://localhost:8090/
  Проверка версии: http://localhost:8090/health

================================================================================