Initial commit: gocarlog project — Milestones 1-10 completed
This commit is contained in:
@@ -0,0 +1,61 @@
|
||||
# GoCarLog - Projektstruktur
|
||||
|
||||
## Verzeichnisstruktur
|
||||
|
||||
```
|
||||
gocarlog/
|
||||
├── cmd/
|
||||
│ └── server/
|
||||
│ └── main.go # Entry point: DB init, Router starten, Server starten
|
||||
├── internal/
|
||||
│ ├── db/
|
||||
│ │ ├── database.go # SQLite-Verbindung, Migrationen, Seed-Daten (Kraftstoffe)
|
||||
│ │ └── migration.sql # SQL-Statements für Tabellen-Erstellung
|
||||
│ ├── model/
|
||||
│ │ ├── fuel.go # Struktur + Methoden für Kraftstoff
|
||||
│ │ ├── vehicle.go # Struktur + Methoden für Fahrzeug
|
||||
│ │ └── log.go # Struktur + Methoden für Logbucheintrag
|
||||
│ ├── handler/
|
||||
│ │ ├── vehicle.go # HTTP-Handler: POST /api/vehicles, GET /api/vehicles, GET /api/vehicles/:id
|
||||
│ │ ├── log.go # HTTP-Handler: POST /api/logs, GET /api/logs
|
||||
│ │ ├── consumption.go # HTTP-Handler: GET /api/vehicles/:id/consumption
|
||||
│ │ └── static.go # Statische Dateien ausliefern (frontend/)
|
||||
│ ├── router/
|
||||
│ │ └── router.go # Router-Setup mit gorilla/mux oder net/http
|
||||
│ └── middleware/
|
||||
│ └── middleware.go # CORS, Logging, Error-Handling
|
||||
├── frontend/
|
||||
│ ├── index.html # Hauptseite mit SPA-Routing
|
||||
│ ├── css/
|
||||
│ │ └── style.css # Dunkles, modernes Design
|
||||
│ ├── js/
|
||||
│ │ ├── app.js # SPA-Routing, View-Management
|
||||
│ │ ├── api.js # API-Client (fetch-Wrapper)
|
||||
│ │ └── views/
|
||||
│ │ ├── logs.js # Logbuch-Ansicht
|
||||
│ │ ├── vehicles.js # Fahrzeugliste
|
||||
│ │ ├── vehicle-detail.js # Fahrzeugdetails
|
||||
│ │ └── forms.js # Eingabemasken (Fahrzeug anlegen, Log eintragen)
|
||||
│ └── assets/
|
||||
│ └── (Icons, Bilder)
|
||||
├── docs/
|
||||
│ ├── project-structure.md # Diese Datei
|
||||
│ ├── database-schema.md # Datenbank-Struktur (Milestone 3)
|
||||
│ └── api-spec.md # JSON-Schnittstelle (Milestone 4)
|
||||
├── tests/ # Integrationstests
|
||||
│ └── api_test.go
|
||||
├── go.mod # Go Module Definition
|
||||
└── README.md
|
||||
```
|
||||
|
||||
## Package-Erklärung
|
||||
|
||||
- **`cmd/server`**: Der einzige Entry Point. Initialisiert DB, lädt Router, startet HTTP-Server.
|
||||
- **`internal/db`**: Datenbankverbindung, Schema-Migrationen, Initialdaten.
|
||||
- **`internal/model`**: Datenstrukturen (Go structs) und domain-spezifische Methoden.
|
||||
- **`internal/handler`**: HTTP-Handler-Funktionen (Request → Response).
|
||||
- **`internal/router`**: URL-Routing-Definitionen.
|
||||
- **`internal/middleware`**: Cross-cutting concerns (CORS, Logging, Error-Handling).
|
||||
- **`frontend/`**: Statische Webdateien (HTML/CSS/JS), vom Backend ausgeliefert.
|
||||
- **`docs/`**: Projektdokumentation.
|
||||
- **`tests/`**: Testdateien.
|
||||
Reference in New Issue
Block a user