🐰 兔兔救助小程序 Rabbit Rescue Mini-Program

graph TB
    subgraph Client["微信客户端"]
        MP["兔兔救助小程序\nUniApp / Vue3"]
    end

    subgraph CDN["微信平台"]
        WX["微信服务器\n登录 / 订阅消息"]
    end

    subgraph Server["服务端"]
        direction TB
        API["FastAPI\n:8000"]
        AUTH["JWT 认证\n中间件"]
        SM["救援状态机\nrescue state machine"]
        API --> AUTH
        API --> SM
    end

    subgraph Storage["存储层"]
        DB["SQLite / PostgreSQL\nSQLAlchemy ORM"]
        FS["静态文件\n/static/images/"]
    end

    MP -->|"HTTPS REST API\nBearer Token"| API
    MP -->|"wx.login code"| WX
    WX -->|"openid + session_key"| API
    API -->|"订阅消息推送"| WX
    WX -->|"通知"| MP
    API --> DB
    API --> FS
    MP -->|"图片直接访问"| FS

graph LR
    subgraph Pages["主页面 pages/"]
        P1["rescue/list\n救援列表"]
        P2["adoption/index\n领养"]
        P3["donation/index\n爱兔公益"]
        P4["activity/index\n活动"]
        P5["profile/index\n我的"]
        P6["auth/login\n登录"]
    end

    subgraph Sub["分包 subpackages/"]
        S1["rescue/\n详情/创建/编辑/筛选"]
        S2["adoption/\n领养申请/兔子详情"]
        S3["donation/\n捐换列表/详情/创建"]
        S4["charity/\n义卖列表/详情/寄养招募/申请"]
        S5["activity/\n云养兔/线下活动详情/创建/编辑"]
        S6["profile/\n消息/帖子/我的领养/我的寄养/设置"]
        S7["admin/\n待审核/历史/领养/寄养/兔子/义卖/用户管理"]
        S8["chat/\n聊天"]
        S9["about/\n关于"]
    end

    subgraph Shared["共享层"]
        C["components/\n公共组件"]
        SVC["services/\nAPI 封装"]
        ST["stores/ Pinia\n状态管理"]
        CFG["config/env.ts\n环境配置"]
    end

    Pages --> Shared
    Sub --> Shared
    SVC -->|"HTTP"| API["后端 API"]
    ST --> SVC

graph TB
    subgraph Routers["路由层 routers/"]
        R1["auth\n登录/注册"]
        R2["rescue\n救援贴/志愿者"]
        R3["adoption\n领养"]
        R4["donation\n捐换"]
        R5["activity\n活动"]
        R6["community\n社区"]
        R7["messages\n消息"]
        R8["profile\n用户资料"]
        R9["admin\n管理员"]
        R10["upload\n图片上传"]
        R11["charity sale\n义卖商品"]
        R12["foster\n寄养申请"]
        R13["rabbits\n兔子档案"]
        R14["chat\n聊天"]
    end

    subgraph Core["核心层"]
        AUTH["auth.py\nJWT 生成/验证"]
        WX["wechat.py\n微信 API 集成"]
        SM["rescue state machine\n状态转换校验"]
        DEP["deps.py\n依赖注入"]
    end

    subgraph Data["数据层"]
        MOD["models.py\nSQLAlchemy 模型"]
        SCH["schemas.py\nPydantic 校验"]
        DB["database.py\n数据库会话"]
        MIG["alembic/\n迁移脚本"]
    end

    Routers --> Core
    Routers --> Data
    Core --> Data
    R2 --> SM
    R1 --> WX

erDiagram
    User {
        int id
        string openid
        string username
        string role
        int cloud_coins
        bool is_banned
    }
    RescuePost {
        int id
        string review_status
        string rescue_status
        int publisher_id
        datetime deleted_at
    }
    RescueStatusHistory {
        int id
        int rescue_post_id
        string old_status
        string new_status
        int changed_by_id
    }
    RescueApplication {
        int id
        int rescue_post_id
        int applicant_id
    }
    AdoptionIntent {
        int id
        int rescue_post_id
        int applicant_id
        string status
    }
    DonationPost {
        int id
        string donation_type
        int publisher_id
        bool is_completed
    }
    CharitySaleItem {
        int id
        string title
        string status
        int created_by_id
    }
    Activity {
        int id
        string activity_type
        int organizer_id
    }
    Message {
        int id
        int recipient_id
        string content
        bool is_read
    }
    Rabbit {
        int id
        string name
        string status
        string gender
        int rescue_post_id
    }
    FosterApplication {
        int id
        int applicant_id
        string status
        string review_note
    }
    Conversation {
        int id
        int user_id
        int admin_id
    }
    ChatMessage {
        int id
        int conversation_id
        int sender_id
        string content
    }

    User ||--o{ RescuePost : "发布"
    User ||--o{ RescueApplication : "申请参与"
    User ||--o{ AdoptionIntent : "申请领养"
    User ||--o{ FosterApplication : "申请寄养"
    User ||--o{ DonationPost : "发布"
    User ||--o{ Message : "接收"
    User ||--o{ Conversation : "参与聊天"
    RescuePost ||--o{ RescueStatusHistory : "状态历史"
    RescuePost ||--o{ RescueApplication : "救援申请"
    RescuePost ||--o{ AdoptionIntent : "领养申请"
    RescuePost ||--o| Rabbit : "兔子档案"
    Conversation ||--o{ ChatMessage : "包含消息"

flowchart TD
    A([发布救援帖]) --> B[待审核]
    B --> C{管理员审核}
    C -->|通过| D[公开展示]
    C -->|驳回 需填原因| E[已驳回]
    E -->|修改重提<br/>最多3次| B

    D --> P1[待救援]
    P1 --> P2[救援中]
    P2 -->|救出 送寄养家庭| P3[寄养中]
    P2 -->|线下直接领养<br/>需填领养人备注| P4[已领养]
    P2 -->|不治离世| P5[已去世]
    P3 -->|找到领养家庭| P4
    P3 -->|不治离世| P5

    P3 -.->|系统自动建档| R[(兔兔档案)]
    R -.->|出现在领养页面| Adopt[用户提交领养申请]
    Adopt -.->|管理员审核通过| P4
    P4 -.->|状态同步| R
    P5 -.->|状态同步| R

    style P1 fill:#dc2626,color:#fff
    style P2 fill:#ea580c,color:#fff
    style P3 fill:#7c3aed,color:#fff
    style P4 fill:#15803d,color:#fff
    style P5 fill:#6b7280,color:#fff
    style R fill:#fffbeb,stroke:#d97706,stroke-width:2px