feat: Phase 1 complete – full working application
Backend (FastAPI): - REST API: auth, plants, beds, plantings - CRUD layer with CRUDBase - Pydantic v2 schemas for all entities - Alembic migration: complete schema + all enums - Seed data: 28 global plants + 15 compatibilities Frontend (Vue 3 + PrimeVue): - Axios client with JWT interceptor + auto-refresh - Pinia stores: auth, beds, plants - Views: Login, Beds, BedDetail, PlantLibrary - Components: AppLayout, BedForm, PlantingForm, PlantForm Docker: - docker-compose.yml (production) - docker-compose.dev.yml (development with hot-reload) - Nginx config with SPA fallback + API proxy - Multi-stage frontend Dockerfile - .env.example, .gitignore Version: 1.0.0-alpha
This commit is contained in:
Faultier314
@@ -10,71 +10,138 @@
|
||||
|
||||
```
|
||||
gartenmanager/
|
||||
├── .claude/ # Claude-Tooling (kein Projektcode)
|
||||
│ ├── scripts/
|
||||
│ │ ├── bump.sh # Version bumpen + commit + push
|
||||
│ │ └── new-feature.sh # Feature-Branch erstellen
|
||||
│ └── session-context.md # Sessionstart-Kontext
|
||||
├── .gitea/
|
||||
│ └── PULL_REQUEST_TEMPLATE.md
|
||||
├── docs/
|
||||
│ ├── branching-strategy.md
|
||||
│ ├── development-standards.md
|
||||
│ └── project-structure.md # dieses Dokument
|
||||
├── .gitattributes
|
||||
├── .claude/ # Claude-Tooling (kein Projektcode)
|
||||
│ ├── scripts/bump.sh # Version bumpen + commit + push
|
||||
│ ├── scripts/new-feature.sh # Feature-Branch erstellen
|
||||
│ └── session-context.md # Sessionstart-Kontext
|
||||
├── .gitea/PULL_REQUEST_TEMPLATE.md
|
||||
├── backend/ # FastAPI Python Backend
|
||||
│ ├── app/
|
||||
│ │ ├── main.py # FastAPI App, CORS, Router-Include, /health
|
||||
│ │ ├── core/
|
||||
│ │ │ ├── config.py # pydantic-settings (DATABASE_URL, SECRET_KEY, ...)
|
||||
│ │ │ ├── security.py # JWT erstellen/prüfen, Passwort-Hashing
|
||||
│ │ │ └── deps.py # FastAPI-Dependencies: get_current_user, get_tenant_context, require_min_role()
|
||||
│ │ ├── db/
|
||||
│ │ │ ├── base.py # DeclarativeBase + alle Model-Imports für Alembic
|
||||
│ │ │ └── session.py # async Engine, AsyncSessionLocal, get_session()
|
||||
│ │ ├── models/ # SQLAlchemy ORM (alle UUID-PKs, async)
|
||||
│ │ │ ├── user.py # User, UserTenant (+ TenantRole Enum)
|
||||
│ │ │ ├── tenant.py # Tenant
|
||||
│ │ │ ├── plant.py # PlantFamily, Plant, PlantCompatibility
|
||||
│ │ │ ├── bed.py # Bed (+ LocationType, SoilType Enums)
|
||||
│ │ │ └── planting.py # BedPlanting
|
||||
│ │ ├── schemas/ # Pydantic v2 (Create/Update/Read)
|
||||
│ │ │ ├── auth.py # LoginRequest, RefreshRequest, TokenResponse, AccessTokenResponse
|
||||
│ │ │ ├── user.py # UserCreate, UserUpdate, UserRead
|
||||
│ │ │ ├── tenant.py # TenantCreate, TenantUpdate, TenantRead
|
||||
│ │ │ ├── plant.py # PlantCreate/Update/Read, PlantFamilyRead, PlantCompatibilityRead
|
||||
│ │ │ ├── bed.py # BedCreate/Update/Read/DetailRead, PlantingInBed
|
||||
│ │ │ └── planting.py # PlantingCreate/Update/Read
|
||||
│ │ ├── crud/ # DB-Zugriff, keine Business-Logik
|
||||
│ │ │ ├── base.py # CRUDBase[Model, Create, Update]: get, get_multi, create, update, remove
|
||||
│ │ │ ├── user.py # get_by_email, authenticate, get_tenants
|
||||
│ │ │ ├── plant.py # get_multi_for_tenant (global+tenant), create_for_tenant
|
||||
│ │ │ ├── bed.py # get_multi_for_tenant, get_with_plantings, create_for_tenant
|
||||
│ │ │ └── planting.py # get_multi_for_bed, create_for_bed
|
||||
│ │ ├── api/v1/
|
||||
│ │ │ ├── router.py # Alle Sub-Router unter /api/v1
|
||||
│ │ │ ├── auth.py # POST /login, POST /refresh, GET /me
|
||||
│ │ │ ├── plants.py # GET/POST/PUT/DELETE /plants, GET /plant-families
|
||||
│ │ │ ├── beds.py # GET/POST/PUT/DELETE /beds
|
||||
│ │ │ └── plantings.py # GET/POST /beds/{id}/plantings, PUT/DELETE /plantings/{id}
|
||||
│ │ └── seeds/
|
||||
│ │ └── initial_data.py # 28 globale Pflanzen + 15 Kompatibilitäten (idempotent)
|
||||
│ ├── alembic/
|
||||
│ │ ├── env.py # Async Alembic-Config, liest DATABASE_URL aus Settings
|
||||
│ │ └── versions/001_initial.py # Vollständiges initiales Schema (alle Tabellen + Enums)
|
||||
│ ├── requirements.txt
|
||||
│ └── Dockerfile # python:3.11-slim, uvicorn
|
||||
├── frontend/ # Vue 3 SPA
|
||||
│ ├── src/
|
||||
│ │ ├── main.js # App-Bootstrap: PrimeVue, Pinia, Router
|
||||
│ │ ├── App.vue # Root: AppLayout (eingeloggt) / router-view (Login)
|
||||
│ │ ├── api/
|
||||
│ │ │ ├── client.js # Axios-Instanz, JWT-Interceptor, Auto-Refresh bei 401
|
||||
│ │ │ └── index.js # authApi, plantsApi, bedsApi, plantingsApi
|
||||
│ │ ├── stores/
|
||||
│ │ │ ├── auth.js # user, tenants, activeTenantId, login(), logout(), setActiveTenant()
|
||||
│ │ │ ├── beds.js # beds, currentBed, fetchBeds/Bed, createBed/Planting, deleteBed/Planting
|
||||
│ │ │ └── plants.js # plants, families, fetchPlants/Families, create/update/deletePlant
|
||||
│ │ ├── router/index.js # /login, /beete, /beete/:id, /pflanzen – auth guard
|
||||
│ │ ├── views/
|
||||
│ │ │ ├── LoginView.vue # Email+Passwort Formular
|
||||
│ │ │ ├── BedsView.vue # DataTable aller Beete, Create/Edit-Dialog
|
||||
│ │ │ ├── BedDetailView.vue # Beet-Infos + Bepflanzungs-Tabelle + Add-Dialog
|
||||
│ │ │ └── PlantsView.vue # Pflanzenbibliothek DataTable, Filter, eigene Pflanze anlegen
|
||||
│ │ └── components/
|
||||
│ │ ├── AppLayout.vue # Navbar (Logo, Nav-Links, Tenant-Selector, Logout)
|
||||
│ │ ├── BedForm.vue # Formular für Beet anlegen/bearbeiten
|
||||
│ │ ├── PlantingForm.vue # Formular für Bepflanzung hinzufügen
|
||||
│ │ └── PlantForm.vue # Formular für eigene Pflanze anlegen
|
||||
│ ├── nginx.conf # SPA fallback + API-Proxy → backend:8000
|
||||
│ ├── Dockerfile # Multi-stage: node:20 build → nginx:alpine
|
||||
│ └── package.json
|
||||
├── docker-compose.yml # Produktion: db + backend + frontend
|
||||
├── docker-compose.dev.yml # Entwicklung: db + backend (reload) + Frontend lokal via npm run dev
|
||||
├── .env.example # Vorlage für .env
|
||||
├── .gitignore
|
||||
├── CHANGELOG.md
|
||||
├── CLAUDE.md
|
||||
├── README.md
|
||||
└── VERSION
|
||||
```
|
||||
|
||||
> Sobald Quellcode-Verzeichnisse entstehen, hier ergänzen.
|
||||
---
|
||||
|
||||
## Berechtigungslogik
|
||||
|
||||
```
|
||||
is_superadmin=True → alles erlaubt, Tenant-Prüfung wird übersprungen
|
||||
TENANT_ADMIN → alles im eigenen Tenant (inkl. Beet löschen)
|
||||
READ_WRITE → lesen + schreiben, kein Beet löschen
|
||||
READ_ONLY → nur GET-Endpoints
|
||||
```
|
||||
|
||||
`require_min_role(TenantRole.READ_WRITE)` in `deps.py` gibt `(user, tenant_id, role)` zurück.
|
||||
|
||||
---
|
||||
|
||||
## Modulübersicht
|
||||
## Datenbankschema (Kurzform)
|
||||
|
||||
> Noch kein Anwendungscode vorhanden. Sobald Module/Komponenten entstehen:
|
||||
>
|
||||
> ```
|
||||
> Modulname | Datei(en) | Zweck | Exportierte Funktionen
|
||||
> ```
|
||||
>
|
||||
> **Format pro Funktion:**
|
||||
> `funktionsname(param: Typ): Rückgabetyp` – Ein-Satz-Beschreibung
|
||||
```
|
||||
users → id, email, hashed_password, is_superadmin
|
||||
tenants → id, name, slug
|
||||
user_tenants → user_id, tenant_id, role
|
||||
plant_families → id, name, latin_name
|
||||
plants → id, tenant_id(nullable=global), family_id, nutrient_demand, water_demand, rest_years, ...
|
||||
plant_compat. → plant_id_a, plant_id_b, rating, reason
|
||||
beds → id, tenant_id, width_m, length_m, location, soil_type
|
||||
bed_plantings → id, bed_id, plant_id, area_m2, count, planted_date, removed_date
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Domänenmodell
|
||||
## API-Routen Übersicht
|
||||
|
||||
| Entität | Felder (geplant) | Beziehungen |
|
||||
|---|---|---|
|
||||
| `Plant` | name, sowingStart, sowingEnd, waterInterval, spacing | gehört zu Bed |
|
||||
| `Bed` | name, width, length, location | enthält viele Plants |
|
||||
| `SowingCalendar` | year, plantId, sowDate, plantDate | referenziert Plant |
|
||||
| `Task` | title, dueDate, done, bedId? | optional zu Bed |
|
||||
| `WateringSchedule` | bedId/plantId, intervalDays, lastWatered | referenziert Bed oder Plant |
|
||||
|
||||
---
|
||||
|
||||
## Datenhaltung
|
||||
|
||||
> Noch festzulegen (SQLite, PostgreSQL, lokale Dateien …).
|
||||
|
||||
---
|
||||
|
||||
## Schnittstellen / API
|
||||
|
||||
> Noch festzulegen. Hier Endpunkte mit Kurzbeschreibung eintragen:
|
||||
>
|
||||
> ```
|
||||
> GET /api/plants – alle Pflanzen
|
||||
> POST /api/plants – neue Pflanze anlegen
|
||||
> ...
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## Konfiguration
|
||||
|
||||
> Relevante Umgebungsvariablen und Konfigurationsdateien hier auflisten.
|
||||
```
|
||||
POST /api/v1/auth/login
|
||||
POST /api/v1/auth/refresh
|
||||
GET /api/v1/auth/me
|
||||
GET /api/v1/plant-families
|
||||
GET /api/v1/plants
|
||||
GET /api/v1/plants/{id}
|
||||
POST /api/v1/plants (READ_WRITE+)
|
||||
PUT /api/v1/plants/{id} (READ_WRITE+, global nur Superadmin)
|
||||
DELETE /api/v1/plants/{id} (READ_WRITE+, global nur Superadmin)
|
||||
GET /api/v1/beds
|
||||
GET /api/v1/beds/{id} (mit Bepflanzungen)
|
||||
POST /api/v1/beds (READ_WRITE+)
|
||||
PUT /api/v1/beds/{id} (READ_WRITE+)
|
||||
DELETE /api/v1/beds/{id} (TENANT_ADMIN+)
|
||||
GET /api/v1/beds/{id}/plantings
|
||||
POST /api/v1/beds/{id}/plantings (READ_WRITE+)
|
||||
PUT /api/v1/plantings/{id} (READ_WRITE+)
|
||||
DELETE /api/v1/plantings/{id} (READ_WRITE+)
|
||||
GET /health
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user