app/api/routers/comments.py

@@ -51,8 +51,16 @@ def create_comment(comment: schemas.CommentCreate, db: Session = Depends(get_db)
 
 
 @router.get("/tasks/{task_id}/comments")
-def list_comments(task_id: int, db: Session = Depends(get_db)):
-    comments = db.query(models.Comment).filter(models.Comment.task_id == task_id).all()
+def list_comments(task_id: str, db: Session = Depends(get_db)):
+    """List comments for a task. task_id can be numeric id or task_code."""
+    try:
+        tid = int(task_id)
+    except (ValueError, TypeError):
+        task = db.query(Task).filter(Task.task_code == task_id).first()
+        if not task:
+            raise HTTPException(status_code=404, detail="Task not found")
+        tid = task.id
+    comments = db.query(models.Comment).filter(models.Comment.task_id == tid).all()
     result = []
     for c in comments:
         author = db.query(models.User).filter(models.User.id == c.author_id).first()

app/api/routers/misc.py

@@ -28,6 +28,19 @@ from app.schemas import schemas
 router = APIRouter()
 
 
+def _resolve_milestone(db: Session, identifier: str) -> MilestoneModel:
+    """Resolve a milestone by numeric id or milestone_code string.
+    Raises 404 if not found."""
+    try:
+        ms_id = int(identifier)
+        ms = db.query(MilestoneModel).filter(MilestoneModel.id == ms_id).first()
+    except (ValueError, TypeError):
+        ms = db.query(MilestoneModel).filter(MilestoneModel.milestone_code == identifier).first()
+    if not ms:
+        raise HTTPException(status_code=404, detail="Milestone not found")
+    return ms
+
+
 # ============ API Keys ============
 
 class APIKeyCreate(BaseModel):
@@ -170,17 +183,12 @@ def _find_milestone_by_id_or_code(db, identifier) -> MilestoneModel | None:
 
 @router.get("/milestones/{milestone_id}", response_model=schemas.MilestoneResponse, tags=["Milestones"])
 def get_milestone(milestone_id: str, db: Session = Depends(get_db)):
-    ms = _find_milestone_by_id_or_code(db, milestone_id)
-    if not ms:
-        raise HTTPException(status_code=404, detail="Milestone not found")
-    return ms
+    return _resolve_milestone(db, milestone_id)
 
 
 @router.patch("/milestones/{milestone_id}", response_model=schemas.MilestoneResponse, tags=["Milestones"])
 def update_milestone(milestone_id: str, ms_update: schemas.MilestoneUpdate, db: Session = Depends(get_db), current_user: models.User = Depends(get_current_user_or_apikey)):
-    ms = _find_milestone_by_id_or_code(db, milestone_id)
-    if not ms:
-        raise HTTPException(status_code=404, detail="Milestone not found")
+    ms = _resolve_milestone(db, milestone_id)
     ensure_can_edit_milestone(db, current_user.id, ms)
     for field, value in ms_update.model_dump(exclude_unset=True).items():
         setattr(ms, field, value)
@@ -191,9 +199,7 @@ def update_milestone(milestone_id: str, ms_update: schemas.MilestoneUpdate, db:
 
 @router.delete("/milestones/{milestone_id}", status_code=status.HTTP_204_NO_CONTENT, tags=["Milestones"])
 def delete_milestone(milestone_id: str, db: Session = Depends(get_db)):
-    ms = _find_milestone_by_id_or_code(db, milestone_id)
-    if not ms:
-        raise HTTPException(status_code=404, detail="Milestone not found")
+    ms = _resolve_milestone(db, milestone_id)
     db.delete(ms)
     db.commit()
     return None
@@ -201,10 +207,8 @@ def delete_milestone(milestone_id: str, db: Session = Depends(get_db)):
 
 @router.get("/milestones/{milestone_id}/progress", tags=["Milestones"])
 def milestone_progress(milestone_id: str, db: Session = Depends(get_db)):
-    ms = _find_milestone_by_id_or_code(db, milestone_id)
-    if not ms:
-        raise HTTPException(status_code=404, detail="Milestone not found")
-    tasks = db.query(Task).filter(Task.milestone_id == milestone_id).all()
+    ms = _resolve_milestone(db, milestone_id)
+    tasks = db.query(Task).filter(Task.milestone_id == ms.id).all()
     total = len(tasks)
     done = sum(1 for t in tasks if t.status == TaskStatus.CLOSED)
 
@@ -216,7 +220,7 @@ def milestone_progress(milestone_id: str, db: Session = Depends(get_db)):
         time_progress = min(100, max(0, (elapsed / total_duration * 100)))
 
     return {
-        "milestone_id": milestone_id,
+        "milestone_id": ms.id,
         "title": ms.title,
         "total": total,
         "total_tasks": total,
@@ -334,18 +338,34 @@ def create_worklog(wl: WorkLogCreate, db: Session = Depends(get_db)):
 
 
 @router.get("/tasks/{task_id}/worklogs", response_model=List[WorkLogResponse], tags=["Time Tracking"])
-def list_task_worklogs(task_id: int, db: Session = Depends(get_db)):
-    return db.query(WorkLog).filter(WorkLog.task_id == task_id).order_by(WorkLog.logged_date.desc()).all()
+def list_task_worklogs(task_id: str, db: Session = Depends(get_db)):
+    """List worklogs for a task. task_id can be numeric id or task_code."""
+    try:
+        tid = int(task_id)
+    except (ValueError, TypeError):
+        task = db.query(Task).filter(Task.task_code == task_id).first()
+        if not task:
+            raise HTTPException(status_code=404, detail="Task not found")
+        tid = task.id
+    return db.query(WorkLog).filter(WorkLog.task_id == tid).order_by(WorkLog.logged_date.desc()).all()
 
 
 @router.get("/tasks/{task_id}/worklogs/summary", tags=["Time Tracking"])
-def task_worklog_summary(task_id: int, db: Session = Depends(get_db)):
-    task = db.query(Task).filter(Task.id == task_id).first()
+def task_worklog_summary(task_id: str, db: Session = Depends(get_db)):
+    """Worklog summary for a task. task_id can be numeric id or task_code."""
+    try:
+        tid = int(task_id)
+    except (ValueError, TypeError):
+        t = db.query(Task).filter(Task.task_code == task_id).first()
+        if not t:
+            raise HTTPException(status_code=404, detail="Task not found")
+        tid = t.id
+    task = db.query(Task).filter(Task.id == tid).first()
     if not task:
         raise HTTPException(status_code=404, detail="Task not found")
-    total = db.query(sqlfunc.sum(WorkLog.hours)).filter(WorkLog.task_id == task_id).scalar() or 0
-    count = db.query(WorkLog).filter(WorkLog.task_id == task_id).count()
-    return {"task_id": task_id, "total_hours": round(total, 2), "log_count": count}
+    total = db.query(sqlfunc.sum(WorkLog.hours)).filter(WorkLog.task_id == tid).scalar() or 0
+    count = db.query(WorkLog).filter(WorkLog.task_id == tid).count()
+    return {"task_id": tid, "total_hours": round(total, 2), "log_count": count}
 
 
 @router.delete("/worklogs/{worklog_id}", status_code=status.HTTP_204_NO_CONTENT, tags=["Time Tracking"])

app/api/routers/tasks.py

@@ -20,6 +20,19 @@ from app.services.dependency_check import check_task_deps
 
 router = APIRouter(tags=["Tasks"])
 
+
+def _resolve_task(db: Session, identifier: str) -> Task:
+    """Resolve a task by numeric id or task_code string.
+    Raises 404 if not found."""
+    try:
+        task_id = int(identifier)
+        task = db.query(Task).filter(Task.id == task_id).first()
+    except (ValueError, TypeError):
+        task = db.query(Task).filter(Task.task_code == identifier).first()
+    if not task:
+        raise HTTPException(status_code=404, detail="Task not found")
+    return task
+
 # ---- State-machine: valid transitions (P5.1-P5.6) ----
 VALID_TRANSITIONS: dict[str, set[str]] = {
     "pending":    {"open", "closed"},
@@ -304,17 +317,13 @@ def search_tasks_alias(
 
 @router.get("/tasks/{task_id}", response_model=schemas.TaskResponse)
 def get_task(task_id: str, db: Session = Depends(get_db)):
-    task = _find_task_by_id_or_code(db, task_id)
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+    task = _resolve_task(db, task_id)
     return _serialize_task(db, task)
 
 
 @router.patch("/tasks/{task_id}", response_model=schemas.TaskResponse)
 def update_task(task_id: str, task_update: schemas.TaskUpdate, db: Session = Depends(get_db), current_user: models.User = Depends(get_current_user_or_apikey)):
-    task = _find_task_by_id_or_code(db, task_id)
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+    task = _resolve_task(db, task_id)
 
     # P5.7: status-based edit restrictions
     current_status = task.status.value if hasattr(task.status, 'value') else task.status
@@ -403,9 +412,7 @@ def update_task(task_id: str, task_update: schemas.TaskUpdate, db: Session = Dep
 
 @router.delete("/tasks/{task_id}", status_code=status.HTTP_204_NO_CONTENT)
 def delete_task(task_id: str, db: Session = Depends(get_db), current_user: models.User = Depends(get_current_user_or_apikey)):
-    task = _find_task_by_id_or_code(db, task_id)
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+    task = _resolve_task(db, task_id)
     check_project_role(db, current_user.id, task.project_id, min_role="mgr")
     log_activity(db, "task.deleted", "task", task.id, current_user.id, {"title": task.title})
     db.delete(task)
@@ -433,9 +440,7 @@ def transition_task(
     valid_statuses = [s.value for s in TaskStatus]
     if new_status not in valid_statuses:
         raise HTTPException(status_code=400, detail=f"Invalid status. Must be one of: {valid_statuses}")
-    task = _find_task_by_id_or_code(db, task_id)
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+    task = _resolve_task(db, task_id)
     old_status = task.status.value if hasattr(task.status, 'value') else task.status
 
     # P5.1: enforce state-machine
@@ -556,10 +561,8 @@ def take_task(
 # ---- Assignment ----
 
 @router.post("/tasks/{task_id}/assign")
-def assign_task(task_id: int, assignee_id: int, db: Session = Depends(get_db)):
-    task = db.query(Task).filter(Task.id == task_id).first()
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+def assign_task(task_id: str, assignee_id: int, db: Session = Depends(get_db)):
+    task = _resolve_task(db, task_id)
     user = db.query(models.User).filter(models.User.id == assignee_id).first()
     if not user:
         raise HTTPException(status_code=404, detail="User not found")
@@ -575,10 +578,8 @@ def assign_task(task_id: int, assignee_id: int, db: Session = Depends(get_db)):
 # ---- Tags ----
 
 @router.post("/tasks/{task_id}/tags")
-def add_tag(task_id: int, tag: str, db: Session = Depends(get_db)):
-    task = db.query(Task).filter(Task.id == task_id).first()
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+def add_tag(task_id: str, tag: str, db: Session = Depends(get_db)):
+    task = _resolve_task(db, task_id)
     current = set(task.tags.split(",")) if task.tags else set()
     current.add(tag.strip())
     current.discard("")
@@ -588,10 +589,8 @@ def add_tag(task_id: int, tag: str, db: Session = Depends(get_db)):
 
 
 @router.delete("/tasks/{task_id}/tags")
-def remove_tag(task_id: int, tag: str, db: Session = Depends(get_db)):
-    task = db.query(Task).filter(Task.id == task_id).first()
-    if not task:
-        raise HTTPException(status_code=404, detail="Task not found")
+def remove_tag(task_id: str, tag: str, db: Session = Depends(get_db)):
+    task = _resolve_task(db, task_id)
     current = set(task.tags.split(",")) if task.tags else set()
     current.discard(tag.strip())
     current.discard("")

app/main.py

@@ -26,6 +26,26 @@ def health_check():
 def version():
     return {"name": "HarborForge", "version": "0.3.0", "description": "Agent/人类协同任务管理平台"}
 
+@app.get("/config/status", tags=["System"])
+def config_status():
+    """Check if HarborForge has been initialized (reads from config volume).
+    Frontend uses this instead of contacting the wizard directly."""
+    import os, json
+    config_dir = os.getenv("CONFIG_DIR", "/config")
+    config_file = os.getenv("CONFIG_FILE", "harborforge.json")
+    config_path = os.path.join(config_dir, config_file)
+    if not os.path.exists(config_path):
+        return {"initialized": False}
+    try:
+        with open(config_path, "r") as f:
+            cfg = json.load(f)
+        return {
+            "initialized": cfg.get("initialized", False),
+            "backend_url": cfg.get("backend_url"),
+        }
+    except Exception:
+        return {"initialized": False}
+
 # Register routers
 from app.api.routers.auth import router as auth_router
 from app.api.routers.tasks import router as tasks_router