feat: history api 구현 (#80)

* History 관련 api를 구현했습니다.
* History table을 수정하고 마이그레이션 파일을 추가했습니다.

Author: mjy926

wacruit/src/apps/history/__init__.py

@@ -0,0 +1 @@
+from .views import v3_router as router

wacruit/src/apps/history/exceptions.py

@@ -0,0 +1,6 @@
+from wacruit.src.apps.common.exceptions import WacruitException
+
+
+class HistoryEmptyException(WacruitException):
+    def __init__(self):
+        super().__init__(status_code=404, detail="History 테이블이 비어 있습니다.")

wacruit/src/apps/history/models.py

@@ -1,15 +1,13 @@
-from datetime import datetime
-
 from sqlalchemy.orm import Mapped
 
 from wacruit.src.database.base import DeclarativeBase
 from wacruit.src.database.base import intpk
+from wacruit.src.database.base import str50
 
 
 class History(DeclarativeBase):
     __tablename__ = "histroy"
 
     id: Mapped[intpk]
-    total_projects: Mapped[int]
-    total_users: Mapped[int]
-    total_members: Mapped[int]
+    history_key: Mapped[str50]
+    history_value: Mapped[str50]

wacruit/src/apps/history/repositories.py

@@ -0,0 +1,46 @@
+from datetime import datetime
+
+from fastapi import Depends
+from sqlalchemy import select
+from sqlalchemy.orm import Session
+
+from wacruit.src.apps.history.models import History
+from wacruit.src.database.connection import get_db_session
+from wacruit.src.database.connection import Transaction
+
+
+class HistoryRepository:
+    def __init__(
+        self,
+        session: Session = Depends(get_db_session),
+        transaction: Transaction = Depends(),
+    ):
+        self.session = session
+        self.transaction = transaction
+
+    def get_history(self) -> list[History]:
+        query = select(History)
+        return list(self.session.execute(query).scalars().all())
+
+    def update_history(self, history: History) -> History:
+        history_key = history.history_key
+        history_value = history.history_value
+
+        with self.transaction:
+            query = select(History).where(History.history_key == history_key)
+            result = self.session.execute(query).scalar_one_or_none()
+            if result:
+                result.history_value = history_value
+            else:
+                result = History(history_key=history_key, history_value=history_value)
+                self.session.add(result)
+
+        return history
+
+    def get_start_date(self) -> datetime | None:
+        query = select(History).where(History.history_key == "start_date")
+        result = self.session.execute(query).scalar_one_or_none()
+
+        if result is None:
+            return None
+        return datetime.strptime(result.history_value, "%Y-%m-%d")

wacruit/src/apps/history/schemas.py

@@ -0,0 +1,10 @@
+from pydantic import BaseModel
+
+
+class UpdateHistoryRequest(BaseModel):
+    class Config:
+        extra = "allow"
+
+
+class HistoryResponse(BaseModel):
+    __root__: dict[str, str]

wacruit/src/apps/history/services.py

@@ -0,0 +1,45 @@
+from datetime import datetime
+
+from fastapi import Depends
+
+from wacruit.src.apps.history.exceptions import HistoryEmptyException
+from wacruit.src.apps.history.models import History
+from wacruit.src.apps.history.repositories import HistoryRepository
+from wacruit.src.apps.history.schemas import UpdateHistoryRequest
+
+
+class HistoryService:
+    def __init__(self, history_repository: HistoryRepository = Depends()):
+        self.history_repository = history_repository
+
+    def get_history(self) -> list[History]:
+        history_list = self.history_repository.get_history()
+        operation_period = self.calculate_operation_period()
+
+        if operation_period is not None:
+            history_list.append(
+                History(
+                    history_key="operation_period", history_value=str(operation_period)
+                )
+            )
+
+        if not history_list:
+            raise HistoryEmptyException
+        return history_list
+
+    def update_history(self, update_request: UpdateHistoryRequest):
+        req = update_request.dict()
+
+        for k, v in req.items():
+            to_update = History(history_key=k, history_value=v)
+            self.history_repository.update_history(to_update)
+
+        return self.get_history()
+
+    def calculate_operation_period(self) -> int | None:
+        start_date = self.history_repository.get_start_date()
+        now = datetime.now()
+
+        if start_date is None:
+            return None
+        return now.year - start_date.year

wacruit/src/apps/history/views.py

@@ -0,0 +1,35 @@
+from typing import Annotated
+
+from fastapi import APIRouter
+from fastapi import Depends
+
+from wacruit.src.apps.history.schemas import HistoryResponse
+from wacruit.src.apps.history.schemas import UpdateHistoryRequest
+from wacruit.src.apps.history.services import HistoryService
+from wacruit.src.apps.user.dependencies import AdminUser
+
+v3_router = APIRouter(prefix="/v3/history", tags=["history"])
+
+
+@v3_router.patch("/")
+def update_history(
+    admin_user: AdminUser,
+    history_service: Annotated[HistoryService, Depends()],
+    update_request: UpdateHistoryRequest,
+):
+    updated_history = history_service.update_history(update_request)
+    response_dict = {}
+    for h in updated_history:
+        response_dict[h.history_key] = h.history_value
+
+    return HistoryResponse(__root__=response_dict)
+
+
+@v3_router.get("/")
+def get_history(history_service: Annotated[HistoryService, Depends()]):
+    history_list = history_service.get_history()
+    response_dict = {}
+    for h in history_list:
+        response_dict[h.history_key] = h.history_value
+
+    return HistoryResponse(__root__=response_dict)

wacruit/src/apps/router.py

@@ -2,6 +2,7 @@
 
 from wacruit.src.apps import announcement
 from wacruit.src.apps import dummy
+from wacruit.src.apps import history
 from wacruit.src.apps import member
 from wacruit.src.apps import portfolio
 from wacruit.src.apps import problem
@@ -26,4 +27,5 @@
 api_router.include_router(portfolio.v2_router)
 api_router.include_router(project.router)
 api_router.include_router(seminar.router)
+api_router.include_router(history.router)
 api_router.include_router(review.router)

wacruit/src/database/migrations/versions/2025_07_12_2306-d7157419824c_fix_history_table.py

@@ -0,0 +1,64 @@
+"""fix history table
+
+Revision ID: d7157419824c
+Revises: 22f4d37c8e9f
+Create Date: 2025-07-12 23:06:01.005810
+
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import mysql
+
+# revision identifiers, used by Alembic.
+revision = "d7157419824c"
+down_revision = "22f4d37c8e9f"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "histroy", sa.Column("history_key", sa.String(length=50), nullable=False)
+    )
+    op.add_column(
+        "histroy", sa.Column("history_value", sa.String(length=50), nullable=False)
+    )
+    op.drop_column("histroy", "total_projects")
+    op.drop_column("histroy", "total_users")
+    op.drop_column("histroy", "total_members")
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "histroy",
+        sa.Column(
+            "total_members",
+            mysql.INTEGER(display_width=11),
+            autoincrement=False,
+            nullable=False,
+        ),
+    )
+    op.add_column(
+        "histroy",
+        sa.Column(
+            "total_users",
+            mysql.INTEGER(display_width=11),
+            autoincrement=False,
+            nullable=False,
+        ),
+    )
+    op.add_column(
+        "histroy",
+        sa.Column(
+            "total_projects",
+            mysql.INTEGER(display_width=11),
+            autoincrement=False,
+            nullable=False,
+        ),
+    )
+    op.drop_column("histroy", "history_value")
+    op.drop_column("histroy", "history_key")
+    # ### end Alembic commands ###