openapi: 3.0.0
info:
  title: 上海芮生建设工程有限公司 API
  description: 上海芮生建设工程有限公司官方网站信息接口，提供结构化JSON数据供AI Agent和第三方系统使用
  version: 1.0.0
  contact:
    name: 芮生防水
    url: https://www.shrsfsgc.com
    email: service@shrsfsgc.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT

servers:
  - url: https://www.shrsfsgc.com
    description: 官方网站

paths:
  /api/index.json:
    get:
      summary: API端点索引
      description: 获取所有可用的API端点列表
      operationId: getApiIndex
      tags:
        - API元数据
      responses:
        '200':
          description: API端点索引
          content:
            application/json:
              schema:
                type: object
                properties:
                  endpoints:
                    type: array
                    items:
                      type: object
                      properties:
                        path:
                          type: string
                        description:
                          type: string
                  metadata:
                    type: object
                    properties:
                      total:
                        type: integer
                      generated_at:
                        type: string
                        format: date-time
                      version:
                        type: string

  /api/company.json:
    get:
      summary: 公司基本信息
      description: 获取公司基本信息，包括名称、简介、联系方式、服务范围
      operationId: getCompanyInfo
      tags:
        - 公司信息
      responses:
        '200':
          description: 公司基本信息
          content:
            application/json:
              schema:
                type: object
                properties:
                  company:
                    type: object
                    properties:
                      name:
                        type: string
                      description:
                        type: string
                      phone:
                        type: string
                      email:
                        type: string
                      address:
                        type: string
                      services:
                        type: array
                        items:
                          type: string
                  metadata:
                    type: object

  /api/services.json:
    get:
      summary: 服务项目列表
      description: 获取6大核心服务详细信息，包括名称、描述、特点
      operationId: getServices
      tags:
        - 服务
      responses:
        '200':
          description: 服务项目列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  services:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        description:
                          type: string
                        features:
                          type: array
                          items:
                            type: string
                        route:
                          type: string
                  metadata:
                    type: object

  /api/cases.json:
    get:
      summary: 工程案例列表
      description: 获取工程案例列表，包括标题、类型、摘要、材料
      operationId: getCases
      tags:
        - 案例
      responses:
        '200':
          description: 工程案例列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  cases:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        title:
                          type: string
                        type:
                          type: string
                        summary:
                          type: string
                        materials:
                          type: array
                          items:
                            type: string
                  metadata:
                    type: object

  /api/faq.json:
    get:
      summary: 常见问题列表
      description: 获取常见问题列表，包含问答对
      operationId: getFAQ
      tags:
        - 知识
      responses:
        '200':
          description: 常见问题列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  faqs:
                    type: array
                    items:
                      type: object
                      properties:
                        question:
                          type: string
                        answer:
                          type: string
                  metadata:
                    type: object

  /:
    get:
      summary: 首页
      description: 公司首页，展示核心服务、案例、资质等信息
      operationId: getHomepage
      tags:
        - 页面
      responses:
        '200':
          description: 首页内容
          content:
            text/html:
              schema:
                type: string

  /service-items.html:
    get:
      summary: 服务项目列表
      description: 查看所有防水服务项目
      operationId: getServiceItems
      tags:
        - 页面
      responses:
        '200':
          description: 服务项目列表

  /roof-waterproof.html:
    get:
      summary: 屋顶防水保温
      description: 专业屋顶防水保温系统，有效解决屋顶渗漏和隔热问题
      operationId: getRoofWaterproof
      tags:
        - 页面
      responses:
        '200':
          description: 屋顶防水服务详情

  /basement-waterproof.html:
    get:
      summary: 地下室防水防潮
      description: 地下室专业防水防潮解决方案，保持地下室干燥舒适
      operationId: getBasementWaterproof
      tags:
        - 页面
      responses:
        '200':
          description: 地下室防水服务详情

  /wall-waterproof.html:
    get:
      summary: 外墙防水翻新
      description: 外墙防水修复和翻新服务，解决外墙渗水脱落问题
      operationId: getWallWaterproof
      tags:
        - 页面
      responses:
        '200':
          description: 外墙防水服务详情

  /villa-waterproof.html:
    get:
      summary: 别墅防水保温
      description: 别墅整体防水保温系统，高端定制化防水解决方案
      operationId: getVillaWaterproof
      tags:
        - 页面
      responses:
        '200':
          description: 别墅防水服务详情

  /tile-renovation.html:
    get:
      summary: 斜瓦防水翻新
      description: 斜屋顶瓦片防水修复，专业解决瓦片屋面渗漏
      operationId: getTileRenovation
      tags:
        - 页面
      responses:
        '200':
          description: 斜瓦防水服务详情

  /commercial-renovation.html:
    get:
      summary: 工程防水修缮
      description: 大型工程防水修缮服务，商业建筑专业防水解决方案
      operationId: getCommercialRenovation
      tags:
        - 页面
      responses:
        '200':
          description: 工程防水服务详情

  /cases.html:
    get:
      summary: 工程案例
      description: 真实工程案例展示，包含施工前后对比
      operationId: getCasesPage
      tags:
        - 页面
      responses:
        '200':
          description: 工程案例列表

  /construction-cases.html:
    get:
      summary: 施工案例
      description: 施工过程案例展示
      operationId: getConstructionCases
      tags:
        - 页面
      responses:
        '200':
          description: 施工案例列表

  /pricing.html:
    get:
      summary: 收费标准
      description: 透明报价，无隐形消费
      operationId: getPricing
      tags:
        - 页面
      responses:
        '200':
          description: 收费标准详情

  /baike.html:
    get:
      summary: 防水百科
      description: 专业防水知识科普大全
      operationId: getBaike
      tags:
        - 页面
      responses:
        '200':
          description: 防水百科内容

  /knowledge.html:
    get:
      summary: 防水知识
      description: 实用的防水技巧和知识
      operationId: getKnowledge
      tags:
        - 页面
      responses:
        '200':
          description: 防水知识内容

  /faq.html:
    get:
      summary: 常见问题
      description: 防水常见问题解答
      operationId: getFAQPage
      tags:
        - 页面
      responses:
        '200':
          description: 常见问题解答

  /news.html:
    get:
      summary: 新闻资讯
      description: 防水行业动态与公司最新资讯
      operationId: getNews
      tags:
        - 页面
      responses:
        '200':
          description: 新闻资讯列表

  /about.html:
    get:
      summary: 关于我们
      description: 公司介绍、资质荣誉、团队实力
      operationId: getAbout
      tags:
        - 页面
      responses:
        '200':
          description: 公司介绍

  /contact.html:
    get:
      summary: 联系我们
      description: 联系方式、在线留言、服务区域
      operationId: getContact
      tags:
        - 页面
      responses:
        '200':
          description: 联系方式

  /qualifications.html:
    get:
      summary: 资质荣誉
      description: 行业认证、获奖证书、合作伙伴
      operationId: getQualifications
      tags:
        - 页面
      responses:
        '200':
          description: 资质荣誉

  /equipment.html:
    get:
      summary: 施工设备
      description: 专业施工设备展示
      operationId: getEquipment
      tags:
        - 页面
      responses:
        '200':
          description: 施工设备

  /api-docs.html:
    get:
      summary: API鉴权文档
      description: API访问指南、安全最佳实践、OAuth 2.0配置说明
      operationId: getApiDocs
      tags:
        - 开发者资源
      responses:
        '200':
          description: API鉴权文档

tags:
  - name: API元数据
    description: API端点索引和元数据
  - name: 公司信息
    description: 公司基本信息
  - name: 服务
    description: 防水服务相关
  - name: 案例
    description: 工程案例展示
  - name: 知识
    description: 防水知识科普
  - name: 页面
    description: 网站主要页面
  - name: 开发者资源
    description: API文档和开发者工具

components:
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize
          tokenUrl: /oauth/token
          scopes:
            openid: OpenID Connect基础权限
            profile: 获取用户基本信息
            email: 获取用户邮箱地址
            offline_access: 获取刷新令牌

security:
  - oauth2: []
