till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-15 20:19:39 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/apps/traces/CLAUDE.md
Till JS bd1178edf8 feat(traces): integrate traces app into monorepo with NestJS backend and AI city guides 
Restructure standalone traces app into monorepo pattern with mobile + backend + shared types.
Add NestJS backend with Drizzle ORM schema for locations, cities, places, POIs, and AI guides.
Add mobile sync layer, cities tab, and guide generation UI. Fix pre-existing type errors across
mobile codebase, matrix-mana-bot (sendDirectMessage), llm-playground, and all web auth stores
(signUp call signature).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 08:12:42 +01:00

2.8 KiB
Raw Blame History

CLAUDE.md - Traces

GPS tracking app with AI city guides. Location tracking runs locally via AsyncStorage, with optional backend sync.

Project Structure

apps/traces/
├── package.json              # Orchestrator (name: traces)
├── apps/
│   ├── backend/              # @traces/backend (NestJS, Port 3026)
│   │   └── src/
│   │       ├── main.ts
│   │       ├── app.module.ts
│   │       ├── db/           # Drizzle schema + connection
│   │       ├── location/     # GPS sync endpoint
│   │       ├── city/         # City CRUD + visit stats
│   │       ├── place/        # Saved places CRUD
│   │       ├── poi/          # Points of Interest
│   │       └── guide/        # AI city guide pipeline
│   └── mobile/               # @traces/mobile (Expo SDK 54)
│       ├── app/              # Expo Router screens
│       ├── components/       # UI components
│       └── utils/            # Services (location, sync, api)
└── packages/
    └── traces-types/         # @traces/types (shared interfaces)

Commands

# Development
pnpm dev:traces:mobile        # Start Expo app
pnpm dev:traces:backend       # Start NestJS backend
pnpm dev:traces:full          # Start auth + backend + mobile

# Database
pnpm traces:db:push           # Push Drizzle schema
pnpm traces:db:studio         # Open Drizzle Studio

Architecture

  • Mobile: Offline-first. All GPS data in AsyncStorage. Sync is additive.
  • Backend: NestJS + Drizzle ORM + PostgreSQL. Auth via ManaCoreModule.
  • AI Guides: Uses mana-search for POI discovery, mana-llm for narratives.
  • Credits: 5 base + 2 per POI consumed via CreditClientService.

API Endpoints

Endpoint Method Description
/api/v1/locations/sync POST Batch sync from mobile
/api/v1/locations GET Query locations
/api/v1/cities GET User's visited cities
/api/v1/cities/:id GET City detail + stats
/api/v1/places GET/POST List/create places
/api/v1/places/:id PUT/DELETE Update/delete place
/api/v1/pois GET Nearby POIs
/api/v1/pois/:id GET POI detail
/api/v1/guides/generate POST Generate AI guide
/api/v1/guides GET User's guides
/api/v1/guides/:id GET/DELETE Guide detail/delete

Environment Variables

Backend: PORT=3026, DATABASE_URL, MANA_CORE_AUTH_URL, MANA_LLM_URL, MANA_SEARCH_URL Mobile: EXPO_PUBLIC_TRACES_BACKEND_URL, EXPO_PUBLIC_MANA_CORE_AUTH_URL

Mobile Navigation (5 tabs)

  1. Tracking - Live GPS tracking + map
  2. Orte - Saved places, cities, countries
  3. Karte - Full-screen map view
  4. Städte - Visited cities with stats
  5. Führungen - AI-generated city guides