code4romania/website-factory

网站工厂 (Website Factory)

![License: MPL 2.0]([***]

Code for Romania展示网站

贡献指南 | 技术栈 | 开发指南 | 部署指南 | 反馈 | 许可证 | 关于Code for Romania

概述

本项目是Code for Romania的官方展示网站，用于向公众呈现组织信息、项目详情、志愿者贡献及活动动态。网站采用现代化技术栈构建，支持通过Docker环境进行高效开发和部署，旨在通过数字化方式传播"科技向善"理念。

核心功能与特性

技术栈

• Laravel（后端框架）
• Tailwind CSS（样式框架）
• Inertia.js（前后端交互）
• Vue.js（前端框架）
• Alpine.js（轻量级交互）

系统要求

• PHP 8.1+
• Nginx（Web服务器）
• PostgreSQL 14+（数据库）

开发指南

项目使用Laravel Sail作为默认Docker开发环境，简化本地开发流程。

环境启动

完成初始设置后，运行以下命令启动环境：

sh
./vendor/bin/sail up -d

实时监听并重建CSS/JS资源：

sh
./vendor/bin/sail npm run watch

初始设置

sh
# 1. 安装Composer依赖
docker run --rm -v ${PWD}:/app -w /app composer:latest composer install --ignore-platform-reqs --no-scripts --no-interaction --prefer-dist --optimize-autoloader

# 2. 复制环境变量文件
cp .env.example .env

# 3. 启动应用
./vendor/bin/sail up -d

# 4. 安装npm依赖
./vendor/bin/sail npm ci

# 5. 构建前端资源
./vendor/bin/sail npm run dev

# 6. 生成应用密钥
./vendor/bin/sail artisan key:generate

# 7. 迁移并填充数据库
./vendor/bin/sail artisan migrate:fresh --seed

有关Laravel Sail的更多信息，请查看官方文档。

部署指南

官方Docker镜像

部署最快方式是使用官方Docker镜像：https://hub.docker.com/r/code4romania/website-factory

前提条件

生成应用密钥

部署前需生成有效应用密钥，运行以下命令：

sh
docker run --rm -it code4romania/website-factory php artisan key:generate --show

生成的密钥格式示例：base64:yEtz1eacKMwq0iVT5BUjMMvcn4OAD7QpCgz1yDoXroE=

运行镜像

1. 下载示例docker-compose.yml并配置环境变量（需填入上述生成的APP_KEY）
2. 启动服务：

sh
docker-compose up -d

访问<您的IP>:8080/admin即可进入管理后台，使用配置的ADMIN_EMAIL和ADMIN_PASSWORD登录。

云平台部署

提供AWS和Azure的Terraform部署方案，详见专用仓库：

• AWS: https://github.com/code4romania/terraform-aws-website-factory
• Azure: https://github.com/code4romania/terraform-azure-website-factory

贡献指南

本项目由志愿者构建，您可通过https://github.com/code4romania/.github/blob/main/CONTRIBUTING.md%EF%BC%8C%E6%88%90%E4%B8%BA%E7%A4%BE%E5%8C%BA%E7%9A%84%E4%B8%80%E5%91%98%E3%80%82

反馈

• 在GitHub上提交新功能请求
• 为热门功能请求投票
• 在GitHub Issues中报告bug
• 发送邮件至***提供其他反馈

许可证

本项目基于MPL 2.0许可证授权 - 详见LICENSE文件。

关于Code for Romania

Code for Romania成立于2016年，是Code for All网络的正式成员，致力于通过公民科技解决社会问题。社区拥有500余名志愿者（开发者、设计师、数据科学家等），无偿开发数字解决方案。如需了解更多项目详情，请访问官网；如需联系团队，请发送邮件至***。

社区成员遍布11个时区，通过技术推动社会变革。我们依赖基础设施和社区管理，如您想支持我们，可通过此处。