From 16e2532b479e4ff8895b2f8afa0e0d29b795ab2e Mon Sep 17 00:00:00 2001
From: Benaya Nathanael Yeroham <benayanathanael02@gmail.com>
Date: Wed, 2 Sep 2026 17:01:05 +0700
Subject: [PATCH] Add README

---
 README.md | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0031c0c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# Products API
+
+Tugas Web Service Lab 03: Contract-First API Design.
+
+## Struktur Project
+
+```
+.
+├── openapi.yaml      # Kontrak API (OpenAPI 3.0.3)
+├── app.py            # Backend Flask
+├── requirements.txt  # Dependencies
+└── .env.example     # Template DATABASE_URL
+```
+
+## Setup
+
+1. Install dependencies:
+   ```
+   pip install -r requirements.txt
+   ```
+
+2. Buat file `.env`:
+   ```
+   copy .env.example .env
+   ```
+
+3. Isi `.env` dengan connection string Neon:
+   ```
+   DATABASE_URL=postgresql://user:pass@host/neondb?sslmode=require
+   ```
+
+## Jalankan Backend
+
+```
+python -m flask --app app --env-file .env run
+```
+
+Server berjalan di `http://localhost:5000`.
+
+## Endpoint
+
+| Method | Path                  | Fungsi              |
+|--------|-----------------------|---------------------|
+| GET    | /products             | Ambil semua produk  |
+| GET    | /products/{id}        | Ambil satu produk   |
+| POST   | /products             | Tambah produk baru  |
+| DELETE | /products/{id}        | Hapus produk        |
+
+## Test dengan curl
+
+```bash
+# Ambil semua produk
+curl http://localhost:5000/products
+
+# Ambil satu produk
+curl http://localhost:5000/products/1
+
+# Tambah produk baru
+curl -X POST http://localhost:5000/products \
+  -H "Content-Type: application/json" \
+  -d '{"name":"Monitor","price":1500000,"stock":5}'
+
+# Hapus produk
+curl -X DELETE http://localhost:5000/products/4
+```
+
+## Database
+
+Menggunakan PostgreSQL Neon. Tabel `products` sudah tersedia dengan struktur:
+
+| Field  | Tipe         |
+|--------|--------------|
+| id     | integer (PK) |
+| name   | varchar(100) |
+| price  | numeric(12,2)|
+| stock  | integer      |