COLSYS/geutebruck-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
10 Commits 2 Branches 0 Tags
4866a8edc36c7a55ffeaccc8292935617d12d42a
Commit Graph

10 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Geutebruck API Developer
4866a8edc3 Phase 5: Camera Discovery (T049-T055) 
Implemented complete camera discovery system with Redis caching:

**Tests:**
- Contract tests for GET /api/v1/cameras (list cameras)
- Contract tests for GET /api/v1/cameras/{id} (camera detail)
- Integration tests for camera data consistency
- Tests for caching behavior and all authentication roles

**Schemas:**
- CameraInfo: Camera data model (id, name, description, has_ptz, has_video_sensor, status)
- CameraListResponse: List endpoint response
- CameraDetailResponse: Detail endpoint response with extended fields
- CameraStatusEnum: Status constants (online, offline, unknown, error, maintenance)

**Services:**
- CameraService: list_cameras(), get_camera(), invalidate_cache()
- Additional methods: search_cameras(), get_online_cameras(), get_ptz_cameras()
- Integrated Redis caching with 60s TTL
- Automatic cache invalidation and refresh

**Router Endpoints:**
- GET /api/v1/cameras - List all cameras (cached, 60s TTL)
- GET /api/v1/cameras/{id} - Get camera details
- POST /api/v1/cameras/refresh - Force refresh (bypass cache)
- GET /api/v1/cameras/search/{query} - Search cameras by name/description
- GET /api/v1/cameras/filter/online - Get online cameras only
- GET /api/v1/cameras/filter/ptz - Get PTZ cameras only

**Authorization:**
- All camera endpoints require at least Viewer role
- All authenticated users can read camera data

**Integration:**
- Registered camera router in main.py
- Camera service communicates with SDK Bridge via gRPC
- Redis caching for performance optimization

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-09 09:19:27 +01:00
Geutebruck API Developer
fbebe10711 Phase 4: Authentication System (T039-T048) 
Implemented complete JWT-based authentication system with RBAC:

**Tests (TDD Approach):**
- Created contract tests for /api/v1/auth/login endpoint
- Created contract tests for /api/v1/auth/logout endpoint
- Created unit tests for AuthService (login, logout, validate_token, password hashing)
- Created pytest configuration and fixtures (test DB, test users, tokens)

**Schemas:**
- LoginRequest: username/password validation
- TokenResponse: access_token, refresh_token, user info
- LogoutResponse: logout confirmation
- RefreshTokenRequest: token refresh payload
- UserInfo: user data (excludes password_hash)

**Services:**
- AuthService: login(), logout(), validate_token(), hash_password(), verify_password()
- Integrated bcrypt password hashing
- JWT token generation (access + refresh tokens)
- Token blacklisting in Redis
- Audit logging for all auth operations

**Middleware:**
- Authentication middleware with JWT validation
- Role-based access control (RBAC) helpers
- require_role() dependency factory
- Convenience dependencies: require_viewer(), require_operator(), require_administrator()
- Client IP and User-Agent extraction

**Router:**
- POST /api/v1/auth/login - Authenticate and get tokens
- POST /api/v1/auth/logout - Blacklist token
- POST /api/v1/auth/refresh - Refresh access token
- GET /api/v1/auth/me - Get current user info

**Integration:**
- Registered auth router in main.py
- Updated startup event to initialize Redis and SDK Bridge clients
- Updated shutdown event to cleanup connections properly
- Fixed error translation utilities
- Added asyncpg dependency for PostgreSQL async driver

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-09 09:04:16 +01:00
Geutebruck API Developer
a4bde18d0f Phase 3 Complete: Python API Foundation (T027-T038) 
Completed all Python API infrastructure tasks:

✅ Core Application (T027-T029):
- FastAPI app with CORS, error handling, structured logging
- Pydantic Settings for environment configuration
- SQLAlchemy async engine with connection pooling
- Alembic migration environment

✅ Infrastructure Clients (T030-T032):
- Redis async client with connection pooling
- gRPC SDK Bridge client (placeholder for protobuf generation)
- Alembic migration environment configured

✅ Utilities & Middleware (T033-T035):
- JWT utilities: create, decode, verify tokens (access & refresh)
- Error translation: gRPC status codes → HTTP status codes
- Error handler middleware for consistent error responses

✅ Database Models (T036-T038):
- User model with RBAC (viewer, operator, administrator)
- AuditLog model for tracking all operations
- Initial migration: creates users and audit_logs tables
- Default admin user (username: admin, password: admin123)

Features:
- Async/await throughout
- Type hints with Pydantic
- Structured JSON logging
- Connection pooling (DB, Redis, gRPC)
- Environment-based configuration
- Permission hierarchy system

Ready for Phase 4: Authentication Implementation

🤖 Generated with Claude Code
 2025-12-09 08:52:48 +01:00
Geutebruck API Developer
12c4e1ca9c Phase 3 (Part 1): API Infrastructure - FastAPI, Database, Redis, gRPC Client 
Completed Tasks (T027-T032):
- ✅ FastAPI application with structured logging, CORS, global error handlers
- ✅ Pydantic Settings for environment configuration
- ✅ SQLAlchemy async engine with session management
- ✅ Alembic migration environment setup
- ✅ Redis async client with connection pooling
- ✅ gRPC SDK Bridge client (placeholder - awaiting protobuf generation)

Next: JWT utilities, middleware, database models

🤖 Generated with Claude Code
 2025-12-09 08:49:08 +01:00
Geutebruck API Developer
48fafae9d2 Phase 2 Complete: SDK Bridge Foundation (T011-T026) 
Implemented complete C# gRPC service wrapping GeViScope SDK:

✅ gRPC Protocol Definitions (T011-T014):
- common.proto: Status, Error, Timestamp messages
- camera.proto: CameraService with ListCameras, GetCamera RPCs
- monitor.proto: MonitorService with ListMonitors, GetMonitor RPCs
- crossswitch.proto: CrossSwitchService with ExecuteCrossSwitch, ClearMonitor, GetRoutingState, HealthCheck RPCs

✅ SDK Wrapper Classes (T015-T021):
- GeViDatabaseWrapper.cs: Connection lifecycle with retry logic (3 attempts, exponential backoff)
- StateQueryHandler.cs: GetFirst/GetNext enumeration pattern for cameras/monitors
- ActionDispatcher.cs: CrossSwitch and ClearVideoOutput action execution
- ErrorTranslator.cs: SDK errors → gRPC status codes → HTTP status codes

✅ gRPC Service Implementations (T022-T026):
- CameraService.cs: List/get camera information from GeViServer
- MonitorService.cs: List/get monitor/viewer information from GeViServer
- CrossSwitchService.cs: Execute cross-switching, clear monitors, query routing state
- Program.cs: gRPC server with Serilog logging, dependency injection
- appsettings.json: GeViServer connection configuration

Key Features:
- Async/await pattern throughout
- Comprehensive error handling and logging
- In-memory routing state tracking
- Health check endpoint
- Connection retry with exponential backoff
- Proper resource disposal

Architecture:
FastAPI (Python) ←gRPC→ SDK Bridge (C# .NET 8.0) ←SDK→ GeViServer

Ready for Phase 3: Python API Foundation

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-09 08:38:20 +01:00
Geutebruck API Developer
733b3b924a Phase 1 Complete: Project Setup & Configuration 
Completed Tasks (T001-T010):
- ✅ Project structure created (src/, tests/, docs/, scripts/)
- ✅ Python dependencies defined (requirements.txt)
- ✅ C# SDK Bridge project initialized (.csproj)
- ✅ Configuration template (.env.example)
- ✅ Database migration config (alembic.ini)
- ✅ Code quality tools (pyproject.toml with ruff, black, mypy)
- ✅ Development setup script (setup_dev_environment.ps1)
- ✅ Service startup script (start_services.ps1)
- ✅ Architecture documentation (docs/architecture.md)
- ✅ Revised MVP tasks (tasks-revised-mvp.md - 84 tasks focused on cross-switching)

MVP Scope Refined:
- Focus: Cross-switching control for GSCView viewers
- NO recordings, NO analytics, NO LPR in MVP
- REST API only, no UI needed
- Phase 2: GeViSet configuration management

Ready for Phase 2: SDK Bridge Foundation

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-09 08:25:26 +01:00
Geutebruck API Developer
dd2278b39a Complete Phase 0 and Phase 1 design documentation 
- Add comprehensive research.md with SDK integration decisions
- Add complete data-model.md with 7 entities and relationships
- Add OpenAPI 3.0 specification (contracts/openapi.yaml)
- Add developer quickstart.md guide
- Add comprehensive tasks.md with 215 tasks organized by user story
- Update plan.md with complete technical context
- Add SDK_INTEGRATION_LESSONS.md capturing critical knowledge
- Add .gitignore for Python and C# projects
- Include GeViScopeConfigReader and GeViSoftConfigReader tools

Phase 1 Design Complete:
✅ Architecture: Python FastAPI + C# gRPC Bridge + GeViScope SDK
✅ 10 user stories mapped to tasks (MVP = US1-4)
✅ Complete API contract with 17 endpoints
✅ Data model with User, Camera, Stream, Event, Recording, Analytics
✅ TDD approach enforced with 80+ test tasks

Ready for Phase 2: Implementation

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-09 07:39:55 +01:00
Geutebruck API Developer
edf22b09c2 feat: add technical implementation plan 
- Technology stack: Python 3.11+ FastAPI Redis
- Complete project structure (src/ tests/ docs/)
- All constitution gates passed
- 7 research topics identified
- 30 API endpoints across 6 resources
- Deployment strategy defined
- Ready for Phase 0 research
 2025-11-13 03:25:05 -08:00
Geutebruck API Developer
44dc06e7f1 feat: add complete API specification 
- 10 prioritized user stories (P1-P3)
- 30 functional requirements
- 15 success criteria with measurable outcomes
- Complete edge cases and risk analysis
- Technology-agnostic specification ready for planning phase
 2025-11-13 03:16:03 -08:00
Geutebruck API Developer
25c29b49ba docs: create constitution v1.0.0 
Initial constitution for Geutebruck Video Surveillance API establishing:
- Core principles: Security-First, RESTful API Design, TDD, SDK Abstraction, Performance
- Technical constraints: Windows platform, GeViScope SDK integration requirements
- Quality standards: Testing requirements, code review process, documentation
- Governance: Amendment process, compliance enforcement, continuous improvement

Constitution defines non-negotiable requirements and guides all development decisions.
 2025-11-13 02:47:05 -08:00