@octo-cyber/property-management 0.5.2

package/web/index.ts

@@ -0,0 +1,24 @@
+// ── Manifest ──────────────────────────────────────────────────────────────────
+export { propertyManifest } from './manifest.js'
+
+// ── Pages ─────────────────────────────────────────────────────────────────────
+export { default as DashboardPage } from './pages/DashboardPage.js'
+export { default as CommunityPage } from './pages/CommunityPage.js'
+export { default as OwnerPage } from './pages/OwnerPage.js'
+export { default as RepairOrderPage } from './pages/RepairOrderPage.js'
+export { default as FeeBillPage } from './pages/FeeBillPage.js'
+export { default as PatrolPage } from './pages/PatrolPage.js'
+export { default as FacilityPage } from './pages/FacilityPage.js'
+export { default as ContractPage } from './pages/ContractPage.js'
+export { default as MeterPage } from './pages/MeterPage.js'
+
+// ── Components ────────────────────────────────────────────────────────────────
+export { RepairStatusBadge } from './components/RepairStatusBadge.js'
+export { BillStatusBadge } from './components/BillStatusBadge.js'
+export { CommunitySelect } from './components/CommunitySelect.js'
+
+// ── Services ──────────────────────────────────────────────────────────────────
+export * from './services/property-api.service.js'
+
+// ── Stores ────────────────────────────────────────────────────────────────────
+export { usePropertyStore } from './stores/property-store.js'

package/web/manifest.ts

@@ -0,0 +1,66 @@
+import type { IFrontendManifest } from '@octo-cyber/core'
+
+export const propertyManifest: IFrontendManifest = {
+  moduleId: 'property-management',
+  icon: 'Building2',
+  color: 'cyan',
+  position: 'main',
+  titleKey: 'property.title',
+  descriptionKey: 'property.description',
+  pages: [
+    {
+      path: '/property',
+      titleKey: 'property.pages.dashboard',
+      icon: 'LayoutDashboard',
+      component: '@octo-cyber/property-management/web/pages/DashboardPage',
+    },
+    {
+      path: '/property/communities',
+      titleKey: 'property.pages.communities',
+      icon: 'Building2',
+      component: '@octo-cyber/property-management/web/pages/CommunityPage',
+    },
+    {
+      path: '/property/owners',
+      titleKey: 'property.pages.owners',
+      icon: 'Users',
+      component: '@octo-cyber/property-management/web/pages/OwnerPage',
+    },
+    {
+      path: '/property/repairs',
+      titleKey: 'property.pages.repairs',
+      icon: 'Wrench',
+      component: '@octo-cyber/property-management/web/pages/RepairOrderPage',
+    },
+    {
+      path: '/property/bills',
+      titleKey: 'property.pages.bills',
+      icon: 'Receipt',
+      component: '@octo-cyber/property-management/web/pages/FeeBillPage',
+    },
+    {
+      path: '/property/patrol',
+      titleKey: 'property.pages.patrol',
+      icon: 'Route',
+      component: '@octo-cyber/property-management/web/pages/PatrolPage',
+    },
+    {
+      path: '/property/facilities',
+      titleKey: 'property.pages.facilities',
+      icon: 'Cog',
+      component: '@octo-cyber/property-management/web/pages/FacilityPage',
+    },
+    {
+      path: '/property/contracts',
+      titleKey: 'property.pages.contracts',
+      icon: 'FileText',
+      component: '@octo-cyber/property-management/web/pages/ContractPage',
+    },
+    {
+      path: '/property/meters',
+      titleKey: 'property.pages.meters',
+      icon: 'Gauge',
+      component: '@octo-cyber/property-management/web/pages/MeterPage',
+    },
+  ],
+}

package/web/messages/en-US.json

@@ -0,0 +1,81 @@
+{
+  "property": {
+    "title": "Property Management",
+    "description": "Community registry, repair orders, billing, and patrol management",
+    "pages": {
+      "dashboard": "Dashboard",
+      "communities": "Communities",
+      "owners": "Owners",
+      "repairs": "Repair Orders",
+      "bills": "Billing",
+      "patrol": "Patrol",
+      "facilities": "Facilities",
+      "contracts": "Contracts",
+      "meters": "Meters"
+    },
+    "common": {
+      "create": "Create",
+      "edit": "Edit",
+      "delete": "Delete",
+      "confirm": "Confirm",
+      "cancel": "Cancel",
+      "save": "Save",
+      "search": "Search",
+      "loading": "Loading...",
+      "noData": "No data",
+      "total": "{count} items"
+    },
+    "community": {
+      "name": "Community Name",
+      "address": "Address",
+      "totalRooms": "Total Units",
+      "occupancyRate": "Occupancy Rate",
+      "status": {
+        "ACTIVE": "Active",
+        "INACTIVE": "Inactive"
+      }
+    },
+    "repair": {
+      "status": {
+        "PENDING": "Pending",
+        "DISPATCHED": "Dispatched",
+        "IN_PROGRESS": "In Progress",
+        "COMPLETED": "Completed",
+        "VERIFIED": "Verified",
+        "CANCELLED": "Cancelled",
+        "REOPENED": "Reopened"
+      },
+      "urgency": {
+        "LOW": "Low",
+        "MEDIUM": "Normal",
+        "HIGH": "Urgent",
+        "URGENT": "Critical"
+      }
+    },
+    "bill": {
+      "status": {
+        "UNPAID": "Unpaid",
+        "PARTIAL": "Partial",
+        "PAID": "Paid",
+        "OVERDUE": "Overdue",
+        "WAIVED": "Waived"
+      }
+    },
+    "patrol": {
+      "status": {
+        "PENDING": "Pending",
+        "IN_PROGRESS": "In Progress",
+        "COMPLETED": "Completed",
+        "MISSED": "Missed"
+      }
+    },
+    "facility": {
+      "status": {
+        "NORMAL": "Normal",
+        "FAULTY": "Faulty",
+        "MAINTENANCE": "Maintenance",
+        "DECOMMISSIONED": "Decommissioned"
+      }
+    }
+  }
+}

package/web/messages/zh-CN.json

@@ -0,0 +1,81 @@
+{
+  "property": {
+    "title": "物业管理",
+    "description": "小区台账、报修工单、物业收费、巡检管理一站式平台",
+    "pages": {
+      "dashboard": "物业驾驶舱",
+      "communities": "小区管理",
+      "owners": "业主管理",
+      "repairs": "报修工单",
+      "bills": "收费账单",
+      "patrol": "巡检管理",
+      "facilities": "设备设施",
+      "contracts": "合同管理",
+      "meters": "仪表抄表"
+    },
+    "common": {
+      "create": "新建",
+      "edit": "编辑",
+      "delete": "删除",
+      "confirm": "确认",
+      "cancel": "取消",
+      "save": "保存",
+      "search": "搜索",
+      "loading": "加载中...",
+      "noData": "暂无数据",
+      "total": "共 {count} 条"
+    },
+    "community": {
+      "name": "小区名称",
+      "address": "地址",
+      "totalRooms": "总户数",
+      "occupancyRate": "入住率",
+      "status": {
+        "ACTIVE": "正常",
+        "INACTIVE": "停用"
+      }
+    },
+    "repair": {
+      "status": {
+        "PENDING": "待派单",
+        "DISPATCHED": "已派单",
+        "IN_PROGRESS": "维修中",
+        "COMPLETED": "待验收",
+        "VERIFIED": "已验收",
+        "CANCELLED": "已取消",
+        "REOPENED": "已重开"
+      },
+      "urgency": {
+        "LOW": "低",
+        "MEDIUM": "普通",
+        "HIGH": "紧急",
+        "URGENT": "特急"
+      }
+    },
+    "bill": {
+      "status": {
+        "UNPAID": "未缴",
+        "PARTIAL": "部分缴",
+        "PAID": "已缴清",
+        "OVERDUE": "已逾期",
+        "WAIVED": "已减免"
+      }
+    },
+    "patrol": {
+      "status": {
+        "PENDING": "待巡检",
+        "IN_PROGRESS": "巡检中",
+        "COMPLETED": "已完成",
+        "MISSED": "漏检"
+      }
+    },
+    "facility": {
+      "status": {
+        "NORMAL": "正常",
+        "FAULTY": "故障",
+        "MAINTENANCE": "维修中",
+        "DECOMMISSIONED": "已报废"
+      }
+    }
+  }
+}

package/web/pages/CommunityPage.tsx

@@ -0,0 +1,182 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import { Plus, Pencil, Trash2, Search } from 'lucide-react'
+import { Button } from '@octo-cyber/ui/components/button'
+import { Input } from '@octo-cyber/ui/components/input'
+import { Badge } from '@octo-cyber/ui/components/badge'
+import {
+  Table, TableBody, TableCell, TableHead, TableHeader, TableRow,
+} from '@octo-cyber/ui/components/table'
+import {
+  Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle,
+} from '@octo-cyber/ui/components/dialog'
+import { Label } from '@octo-cyber/ui/components/label'
+import { toast } from 'sonner'
+import {
+  listCommunities, createCommunity, updateCommunity, deleteCommunity,
+  type Community,
+} from '../services/property-api.service.js'
+
+export default function CommunityPage() {
+  const [items, setItems] = useState<Community[]>([])
+  const [total, setTotal] = useState(0)
+  const [page, setPage] = useState(1)
+  const [keyword, setKeyword] = useState('')
+  const [loading, setLoading] = useState(false)
+  const [dialogOpen, setDialogOpen] = useState(false)
+  const [editing, setEditing] = useState<Partial<Community> | null>(null)
+  const [saving, setSaving] = useState(false)
+
+  const load = () => {
+    setLoading(true)
+    listCommunities({ page, pageSize: 20, keyword })
+      .then((r) => { setItems(r.items); setTotal(r.total) })
+      .catch(() => toast.error('加载失败'))
+      .finally(() => setLoading(false))
+  }
+
+  useEffect(() => { load() }, [page, keyword])
+
+  const openCreate = () => {
+    setEditing({ name: '', address: '', propertyType: 'RESIDENTIAL', status: 'ACTIVE' })
+    setDialogOpen(true)
+  }
+
+  const openEdit = (c: Community) => {
+    setEditing({ ...c })
+    setDialogOpen(true)
+  }
+
+  const handleSave = async () => {
+    if (!editing?.name || !editing?.address) {
+      toast.error('小区名称和地址不能为空')
+      return
+    }
+    setSaving(true)
+    try {
+      if (editing.id) {
+        await updateCommunity(editing.id, editing)
+        toast.success('更新成功')
+      } else {
+        await createCommunity(editing)
+        toast.success('创建成功')
+      }
+      setDialogOpen(false)
+      load()
+    } catch (e: unknown) {
+      toast.error((e as Error).message ?? '操作失败')
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  const handleDelete = async (id: string, name: string) => {
+    if (!confirm(`确认删除小区「${name}」？`)) return
+    try {
+      await deleteCommunity(id)
+      toast.success('删除成功')
+      load()
+    } catch (e: unknown) {
+      toast.error((e as Error).message ?? '删除失败')
+    }
+  }
+
+  return (
+    <div className="space-y-4 p-6">
+      <div className="flex items-center justify-between">
+        <h1 className="text-2xl font-bold">小区管理</h1>
+        <Button onClick={openCreate}><Plus className="mr-2 h-4 w-4" />新建小区</Button>
+      </div>
+
+      <div className="flex items-center gap-2">
+        <Search className="h-4 w-4 text-muted-foreground" />
+        <Input
+          placeholder="搜索小区名称..."
+          value={keyword}
+          onChange={(e) => { setKeyword(e.target.value); setPage(1) }}
+          className="max-w-xs"
+        />
+        <span className="text-sm text-muted-foreground">共 {total} 条</span>
+      </div>
+
+      <div className="rounded-md border">
+        <Table>
+          <TableHeader>
+            <TableRow>
+              <TableHead>小区名称</TableHead>
+              <TableHead>地址</TableHead>
+              <TableHead>总户数</TableHead>
+              <TableHead>已入住</TableHead>
+              <TableHead>状态</TableHead>
+              <TableHead className="w-24">操作</TableHead>
+            </TableRow>
+          </TableHeader>
+          <TableBody>
+            {loading ? (
+              <TableRow><TableCell colSpan={6} className="text-center text-muted-foreground">加载中...</TableCell></TableRow>
+            ) : items.length === 0 ? (
+              <TableRow><TableCell colSpan={6} className="text-center text-muted-foreground">暂无数据</TableCell></TableRow>
+            ) : items.map((c) => (
+              <TableRow key={c.id}>
+                <TableCell className="font-medium">{c.name}</TableCell>
+                <TableCell>{c.address}</TableCell>
+                <TableCell>{c.totalRooms}</TableCell>
+                <TableCell>{c.occupiedRooms}</TableCell>
+                <TableCell>
+                  <Badge variant={c.status === 'ACTIVE' ? 'default' : 'secondary'}>
+                    {c.status === 'ACTIVE' ? '正常' : '停用'}
+                  </Badge>
+                </TableCell>
+                <TableCell>
+                  <div className="flex gap-1">
+                    <Button variant="ghost" size="icon" onClick={() => openEdit(c)}>
+                      <Pencil className="h-4 w-4" />
+                    </Button>
+                    <Button variant="ghost" size="icon" onClick={() => handleDelete(c.id, c.name)}>
+                      <Trash2 className="h-4 w-4 text-destructive" />
+                    </Button>
+                  </div>
+                </TableCell>
+              </TableRow>
+            ))}
+          </TableBody>
+        </Table>
+      </div>
+
+      {total > 20 && (
+        <div className="flex justify-end gap-2">
+          <Button variant="outline" size="sm" disabled={page <= 1} onClick={() => setPage(p => p - 1)}>上一页</Button>
+          <span className="flex items-center text-sm text-muted-foreground">第 {page} 页</span>
+          <Button variant="outline" size="sm" disabled={page * 20 >= total} onClick={() => setPage(p => p + 1)}>下一页</Button>
+        </div>
+      )}
+
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{editing?.id ? '编辑小区' : '新建小区'}</DialogTitle>
+          </DialogHeader>
+          <div className="space-y-4 py-2">
+            <div className="space-y-1">
+              <Label>小区名称 *</Label>
+              <Input value={editing?.name ?? ''} onChange={(e) => setEditing(v => ({ ...v, name: e.target.value }))} />
+            </div>
+            <div className="space-y-1">
+              <Label>地址 *</Label>
+              <Input value={editing?.address ?? ''} onChange={(e) => setEditing(v => ({ ...v, address: e.target.value }))} />
+            </div>
+            <div className="space-y-1">
+              <Label>联系电话</Label>
+              <Input value={editing?.contactPhone ?? ''} onChange={(e) => setEditing(v => ({ ...v, contactPhone: e.target.value }))} />
+            </div>
+          </div>
+          <DialogFooter>
+            <Button variant="outline" onClick={() => setDialogOpen(false)}>取消</Button>
+            <Button onClick={handleSave} disabled={saving}>{saving ? '保存中...' : '保存'}</Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </div>
+  )
+}

package/web/pages/ContractPage.tsx

@@ -0,0 +1,111 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import { Plus, Search } from 'lucide-react'
+import { Button } from '@octo-cyber/ui/components/button'
+import { Input } from '@octo-cyber/ui/components/input'
+import { Badge } from '@octo-cyber/ui/components/badge'
+import {
+  Table, TableBody, TableCell, TableHead, TableHeader, TableRow,
+} from '@octo-cyber/ui/components/table'
+import { toast } from 'sonner'
+import type { Contract } from '../services/property-api.service.js'
+
+const STATUS_LABELS: Record<string, string> = {
+  DRAFT: '草稿', ACTIVE: '有效', EXPIRED: '已到期', TERMINATED: '已终止',
+}
+const STATUS_VARIANT: Record<string, 'default' | 'secondary' | 'destructive' | 'outline'> = {
+  DRAFT: 'outline', ACTIVE: 'default', EXPIRED: 'secondary', TERMINATED: 'destructive',
+}
+
+async function fetchContracts(params: { page: number; keyword?: string }): Promise<{ items: Contract[]; total: number }> {
+  const qs = new URLSearchParams({ page: String(params.page), pageSize: '20' })
+  if (params.keyword) qs.set('keyword', params.keyword)
+  const res = await fetch(`/api/v1/property/contracts?${qs}`)
+  const json = await res.json()
+  if (!res.ok) throw new Error(json.message ?? 'Request failed')
+  return json.data
+}
+
+export default function ContractPage() {
+  const [items, setItems] = useState<Contract[]>([])
+  const [total, setTotal] = useState(0)
+  const [page, setPage] = useState(1)
+  const [keyword, setKeyword] = useState('')
+  const [loading, setLoading] = useState(false)
+
+  const load = () => {
+    setLoading(true)
+    fetchContracts({ page, keyword })
+      .then((r) => { setItems(r.items); setTotal(r.total) })
+      .catch(() => toast.error('加载失败'))
+      .finally(() => setLoading(false))
+  }
+
+  useEffect(() => { load() }, [page, keyword])
+
+  return (
+    <div className="space-y-4 p-6">
+      <div className="flex items-center justify-between">
+        <h1 className="text-2xl font-bold">合同管理</h1>
+        <Button disabled><Plus className="mr-2 h-4 w-4" />新建合同</Button>
+      </div>
+
+      <div className="flex items-center gap-2">
+        <Search className="h-4 w-4 text-muted-foreground" />
+        <Input
+          placeholder="搜索合同名称..."
+          value={keyword}
+          onChange={(e) => { setKeyword(e.target.value); setPage(1) }}
+          className="max-w-xs"
+        />
+        <span className="text-sm text-muted-foreground">共 {total} 条</span>
+      </div>
+
+      <div className="rounded-md border">
+        <Table>
+          <TableHeader>
+            <TableRow>
+              <TableHead>合同编号</TableHead>
+              <TableHead>合同名称</TableHead>
+              <TableHead>类型</TableHead>
+              <TableHead>乙方</TableHead>
+              <TableHead>开始日期</TableHead>
+              <TableHead>到期日期</TableHead>
+              <TableHead>状态</TableHead>
+            </TableRow>
+          </TableHeader>
+          <TableBody>
+            {loading ? (
+              <TableRow><TableCell colSpan={7} className="text-center text-muted-foreground">加载中...</TableCell></TableRow>
+            ) : items.length === 0 ? (
+              <TableRow><TableCell colSpan={7} className="text-center text-muted-foreground">暂无数据</TableCell></TableRow>
+            ) : items.map((c) => (
+              <TableRow key={c.id}>
+                <TableCell className="font-mono text-xs">{c.contractNo}</TableCell>
+                <TableCell className="font-medium">{c.name}</TableCell>
+                <TableCell>{c.type}</TableCell>
+                <TableCell>{c.partyB}</TableCell>
+                <TableCell>{c.startDate?.slice(0, 10)}</TableCell>
+                <TableCell>{c.endDate?.slice(0, 10)}</TableCell>
+                <TableCell>
+                  <Badge variant={STATUS_VARIANT[c.status] ?? 'secondary'}>
+                    {STATUS_LABELS[c.status] ?? c.status}
+                  </Badge>
+                </TableCell>
+              </TableRow>
+            ))}
+          </TableBody>
+        </Table>
+      </div>
+
+      {total > 20 && (
+        <div className="flex justify-end gap-2">
+          <Button variant="outline" size="sm" disabled={page <= 1} onClick={() => setPage(p => p - 1)}>上一页</Button>
+          <span className="flex items-center text-sm text-muted-foreground">第 {page} 页</span>
+          <Button variant="outline" size="sm" disabled={page * 20 >= total} onClick={() => setPage(p => p + 1)}>下一页</Button>
+        </div>
+      )}
+    </div>
+  )
+}

package/web/pages/DashboardPage.tsx

@@ -0,0 +1,136 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import { useTranslations } from 'next-intl'
+import { Building2, Wrench, Receipt, AlertTriangle } from 'lucide-react'
+import { Card, CardContent, CardHeader, CardTitle } from '@octo-cyber/ui/components/card'
+import { toast } from 'sonner'
+import { getStatsDashboard, listCommunities, type DashboardData, type Community } from '../services/property-api.service.js'
+import { CommunitySelect } from '../components/CommunitySelect.js'
+
+export default function DashboardPage() {
+  const t = useTranslations('property')
+  const [communityId, setCommunityId] = useState<string>('')
+  const [communities, setCommunities] = useState<Community[]>([])
+  const [data, setData] = useState<DashboardData | null>(null)
+  const [loading, setLoading] = useState(false)
+
+  useEffect(() => {
+    listCommunities({ pageSize: 100 })
+      .then((r) => {
+        setCommunities(r.items)
+        if (r.items.length > 0) setCommunityId(r.items[0].id)
+      })
+      .catch(() => toast.error('加载小区列表失败'))
+  }, [])
+
+  useEffect(() => {
+    if (!communityId) return
+    setLoading(true)
+    getStatsDashboard(communityId)
+      .then(setData)
+      .catch(() => toast.error('加载数据失败'))
+      .finally(() => setLoading(false))
+  }, [communityId])
+
+  const stats = [
+    {
+      title: '入住率',
+      value: data ? `${(data.occupancyRate * 100).toFixed(1)}%` : '--',
+      icon: Building2,
+      color: 'text-blue-500',
+    },
+    {
+      title: '收费率',
+      value: data ? `${(data.collectionRate * 100).toFixed(1)}%` : '--',
+      icon: Receipt,
+      color: 'text-green-500',
+    },
+    {
+      title: '待处理报修',
+      value: data?.pendingRepairs ?? '--',
+      icon: Wrench,
+      color: 'text-orange-500',
+    },
+    {
+      title: '逾期账单',
+      value: data?.overdueCount ?? '--',
+      icon: AlertTriangle,
+      color: 'text-red-500',
+    },
+  ]
+
+  return (
+    <div className="space-y-6 p-6">
+      <div className="flex items-center justify-between">
+        <h1 className="text-2xl font-bold">{t('pages.dashboard')}</h1>
+        <div className="w-48">
+          <CommunitySelect value={communityId} onChange={setCommunityId} placeholder="选择小区" />
+        </div>
+      </div>
+
+      {loading ? (
+        <div className="grid grid-cols-2 gap-4 lg:grid-cols-4">
+          {[1, 2, 3, 4].map((i) => (
+            <Card key={i} className="animate-pulse">
+              <CardContent className="p-6">
+                <div className="h-8 bg-muted rounded" />
+              </CardContent>
+            </Card>
+          ))}
+        </div>
+      ) : (
+        <div className="grid grid-cols-2 gap-4 lg:grid-cols-4">
+          {stats.map((stat) => (
+            <Card key={stat.title}>
+              <CardHeader className="flex flex-row items-center justify-between pb-2">
+                <CardTitle className="text-sm font-medium text-muted-foreground">{stat.title}</CardTitle>
+                <stat.icon className={`h-4 w-4 ${stat.color}`} />
+              </CardHeader>
+              <CardContent>
+                <div className="text-2xl font-bold">{stat.value}</div>
+              </CardContent>
+            </Card>
+          ))}
+        </div>
+      )}
+
+      {data?.community && (
+        <Card>
+          <CardHeader>
+            <CardTitle>{data.community.name}</CardTitle>
+          </CardHeader>
+          <CardContent>
+            <div className="grid grid-cols-2 gap-4 text-sm md:grid-cols-4">
+              <div>
+                <span className="text-muted-foreground">地址：</span>
+                <span>{data.community.address}</span>
+              </div>
+              <div>
+                <span className="text-muted-foreground">总户数：</span>
+                <span>{data.community.totalRooms}</span>
+              </div>
+              <div>
+                <span className="text-muted-foreground">已入住：</span>
+                <span>{data.community.occupiedRooms}</span>
+              </div>
+              <div>
+                <span className="text-muted-foreground">当前账期：</span>
+                <span>{data.currentPeriod}</span>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      )}
+
+      {communities.length === 0 && !loading && (
+        <Card>
+          <CardContent className="flex flex-col items-center justify-center py-12 text-muted-foreground">
+            <Building2 className="mb-4 h-12 w-12 opacity-30" />
+            <p>暂无小区数据，请先在「小区管理」中添加小区</p>
+          </CardContent>
+        </Card>
+      )}
+    </div>
+  )
+}