#星光不负 码向未来# 从“写页面”到“做能力”：一个大学生自学上岸的鸿蒙实战复盘 原创

{
  "module": {
    "abilities": [{
      "name": "EntryAbility",
      "skills": [{
        "actions": [ "action.view" ],
        "uris": [{
          "scheme": "https",
          "host": "study.自己的网页.com",
          "paths": [ "/room/*" ]
        }]
      }]
    }]
  }
}

// form/Card.ets
@Component
export struct RoomCard {
  @Prop roomId: string
  @State slot: string = ''
  @State brief: string = '点击预约 / 查看状态'

  build() {
    Column({ space: 8 }) {
      Text(`自习室 ${this.roomId}`).fontSize(18).fontWeight(FontWeight.Medium)
      Text(this.brief).fontSize(14)
      Row({ space: 12 }) {
        Button('预约').onClick(() => postCardEvent('reserve', { roomId: this.roomId, slot: this.slot }))
        Button('取消').onClick(() => postCardEvent('cancel', { roomId: this.roomId, slot: this.slot }))
      }
    }.padding(16)
  }
}

// 将事件抛给卡片宿主（由 FormExtensionAbility 接收）
function postCardEvent(type: string, payload: Record<string, string | number>) {
  // 实际用 FormExtensionAbility 的 onEvent 接收，以下为示意
  (globalThis as any).__FORM_EVENT__?.({ type, payload })
}

// form/FormExtAbility.ets（示意）
export default class FormExtAbility extends FormExtensionAbility {
  async onAddForm(formId: string, want: Want): Promise<void> {
    // 初始化卡片数据：最近可预约时间段等
    await this.updateForm(formId, { slot: nextAvailableSlot() })
  }

  async onEvent(formId: string, message: string): Promise<void> {
    const evt = JSON.parse(message) // { type, payload }
    if (evt.type === 'reserve') {
      const ok = await reserveRoom(evt.payload.roomId, evt.payload.slot) // 调云函数
      await this.updateForm(formId, { brief: ok ? '预约成功' : '名额已满' })
    } else if (evt.type === 'cancel') {
      const ok = await cancelRoom(evt.payload.roomId, evt.payload.slot)
      await this.updateForm(formId, { brief: ok ? '已取消' : '取消失败' })
    }
  }
}

// data/clouddb.ts（示意，以实际 AGC 接口为准）
import agconnect from '@hw-agconnect/core'
import clouddb from '@hw-agconnect/clouddb'

let zone: any

export async function initCloudDB() {
  await agconnect.instance().config({ /* your agc options */ })
  const cloudDB = clouddb.AGConnectCloudDB.getInstance(agconnect.instance())
  await cloudDB.initialize()
  zone = await cloudDB.openCloudDBZone('room_booking', {
    syncMode: clouddb.CloudDBZoneConfig.CloudDBZoneSyncProperty.CLOUDDBZONE_CLOUD_CACHE,
    accessProperty: clouddb.CloudDBZoneConfig.CloudDBZoneAccessProperty.CLOUDDBZONE_PUBLIC
  })
}

export async function queryRoomStatus(roomId: string, slot: string) {
  const query = clouddb.CloudDBZoneQuery.where('Booking')
    .equalTo('roomId', roomId).and().equalTo('slot', slot)
  const result = await zone.executeQuery(query)
  return result.getSnapshotObjects() // 本地有缓存，弱网也能读
}

// functions/reserveRoom.js
const { getDB, withTransaction } = require('./_db') // 你自己的封装

exports.main = async (event, context) => {
  const { roomId, slot, uid } = event
  const db = await getDB()

  return withTransaction(db, async (tx) => {
    const key = `${roomId}@${slot}`
    const quota = await tx.get('Quota', key) // { total, used, version }
    if (!quota || quota.used >= quota.total) {
      return { ok: false, reason: 'FULL' }
    }
    // 幂等：同一人重复提交直接返回成功
    const existing = await tx.get('Booking', `${key}#${uid}`)
    if (existing) return { ok: true, dup: true }

    // 乐观锁：版本号或 compare-and-set
    await tx.update('Quota', key, { used: quota.used + 1, version: quota.version + 1 }, { matchVersion: quota.version })
    await tx.put('Booking', `${key}#${uid}`, { roomId, slot, uid, ts: Date.now() })
    return { ok: true }
  })
}

@RestController
@RequestMapping("/admin/booking")
public class BookingAdminController {
  private final BookingService bookingService;

  public BookingAdminController(BookingService bookingService) {
    this.bookingService = bookingService;
  }

  @PostMapping("/unlock")
  public Resp unlock(@RequestParam String roomId, @RequestParam String slot) {
    bookingService.unlockQuota(roomId, slot); // 释放异常卡死的占用
    return Resp.ok();
  }

  @GetMapping("/export")
  public void export(@RequestParam String date, HttpServletResponse res) {
    res.setHeader("Content-Disposition", "attachment; filename=booking-"+date+".csv");
    bookingService.exportCsv(date, res);
  }
}