Newer
Older
gnexus-tasks / README.md

gntodo (gnexus-tasks)

Персональный менеджер задач: быстрый захват без метаданных, автодетализация через локальную LLM (Ollama), дерево задач, MCP-интерфейс для ИИ-агентов.

Техническое задание: docs/TZ.md.

Стек

  • Frontend: Vue 3 SPA + gnexus-ui-kit (Vite, TypeScript)
  • Backend: Python 3.12, FastAPI, SQLAlchemy/PostgreSQL
  • SSO: auth.gnexus.space через gnexus-gauth
  • AI: Ollama (модель из конфига) — автодетализация метаданных
  • MCP: MCP-сервер в составе backend (M5)
  • Деплой: Docker Compose на VPS

Структура

docs/          — техническое задание и прочая документация
backend/       — FastAPI API + MCP (Python, uv)
frontend/      — Vue 3 SPA (Vite, TypeScript)

Разработка

Backend:

cd backend
uv sync                  # создаст .venv, установит зависимости
uv run uvicorn app.main:app --reload

Frontend:

cd frontend
npm install
npm run dev              # http://localhost:5173, /api проксируется на :8000

Прод-сборка: docker compose up -d --build (настройки — .env, шаблон .env.example).

Вехи

M0 — каркас (репо, скелеты, SSO, деплой) → M1 MVP задач → M2 автодетализация → M3 структура → M4 прогнозы/бюджет/«3 варианта» → M5 MCP → M6 PWA → M7 Docker-упаковка.