🎉 init: 小龙的工作空间

2026-06-06 10:40:48 +08:00
commit a188ee1426
3201 changed files with 231817 additions and 0 deletions
@@ -0,0 +1,139 @@
+# MealPrep — Backend API
+
+> 一款支持商品浏览、购物车、在线支付和物流追踪的电商应用。
+
+## Tech Stack
+
+- **Runtime**: Node.js
+- **Framework**: Fastify 5
+- **Language**: TypeScript
+- **Database**: SQLite (better-sqlite3)
+- **Auth**: JWT + bcrypt
+
+## Getting Started
+
+```bash
+# Install dependencies
+npm install
+
+# Development (hot reload)
+npm run dev
+
+# Build
+npm run build
+
+# Production start
+npm run start
+
+# Run tests
+npm test
+```
+
+## Project Structure
+
+```
+src/
+├── index.ts          # Server entry point
+├── db/
+│   ├── schema.ts     # SQLite schema
+│   └── client.ts     # Database client
+├── routes/
+│   ├── auth.ts       # Auth routes (register/login/me)
+│   └── *.ts          # CRUD routes
+├── services/
+│   └── *.ts          # Business logic
+├── middleware/
+│   └── auth.ts       # JWT middleware
+├── types/
+│   └── index.ts      # TypeScript types
+└── __tests__/
+    └── *.test.ts     # Tests
+```
+
+## API Endpoints
+
+### Auth
+- `POST /api/auth/register` — Register
+- `POST /api/auth/login` — Login
+- `GET  /api/auth/me` — Current user (auth required)
+
+### Resources
+#### users
+- `GET    /api/users` — List all
+- `GET    /api/users/:id` — Get by ID
+- `POST   /api/users` — Create
+- `PUT    /api/users/:id` — Update
+- `DELETE /api/users/:id` — Delete
+
+#### foods
+- `GET    /api/foods` — List all
+- `GET    /api/foods/:id` — Get by ID
+- `POST   /api/foods` — Create
+- `PUT    /api/foods/:id` — Update
+- `DELETE /api/foods/:id` — Delete
+
+#### customers
+- `GET    /api/customers` — List all
+- `GET    /api/customers/:id` — Get by ID
+- `POST   /api/customers` — Create
+- `PUT    /api/customers/:id` — Update
+- `DELETE /api/customers/:id` — Delete
+
+#### meal_plans
+- `GET    /api/meal_plans` — List all
+- `GET    /api/meal_plans/:id` — Get by ID
+- `POST   /api/meal_plans` — Create
+- `PUT    /api/meal_plans/:id` — Update
+- `DELETE /api/meal_plans/:id` — Delete
+
+#### nutrition
+- `GET    /api/nutrition` — List all
+- `GET    /api/nutrition/:id` — Get by ID
+- `POST   /api/nutrition` — Create
+- `PUT    /api/nutrition/:id` — Update
+- `DELETE /api/nutrition/:id` — Delete
+
+#### shopping_lists
+- `GET    /api/shopping_lists` — List all
+- `GET    /api/shopping_lists/:id` — Get by ID
+- `POST   /api/shopping_lists` — Create
+- `PUT    /api/shopping_lists/:id` — Update
+- `DELETE /api/shopping_lists/:id` — Delete
+
+#### templates
+- `GET    /api/templates` — List all
+- `GET    /api/templates/:id` — Get by ID
+- `POST   /api/templates` — Create
+- `PUT    /api/templates/:id` — Update
+- `DELETE /api/templates/:id` — Delete
+
+#### products
+- `GET    /api/products` — List all
+- `GET    /api/products/:id` — Get by ID
+- `POST   /api/products` — Create
+- `PUT    /api/products/:id` — Update
+- `DELETE /api/products/:id` — Delete
+
+#### orders
+- `GET    /api/orders` — List all
+- `GET    /api/orders/:id` — Get by ID
+- `POST   /api/orders` — Create
+- `PUT    /api/orders/:id` — Update
+- `DELETE /api/orders/:id` — Delete
+
+#### order_items
+- `GET    /api/order_items` — List all
+- `GET    /api/order_items/:id` — Get by ID
+- `POST   /api/order_items` — Create
+- `PUT    /api/order_items/:id` — Update
+- `DELETE /api/order_items/:id` — Delete
+
+#### logistics
+- `GET    /api/logistics` — List all
+- `GET    /api/logistics/:id` — Get by ID
+- `POST   /api/logistics` — Create
+- `PUT    /api/logistics/:id` — Update
+- `DELETE /api/logistics/:id` — Delete
+
+### System
+- `GET /api/health` — Health check