added fresh screens

alembic/versions/0015_starred_at.py

@@ -0,0 +1,33 @@
+"""leads.starred_at
+
+"Star" priority mark (user, 2026-09-23): "agar humyn us lead ko priority deni ho toh sales team star mark
+kr dy... yeh sirf mark hai koi action nhi" -- a rep flags a lead as worth prioritizing. Tag only, same as
+call_picked_by (revision 0013): never changes pipeline_stage or queue position, not logged as a
+call_events row. Pipeline shows/filters by it; a starred card renders with a blue accent.
+
+Nullable, no default, no backfill: every existing lead is unaffected (not starred).
+
+Revision ID: 0015_starred_at
+Revises: 0014_hidden_and_callback
+Create Date: 2026-09-23
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "0015_starred_at"
+down_revision: Union[str, None] = "0014_hidden_and_callback"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.add_column("leads", sa.Column("starred_at", sa.DateTime(), nullable=True))
+    op.create_index("idx_leads_starred", "leads", ["starred_at"])
+
+
+def downgrade() -> None:
+    op.drop_index("idx_leads_starred", table_name="leads")
+    op.drop_column("leads", "starred_at")

app/api/leads.py

@@ -190,6 +190,13 @@ def needs_email(
     return LeadOut.from_model(crud.mark_needs_email(db, lead, user))
 
 
+@router.post("/leads/{lead_id}/star", response_model=LeadOut)
+def star(lead_id: int, db: Session = Depends(get_db), user: User | None = Depends(get_current_user)):
+    """"Star" priority mark -- toggle, see crud.toggle_star(). User request, 2026-09-23."""
+    lead = _require(db, lead_id)
+    return LeadOut.from_model(crud.toggle_star(db, lead, user))
+
+
 @router.post("/leads/{lead_id}/meeting-outcome", response_model=LeadOut)
 def meeting_outcome(
     lead_id: int,

app/crud/leads.py

@@ -509,6 +509,20 @@ def set_call_picked_by(db: Session, lead: Lead, value: str, user=None) -> Lead:
     return lead
 
 
+def toggle_star(db: Session, lead: Lead, user=None) -> Lead:
+    """
+    "Star" priority mark (user, 2026-09-23) -- same tag-only rule as set_call_picked_by above: no stage
+    change, no queue movement, not logged as a call_events row. Just flips starred_at on/off.
+    """
+    lead.starred_at = None if lead.starred_at else _now()
+    lead.updated_at = _now()
+    if user is not None:
+        lead.last_touched_by_user_id = user.id
+    db.commit()
+    db.refresh(lead)
+    return lead
+
+
 def mark_needs_email(db: Session, lead: Lead, user=None) -> Lead:
     """
     "Email Send" button -- structure-plan.md Phase 3/4. A forward-looking flag ("this lead now needs an

app/models.py

@@ -73,6 +73,7 @@ class Lead(Base):
         Index("idx_leads_sent_to_desk", "sent_to_desk_at"),
         Index("idx_leads_hidden", "hidden_at"),
         Index("idx_leads_callback", "callback_at"),
+        Index("idx_leads_starred", "starred_at"),
     )
 
     id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
@@ -198,6 +199,10 @@ class Lead(Base):
     # Callback Scheduled's date/time (separate from meeting_at -- a callback is not a meeting and must
     # never appear on the Meetings calendar). Pipeline shows/filters by this.
     callback_at: Mapped[datetime | None] = mapped_column(DateTime, nullable=True)
+    # "Star" priority mark (revision 0015, user 2026-09-23) -- tag only, same as call_picked_by: never
+    # changes pipeline_stage or queue position, not logged as a call_events row. A rep sets this to flag
+    # "this lead is worth prioritizing"; Pipeline shows/filters by it.
+    starred_at: Mapped[datetime | None] = mapped_column(DateTime, nullable=True)
 
     contacts: Mapped[list["LeadContact"]] = relationship(
         back_populates="lead", cascade="all, delete-orphan", passive_deletes=True

app/schemas/lead.py

@@ -173,6 +173,8 @@ class LeadOut(BaseModel):
     hidden_at: str = ""
     # "" = no callback scheduled. Pipeline shows/filters leads by this.
     callback_at: str = ""
+    # "" = not starred. Priority mark, tag only -- see models.Lead.starred_at. User request, 2026-09-23.
+    starred_at: str = ""
 
     @classmethod
     def from_model(cls, m: Any) -> "LeadOut":
@@ -234,6 +236,7 @@ class LeadOut(BaseModel):
             call_picked_by=_s(getattr(m, "call_picked_by", "")),
             hidden_at=_dt_utc(getattr(m, "hidden_at", None)),
             callback_at=_dt_utc(getattr(m, "callback_at", None)),
+            starred_at=_dt_utc(getattr(m, "starred_at", None)),
             call_tz=call_timezone(
                 _s(m.contact_phone),
                 _s(getattr(m, "phone_country", "")) or _s(getattr(m, "country", "")),

scripts/check_star.py

@@ -0,0 +1,63 @@
+"""
+check_star.py -- offline: the "Star" priority mark (user, 2026-09-23).
+
+    uv run python scripts/check_star.py
+
+No database, no network -- throwaway in-memory SQLite. Covers: toggle_star() flips starred_at on/off,
+never touches pipeline_stage, sent_to_desk_at, or hidden_at (tag only, same rule as call_picked_by), and
+is not logged as a call_events row.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from sqlalchemy import create_engine, select  # noqa: E402
+from sqlalchemy.orm import sessionmaker  # noqa: E402
+from sqlalchemy.pool import StaticPool  # noqa: E402
+
+import app.models  # noqa: E402,F401
+from app.crud import leads as crud_leads  # noqa: E402
+from app.database import Base  # noqa: E402
+from app.models import CallEvent  # noqa: E402
+
+FAILED = 0
+
+
+def check(label: str, ok: bool, detail: str = "") -> None:
+    global FAILED
+    FAILED += 0 if ok else 1
+    print(f"  [{'ok  ' if ok else 'FAIL'}] {label}" + ("" if ok else f"   {detail}"))
+
+
+def main() -> int:
+    engine = create_engine("sqlite://", connect_args={"check_same_thread": False}, poolclass=StaticPool)
+    Base.metadata.create_all(engine)
+    db = sessionmaker(bind=engine)()
+
+    lead = crud_leads.add_lead_dict(db, {"company_name": "Star Co"})
+    before_stage, before_desk, before_hidden = lead.pipeline_stage, lead.sent_to_desk_at, lead.hidden_at
+    events_before = db.scalars(select(CallEvent).where(CallEvent.lead_id == lead.id)).all()
+
+    print("\nStar on")
+    lead = crud_leads.toggle_star(db, lead)
+    check("starred_at set", lead.starred_at is not None)
+    check("pipeline_stage untouched", lead.pipeline_stage == before_stage)
+    check("sent_to_desk_at untouched", lead.sent_to_desk_at == before_desk)
+    check("hidden_at untouched", lead.hidden_at == before_hidden)
+    events_after = db.scalars(select(CallEvent).where(CallEvent.lead_id == lead.id)).all()
+    check("no call_events row logged", len(events_after) == len(events_before))
+
+    print("\nStar off (toggle again)")
+    lead = crud_leads.toggle_star(db, lead)
+    check("starred_at cleared", lead.starred_at is None)
+
+    print(f"\n{'FAILED: ' + str(FAILED) if FAILED else 'All checks passed.'}")
+    return 1 if FAILED else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())