myworkspace/LinkSyncServer/tasks.md

LinkSyncServer - Implementation Tasks

Phase 1: Project Setup

Setup Tasks

• Initialize git repository
• Configure git remote (gitea.blabber1565.com)
• Create directory structure
• Write README.md
• Write TODOs.txt
• Write design.md
• Write tasks.md
• Write AGENTS.md
• Create docker-compose.yml
• Create Dockerfile
• Create requirements.txt
• Create pyproject.toml
• Create .env.example

Phase 2: Core Application

App Configuration

• Create app.py with FastAPI setup
• Configure CORS
• Set up error handlers
• Create health check endpoint
• Create config/settings.py

Database Setup

• Create models/base.py
• Create models/user.py
• Create models/link.py
• Create models/collection.py
• Create models/tag.py
• Create models/audit_log.py
• Configure SQLAlchemy engine
• Create schema.sql
• Set up Alembic migrations

Authentication

• Create models for users/roles
• Implement password hashing (bcrypt)
• Create JWT token utilities
• Implement login endpoint
• Implement register endpoint
• Implement logout endpoint
• Create API key model and endpoints
• Set up session management

Phase 3: API Endpoints

Auth Endpoints

• POST /api/auth/register/
• POST /api/auth/login/
• POST /api/auth/logout/
• POST /api/auth/api-key/
• DELETE /api/auth/api-key/{key_id}/

Link Endpoints

• GET /api/links/ - list with pagination and filters
• GET /api/links/{id}/ - single link details
• POST /api/links/ - create link
• PUT /api/links/{id}/ - update link
• DELETE /api/links/{id}/ - delete link
• POST /api/links/{id}/tags/ - add tags
• DELETE /api/links/{id}/tags/ - remove tags

Collection Endpoints

• GET /api/collections/ - list collections
• GET /api/collections/{id}/ - collection details
• POST /api/collections/ - create collection
• PUT /api/collections/{id}/ - update collection
• DELETE /api/collections/{id}/ - delete collection
• POST /api/collections/{id}/refresh/ - refresh dynamic collection

Query Endpoints

• POST /api/queries/parse/ - parse and validate query
• POST /api/queries/execute/ - execute query and return results
• GET /api/queries/{id}/ - get saved query
• PUT /api/queries/{id}/ - update saved query
• DELETE /api/queries/{id}/ - delete query

Sync Endpoint

• POST /api/sync/ - sync with browser extension
• Implement sync mode logic
• Handle conflict resolution
• Process deletions

Admin Endpoints

• GET /api/admin/users/ - list all users
• POST /api/admin/users/ - create user
• PUT /api/admin/users/{id}/ - update user
• DELETE /api/admin/users/{id}/ - delete user
• PUT /api/admin/settings/ - update settings

Phase 4: Query Engine

Parser

• Create tokenization logic
• Implement AST node classes
• Build parser with precedence rules
• Validate AST
• Serialize AST to JSON

Executor

• Implement TermSet executor
• Implement TagFilter executor
• Implement FieldFilter executor
• Implement AND/OR/XOR operators
• Build SQL from AST
• Execute queries with full-text search

Cache

• Implement query result caching
• Set appropriate TTL
• Invalidate on link update

Phase 5: Web Interface

Layout

• Create templates/base.html
• Create templates/layout.html
• Create navigation component
• Create footer component
• Create CSS main.css

Links View

• Create templates/links/list.html
• Create templates/links/detail.html
• Create templates/links/create.html
• Create templates/links/edit.html
• Implement link list search
• Implement tag filtering
• Implement pagination

Collections View

• Create templates/collections/list.html
• Create templates/collections/detail.html
• Create templates/collections/create.html
• Create templates/collections/edit.html
• Implement query builder UI
• Implement collection type selector

Auth Views

• Create templates/auth/login.html
• Create templates/auth/register.html
• Create templates/auth/forgot_password.html

Static Files

• Create static/css/main.css
• Create static/js/main.js
• Create static/js/api.js
• Add favicon

Phase 6: Testing

Unit Tests

• tests/test_auth.py
• tests/test_links.py
• tests/test_collections.py
• tests/test_queries.py
• tests/test_sync.py

Integration Tests

• Setup test database
• Test full registration flow
• Test CRUD operations
• Test sync endpoint
• Test query execution

E2E Tests

• Test login/logout
• Test link CRUD
• Test collection CRUD
• Test query builder
• Test sync flow

Phase 7: Docker & Deployment

Docker

• Create optimized Dockerfile
• Configure health checks
• Test container build
• Test container run
• Test docker-compose

Deployment

• Create deployment guide
• Configure production settings
• Set up logging
• Configure monitoring
• Create backups procedure

Phase 8: Documentation

• API reference
• User guide
• Query syntax guide
• Deployment guide
• Troubleshooting guide