feat: add session management features including creation, deletion, and note handling; enhance UI with modals for adding sessions and displaying notes

Author: RafaelHDSV

docs/context.md

@@ -47,10 +47,10 @@ Variáveis: `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY` (servidor). Opcional no
 |-------|--------|
 | `public/data/people.yaml` | Pessoas e tópicos — versionado no git; `topicOrder` opcional (seed) |
 | `public/data/sessions.yaml` | Agenda seed — versionado no git |
-| Supabase `sessions` | Estado vivo (status, datas, notas) |
+| Supabase `sessions` | Estado vivo (status, datas, notas) — N sessoes por topico permitidas |
 | Supabase `person_preferences` | Ordem de gravacao por pessoa (`topic_order`); override editavel no painel |
 
-**Status:** `scheduled`, `done`, `postponed`. **Fuso:** `America/Sao_Paulo`.
+**Status:** `scheduled`, `done`, `postponed`. **Fuso:** `America/Sao_Paulo`. Um topico pode ter **N sessoes**; o video so conta como concluido quando todas estao `done`.
 
 ---
 
@@ -59,6 +59,8 @@ Variáveis: `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY` (servidor). Opcional no
 | Método | Rota | Função |
 |--------|------|--------|
 | GET | `/api/schedule` | `{ people, sessions }` — sessoes relidas do Supabase a cada request |
+| POST | `/api/sessions` | Cria sessao adicional para topico existente (editor) |
+| DELETE | `/api/sessions/:id` | Remove sessao (editor) |
 | PATCH | `/api/people/:personId/topic-order` | Atualiza ordem de gravacao dos topicos (editor) |
 | PATCH | `/api/sessions/:id` | Atualiza sessão no Supabase |
 | POST | `/api/sessions/swap-time` | Troca horário entre duas sessões |
@@ -68,9 +70,9 @@ Variáveis: `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY` (servidor). Opcional no
 
 ## UI (abas)
 
-1. **Resumo** — totais e tabela por pessoa.
-2. **Calendário** — grade mensal, drag-and-drop, adiadas, swap de horário.
-3. **Por pessoa** — progresso e checklist por tópico.
+1. **Resumo** — totais por **topico** (catalogo) e sessoes como detalhe.
+2. **Calendario** — grade mensal, drag-and-drop, adiadas, swap de horario; badge de progresso por topico quando N > 1; notas por sessao.
+3. **Por pessoa** — progresso por topico, sub-linhas por sessao, adicionar sessao, indicador de notas.
 
 ---
 
@@ -87,6 +89,8 @@ Variáveis: `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY` (servidor). Opcional no
 8. **`base: './'`** no Vite para GitHub Pages / raiz.
 9. **`yarn import`** regenera YAMLs do script legado.
 10. **`topicOrder`** — ordem de gravacao por pessoa: seed em `people.yaml`; override em Supabase (`cronograma_person_preferences`). Util `getTopicOrder()` / `getOrderedTopics()` em `src/lib/topicOrder.ts` (reexport em `schedule.ts`).
+11. **Multi-sessao por topico** — agrupamento em `src/lib/topicSessions.ts`; IDs novos com sufixo `-2`, `-3` se colidir no mesmo slot.
+12. **Notas por sessao** — campo `notes` no Supabase; edicao no calendario (painel Alterar sessao, fila de rascunho); leitura para visitantes; indicador com tooltip na aba Por pessoa (`src/lib/sessionNotes.ts`).
 
 ---
 
@@ -104,7 +108,7 @@ Variáveis: `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY` (servidor). Opcional no
 
 - Contas individuais / OAuth por usuario.
 - `people` / tópicos no Supabase.
-- Botão Discord no UI; deep link `?date=`; campo `notes` na UI; status `cancelled`.
+- Botão Discord no UI; deep link `?date=`; status `cancelled`.
 - GitHub Pages com API (só estático no workflow atual).
 
 ---

server/data.ts

@@ -30,6 +30,7 @@ export interface Session {
   topicLetter: string
   status: SessionStatus
   recordedAt?: string
+  notes?: string
 }
 
 interface SessionRow {
@@ -49,6 +50,8 @@ const SESSIONS_YAML = path.join(ROOT, 'public', 'data', 'sessions.yaml')
 let people: Person[] = []
 let sessions: Session[] = []
 
+const TZ = 'America/Sao_Paulo'
+
 function rowToSession(row: SessionRow): Session {
   const scheduledAt =
     typeof row.scheduled_at === 'string'
@@ -61,6 +64,7 @@ function rowToSession(row: SessionRow): Session {
     topicLetter: row.topic_letter,
     status: row.status,
     recordedAt: row.recorded_at ?? undefined,
+    notes: row.notes?.trim() ? row.notes : undefined,
   }
 }
 
@@ -71,11 +75,41 @@ function sessionToRow(session: Session): SessionRow {
     person_id: session.personId,
     topic_letter: session.topicLetter,
     status: session.status,
-    notes: '',
+    notes: session.notes?.trim() ? session.notes : '',
     recorded_at: session.recordedAt?.trim() ? session.recordedAt : null,
   }
 }
 
+function sessionIdBase(scheduledAt: string, personId: string, topicLetter: string): string {
+  const parts = new Intl.DateTimeFormat('en-CA', {
+    timeZone: TZ,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: 'numeric',
+    minute: 'numeric',
+    hour12: false,
+  }).formatToParts(new Date(scheduledAt))
+  const get = (t: string) => parts.find((p) => p.type === t)?.value ?? ''
+  const date = `${get('year')}-${get('month')}-${get('day')}`
+  const hour = get('hour').padStart(2, '0')
+  return `${date}-${hour}-${personId}-${topicLetter}`
+}
+
+export function generateSessionId(
+  scheduledAt: string,
+  personId: string,
+  topicLetter: string,
+  existingIds: Iterable<string>,
+): string {
+  const ids = new Set(existingIds)
+  const base = sessionIdBase(scheduledAt, personId, topicLetter)
+  if (!ids.has(base)) return base
+  let n = 2
+  while (ids.has(`${base}-${n}`)) n++
+  return `${base}-${n}`
+}
+
 interface PreferenceRow {
   person_id: string
   topic_order: string[]
@@ -204,7 +238,13 @@ export function findSession(id: string): Session | undefined {
 
 export async function updateSession(
   id: string,
-  patch: { status?: SessionStatus; scheduledAt?: string; recordedAt?: string },
+  patch: {
+    status?: SessionStatus
+    scheduledAt?: string
+    recordedAt?: string
+    notes?: string
+    topicLetter?: string
+  },
 ): Promise<Session | null> {
   const idx = sessions.findIndex((s) => s.id === id)
   if (idx === -1) return null
@@ -215,6 +255,17 @@ export async function updateSession(
   if (patch.recordedAt !== undefined) {
     session.recordedAt = patch.recordedAt.trim() ? patch.recordedAt : undefined
   }
+  if (patch.notes !== undefined) {
+    session.notes = patch.notes.trim() ? patch.notes : undefined
+  }
+  if (patch.topicLetter !== undefined) {
+    const letter = patch.topicLetter.trim().toLowerCase()
+    const person = people.find((p) => p.id === session.personId)
+    if (!person?.topics.some((t) => t.letter === letter)) {
+      throw new Error('Topico invalido para esta pessoa')
+    }
+    session.topicLetter = letter
+  }
 
   const { error } = await supabase.from(tables.sessions).update(sessionToRow(session)).eq('id', id)
   if (error) throw new Error(formatSupabaseError('[data] Falha ao atualizar sessao', error))
@@ -235,6 +286,8 @@ export type SessionPatch = {
   status?: SessionStatus
   scheduledAt?: string
   recordedAt?: string
+  notes?: string
+  topicLetter?: string
 }
 
 export async function applySessionPatches(
@@ -300,3 +353,61 @@ export async function updatePersonTopicOrder(
   people[idx] = updated
   return updated
 }
+
+export async function deleteSession(id: string): Promise<boolean> {
+  const idx = sessions.findIndex((s) => s.id === id)
+  if (idx === -1) return false
+
+  const { error } = await supabase.from(tables.sessions).delete().eq('id', id)
+  if (error) throw new Error(formatSupabaseError('[data] Falha ao remover sessao', error))
+
+  sessions.splice(idx, 1)
+  console.log(`[data] Sessao removida: ${id}`)
+  return true
+}
+
+export interface CreateSessionInput {
+  personId: string
+  topicLetter: string
+  scheduledAt: string
+  status?: SessionStatus
+}
+
+export async function createSession(input: CreateSessionInput): Promise<Session> {
+  const person = people.find((p) => p.id === input.personId)
+  if (!person) throw new Error('Pessoa nao encontrada')
+
+  const letter = input.topicLetter.trim().toLowerCase()
+  if (!person.topics.some((t) => t.letter === letter)) {
+    throw new Error('Topico invalido para esta pessoa')
+  }
+
+  const scheduledAt = input.scheduledAt?.trim()
+  if (!scheduledAt) throw new Error('scheduledAt e obrigatorio')
+
+  const status: SessionStatus =
+    input.status === 'done' || input.status === 'postponed' ? input.status : 'scheduled'
+
+  const id = generateSessionId(
+    scheduledAt,
+    input.personId,
+    letter,
+    sessions.map((s) => s.id),
+  )
+
+  const session: Session = {
+    id,
+    scheduledAt,
+    personId: input.personId,
+    topicLetter: letter,
+    status,
+  }
+
+  const { error } = await supabase.from(tables.sessions).insert(sessionToRow(session))
+  if (error) throw new Error(formatSupabaseError('[data] Falha ao criar sessao', error))
+
+  sessions.push(session)
+  sessions.sort((a, b) => a.scheduledAt.localeCompare(b.scheduledAt))
+  console.log(`[data] Sessao criada: ${id} (${input.personId}/${letter})`)
+  return session
+}

server/index.ts

@@ -12,6 +12,9 @@ import {
   resetSessionsFromYaml,
   applySessionPatches,
   updatePersonTopicOrder,
+  createSession,
+  deleteSession,
+  type CreateSessionInput,
   type SessionPatch,
 } from './data.js'
 import { handleAuthMe, handleLogin, requireEditor } from './auth.js'
@@ -52,8 +55,8 @@ app.get('/api/schedule', async (_req, res) => {
 app.patch('/api/sessions/:id', requireEditor, async (req, res) => {
   try {
     const id = String(req.params.id)
-    const { status, scheduledAt, recordedAt } = req.body as SessionPatch
-    const session = await updateSession(id, { status, scheduledAt, recordedAt })
+    const { status, scheduledAt, recordedAt, notes, topicLetter } = req.body as SessionPatch
+    const session = await updateSession(id, { status, scheduledAt, recordedAt, notes, topicLetter })
     if (!session) {
       return res.status(404).json({ error: 'Session not found' })
     }
@@ -64,6 +67,38 @@ app.patch('/api/sessions/:id', requireEditor, async (req, res) => {
   }
 })
 
+app.post('/api/sessions', requireEditor, async (req, res) => {
+  try {
+    const { personId, topicLetter, scheduledAt, status } = req.body as CreateSessionInput
+    if (!personId || !topicLetter || !scheduledAt) {
+      return res.status(400).json({ error: 'personId, topicLetter e scheduledAt sao obrigatorios' })
+    }
+    const session = await createSession({ personId, topicLetter, scheduledAt, status })
+    res.status(201).json({ session })
+  } catch (e) {
+    console.error(e)
+    const msg = String(e)
+    if (msg.includes('nao encontrada') || msg.includes('invalido')) {
+      return res.status(400).json({ error: msg })
+    }
+    res.status(500).json({ error: msg })
+  }
+})
+
+app.delete('/api/sessions/:id', requireEditor, async (req, res) => {
+  try {
+    const id = String(req.params.id)
+    const removed = await deleteSession(id)
+    if (!removed) {
+      return res.status(404).json({ error: 'Session not found' })
+    }
+    res.status(200).json({ ok: true })
+  } catch (e) {
+    console.error(e)
+    res.status(500).json({ error: String(e) })
+  }
+})
+
 app.post('/api/sessions/apply-batch', requireEditor, async (req, res) => {
   if (isRateLimited(req, 'apply-batch', BATCH_LIMIT.max, BATCH_LIMIT.windowMs)) {
     return res.status(429).json({ error: 'Muitas alteracoes em pouco tempo. Aguarde um momento.' })