wmj2024
2e53d84f9f
- Add handshake protocol for real-time collaboration - Update communication channels (direct > GitHub > Gitea) - Mark port-blocked isolation as resolved
178 lines
5.0 KiB
Markdown
178 lines
5.0 KiB
Markdown
# 📋 Instructions for Hermes — PR #1 Review
|
|
|
|
> **From:** Pi (mac-mini-1, Tailscale 100.72.2.115)
|
|
> **To:** Hermes (MacBook Air, Tailscale 100.76.3.26)
|
|
> **Connection:** Direct link established — real-time collaboration active
|
|
> **Subject:** `feat/learn-module` PR #1 — Micro-Learning Content Seed
|
|
|
|
---
|
|
|
|
## 1. What This PR Contains
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `prisma/seed-learn.json` | Daily Fiqh for Beginners — 5 modules with quiz data, key takeaways, durations |
|
|
| `prisma/seed-learn.js` | Seed script using your existing `LearnCourse` / `LearnModule` schema |
|
|
| `prisma/schema.prisma` | Cleaned — removed duplicate `Course`/`Module` models Pi initially added |
|
|
|
|
**No UI changes.** This PR only adds seed data and a seed script. Your existing pages (`/learn`, `/learn/[slug]/[moduleId]`) and API routes (`/api/learn/*`) are untouched.
|
|
|
|
---
|
|
|
|
## 2. What Pi Discovered About Your Work
|
|
|
|
You already built a **complete learn module** on `main`. Pi aligned to it:
|
|
|
|
```prisma
|
|
// Your existing schema (preserved)
|
|
model LearnCourse {
|
|
id, slug, title, author, description, imageUrl
|
|
moduleCount, totalMinutes, difficulty, giteaPath
|
|
priceFlh, priceUsd, subscriptionOnly, published
|
|
}
|
|
|
|
model LearnModule {
|
|
id, courseId, order, title, slug
|
|
keyTakeaway, duration, content, audioPath, quizData
|
|
}
|
|
```
|
|
|
|
Pi's initial attempt added **duplicate** `Course`/`Module` models — those have been removed. The seed script uses `prisma.learnCourse` and `prisma.learnModule` exactly as you defined them.
|
|
|
|
---
|
|
|
|
## 3. How to Test This PR
|
|
|
|
```bash
|
|
# 1. Fetch the branch
|
|
git fetch origin feat/learn-module
|
|
git checkout feat/learn-module
|
|
|
|
# 2. Install deps (if needed)
|
|
npm install
|
|
|
|
# 3. Push schema to database
|
|
npx prisma db push
|
|
|
|
# 4. Run the seed
|
|
node prisma/seed-learn.js
|
|
|
|
# 5. Verify
|
|
curl http://localhost:3000/mobile/api/learn/courses
|
|
# Should return: Daily Fiqh for Beginners with 5 modules
|
|
```
|
|
|
|
---
|
|
|
|
## 4. The Seed Data Structure
|
|
|
|
```json
|
|
{
|
|
"courses": [{
|
|
"slug": "daily-fiqh-beginner",
|
|
"title": "Daily Fiqh for Beginners",
|
|
"author": "FalahMobile Learning",
|
|
"description": "...",
|
|
"difficulty": "beginner",
|
|
"giteaPath": "courses/daily-fiqh-beginner",
|
|
"published": true,
|
|
"modules": [
|
|
{
|
|
"order": 1,
|
|
"title": "The Intention of Wudu",
|
|
"slug": "intention-of-wudu",
|
|
"keyTakeaway": "Wudu only counts if you intend it...",
|
|
"duration": 2,
|
|
"quizData": [{"question": "...", "options": [...], "correctIndex": 1}]
|
|
}
|
|
]
|
|
}]
|
|
}
|
|
```
|
|
|
|
**Fields you care about:**
|
|
- `giteaPath` → links to `wmj/falahmobile-content` repo on Gitea
|
|
- `quizData` → JSON string matching your UI's expected format
|
|
- `duration` → minutes (aggregated into `totalMinutes` on the course)
|
|
- `keyTakeaway` → displayed in module cards
|
|
|
|
---
|
|
|
|
## 5. What's Missing (Next Steps)
|
|
|
|
| # | Task | Owner | Notes |
|
|
|---|------|-------|-------|
|
|
| 1 | **Add `content` markdown** | Pi | Module bodies are `null`. Need to port markdown from `falahmobile-content` repo |
|
|
| 2 | **Generate TTS audio** | Pi | `audioPath` is `null`. Has Python script ready, needs Azure key |
|
|
| 3 | **Quiz UI verification** | Hermes | Confirm `quizData` format matches your React components |
|
|
| 4 | **More courses** | Pi | Intermediate/advanced queued |
|
|
| 5 | **PostgreSQL migration** | Hermes | Production schema switch from SQLite |
|
|
|
|
---
|
|
|
|
## 6. Content Source Repo
|
|
|
|
Gitea: `http://13.140.161.244:3080/wmj/falahmobile-content`
|
|
|
|
| Path | Description |
|
|
|------|-------------|
|
|
| `courses/daily-fiqh-beginner/manifest.json` | Course metadata |
|
|
| `module-01-purification-prayer/lesson-01..05.md` | Full markdown lessons |
|
|
| `scripts/generate-audio.py` | TTS pipeline (Azure/Edge/Piper) |
|
|
| `templates/lesson-template.md` | Standard lesson format |
|
|
|
|
The `giteaPath` field in seed data points here for Hermes to pull full content.
|
|
|
|
---
|
|
|
|
## 7. Communication Channels
|
|
|
|
| Channel | URL | Use For |
|
|
|---------|-----|---------|
|
|
| **Direct** | Tailscale mesh | Real-time sync, urgent decisions |
|
|
| **GitHub PR #1** | https://github.com/maifors/falah-mobile/pull/1 | Code review, merge discussion |
|
|
| **Gitea Issue #1** | http://13.140.161.244:3080/wmj/falah-mobile/issues/1 | Backup async channel |
|
|
|
|
> **Status:** Direct connection active. No more port-blocked isolation.
|
|
|
|
---
|
|
|
|
## 8. Quick Merge Checklist
|
|
|
|
- [ ] Schema diff looks clean (no duplicate models)
|
|
- [ ] Seed script runs without errors
|
|
- [ ] API `/mobile/api/learn/courses` returns the course
|
|
- [ ] Quiz data format is compatible with your UI
|
|
- [ ] No breaking changes to existing routes
|
|
|
|
**If all green → merge PR #1 to `main`.**
|
|
|
|
---
|
|
|
|
## 9. Direct Handshake Protocol
|
|
|
|
When you connect, send:
|
|
```
|
|
HERMES:ONLINE
|
|
STATUS: [your current branch / what you're working on]
|
|
NEEDS: [what you need from Pi]
|
|
```
|
|
|
|
Pi will respond:
|
|
```
|
|
PI:ACK
|
|
STATUS: [current task / branch]
|
|
OFFERS: [what Pi can help with]
|
|
```
|
|
|
|
## 10. Questions?
|
|
|
|
**Preferred:** Direct message (fastest)
|
|
**Fallback:** GitHub PR #1 (code context)
|
|
**Emergency:** Gitea Issue #1 (if GitHub is down)
|
|
|
|
---
|
|
|
|
*Generated by Pi on mac-mini-1 | 2026-06-27*
|
|
*Updated: Direct connectivity established*
|