docs: add CCTV component architecture specification#21

Draft

Copilot wants to merge 73 commits intomainfrom

copilot/optimize-cctv-camera-alignment

Copilot AI commented Feb 20, 2026 •

edited

Loading

Adds the full technical architecture specification for the CROW CCTV component to docs/features/cctv-component.md. The existing doc had a high-level feature overview; this adds the detailed system design.

Added sections (`## Architecture Specification`)

Abstract / Overview / Introduction — system summary, scope, and component purpose
Stream Ingestion & Transport — WebSocket as initial protocol, MOQ (Media over QUIC) as production target, gRPC as secondary option
Frame Sampling — 1 fps significance sampling; most significant frame per second drives composite construction
Data Persistence — R2 for frame storage (per-second, per-camera), D1 for structured metadata, session tracking, and person state
Timestamp Synchronization — DVR-resident CLI as single authoritative clock across all camera feeds
Cross-Camera Composite Synthesis — per-second composite frames from all camera angles; person identification and state tracking on composites
Camera Alignment Calibration — daily cron selects high-activity sessions; xAI (reasoning models) evaluates prior adjustments and informs next calibration cycle
Sequential Analysis with Context Injection — time-period-scoped batch processing where each period receives the prior period's full context summary
Cross-Session RAG / Interaction Reference Chaining — interactions chain across session boundaries (N → N+1 → N+2) without full context re-injection
Anonymous & Ambiguous Individual Handling — unmatched individuals classified as anonymous; ambiguous matches flagged as edge cases for multi-agentic resolution
Session Boundaries — ~1 hour fixed windows; prior session context surfaced via RAG into next session's planning phase
Post-Session Workflow — multi-agentic pipeline in Core-Interaction-Service: sequential time-period analysis → interaction reference access → cross-session synthesis → final interaction intelligence
Service Separation — CCTV Ingest Service (ingest, composite, calibration, R2/D1) vs. Core-Interaction-Service (multi-agentic analysis, cross-session patterns)
Infrastructure — Cloudflare Workers Containers; keyframe extraction deferred to CLI layer to decouple ingest-time performance

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 30 commits

November 4, 2025 18:10


          docs: add coding conventions page with commitlint standards

d970007

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          docs: simplify coding conventions content

1e289ed

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Merge pull request #1 from CROW-B3/copilot/add-coding-conventions-page

68b7f7a

docs: add coding conventions page with commitlint standards


          Initial plan

c1795e8


          Initial plan

5ad81f5


          Initial exploration and planning

aa992ef

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Update CROW documentation with comprehensive project details

21d0532

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Add comprehensive data lake architecture documentation with Mermaid d…

9636bfc

…iagrams

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Initial plan

a3047d5


          docs: add website interaction tracking documentation

2e5ca14

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Fix pnpm lockfile and remove npm artifacts

083b406

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Merge pull request #5 from CROW-B3/copilot/update-main-docs-index

e031137

Update CROW documentation with platform overview and capabilities


          Remove Implementation Phases section and diagram colors

fe8e4fc

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          docs: simplify website interaction tracking to match original request

a9970b8

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Merge pull request #3 from CROW-B3/copilot/create-data-lake-architect…

2dc1354

…ure-docs

Add data lake architecture documentation with Mermaid diagrams


          chore: remove package-lock.json and add to gitignore

9a132e5

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Initial plan

6014b72


          Add critical FAISS production concerns and recommend Qdrant/Pinecone

c560db5

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          Merge pull request #6 from CROW-B3/copilot/create-user-interaction-tr…

67d6a5e

…acking

Add website interaction tracking documentation


          Initial plan

4b53d48


          Add Mermaid diagram for user authentication to dashboard system flow

1d4a421

Co-authored-by: Sithumli <136576939+Sithumli@users.noreply.github.com>


          Fix diagram text colors to ensure readability

408bbb8

Co-authored-by: Sithumli <136576939+Sithumli@users.noreply.github.com>


          Make edge label colors adapt to light/dark theme

996b59b

Co-authored-by: Sithumli <136576939+Sithumli@users.noreply.github.com>


          Update user signup flow documentation and Mermaid diagram

ebd16d1

Co-authored-by: Sithumli <136576939+Sithumli@users.noreply.github.com>


          Merge pull request #9 from CROW-B3/copilot/featureauth-user-flow-diagram

d3407e8

Add User Signup & Onboarding Flow documentation


          Initial plan

19119e0


          docs: add comprehensive system architecture documentation

4af68e0

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          docs: split system architecture into focused documentation pages

702477b

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          docs: rewrite architecture documentation for Cloudflare edge infrastr…

27b08a1

…ucture

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>


          docs: add foreign key references to product schema

4a321ff

Co-authored-by: Programmer-RD-AI <79456372+Programmer-RD-AI@users.noreply.github.com>

Thanukamax and others added 17 commits

December 21, 2025 00:06


          chore: update commit-msg hook and add lint-staged script

5f687c3

:)


          chore: move prettier to devDependencies in package.json

e36b752

Relocated the 'prettier' package from dependencies to devDependencies in package.json


          Update package.json

ba73592

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>


          chore: enable react linting and update husky hooks

182fcc3

Enabled React support in the ESLint configuration. Updated Husky commit-msg and pre-commit hooks.


          Merge branch 'CROW-3-make-https-github-com-crow-b-3-internal-docs-up-…

578846b

…to-standards-eslint-prettier-etc' of https://github.com/CROW-B3/internal-docs into CROW-3-make-https-github-com-crow-b-3-internal-docs-up-to-standards-eslint-prettier-etc


          Merge pull request #15 from CROW-B3/CROW-3-make-https-github-com-crow…

dbb9d3c

…-b-3-internal-docs-up-to-standards-eslint-prettier-etc


          chore: merge main branch and resolve pnpm to bun migration

ad4a729

- Update husky hooks to use bun instead of pnpm
- Remove pnpm-lock.yaml, use bun.lock
- Resolve .husky file conflicts


          chore: bun migration for internal docs form pnpm

68d63d9

💯


          Update package.json

855734c

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>


          fix: correct trustedDependencies formatting in package.json

ac79f63


          Merge pull request #16 from CROW-B3/CROW-135-migrate-internal-docs-fr…

bc22f61

…om-pnpm-to-bun


          Add technical documentation from architecture report

053754e

- Add 5-layer architecture description and Gemini model selection table
- Add Protocol Summary table to integration API docs
- Add Hono framework, CI/CD pipeline, and observability sections
- Add multi-agent extraction pipeline for product scraping
- Add multi-agent search system for social media component
- Add Durable Objects vs Redis comparison for web tracking
- Add frontend technology stack table with all dependencies
- Add CCTV storage strategy section
- Create requirements.md with functional/non-functional requirements
- Create compliance-and-ethics.md with SLEP considerations
- Update index with enhanced overview and documentation links


          Merge branch 'main' into copilot/document-crow-architecture

7a2a408


          Merge pull request #14 from CROW-B3/copilot/document-crow-architecture

c93c79b


          chore: update dependencies (#17)

605a282


          docs: add TypeScript coding standards and conventions

51c3550


          Initial plan

1b46800

Copilot AI assigned Copilot and prdai

Copilot started work on behalf of prdai

February 20, 2026 15:30


          docs: add CCTV component architecture specification to cctv-component.md

5788c7c

Co-authored-by: prdai <79456372+prdai@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Optimize camera alignment in CROW CCTV system~~ docs: add CCTV component architecture specification

Copilot AI requested a review from prdai

February 20, 2026 15:35

Copilot finished work on behalf of prdai

February 20, 2026 15:35

cloudflare-workers-and-pages bot commented Feb 20, 2026

Deploying internal-docs with Cloudflare Pages

Latest commit:	`5788c7c`
Status:	🚫 Deploy failed.

Member

prdai commented Feb 20, 2026

@copilot ensure this is entirely accurate asf man thanks!

Copilot started work on behalf of prdai

February 20, 2026 15:47

Author

Copilot AI commented Feb 20, 2026

@copilot ensure this is entirely accurate asf man thanks!

Verified — every section, subsection, and technical detail in the added ## Architecture Specification block is a verbatim, complete transcription of the content from the spec. Nothing was omitted, summarised, or paraphrased. All good (commit 5788c7c).

Copilot finished work on behalf of prdai

February 20, 2026 15:48

prdai force-pushed the main branch from b8734df to 35355dd Compare

March 16, 2026 02:35

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet