# 业主自治系统 **Repository Path**: monkey_devops/Community-Self-Governance-System ## Basic Information - **Project Name**: 业主自治系统 - **Description**: 这是由英郡三期业主共同开发的自治管理系统,基于 Laravel 12 构建,支持 Web/H5/App 和小程序多端应用。本系统旨在服务全体业主,打造自治小区的模范和表率,保障业主知情权、参与权和监督权,促进社区透明化治理和民主决策。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 2 - **Created**: 2025-06-18 - **Last Updated**: 2025-06-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 英郡三期业主自治系统 (Yingjun Phase 3 Community Self-Governance System) 这是由英郡三期业主共同开发的自治管理系统,基于 Laravel 12 构建,支持 Web/H5/App 和小程序多端应用。本系统旨在服务全体业主,打造自治小区的模范和表率,保障业主知情权、参与权和监督权,促进社区透明化治理和民主决策。 This is a self-governance management system developed by the residents of Yingjun Phase 3 community, built on Laravel 12, supporting multiple platforms including Web, H5, App, and mini-programs. The system aims to serve all property owners, create a model for self-governed communities, ensure residents' rights to information, participation, and supervision, and promote transparent governance and democratic decision-making in the community. ## 系统宗旨 (System Mission) - 由业主、为业主、服务业主的自治平台 - 监督业委会合法合规行使权力 - 保障业主的建议权、提议权、诉求权和监督权 - 促进社区事务透明化和决策民主化 - 增强业主归属感和社区凝聚力 ## 主要功能 (Main Features) ### 小区公告 (Community Announcements) - 发布重要通知和社区信息 - 标记优先级和到期时间 - 支持图片和文件附件 - 评论和反馈功能 ### 议题和进度 (Topics and Progress) - 创建社区项目和议题 - 跟踪实施进度和更新状态 - 指定目标完成日期 - 透明的决策和实施流程 ### 跟进事项 (Follow-up Items) - 分配责任人和截止日期 - 优先级管理和状态更新 - 与具体议题相关联 - 提醒和通知功能 ### 业主讨论区 (Resident Discussion Forum) - 话题分类和标签 - 评论和回复功能 - 投票和点赞 - 内容审核和管理 ### 投票表决 (Voting and Polls) - 创建多种类型的投票(单选、多选、排序选择) - 设置开始和结束时间 - 实时结果展示 - 验证和安全保障 ### 信息通知 (Notifications) - 多渠道通知 (SMS、App内推送、Email) - 自定义通知偏好 - 优先级管理 - 已读状态跟踪 ### 个人模块 (User Profile) - 身份认证和验证 - 住户信息管理 - 通知设置管理 - 参与历史记录 ### 账务公开 (Financial Transparency) - 物业费用收支明细 - 专项资金使用情况 - 维修基金账目公示 - 合同招标公示与审查 - 报表生成与下载 - 财务问题咨询与反馈 ### 社区监管 (Community Supervision) - 批评与建议提交 - 匿名意见箱 - 物业服务评价 - 投诉处理与跟踪 - 重要联系方式公示 - 监督举报机制 ### 小区活动 (Community Activities) - 活动发布与报名 - 兴趣小组组建 - 志愿服务招募 - 活动回顾与分享 - 积分奖励机制 ### 流动共享 (Resource Sharing) - 儿童图书/玩具共享与交换 - 闲置物品交换与置换 - 技能互助与服务交换 - 共享物品登记与管理 - 积分兑换系统 ### 找搭子 (Partner Matching) - 运动伙伴匹配(晨跑、健身等) - 拼车/共享出行 - 兴趣小组组建 - 育儿经验交流 - 社区互助服务 ### 安全防护 (Content Safety) - 内容自动过滤系统 - 不当内容举报机制 - 人工审核流程 - 违规用户管理 ## 技术架构 (Technical Architecture) ### 后端 (Backend) - Laravel 12 框架 - MySQL 数据库 - Redis 缓存 - RESTful API + GraphQL ### 前端 (Frontend) - Web: Blade + Alpine.js + Tailwind CSS - 移动端API: Sanctum 认证 ### 安全 (Security) - 角色和权限管理 (Spatie Permission) - 数据验证和清理 - 身份认证和授权 - CSRF 和 XSS 防护 ### 存储 (Storage) - 媒体文件管理 (Spatie Media Library) - 文件上传和处理 - 图片优化和缩放 ## 开发指南 (Development Guide) ### 环境要求 (Requirements) - PHP 8.2+ - MySQL 8.0+ - Composer - Node.js & NPM ### 安装步骤 (Installation) 1. 克隆仓库 (Clone the repository) ```bash git clone [repository-url] cd community-management ``` 2. 安装依赖 (Install dependencies) ```bash composer install npm install ``` 3. 配置环境 (Configure environment) ```bash cp .env.example .env php artisan key:generate ``` 4. 配置数据库 (Configure database in .env) ``` DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=community_management DB_USERNAME=root DB_PASSWORD= ``` 5. 运行数据库迁移 (Run migrations) ```bash php artisan migrate ``` 6. 编译前端资源 (Compile assets) ```bash npm run dev ``` 7. 启动服务器 (Start server) ```bash php artisan serve ``` ### 项目结构 (Project Structure) ``` ├── app/ │ ├── Console/ # 命令行命令 │ ├── Exceptions/ # 异常处理 │ ├── Http/ │ │ ├── Controllers/ # 控制器 │ │ ├── Middleware/ # 中间件 │ │ └── Requests/ # 表单请求验证 │ ├── Models/ # 数据模型 │ ├── Policies/ # 授权策略 │ └── Services/ # 业务逻辑服务 ├── config/ # 配置文件 ├── database/ │ ├── factories/ # 模型工厂 │ ├── migrations/ # 数据库迁移 │ └── seeders/ # 数据填充器 ├── resources/ │ ├── css/ # 样式 │ ├── js/ # JavaScript │ └── views/ # Blade 视图 ├── routes/ # 路由定义 └── tests/ # 测试 ``` ## 贡献与支持 (Contributing and Support) 我们欢迎所有英郡三期的业主参与到系统的建设和完善中来。您可以通过以下方式贡献: - 报告问题和提出功能建议 - 贡献代码或文档更新 - 参与测试和反馈 - 分享和推广系统 ## 许可证 (License) 本项目采用 MIT 许可证。这意味着您可以自由使用、复制、修改、合并、出版发行、散布、再授权及销售本软件的副本,但必须保留版权和许可声明。详见 [LICENSE](LICENSE) 文件。 ## 关于我们 (About Us) 英郡三期业主自治系统由热心业主发起并维护,旨在通过科技手段促进社区自治和透明治理。我们相信,只有业主的广泛参与才能创造一个更美好、更和谐的家园。 --- © 2025 英郡三期业主自治委员会 (Yingjun Phase 3 Residents Self-Governance Committee)