till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-14 19:01:08 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/apps/traces/CLAUDE.md
Till JS ab387b9b3d chore: remove all NestJS backend references, replace with Hono/Bun 
- Delete nestjs-backend.md guideline (replaced by hono-server.md)
- Delete Dockerfile.nestjs-base and Dockerfile.nestjs templates
- Delete stale BACKEND_ARCHITECTURE.md doc (NestJS-era, obsolete)
- Update CLAUDE.md, GUIDELINES.md, authentication.md to Hono/Bun first
- Update all app CLAUDE.md files: backend/ → server/, NestJS → Hono+Bun
- Update all app package.json files: @*/backend → @*/server
- Update docs: LOCAL_DEVELOPMENT, PORT_SCHEMA, ENVIRONMENT_VARIABLES,
  DATABASE_MIGRATIONS, MAC_MINI_SERVER, PROJECT_OVERVIEW
- Update scripts: generate-env.mjs, setup-databases.sh, build-app.sh
- Update CI/CD: cd-macmini.yml backend → server paths
- Update Astro docs site: @chat/backend → @chat/server

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 16:52:25 +02: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/server (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:server       # 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