Files
myworkspace/LinkSyncServer/api/endpoints/admin.py
DavidSaylor 09d30427f4 Complete LinkSyncServer and LinkSyncExtension implementation
LinkSyncServer:
- Fix app.py imports, add CORS middleware, lifespan events
- Create api/routes.py router aggregator
- Create config/settings.py for centralized configuration
- Rewrite models/base.py with proper relationships and serialization
- Rewrite all API endpoints with real DB integration (auth, links, collections, sync, queries, tags)
- Add admin endpoints (user management, stats, audit log)
- Complete query parser with recursive descent and proper precedence
- Complete query executor with set operations and field filters
- Set up Alembic migrations with initial schema
- Create web interface (templates, CSS, JS)
- Add 42 passing tests (auth, links, collections, queries)
- Add deploy.ps1 and deploy.sh scripts
- Update README with deployment workflow

LinkSyncExtension:
- Create utils/api.js (REST client with retries, auth, error handling)
- Create utils/sync.js (3 sync modes + conflict detection)
- Create utils/collection.js (collection management)
- Create utils/query-engine.js (client-side query parser)
- Rewrite background.js (sync loop, bookmark events, message routing)
- Rewrite popup.js (tabs, settings modal, notifications, CRUD)
- Update popup.html (tabbed interface, query builder, modal)
- Update popup.css (full redesign)
- Create content/content.js (page metadata extraction)
- Create options.html/js (dedicated settings page)
- Generate icons (48x48, 96x96)
- Update manifest.json (host permissions, content scripts, options)
- Create AGENTS.md
2026-05-19 13:21:26 -05:00

188 lines
5.4 KiB
Python

"""
LinkSyncServer - Admin Endpoints
"""
import uuid
from typing import List, Optional
from fastapi import APIRouter, HTTPException, Query, status
from pydantic import BaseModel, EmailStr, Field
from api.endpoints.auth import hash_password, require_admin
from models.base import AuditLog, Bookmark, Collection, Tag, User, get_session
router = APIRouter(prefix="/api/admin", tags=["Admin"])
class UserCreate(BaseModel):
username: str
email: EmailStr
password: str
role: str = Field(default="user", pattern="^(admin|user)$")
is_active: bool = True
class UserUpdate(BaseModel):
email: Optional[EmailStr] = None
role: Optional[str] = Field(None, pattern="^(admin|user)$")
is_active: Optional[bool] = None
password: Optional[str] = None
class SettingsUpdate(BaseModel):
debug: Optional[bool] = None
cors_origins: Optional[str] = None
@router.get("/users", response_model=List[dict])
async def list_users(
limit: int = Query(20, le=100, ge=1),
offset: int = Query(0, ge=0),
current_admin: dict = require_admin,
):
db = get_session()
try:
users = db.query(User).order_by(User.created_at.desc()).offset(offset).limit(limit).all()
return [u.to_dict() for u in users]
finally:
db.close()
@router.post("/users", response_model=dict, status_code=status.HTTP_201_CREATED)
async def create_user(
data: UserCreate,
current_admin: dict = require_admin,
):
db = get_session()
try:
existing = db.query(User).filter(
(User.username == data.username) | (User.email == data.email)
).first()
if existing:
raise HTTPException(status_code=400, detail="Username or email already exists")
user = User(
id=str(uuid.uuid4()),
username=data.username,
email=data.email,
password_hash=hash_password(data.password),
role=data.role,
is_active=data.is_active,
)
db.add(user)
db.commit()
db.refresh(user)
return user.to_dict()
finally:
db.close()
@router.get("/users/{user_id}", response_model=dict)
async def get_user(
user_id: str,
current_admin: dict = require_admin,
):
db = get_session()
try:
user = db.query(User).filter(User.id == user_id).first()
if not user:
raise HTTPException(status_code=404, detail="User not found")
return user.to_dict()
finally:
db.close()
@router.put("/users/{user_id}", response_model=dict)
async def update_user(
user_id: str,
data: UserUpdate,
current_admin: dict = require_admin,
):
db = get_session()
try:
user = db.query(User).filter(User.id == user_id).first()
if not user:
raise HTTPException(status_code=404, detail="User not found")
update_data = data.model_dump(exclude_unset=True)
if "password" in update_data:
update_data["password_hash"] = hash_password(update_data.pop("password"))
for field, value in update_data.items():
setattr(user, field, value)
db.commit()
db.refresh(user)
return user.to_dict()
finally:
db.close()
@router.delete("/users/{user_id}", response_model=dict)
async def delete_user(
user_id: str,
current_admin: dict = require_admin,
):
db = get_session()
try:
user = db.query(User).filter(User.id == user_id).first()
if not user:
raise HTTPException(status_code=404, detail="User not found")
if user.username == current_admin.get("username"):
raise HTTPException(status_code=400, detail="Cannot delete yourself")
db.delete(user)
db.commit()
return {"message": "User deleted successfully", "deleted_id": user_id}
finally:
db.close()
@router.get("/stats", response_model=dict)
async def get_system_stats(current_admin: dict = require_admin):
db = get_session()
try:
return {
"total_users": db.query(User).count(),
"total_bookmarks": db.query(Bookmark).count(),
"total_collections": db.query(Collection).count(),
"total_tags": db.query(Tag).count(),
"total_audit_logs": db.query(AuditLog).count(),
}
finally:
db.close()
@router.get("/audit", response_model=List[dict])
async def get_audit_log(
limit: int = Query(50, le=200, ge=1),
offset: int = Query(0, ge=0),
entity_type: Optional[str] = Query(None),
action: Optional[str] = Query(None),
current_admin: dict = require_admin,
):
db = get_session()
try:
query = db.query(AuditLog)
if entity_type:
query = query.filter(AuditLog.entity_type == entity_type)
if action:
query = query.filter(AuditLog.action == action)
logs = query.order_by(AuditLog.created_at.desc()).offset(offset).limit(limit).all()
return [
{
"id": log.id,
"user_id": log.user_id,
"action": log.action,
"entity_type": log.entity_type,
"entity_id": log.entity_id,
"old_value": log.old_value,
"new_value": log.new_value,
"ip_address": log.ip_address,
"created_at": log.created_at.isoformat() if log.created_at else None,
}
for log in logs
]
finally:
db.close()