Skip to content

Commit b606166

Browse files
Berny-ftBerny-ft
authored
Merge pull request #38 from hack4impact/feature/4-db-schema
Feat : Designed and implemented database schema and tables
2 parents a78bc14 + 9f607ff commit b606166

9 files changed

Lines changed: 527 additions & 197 deletions

File tree

‎docs/coaching.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Coaching Sessions Table
2+
3+
One-on-one sessions booked between a user and a coach. Linked to a `coaching_session`-type entry in `services`.
4+
5+
```mermaid
6+
erDiagram
7+
coaching_sessions {
8+
uuid id PK
9+
uuid service_id FK
10+
uuid coach_id FK
11+
uuid user_id FK
12+
timestamp scheduled_at "null until a slot is confirmed"
13+
int duration_minutes
14+
session_status status "pending | confirmed | cancelled | completed"
15+
text meeting_url
16+
text notes
17+
jsonb selected_time_slots "array of {start, end} objects"
18+
timestamp created_at
19+
timestamp updated_at
20+
}
21+
22+
profiles ||--o{ coaching_sessions : "coach leads"
23+
profiles ||--o{ coaching_sessions : "user attends"
24+
services ||--o{ coaching_sessions : "fulfilled by"
25+
```
26+
27+
## Notes
28+
29+
- `scheduled_at` is null by default — it is set once the user selects a specific slot from `selected_time_slots`.
30+
- `selected_time_slots` is a JSON array of `{ start, end }` objects (ISO 8601 strings) representing the time options offered to the user e.g. `[{ "start": "2026-04-14T14:00:00Z", "end": "2026-04-14T17:00:00Z" }]`.
31+
- `meeting_url` is provided by the coach after confirmation.
32+
- `status = completed` is set after the session ends.

‎docs/profiles.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Profiles Table
2+
3+
Mirrors Supabase `auth.users` — populated via a database trigger on signup. Stores display data and the user's role within the platform.
4+
5+
```mermaid
6+
erDiagram
7+
profiles {
8+
uuid id PK "references auth.users(id)"
9+
text first_name
10+
text last_name
11+
role role "user | admin | coach"
12+
timestamp created_at
13+
timestamp updated_at
14+
}
15+
```
16+
17+
## Notes
18+
19+
- `id` is **not** auto-generated — it is set to the corresponding `auth.users.id` from Supabase Auth.
20+
- `role` controls access: `user` is a regular member, `coach` can manage and lead sessions, `admin` has full access.

‎docs/schema-overview.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# MCLD Platform — Full Schema Overview
2+
3+
```mermaid
4+
erDiagram
5+
profiles {
6+
uuid id PK
7+
text first_name
8+
text last_name
9+
role role
10+
timestamp created_at
11+
timestamp updated_at
12+
}
13+
14+
services {
15+
uuid id PK
16+
text title
17+
text description
18+
service_type type
19+
jsonb scheduled_at "null for coaching_session"
20+
int duration_minutes
21+
int price
22+
boolean is_active
23+
timestamp created_at
24+
timestamp updated_at
25+
}
26+
27+
service_bookings {
28+
uuid id PK
29+
uuid user_id FK
30+
uuid service_id FK
31+
booking_status status
32+
text notes
33+
boolean is_active
34+
timestamp created_at
35+
timestamp updated_at
36+
}
37+
38+
webinars {
39+
uuid id PK
40+
text title
41+
text description
42+
webinar_tier tier
43+
int duration_minutes
44+
text youtube_url
45+
boolean is_active
46+
timestamp created_at
47+
timestamp updated_at
48+
}
49+
50+
coaching_sessions {
51+
uuid id PK
52+
uuid service_id FK
53+
uuid coach_id FK
54+
uuid user_id FK
55+
timestamp scheduled_at
56+
int duration_minutes
57+
session_status status
58+
text meeting_url
59+
text notes
60+
jsonb selected_time_slots "array of {start, end} objects"
61+
timestamp created_at
62+
timestamp updated_at
63+
}
64+
65+
profiles ||--o{ service_bookings : "books"
66+
services ||--o{ service_bookings : "booked via"
67+
profiles ||--o{ coaching_sessions : "coaches"
68+
profiles ||--o{ coaching_sessions : "attends"
69+
services ||--o{ coaching_sessions : "fulfilled by"
70+
```
71+
72+
## Enums
73+
74+
| Enum | Values |
75+
|---|---|
76+
| `role` | `user`, `admin`, `coach` |
77+
| `service_type` | `coaching_session`, `booking` |
78+
| `booking_status` | `pending`, `confirmed`, `cancelled` |
79+
| `webinar_tier` | `free`, `premium` |
80+
| `session_status` | `pending`, `confirmed`, `cancelled`, `completed` |

‎docs/services.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Services & Service Bookings Tables
2+
3+
## Services
4+
5+
The central catalog of offerings on the platform. Two types:
6+
- **`booking`** — a fixed event with predetermined time slots set by the admin. Users buy it like a product with no input on timing. `scheduled_at` holds the time slots as a JSON array.
7+
- **`coaching_session`** — a coaching offering where the user proposes availability. `scheduled_at` is null — timing is handled through the `coaching_sessions` table.
8+
9+
```mermaid
10+
erDiagram
11+
services {
12+
uuid id PK
13+
text title
14+
text description
15+
service_type type "coaching_session | booking"
16+
jsonb scheduled_at "array of {start, end} objects — null for coaching_session"
17+
int duration_minutes
18+
int price "in cents"
19+
boolean is_active
20+
timestamp created_at
21+
timestamp updated_at
22+
}
23+
```
24+
25+
## Service Bookings
26+
27+
A user's purchase of a booking-type service.
28+
29+
```mermaid
30+
erDiagram
31+
service_bookings {
32+
uuid id PK
33+
uuid user_id FK
34+
uuid service_id FK
35+
booking_status status "pending | confirmed | cancelled"
36+
text notes
37+
boolean is_active
38+
timestamp created_at
39+
timestamp updated_at
40+
}
41+
42+
services ||--o{ service_bookings : "booked via"
43+
```
44+
45+
## Notes
46+
47+
- `price` is stored in **cents** (integer) to avoid floating-point issues.
48+
- `is_active = false` hides a service without deleting historical bookings.
49+
- `scheduled_at` is a JSON array of `{ start, end }` ISO 8601 objects e.g. `[{ "start": "2026-04-15T14:00:00Z", "end": "2026-04-15T16:00:00Z" }]`.

‎docs/webinars.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Webinars Table
2+
3+
Online video content hosted on the platform. Two tiers:
4+
- **`free`** — accessible to all users.
5+
- **`premium`** — accessible to active subscribers only.
6+
7+
```mermaid
8+
erDiagram
9+
webinars {
10+
uuid id PK
11+
text title
12+
text description
13+
webinar_tier tier "free | premium"
14+
int duration_minutes
15+
text youtube_url
16+
boolean is_active
17+
timestamp created_at
18+
timestamp updated_at
19+
}
20+
```
21+
22+
## Notes
23+
24+
- Access is determined by the user's subscription status, not registration — there is no sign-up flow.
25+
- `youtube_url` is the link to the YouTube video.
26+
- `is_active = false` hides a webinar without deleting it.

‎drizzle.config.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ import { defineConfig } from "drizzle-kit";
44
export default defineConfig({
55
out: "./drizzle",
66
schema: "./lib/db/schema.ts",
7+
schemaFilter: ["public"],
78
dialect: "postgresql",
89
dbCredentials: {
910
url: process.env.DATABASE_URL!,

‎lib/db/schema.ts‎

Lines changed: 90 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,94 @@
1-
import { pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core";
1+
import { pgTable, text, timestamp, uuid, pgEnum, integer, boolean, jsonb } from "drizzle-orm/pg-core";
2+
3+
export const roleEnum = pgEnum("role", ["user", "admin", "coach"]);
4+
export const serviceTypeEnum = pgEnum('service_type', ["coaching_session", "booking"]);
5+
export const bookingStatusEnum = pgEnum('booking_status', ["pending", "confirmed", "cancelled"]);
6+
export const webinarTierEnum = pgEnum('webinar_tier', ["free", "premium"]);
7+
export const sessionStatusEnum = pgEnum("session_status", ["pending", "confirmed", "cancelled", "completed"]);
8+
29

310
export const profiles = pgTable("profiles", {
411
id: uuid("id").primaryKey(),
5-
fullName: text("full_name"),
6-
avatarUrl: text("avatar_url"),
7-
createdAt: timestamp("created_at").defaultNow(),
12+
firstName: text("first_name").notNull(),
13+
lastName: text("last_name").notNull(),
14+
role: roleEnum("role").notNull().default("user"),
15+
stripeCustomerId: text("stripe_customer_id").unique(),
16+
createdAt: timestamp("created_at").defaultNow().notNull(),
17+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
18+
})
19+
20+
export const services = pgTable("services", {
21+
id: uuid("id").primaryKey().defaultRandom(),
22+
title: text("title").notNull(),
23+
description: text("description"),
24+
type: serviceTypeEnum("type").notNull(),
25+
scheduledAt: jsonb("scheduled_at"),
26+
durationMinutes: integer("duration_minutes").notNull(),
27+
price: integer("price").notNull().default(0),
28+
isActive: boolean("is_active").notNull().default(true),
29+
createdAt: timestamp("created_at").defaultNow().notNull(),
30+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
31+
})
32+
33+
export const serviceBookings = pgTable("service_bookings", {
34+
id: uuid("id").primaryKey().defaultRandom(),
35+
userId: uuid("user_id").references(() => profiles.id, { onDelete: "cascade" }).notNull(),
36+
serviceId: uuid("service_id").references(() => services.id, { onDelete: "cascade" }).notNull(),
37+
status: bookingStatusEnum("status").notNull().default("pending"),
38+
notes: text("notes"),
39+
isActive: boolean("is_active").notNull().default(true),
40+
createdAt: timestamp("created_at").defaultNow().notNull(),
41+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
42+
});
43+
44+
export const webinars = pgTable("webinars", {
45+
id: uuid("id").primaryKey().defaultRandom(),
46+
title: text("title").notNull(),
47+
description: text("description"),
48+
tier: webinarTierEnum("tier").notNull().default("free"),
49+
durationMinutes: integer("duration_minutes").notNull(),
50+
youtubeUrl: text("youtube_url"),
51+
isActive: boolean("is_active").notNull().default(true),
52+
createdAt: timestamp("created_at").defaultNow().notNull(),
53+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
54+
});
55+
56+
export const coachingSessions = pgTable("coaching_sessions", {
57+
id: uuid("id").primaryKey().defaultRandom(),
58+
serviceId: uuid("service_id").references(() => services.id, { onDelete: "cascade" }).notNull(),
59+
coachId: uuid("coach_id").references(() => profiles.id, { onDelete: "cascade" }).notNull(),
60+
userId: uuid("user_id").references(() => profiles.id, { onDelete: "cascade" }).notNull(),
61+
scheduledAt: timestamp("scheduled_at"),
62+
durationMinutes: integer("duration_minutes").notNull().default(60),
63+
status: sessionStatusEnum("status").notNull().default("pending"),
64+
meetingUrl: text("meeting_url"),
65+
notes: text("notes"),
66+
selectedTimeSlots: jsonb("selected_time_slots").notNull(),
67+
createdAt: timestamp("created_at").defaultNow().notNull(),
68+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
69+
});
70+
71+
export const subscriptions = pgTable("subscriptions", {
72+
id: uuid("id").primaryKey().defaultRandom(),
73+
userId: uuid("user_id").references(() => profiles.id, { onDelete: "cascade" }).notNull().unique(),
74+
stripeSubscriptionId: text("stripe_subscription_id").unique(),
75+
status: text("status").notNull().default("none"),
76+
stripePriceId: text("stripe_price_id"),
77+
cancelAtPeriodEnd: boolean("cancel_at_period_end").notNull().default(false),
78+
paymentMethodBrand: text("payment_method_brand"),
79+
paymentMethodLast4: text("payment_method_last4"),
80+
createdAt: timestamp("created_at").defaultNow().notNull(),
81+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
82+
});
83+
84+
export const purchases = pgTable("purchases", {
85+
id: uuid("id").primaryKey().defaultRandom(),
86+
userId: uuid("user_id").references(() => profiles.id, { onDelete: "cascade" }).notNull(),
87+
stripePriceId: text("stripe_price_id").notNull(),
88+
stripeSessionId: text("stripe_session_id").notNull().unique(),
89+
productName: text("product_name").notNull(),
90+
amount: integer("amount").notNull(),
91+
currency: text("currency").notNull(),
92+
createdAt: timestamp("created_at").defaultNow().notNull(),
93+
updatedAt: timestamp("updated_at").defaultNow().notNull(),
894
});

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
"class-variance-authority": "^0.7.1",
2121
"clsx": "^2.1.1",
2222
"dotenv": "^17.3.1",
23-
"drizzle-orm": "^0.45.1",
23+
"drizzle-orm": "^0.45.2",
2424
"lucide-react": "^0.577.0",
2525
"next": "16.2.1",
2626
"postgres": "^3.4.8",

0 commit comments

Comments
 (0)