feat(backend): Phase 1-4 全新開發完成，37/37 TDD 通過

[Phase 0 Reset]
- 清除舊版 app/、alembic/versions/、雜亂測試腳本
- 新 requirements.txt (移除 caldav/redis/keycloak-lib，加入 apscheduler/croniter/docker/paramiko/ping3/dnspython)

[Phase 1 資料庫]
- 9 張資料表 SQLAlchemy Models：tenants / accounts / schedules / schedule_logs /
  tenant_schedule_results / account_schedule_results / servers / server_status_logs / system_status_logs
- Alembic migration 001_create_all_tables (已套用到 10.1.0.20:5433/virtual_mis)
- seed.py：schedules 初始 3 筆 / servers 初始 4 筆

[Phase 2 CRUD API]
- GET/POST/PUT/DELETE: /api/v1/tenants / accounts / servers / schedules
- /api/v1/system-status
- 帳號編碼自動產生 (prefix + seq_no 4碼左補0)
- 燈號 (lights) 從最新排程結果取得

[Phase 3 Watchdog]
- APScheduler interval 3分鐘，原子 UPDATE status=Going 防重複執行
- 手動觸發 API: POST /api/v1/schedules/{id}/run

[Phase 4 Service Clients]
- KeycloakClient：vmis-admin realm，REST API (不用 python-keycloak)
- MailClient：Docker Mailserver @ 10.1.0.254:8080，含 MX DNS 驗證
- DockerClient：docker-py 本機 + paramiko SSH 遠端 compose
- NextcloudClient：OCS API user/quota
- SystemChecker：功能驗證 (traefik routers>0 / keycloak token / SMTP EHLO / DB SELECT 1 / ping)

[TDD]
- 37 tests / 37 passed (2.11s)
- SQLite in-memory + StaticPool，無需外部 DB

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

backend/app/models/__init__.py

@@ -0,0 +1,11 @@
+from app.models.tenant import Tenant
+from app.models.account import Account
+from app.models.schedule import Schedule, ScheduleLog
+from app.models.result import TenantScheduleResult, AccountScheduleResult
+from app.models.server import Server, ServerStatusLog, SystemStatusLog
+
+__all__ = [
+    "Tenant", "Account", "Schedule", "ScheduleLog",
+    "TenantScheduleResult", "AccountScheduleResult",
+    "Server", "ServerStatusLog", "SystemStatusLog",
+]

backend/app/models/account.py

@@ -0,0 +1,28 @@
+from datetime import datetime
+from sqlalchemy import Boolean, Column, Integer, String, DateTime, ForeignKey
+from sqlalchemy.orm import relationship
+from app.core.database import Base
+
+
+class Account(Base):
+    __tablename__ = "accounts"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    tenant_id = Column(Integer, ForeignKey("tenants.id", ondelete="CASCADE"), nullable=False, index=True)
+    account_code = Column(String(20), unique=True, nullable=False, index=True)  # prefix + seq_no 4碼左補0
+    sso_account = Column(String(100), nullable=False)
+    sso_uuid = Column(String(100), unique=True)     # Keycloak UUID，首次建立後回寫
+    notification_email = Column(String(200), nullable=False)
+    email = Column(String(200))                      # sso_account@tenants.domain
+    legal_name = Column(String(200))
+    english_name = Column(String(200))
+    quota_limit = Column(Integer, nullable=False, default=20)  # GB
+    is_active = Column(Boolean, nullable=False, default=True)
+    default_password = Column(String(200))
+    seq_no = Column(Integer, nullable=False)         # 同租戶內流水號
+
+    created_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+    updated_at = Column(DateTime, nullable=False, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    tenant = relationship("Tenant", back_populates="accounts")
+    schedule_results = relationship("AccountScheduleResult", back_populates="account")

backend/app/models/result.py

@@ -0,0 +1,60 @@
+from datetime import datetime
+from sqlalchemy import Boolean, Column, Integer, String, Text, DateTime, Float, ForeignKey
+from sqlalchemy.orm import relationship
+from app.core.database import Base
+
+
+class TenantScheduleResult(Base):
+    __tablename__ = "tenant_schedule_results"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    schedule_log_id = Column(Integer, ForeignKey("schedule_logs.id"), nullable=False, index=True)
+    tenant_id = Column(Integer, ForeignKey("tenants.id"), nullable=False, index=True)
+
+    traefik_status = Column(Boolean)
+    traefik_done_at = Column(DateTime)
+
+    sso_result = Column(Boolean)
+    sso_done_at = Column(DateTime)
+
+    mailbox_result = Column(Boolean)
+    mailbox_done_at = Column(DateTime)
+
+    nc_result = Column(Boolean)
+    nc_done_at = Column(DateTime)
+
+    office_result = Column(Boolean)
+    office_done_at = Column(DateTime)
+
+    fail_reason = Column(Text)
+    quota_usage = Column(Float)   # GB
+    recorded_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+
+    schedule_log = relationship("ScheduleLog", back_populates="tenant_results")
+    tenant = relationship("Tenant", back_populates="schedule_results")
+
+
+class AccountScheduleResult(Base):
+    __tablename__ = "account_schedule_results"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    schedule_log_id = Column(Integer, ForeignKey("schedule_logs.id"), nullable=False, index=True)
+    account_id = Column(Integer, ForeignKey("accounts.id"), nullable=False, index=True)
+
+    sso_uuid = Column(String(100))
+    sso_account = Column(String(100))
+    sso_result = Column(Boolean)
+    sso_done_at = Column(DateTime)
+
+    mailbox_result = Column(Boolean)
+    mailbox_done_at = Column(DateTime)
+
+    nc_result = Column(Boolean)
+    nc_done_at = Column(DateTime)
+
+    fail_reason = Column(Text)
+    quota_usage = Column(Float)   # GB
+    recorded_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+
+    schedule_log = relationship("ScheduleLog", back_populates="account_results")
+    account = relationship("Account", back_populates="schedule_results")

backend/app/models/schedule.py

@@ -0,0 +1,36 @@
+from datetime import datetime
+from sqlalchemy import Column, Integer, String, DateTime, ForeignKey
+from sqlalchemy.orm import relationship
+from app.core.database import Base
+
+
+class Schedule(Base):
+    __tablename__ = "schedules"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    name = Column(String(100), unique=True, nullable=False)
+    cron_timer = Column(String(50), nullable=False)   # 六碼 cron: 秒 分 時 日 月 週
+    status = Column(String(10), nullable=False, default="Waiting")  # Waiting / Going
+    last_run_at = Column(DateTime)
+    next_run_at = Column(DateTime)
+    last_status = Column(String(10))                  # ok / error
+    recorded_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+
+    logs = relationship("ScheduleLog", back_populates="schedule")
+
+
+class ScheduleLog(Base):
+    __tablename__ = "schedule_logs"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    schedule_id = Column(Integer, ForeignKey("schedules.id"), nullable=False, index=True)
+    schedule_name = Column(String(100), nullable=False)
+    started_at = Column(DateTime, nullable=False)
+    ended_at = Column(DateTime)
+    status = Column(String(10), nullable=False, default="running")  # running / ok / error
+
+    schedule = relationship("Schedule", back_populates="logs")
+    tenant_results = relationship("TenantScheduleResult", back_populates="schedule_log")
+    account_results = relationship("AccountScheduleResult", back_populates="schedule_log")
+    system_status_logs = relationship("SystemStatusLog", back_populates="schedule_log")
+    server_status_logs = relationship("ServerStatusLog", back_populates="schedule_log")

backend/app/models/server.py

@@ -0,0 +1,48 @@
+from datetime import datetime
+from sqlalchemy import Boolean, Column, Integer, String, Text, DateTime, Float, ForeignKey
+from sqlalchemy.orm import relationship
+from app.core.database import Base
+
+
+class Server(Base):
+    __tablename__ = "servers"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    name = Column(String(100), nullable=False)
+    ip_address = Column(String(50), unique=True, nullable=False)
+    description = Column(String(200))
+    sort_order = Column(Integer, nullable=False, default=0)
+    is_active = Column(Boolean, nullable=False, default=True)
+    recorded_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+
+    status_logs = relationship("ServerStatusLog", back_populates="server")
+
+
+class ServerStatusLog(Base):
+    __tablename__ = "server_status_logs"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    schedule_log_id = Column(Integer, ForeignKey("schedule_logs.id"), nullable=False, index=True)
+    server_id = Column(Integer, ForeignKey("servers.id"), nullable=False, index=True)
+    result = Column(Boolean, nullable=False)
+    response_time = Column(Float)     # ms
+    fail_reason = Column(Text)
+    recorded_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+
+    schedule_log = relationship("ScheduleLog", back_populates="server_status_logs")
+    server = relationship("Server", back_populates="status_logs")
+
+
+class SystemStatusLog(Base):
+    __tablename__ = "system_status_logs"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    schedule_log_id = Column(Integer, ForeignKey("schedule_logs.id"), nullable=False, index=True)
+    environment = Column(String(10), nullable=False)    # test / prod
+    service_name = Column(String(50), nullable=False)  # traefik / keycloak / mail / db
+    service_desc = Column(String(100))
+    result = Column(Boolean, nullable=False)
+    fail_reason = Column(Text)
+    recorded_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+
+    schedule_log = relationship("ScheduleLog", back_populates="system_status_logs")

backend/app/models/tenant.py

@@ -0,0 +1,37 @@
+from datetime import datetime
+from sqlalchemy import Boolean, Column, Integer, String, Text, DateTime, Date
+from sqlalchemy.orm import relationship
+from app.core.database import Base
+
+
+class Tenant(Base):
+    __tablename__ = "tenants"
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    code = Column(String(50), unique=True, nullable=False, index=True)
+    prefix = Column(String(20), nullable=False, default="")
+    name = Column(String(200), nullable=False)
+    name_eng = Column(String(200))
+    tax_id = Column(String(20))
+    domain = Column(String(200), unique=True, nullable=False, index=True)
+    address = Column(String(500))
+    tel = Column(String(50))
+    contact = Column(String(100))
+    contact_mobile = Column(String(50))
+    contact_email = Column(String(200))
+    keycloak_realm = Column(String(100))
+    plan_code = Column(String(50))
+    employee_limit = Column(Integer)
+    trial_start_date = Column(Date)
+    trial_end_date = Column(Date)
+    quota_per_user = Column(Integer, nullable=False, default=20)   # GB
+    total_quota = Column(Integer, nullable=False, default=200)     # GB
+    is_manager = Column(Boolean, nullable=False, default=False)
+    is_active = Column(Boolean, nullable=False, default=True)
+    status = Column(String(20), nullable=False, default="trial")   # trial / active / inactive
+    note = Column(Text)
+    created_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+    updated_at = Column(DateTime, nullable=False, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    accounts = relationship("Account", back_populates="tenant", cascade="all, delete-orphan")
+    schedule_results = relationship("TenantScheduleResult", back_populates="tenant")