huncode/content-factory
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(task-005): complete article intake dashboard detail flow

Browse Source
This commit is contained in:
huncode
2026-05-21 18:54:11 +03:00
parent 7972e9a95f
commit cf84400118
28 changed files with 1714 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/backend/src/application/articles.py
+48 -18
View File
@@ -1,13 +1,15 @@
from __future__ import annotations
from datetime import UTC, datetime
from uuid import NAMESPACE_URL, UUID, uuid5
from uuid import UUID, uuid4
from src.domain.contracts import (
ArticleCreateRequest,
ArticleCreateResponse,
ArticleSummary,
ArticleDetailResponse,
ArticleListResponse,
ArticleWorkflowStatus,
CurrentUser,
PublishingStatus,
ReviewActionResponse,
ReviewStatus,
@@ -16,18 +18,15 @@ from src.domain.contracts import (
)
PLACEHOLDER_CREATED_AT = datetime(1970, 1, 1, tzinfo=UTC)
def build_placeholder_article_response(
def create_article(
repository: object,
request: ArticleCreateRequest,
current_user: CurrentUser,
) -> ArticleCreateResponse:
article_id = uuid5(
NAMESPACE_URL,
f"article:{request.target_site_id}:{request.brief_description}",
)
article = ArticleSummary(
id=article_id,
repository.target_sites.get_by_id(request.target_site_id)
now = _now()
summary = repository.articles.create(
target_site_id=request.target_site_id,
status=ArticleWorkflowStatus.ARTICLE_BRIEF_CREATED,
publishing_status=PublishingStatus.PUBLISH_NOT_STARTED,
@@ -36,11 +35,38 @@ def build_placeholder_article_response(
language=request.language,
content_type=request.content_type,
primary_keyword=request.primary_keyword,
assigned_editor_id=request.assigned_editor_id,
created_at=PLACEHOLDER_CREATED_AT,
updated_at=PLACEHOLDER_CREATED_AT,
assigned_editor_id=request.assigned_editor_id or current_user.id,
created_at=now,
updated_at=now,
)
repository.articles.create_workflow_event(
article_id=summary.id,
event_type="ARTICLE_CREATED",
from_status=None,
to_status=ArticleWorkflowStatus.ARTICLE_BRIEF_CREATED,
actor_user_id=current_user.id,
payload={"brief_description_length": len(request.brief_description)},
created_at=now,
)
return ArticleCreateResponse(article=summary)
def list_articles(repository: object) -> ArticleListResponse:
return ArticleListResponse(articles=repository.articles.list())
def get_article_detail(
repository: object,
article_id: UUID,
) -> ArticleDetailResponse:
article = repository.articles.get(article_id)
target_site = repository.target_sites.get_by_id(article.target_site_id)
workflow_events = repository.articles.list_workflow_events(article_id)
return ArticleDetailResponse(
article=article,
target_site=target_site,
workflow_events=workflow_events,
)
return ArticleCreateResponse(article=article)
def build_placeholder_plan_approval_response(
@@ -50,12 +76,16 @@ def build_placeholder_plan_approval_response(
reviewer_id: UUID,
) -> ReviewActionResponse:
review = ReviewSummary(
id=uuid5(NAMESPACE_URL, f"plan-approval:{article_id}:{plan_id}:{reviewer_id}"),
id=uuid4(),
article_id=article_id,
review_type=ReviewType.PLAN,
status=ReviewStatus.APPROVED,
reviewer_id=reviewer_id,
notes=None,
created_at=PLACEHOLDER_CREATED_AT,
created_at=_now(),
)
return ReviewActionResponse(review=review)
def _now() -> datetime:
return datetime.now(UTC)
apps/backend/src/domain/contracts/__init__.py
+2
View File
@@ -22,6 +22,7 @@ from .models import (
ArticleDetailResponse,
ArticleListResponse,
ArticleSummary,
WorkflowEventSummary,
AssetSummary,
ClaimSummary,
CurrentUser,
@@ -66,6 +67,7 @@ __all__ = [
"ArticleDetailResponse",
"ArticleListResponse",
"ArticleSummary",
"WorkflowEventSummary",
"ArticleWorkflowStatus",
"AssetStatus",
"AssetSummary",
apps/backend/src/domain/contracts/models.py
+12
View File
@@ -169,6 +169,17 @@ class ArticleListResponse(ContractModel):
articles: list[ArticleSummary]
class WorkflowEventSummary(ContractModel):
id: UUID
article_id: UUID
event_type: str = Field(min_length=1)
from_status: ArticleWorkflowStatus | None = None
to_status: ArticleWorkflowStatus | None = None
actor_user_id: UUID | None = None
payload: JsonObject = Field(default_factory=dict)
created_at: datetime
class PlanSectionSummary(ContractModel):
id: UUID
article_plan_id: UUID
@@ -317,6 +328,7 @@ class AgentJobOutput(ContractModel):
class ArticleDetailResponse(ContractModel):
article: ArticleSummary
target_site: TargetSiteConfig | None = None
workflow_events: list[WorkflowEventSummary] = Field(default_factory=list)
plan: PlanSummary | None = None
draft: DraftSummary | None = None
evidence: list[EvidenceSummary] = Field(default_factory=list)
apps/backend/src/domain/contracts/openapi.py
+2
View File
@@ -51,6 +51,7 @@ from .models import (
TargetSiteConfig,
TargetSiteConfigCreateRequest,
TargetSiteConfigResponse,
WorkflowEventSummary,
TargetSiteConfigUpdateRequest,
UserSummary,
)
@@ -90,6 +91,7 @@ CONTRACT_SCHEMA_MODELS: tuple[type[BaseModel], ...] = (
ArticleSummary,
ArticleCreateResponse,
ArticleListResponse,
WorkflowEventSummary,
PlanSectionSummary,
PlanSummary,
ResearchArtifactSummary,
apps/backend/src/infrastructure/repositories.py
+240 -1
View File
@@ -6,10 +6,14 @@ from collections.abc import Iterator
from contextlib import contextmanager
from datetime import datetime
from typing import Any
from uuid import UUID
from uuid import UUID, uuid4
from src.domain.contracts import (
ArticleSummary,
PublishingRules,
PublishingStatus,
ArticleWorkflowStatus,
WorkflowEventSummary,
Role,
ScriptConfigVersionStatus,
TargetSiteConfig,
@@ -31,6 +35,7 @@ class BackendRepository:
self.dialect = "sqlite" if dsn.startswith("sqlite:///") else "postgres"
self.users = UsersRepository(self)
self.target_sites = TargetSitesRepository(self)
self.articles = ArticlesRepository(self)
self.script_config_versions = ScriptConfigVersionsRepository(self)
self.schema = SchemaRepository(self)
@@ -384,6 +389,204 @@ class TargetSitesRepository:
return [_target_site_from_row(row) for row in rows]
class ArticlesRepository:
def __init__(self, repository: BackendRepository) -> None:
self._repository = repository
def create(
self,
*,
target_site_id: UUID,
status: ArticleWorkflowStatus,
publishing_status: PublishingStatus,
brief_description: str,
working_title: str | None,
language: str,
content_type: str,
primary_keyword: str | None,
assigned_editor_id: UUID | None,
created_at: datetime,
updated_at: datetime,
) -> ArticleSummary:
article_id = uuid4()
placeholder = self._repository.placeholder()
sql = f"""
INSERT INTO articles (
id,
target_site_id,
status,
publishing_status,
brief_description,
working_title,
language,
content_type,
primary_keyword,
assigned_editor_id,
created_at,
updated_at
)
VALUES (
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder}
)
"""
with self._repository.connection() as connection:
connection.execute(
sql,
(
str(article_id),
str(target_site_id),
status.value,
publishing_status.value,
brief_description,
working_title,
language,
content_type,
primary_keyword,
_uuid_value(assigned_editor_id),
_datetime_value(created_at),
_datetime_value(updated_at),
),
)
return self.get(article_id)
def list(self) -> list[ArticleSummary]:
with self._repository.connection() as connection:
rows = connection.execute(
"""
SELECT
id,
target_site_id,
status,
publishing_status,
brief_description,
working_title,
language,
content_type,
primary_keyword,
assigned_editor_id,
created_at,
updated_at
FROM articles
ORDER BY updated_at DESC
"""
).fetchall()
return [_article_summary_from_row(row) for row in rows]
def get(self, article_id: UUID) -> ArticleSummary:
placeholder = self._repository.placeholder()
with self._repository.connection() as connection:
row = connection.execute(
f"""
SELECT
id,
target_site_id,
status,
publishing_status,
brief_description,
working_title,
language,
content_type,
primary_keyword,
assigned_editor_id,
created_at,
updated_at
FROM articles
WHERE id = {placeholder}
""",
(str(article_id),),
).fetchone()
if row is None:
raise LookupError(f"Article not found: {article_id}")
return _article_summary_from_row(row)
def create_workflow_event(
self,
*,
article_id: UUID,
event_type: str,
from_status: ArticleWorkflowStatus | None,
to_status: ArticleWorkflowStatus | None,
actor_user_id: UUID | None,
payload: dict[str, Any],
created_at: datetime,
) -> None:
placeholder = self._repository.placeholder()
json_cast = self._repository.json_cast()
sql = f"""
INSERT INTO workflow_events (
id,
article_id,
event_type,
from_status,
to_status,
actor_user_id,
payload,
created_at
)
VALUES (
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder},
{placeholder}{json_cast},
{placeholder}
)
"""
with self._repository.connection() as connection:
connection.execute(
sql,
(
str(uuid4()),
str(article_id),
event_type,
_article_status_value(from_status),
_article_status_value(to_status),
_uuid_value(actor_user_id),
_json_value(payload),
_datetime_value(created_at),
),
)
def list_workflow_events(self, article_id: UUID) -> list[WorkflowEventSummary]:
placeholder = self._repository.placeholder()
with self._repository.connection() as connection:
rows = connection.execute(
f"""
SELECT
id,
article_id,
event_type,
from_status,
to_status,
actor_user_id,
payload,
created_at
FROM workflow_events
WHERE article_id = {placeholder}
ORDER BY created_at
""",
(str(article_id),),
).fetchall()
return [_workflow_event_from_row(row) for row in rows]
class ScriptConfigVersionsRepository:
def __init__(self, repository: BackendRepository) -> None:
self._repository = repository
@@ -687,6 +890,36 @@ def _target_site_from_row(row: Any) -> TargetSiteConfig:
)
def _article_summary_from_row(row: Any) -> ArticleSummary:
return ArticleSummary(
id=_row_value(row, "id"),
target_site_id=_row_value(row, "target_site_id"),
status=_row_value(row, "status"),
publishing_status=_row_value(row, "publishing_status"),
brief_description=_row_value(row, "brief_description"),
working_title=_row_value(row, "working_title"),
language=_row_value(row, "language"),
content_type=_row_value(row, "content_type"),
primary_keyword=_row_value(row, "primary_keyword"),
assigned_editor_id=_row_value(row, "assigned_editor_id"),
created_at=_row_value(row, "created_at"),
updated_at=_row_value(row, "updated_at"),
)
def _workflow_event_from_row(row: Any) -> WorkflowEventSummary:
return WorkflowEventSummary(
id=_row_value(row, "id"),
article_id=_row_value(row, "article_id"),
event_type=_row_value(row, "event_type"),
from_status=_row_value(row, "from_status"),
to_status=_row_value(row, "to_status"),
actor_user_id=_row_value(row, "actor_user_id"),
payload=_json_from_row(row, "payload"),
created_at=_row_value(row, "created_at"),
)
def _plain_row(row: Any) -> dict[str, Any]:
if isinstance(row, sqlite3.Row):
result = dict(row)
@@ -733,3 +966,9 @@ def _datetime_value(value: datetime | None) -> str | None:
if value is None:
return None
return value.isoformat()
def _article_status_value(value: ArticleWorkflowStatus | None) -> str | None:
if value is None:
return None
return value.value
apps/backend/src/presentation/routes/articles.py
+48 -6
View File
@@ -2,20 +2,25 @@ from __future__ import annotations
from uuid import UUID
from fastapi import APIRouter, Depends, status
from fastapi import APIRouter, Depends, HTTPException, status
from src.application.articles import (
build_placeholder_article_response,
create_article,
get_article_detail,
list_articles,
build_placeholder_plan_approval_response,
)
from src.domain.auth import EDITOR_OR_ADMIN_ROLES
from src.domain.contracts import (
ArticleCreateRequest,
ArticleCreateResponse,
ArticleDetailResponse,
ArticleListResponse,
CurrentUser,
ReviewActionResponse,
)
from src.presentation.dependencies import require_roles
from src.infrastructure.repositories import BackendRepository
from src.presentation.dependencies import get_repository, require_roles
router = APIRouter(prefix="/api", tags=["articles"])
@@ -26,11 +31,48 @@ router = APIRouter(prefix="/api", tags=["articles"])
response_model=ArticleCreateResponse,
status_code=status.HTTP_201_CREATED,
)
def create_article(
def post_article(
request: ArticleCreateRequest,
_: CurrentUser = Depends(require_roles(EDITOR_OR_ADMIN_ROLES)),
current_user: CurrentUser = Depends(require_roles(EDITOR_OR_ADMIN_ROLES)),
repository: BackendRepository = Depends(get_repository),
) -> ArticleCreateResponse:
return build_placeholder_article_response(request)
try:
return create_article(
repository,
request=request,
current_user=current_user,
)
except LookupError as error:
raise HTTPException(
status_code=status.HTTP_400_BAD_REQUEST,
detail="Invalid target_site_id",
) from error
@router.get("/articles", response_model=ArticleListResponse)
def list_articles_route(
_: CurrentUser = Depends(require_roles(EDITOR_OR_ADMIN_ROLES)),
repository: BackendRepository = Depends(get_repository),
) -> ArticleListResponse:
return list_articles(repository)
@router.get(
"/articles/{article_id}",
response_model=ArticleDetailResponse,
)
def get_article(
article_id: UUID,
_: CurrentUser = Depends(require_roles(EDITOR_OR_ADMIN_ROLES)),
repository: BackendRepository = Depends(get_repository),
) -> ArticleDetailResponse:
try:
return get_article_detail(repository=repository, article_id=article_id)
except LookupError as error:
raise HTTPException(
status_code=status.HTTP_404_NOT_FOUND,
detail="Not Found",
) from error
@router.post(