consent preparation

server/README.md

@@ -0,0 +1,22 @@
+## AWS S3/SQS usage clarification
+
+Whereby.com uploads recordings directly to our S3 bucket when meetings end.
+
+SQS Queue (AWS_PROCESS_RECORDING_QUEUE_URL)
+
+Filled by: AWS S3 Event Notifications
+
+The S3 bucket is configured to send notifications to our SQS queue when new objects are created. This is standard AWS infrastructure - not in our codebase.
+
+AWS S3 → SQS Event Configuration:
+- Event Type: s3:ObjectCreated:*
+- Filter: *.mp4 files
+- Destination: Our SQS queue
+
+Our System's Role
+
+Polls SQS every 60 seconds via /server/reflector/worker/process.py:24-62:
+
+# Every 60 seconds, check for new recordings
+sqs = boto3.client("sqs", ...)
+response = sqs.receive_message(QueueUrl=queue_url, ...)

server/reflector/db/transcripts.py

@@ -542,7 +542,7 @@ class TranscriptController:
         topic: TranscriptTopic,
     ) -> TranscriptEvent:
         """
-        Append an event to a transcript
+        Upsert topics to a transcript
         """
         transcript.upsert_topic(topic)
         await self.update(