# GEO

**Repository Path**: feishu-tech/geo

## Basic Information

- **Project Name**: GEO
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-06
- **Last Updated**: 2026-11-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GEO运营

面向全球团队的 GEO（Generative Engine Optimization）开源运营平台：内容工作流、AI 可见性度量、托管渠道站点与部署升级工具链。

[![License-AGPL--3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)

## 功能概览

- 文章 / 关键词 / 标题 / 素材库的内容工作流
- AI 可见性采集与报表（`geoflow:collect-ai-visibility`）
- 托管渠道站点（hosted channel sites）与多站点前缀路由
- 系统更新器（Updater）与签名升级计划（`deployment/upgrade-plan.json`）
- GEO运营 CLI：`catalog` / `task` / `job` / `material` / `article` 子命令

## 本地开发

```bash
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan serve --port=18080
```

启动后：

- 站点首页：http://localhost:18080
- 后台登录：http://localhost:18080/geo_admin/login

更多本地配置（`GEO_FORWARDED_PREFIX`、Reverb 等）见 `docs/deployment/DEPLOYMENT.md`。

## 生产部署

生产环境必须显式加载 `.env.prod`：

```bash
docker compose -f docker-compose.prod.yml --env-file .env.prod up -d

# 按服务名拉起全栈（并清理孤儿容器）
docker compose up -d --remove-orphans
docker compose --env-file .env.prod -f docker-compose.prod.yml up -d --remove-orphans app web queue ai-quality-queue ai-quality-backfill-queue ai-optimization-queue knowledge-queue scheduler reverb
```

完整部署与升级流程见 `docs/deployment/DEPLOYMENT.md` 与 `docs/deployment/GEO_V3_RELEASE.md`。

## 许可

本项目采用 GNU Affero General Public License v3.0（AGPL-3.0-only）许可，
历史 Apache-2.0 部分见 `docs/licenses/Apache-2.0.txt` 与 `NOTICE`。

贡献代码前请阅读并签署 Contributor License Agreement v1.0（见 `CLA.md`）；
提交 Pull Request 时会通过 `.github/pull_request_template.md` 提示确认。