admin/enduro-trails
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
5d7fda44bba5b59fef389eff3a6164ba3954eba9
enduro-trails/CLAUDE.md
Slava 5d7fda44bb feat: initial project structure 
- CLAUDE.md project passport
- Agent system prompts (architect, developer, reviewer, tester, deployer)
- Gitea Actions CI pipeline (lint, test, build)
- Docker configuration (Dockerfile, docker-compose.yml)
- Canonical directory structure per BRD
- Makefile with dev/test/lint/build/deploy targets
- Architecture docs skeleton

Refs: multi-agent F0-3, F0-5, F0-6, F0-8
2026-05-15 13:30:14 +03:00

2.7 KiB
Raw Blame History

CLAUDE.md — паспорт проекта enduro-trails

TL;DR

Карта эндуро-маршрутов с рельефом, навигацией и слоями terrain/TRI/hillshade. Веб-приложение для планирования офф-роуд маршрутов с учётом сложности рельефа.

Стек

  • Frontend: MapLibre GL JS + vanilla JS (без фреймворка)
  • Backend: FastAPI + uvicorn (Python 3.12)
  • БД: SQLite (Spatialite) → PostGIS (при масштабировании)
  • Тайлы: self-hosted raster tiles (terrain, hillshade, TRI)
  • Роутинг: OSRM (кастомный эндуро-профиль)
  • Контейнеризация: Docker + Compose
  • CI/CD: Gitea Actions
  • Деплой: docker compose up -d на mva154

Команды

  • make dev — поднять локально
  • make test — все тесты
  • make lint — линтеры (ruff + eslint)
  • make build — собрать Docker-образ
  • make deploy-test — деплой в test

Среды

Структура

  • src/api/ — FastAPI backend (маршруты, тайлы, поиск)
  • src/web/ — фронтенд (MapLibre, UI компоненты)
  • tests/ — тесты (unit, integration, e2e)
  • docs/ — документация, ADR, work-items
  • scripts/ — утилиты (lint, coverage, deploy)
  • migrations/ — миграции БД

Конвенции

  • Conventional Commits (feat:, fix:, docs:, refactor:, test:)
  • Ветки: feature/PROJ-NNN-slug, bugfix/PROJ-NNN-slug
  • ADR: docs/architecture/adr/adr-NNNN-slug.md
  • Work items: docs/work-items/<plane-id>/

Правила для агентов

  1. Перед любым действием прочесть этот файл и docs/architecture/README.md.
  2. Никогда не править артефакты других этапов.
  3. Никогда не комментировать ТЗ задним числом — если ТЗ не годится, возвращай в Анализ.
  4. Никогда не закрывать задачу самостоятельно — это делает CI.
  5. Бюджет токенов на задачу — в .openclaw/budget.yaml.
  6. Коммиты от имени claude-bot (git config user.name/email уже настроен).
  7. Не использовать --no-verify без явного одобрения Owner.

Данные

  • Terrain tiles: /home/slin/enduro-trails/data/terrain/ (hillshade, TRI, hypso)
  • OSM данные: /home/slin/enduro-trails/data/osm/
  • OSRM графы: /home/slin/enduro-trails/data/osrm/
Reference in New Issue View Git Blame Copy Permalink