feat: v2.0 — maintenance module, AI analysis, station power fix

- Add full 检修维护中心 (6.4): 3-type work orders (消缺/巡检/抄表), asset management, warehouse, work plans, billing settlement - Add AI智能分析 tab with LLM-powered diagnostics (StepFun + ZhipuAI) - Add AI模型配置 settings page (provider, temperature, prompts) - Fix station power accuracy: use API station total (station_power) instead of inverter-level computation — eliminates timing gaps - Add 7 new DB models, 4 new API routers, 5 new frontend pages - Migrations: 009 (maintenance expansion) + 010 (AI analysis) - Version bump: 1.6.1 → 2.0.0 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 21:16:03 +08:00
parent 7947a230c4
commit f0f13faf00
30 changed files with 3325 additions and 52 deletions
--- a/core/backend/app/models/init.py
+++ b/core/backend/app/models/init.py
@@ -14,12 +14,16 @@ from app.models.charging import (
 )
 from app.models.quota import EnergyQuota, QuotaUsage
 from app.models.pricing import ElectricityPricing, PricingPeriod
-from app.models.maintenance import InspectionPlan, InspectionRecord, RepairOrder, DutySchedule
+from app.models.maintenance import (
+    InspectionPlan, InspectionRecord, RepairOrder, DutySchedule,
+    Asset, AssetCategory, AssetChange, SparePart, WarehouseTransaction,
+    MaintenanceWorkPlan, BillingRecord,
+)
 from app.models.management import Regulation, Standard, ProcessDoc, EmergencyPlan
 from app.models.prediction import PredictionTask, PredictionResult, OptimizationSchedule
 from app.models.energy_strategy import TouPricing, TouPricingPeriod, EnergyStrategy, StrategyExecution, MonthlyCostReport
 from app.models.weather import WeatherData, WeatherConfig
-from app.models.ai_ops import DeviceHealthScore, AnomalyDetection, DiagnosticReport, MaintenancePrediction, OpsInsight
+from app.models.ai_ops import DeviceHealthScore, AnomalyDetection, DiagnosticReport, MaintenancePrediction, OpsInsight, AIAnalysisResult

 __all__ = [
    "User", "Role", "AuditLog",
@@ -35,9 +39,12 @@ __all__ = [
    "EnergyQuota", "QuotaUsage",
    "ElectricityPricing", "PricingPeriod",
    "InspectionPlan", "InspectionRecord", "RepairOrder", "DutySchedule",
+    "Asset", "AssetCategory", "AssetChange", "SparePart", "WarehouseTransaction",
+    "MaintenanceWorkPlan", "BillingRecord",
    "Regulation", "Standard", "ProcessDoc", "EmergencyPlan",
    "PredictionTask", "PredictionResult", "OptimizationSchedule",
    "TouPricing", "TouPricingPeriod", "EnergyStrategy", "StrategyExecution", "MonthlyCostReport",
    "WeatherData", "WeatherConfig",
    "DeviceHealthScore", "AnomalyDetection", "DiagnosticReport", "MaintenancePrediction", "OpsInsight",
+    "AIAnalysisResult",
 ]
--- a/core/backend/app/models/ai_ops.py
+++ b/core/backend/app/models/ai_ops.py
@@ -86,3 +86,21 @@ class OpsInsight(Base):
    generated_at = Column(DateTime(timezone=True), server_default=func.now())
    valid_until = Column(DateTime(timezone=True))
    created_at = Column(DateTime(timezone=True), server_default=func.now())
+
+
+class AIAnalysisResult(Base):
+    """AI智能分析结果"""
+    __tablename__ = "ai_analysis_results"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    scope = Column(String(20), default="station")  # device, station, all
+    device_id = Column(Integer, ForeignKey("devices.id"), nullable=True)
+    analysis_type = Column(String(20), default="diagnostic")  # diagnostic, insight, custom
+    prompt_used = Column(Text)
+    result_text = Column(Text)
+    model_used = Column(String(100))
+    provider_used = Column(String(20))  # stepfun, zhipu
+    tokens_used = Column(Integer)
+    duration_ms = Column(Integer)
+    created_by = Column(Integer, ForeignKey("users.id"))
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
--- a/core/backend/app/models/maintenance.py
+++ b/core/backend/app/models/maintenance.py
@@ -40,9 +40,11 @@ class RepairOrder(Base):

    id = Column(Integer, primary_key=True, autoincrement=True)
    code = Column(String(50), unique=True, nullable=False)  # WO-20260402-001
+    order_type = Column(String(20), default="repair")  # repair(消缺), inspection(巡检), meter_reading(抄表)
    title = Column(String(200), nullable=False)
    description = Column(Text)
    device_id = Column(Integer, ForeignKey("devices.id"))
+    station_name = Column(String(200))
    alarm_event_id = Column(Integer, ForeignKey("alarm_events.id"))
    priority = Column(String(20), default="medium")  # critical, high, medium, low
    status = Column(String(20), default="open")  # open, assigned, in_progress, completed, verified, closed
@@ -55,6 +57,7 @@ class RepairOrder(Base):
    assigned_at = Column(DateTime(timezone=True))
    completed_at = Column(DateTime(timezone=True))
    closed_at = Column(DateTime(timezone=True))
+    due_date = Column(DateTime(timezone=True))  # 要求完成时间


 class DutySchedule(Base):
@@ -67,3 +70,137 @@ class DutySchedule(Base):
    area_id = Column(Integer, ForeignKey("device_groups.id"))
    notes = Column(Text)
    created_at = Column(DateTime(timezone=True), server_default=func.now())
+
+
+class AssetCategory(Base):
+    __tablename__ = "asset_categories"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    name = Column(String(100), nullable=False)
+    parent_id = Column(Integer, ForeignKey("asset_categories.id"), nullable=True)
+    description = Column(Text)
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+
+
+class Asset(Base):
+    __tablename__ = "assets"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    name = Column(String(200), nullable=False)
+    asset_code = Column(String(50), unique=True)
+    category_id = Column(Integer, ForeignKey("asset_categories.id"))
+    device_id = Column(Integer, ForeignKey("devices.id"), nullable=True)
+    station_name = Column(String(200))
+    manufacturer = Column(String(200))
+    model_number = Column(String(100))
+    serial_number = Column(String(100))
+    purchase_date = Column(DateTime(timezone=True))
+    warranty_expiry = Column(DateTime(timezone=True))
+    purchase_price = Column(Float)
+    status = Column(String(20), default="active")
+    location = Column(String(200))
+    responsible_dept = Column(String(100))
+    custodian = Column(String(100))
+    supplier = Column(String(200))
+    notes = Column(Text)
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+    updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())
+
+
+class AssetChange(Base):
+    __tablename__ = "asset_changes"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    asset_id = Column(Integer, ForeignKey("assets.id"), nullable=False)
+    change_type = Column(String(20))
+    change_date = Column(DateTime(timezone=True))
+    description = Column(Text)
+    old_value = Column(JSON)
+    new_value = Column(JSON)
+    operator_id = Column(Integer, ForeignKey("users.id"))
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+
+
+class SparePart(Base):
+    __tablename__ = "spare_parts"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    name = Column(String(200), nullable=False)
+    part_code = Column(String(50), unique=True)
+    category = Column(String(100))
+    specification = Column(String(200))
+    unit = Column(String(20))
+    current_stock = Column(Integer, default=0)
+    min_stock = Column(Integer, default=0)
+    max_stock = Column(Integer)
+    warehouse_location = Column(String(100))
+    unit_price = Column(Float)
+    supplier = Column(String(200))
+    notes = Column(Text)
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+    updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())
+
+
+class WarehouseTransaction(Base):
+    __tablename__ = "warehouse_transactions"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    spare_part_id = Column(Integer, ForeignKey("spare_parts.id"), nullable=False)
+    transaction_type = Column(String(20))
+    quantity = Column(Integer, nullable=False)
+    unit_price = Column(Float)
+    total_price = Column(Float)
+    transaction_date = Column(DateTime(timezone=True))
+    work_order_id = Column(Integer, ForeignKey("repair_orders.id"), nullable=True)
+    reason = Column(String(200))
+    operator_id = Column(Integer, ForeignKey("users.id"))
+    notes = Column(Text)
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+
+
+class MaintenanceWorkPlan(Base):
+    __tablename__ = "maintenance_work_plans"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    name = Column(String(200), nullable=False)
+    plan_type = Column(String(20))
+    station_name = Column(String(200))
+    device_ids = Column(JSON)
+    cycle_period = Column(String(20))
+    execution_days = Column(Integer)
+    effective_start = Column(DateTime(timezone=True))
+    effective_end = Column(DateTime(timezone=True))
+    description = Column(Text)
+    workflow_config = Column(JSON)
+    is_active = Column(Boolean, default=True)
+    created_by = Column(Integer, ForeignKey("users.id"))
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+    updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())
+
+
+class BillingRecord(Base):
+    __tablename__ = "billing_records"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    station_name = Column(String(200))
+    billing_type = Column(String(20))
+    billing_period_start = Column(DateTime(timezone=True))
+    billing_period_end = Column(DateTime(timezone=True))
+    generation_kwh = Column(Float)
+    self_use_kwh = Column(Float)
+    grid_feed_kwh = Column(Float)
+    electricity_price = Column(Float)
+    self_use_price = Column(Float)
+    feed_in_tariff = Column(Float)
+    total_amount = Column(Float)
+    self_use_amount = Column(Float)
+    feed_in_amount = Column(Float)
+    subsidy_amount = Column(Float)
+    status = Column(String(20), default="pending")
+    invoice_number = Column(String(100))
+    invoice_date = Column(DateTime(timezone=True))
+    attachment_url = Column(String(500))
+    notes = Column(Text)
+    created_by = Column(Integer, ForeignKey("users.id"))
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+    updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())