Document fields that will be in agency API

[jackiekazil]

Document fields that will be in agency API -- this is for... #27
/cc @vz3

[jackiekazil]

Fields and field notes

Agency 
    name
    abbr -- not consistant, about 10 char max
    desc -- from website, text field
    slug -- based off of name
    chief_foia_officer - name (possibly title)
    image -- currently we do not have these, but it is possible, but we might
        want to get from somewhere else, because the current images are
        restrictive with what we can do -- example: http://www.foia.gov/images/logo-edu.jpg

    Offices (many offices to one agency)
        agency --
        name
        slug -- based off of name 
        request_form -- url or None
        service_center -- phone (usually 1, but sometimes 2
            thinking of restricting to 1)
        website -- url or None
        address/foia_contact -- The FOIA contact is basically a name 
            w/ address to mail FOIA requests.
            This will be text block of 4 to 8 lines. I can parse if needed.
        fax -- number
        emails -- email to send requests (in some cases this is multiple 
            emails -- like 2). No name associated w/ email. 
        notes -- in most cases, this says the following:
            "Notes: This agency has additional FOIA contact information that can be found by visiting its website."
            - However, in some cases it has specific information.
        public_liason -- This is sometimes one person, sometimes multiple
            in one field. 
            -- name
            -- phone
            -- email (sometimes)

Sample data

Agency
    'name': 'Department of Defense',
    'abbr': DoD',
    'desc': 'The mission of the Department of Defense is to provide the military forces needed to deter war and to protect the security of our country.'
    'slug': 'us-transportation-command'
    'officier': (I need to explore this further -- name, title)

Office
    'address':'JoAnne Collins
               FOIA Contact
               SAF/AAII (FOIA)
               1000 Air Force Pentagon
               Washington, DC 20330-1000'],
    'emails': ['haffoia.workflow@pentagon.af.mil'],
    'fax': '703-696-7273',
    'name': 'Department of the Air Force - Headquarters/ICIO (FOIA)',
    'notes': 'This agency has additional FOIA contact information that can be '
          'found by visiting its website.',
    'public_liaison': 'Anh Trinh, Phone: (703) 614-8500',
    'request_form': 'https://www.efoia.af.mil/palMain.aspx',
    'service_center': 'Phone: (703) 696-2735',
    'website': 'http://www.foia.af.mil/'

Link to find records online: http://www.foia.gov/report-makerequest.html

Role descriptions from website

• Chief FOIA Officer – A designated high-level official within each agency who has overall responsibility for the agency’s compliance with the FOIA.
• Requester Service Center – This is the name and phone number of a contact at each agency or office, where you can call and ask questions about your pending FOIA request. Much like with the FOIA Contact, each agency or office handles only the requests that have been sent to them, and can only answer questions on pending requests within their office.
  *FOIA Public Liaison – If you have any issues with how an agency or office is handling your request, you can call the number found here to talk with that agency or office’s FOIA Public Liaison, who will work to address your concerns.
• FOIA Contact – The name, address and phone number at each agency or office where you can make a FOIA request. Each agency or office only handles their own records, so make sure you direct a request to the agency or office that would have the records you are interested in.

[jackiekazil]

Reassigning to @vz3 to close. If this is enough for you, feel free to close this ticket. If not, then please bump back and with you need more info on.

[jackiekazil]

Assuming this is done & enough for you. @vz3, please reopen if it is not.

[vz3]

Looks good for now. Are we going with "officer" over "chief_foia_officer"? The less it looks like a Job Title, the better IMO.

[corizarek]

Good Q, @vz3. Those are actually two separate titles. The Chief FOIA Officer is the head of FOIA ops (the true "chief") while agencies may have one ore more FOIA Officers who share some responsibility, but typically not at the top of the ladder. If we're looking for something all-encompassing, we may want to go with "FOIA contact"?

[jackiekazil]

Currently that position is not included, because we don't have that data, but it will be added in the future. I can be stored as whatever in the json, however what it is displayed as on the website is probably something we need to have more conversation about -- not sure it is that easy.